About this article:
! If upgrading from lower versions ie: NP 17.2.x and lower, there is an upgrade path that needs to be complied with. Please review the following links prior to upgrading:
Environment:
- Qlik NPrinting 17.3.x and higher versions
Before proceeding please note the following:
*Do not uninstall Qlik NPrinting Server in order to upgrade. This is an 'in-place' upgrade*
*Do not perform an NPrinting Database restore at any point in the upgrade process*. The NPrinting tables are updated by the NPrinting upgrade process
- Prepare for upgrade following Parts 1 and 2 below
- A backup should be taken prior to the upgrade as a precautionary measure in case a roll back to the previous version is required
- NPrinting must not be installed on the same computer as the QlikView or Qlik Sense servers. https://help.qlik.com/en-US/nprinting/Content/NPrinting/DeployingQVNprinting/Supported-unsupported-c...
- Qlik Sense 3.1 is the minimum requirement for full inter-operability with NPrinting 17.3.x and all higher versions
- Once you are fully prepared, follow the install steps provided in Part 3 through Part 5 below.
Upgrade Steps:
Part 1: Prepare for the installation
System requirements:
Part 2: Back up the NPrinting Repository Database
- Stop the Qlik NPrinting services
- Open the Windows Service Manager (services.msc), and stop the following services (by right-clicking them, and then clicking Stop) in the order below:
- Qlik NPrinting Engine
- Qlik NPrinting Scheduler
- Qlik NPrinting WebEngine
- Qlik NPrinting Messaging Service
- Do not stop the Qlik NPrinting RepoService
- Create a folder for your NPrinting backups (NOTE: do NOT change any of the default paths below)
Create the folder C:\NPrintingBackups
- Open a windows Administrative command prompt to perform the backup
- Change directory using the following command: cd C:\Program Files\NPrintingServer\Tools\Manager
- Copy the following syntax into the command prompt replacing yoursuperuserdbpasswordhere with the NP superuser password that was first used to install NPrinting with
Qlik.Nprinting.Manager.exe backup -f C:\NPrintingBackups\NP_Backup.zip -p "C:\Program Files\NPrintingServer\pgsql\bin" --pg-password yoursuperuserdbpasswordhere
! Check that the backup message "completed successfully" Qlik.Nprinting.Manager.exe's command prompt window
The resulting back up file should be similar size to the files found in C:\ProgramData\NPrinting
Part 3: Upgrade the NPrinting server using the steps in the links below and in the order as follows
Upgrade the NPrinting Engine:
- The NP engine installation software used MUST match the version of the NPrinting server
- Stop the NP engine, License, Scheduler, Web Engine service before performing the upgrade
Reference: https://help.qlik.com/en-US/nprinting/Content/NPrinting/DeployingQVNprinting/Installing-q...
Part 4: Check that all NPrinting services are running
- Open the Windows Services panel and review all Qlik Nprinting services to ensure they are started
- Log into NPrinting as usual and begin working
- Note that once the upgrade is complete, you will find two automated NPrinting backup files created by the upgrade process that can be found here: C:\ProgramData\NPrinting. The upgrade process creates pre and post upgrade backup files that may be used for disaster recovery purposes. Product Version IDs and Upgrade dates are appended to these files. See examples below:
- 201810041251491282_nprinting18.19.6.0_backup_old.zip
- 201810041301581371_nprinting18.29.7.0_backup_new.zip
! For disaster recovery purposes, as a standard industry best practice, it is recommended to perform regular manual backups including the NPrinting repository database. See the following article for NP database backup and restore procedure
Part 5:
Finally, update all NPrinting Designers so that they match the NPrinting server and NP engine version that have been upgraded as per above
Reference: