Planning your upgrade
You must follow one of the approved upgrade paths to ensure that the Qlik NPrinting repository is rendered compatible with the newer version of Qlik NPrinting. If you try to upgrade Qlik NPrinting without following an approved upgrade path, the installer will stop the procedure and display an error message.
As a best practice, you should update your Qlik NPrinting deployment regularly, to ensure you are using a supported version.
You must back up your data before you proceed. Data can become damaged if a problem occurs during the upgrade. If data is damaged, a backup is required to restore the repository. For more information, see Backup and restore Qlik NPrinting.
If you are upgrading from a version older than February 2018, all QlikView and Qlik Sense metadata caches will be marked as "not generated". This is due to a breaking change in the format of the metadata cache. All connection caches must be regenerated before you can edit a template or create a new connection.
Upgrading from April 2018 or newer
You can upgrade from Qlik NPrinting April 2018 (18.9.5) or later using the Qlik NPrinting setup program. For more information, see Upgrading Qlik NPrinting.
If you want to upgrade to May 2022 or later you must start from April 2018 or later.
Upgrading from September 2018 SR2 or older
If you are upgrading from September 2018 SR2 or older you must:
-
Open port 4997 outbound on Qlik NPrinting Server and inbound on all Qlik NPrinting Engines.
-
Reinstall all your Qlik NPrinting Engine and provide a password for certificate exchange.
-
Open the Engine manager in the Web Console.
-
Open the detail page for each Engine and send the certificate after inserting the same password you used during the engine’s re-installation.
Qlik NPrinting Engines stay offline until the certificate exchange is performed.
Upgrade paths from version 17.3 to Qlik NPrinting June 2017 or newer
The following information applies if you are upgrading to Qlik NPrinting June 2017 or later.
To upgrade to Qlik NPrinting June 2017 or later you must start from any previous version of Qlik NPrinting in the 17.3 series or later. You cannot upgrade to Qlik NPrinting June 2017 or later from a version older than 17.3. For example, if you have installed Qlik NPrinting 17.1 you must first upgrade to 17.2 and then to 17.3 before upgrading to Qlik NPrinting June 2017 or later.
Upgrade paths from version 17.2 to version 17.3
The following information applies if you are upgrading Qlik NPrinting to version 17.3 or 17.3.1.
Qlik NPrinting 17.3 has increased the number of supported upgrade paths. To upgrade to Qlik NPrinting 17.3.0 you must start from any version of Qlik NPrinting in the 17.2 series. You cannot upgrade to Qlik NPrinting 17.3 from a version older then 17.2. For example, if you have installed Qlik NPrinting 17.1 you must first upgrade it to 17.2 before upgrading to 17.3.
The following upgrade paths are supported:
| Current Qlik NPrinting version | Upgrade to |
|---|---|
| 17.2.0 | Qlik NPrinting 17.3.0 |
| 17.2.1 | Qlik NPrinting 17.3.0 |
| 17.2.2 | Qlik NPrinting 17.3.0 |
| 17.2.3 | Qlik NPrinting 17.3.0 |
| 17.3.0 | Qlik NPrinting 17.3.1 |
Upgrade paths from version 17.0 to 17.2
The following information applies if you are upgrading Qlik NPrinting to a version earlier than 17.3.
A Qlik NPrinting feature release must be upgraded to the next successive feature or service release. A Qlik NPrinting service release must be upgraded to the next successive service release. You cannot upgrade a service release directly to next major feature release. For example, from 17.0.1 you must upgrade to 17.0.2, then to 17.0.3, etc, without skipping any releases.
If the installed version is the final service release before a major feature release, you can upgrade it to the next feature release. For example, 17.0.5 is the final service release of the 17.0 series and you can upgrade it to 17.1.
You can not skip a major feature release. For example, you can not upgrade directly from 17.0.5 to 17.2. The previous feature release 17.1 must be installed before upgrading to 17.2.
Qlik NPrinting messaging service upgrade
Starting with Qlik NPrinting 17.2.1, the Qlik NPrinting Server upgrade removes RabbitMQ and replaces it with the Qlik NPrinting messaging service. It is not possible to keep RabbitMQ installed on the same computer as Qlik NPrinting Server 17.2.1 or later.
Repository database backups
The Qlik NPrinting upgrade process will attempt to close the Qlik NPrinting Windows services and stop the processes automatically. However, under some circumstances, not all services and processes are stopped successfully. If you attempt to upgrade Qlik NPrinting with the services and process still running, it can result in repository data being lost. Therefore, it is important to check that the services are stopped before proceeding with an upgrade, and close them manually if necessary.
The Qlik NPrinting upgrade process creates two backups of the repository :
- Backup before updating the repository.
The name is composed by concatenating a timestamp (YearMonthDayTime) with the fixed string _nprinting17.2.0.0_backup_old.zip (for example 201611180947162456_nprinting17.2.0.0_backup_old.zip).
- Backup after updating the repository.
The name is composed by concatenating a timestamp (YearMonthDayTime) with the fixed string _nprinting17.2.1.0_backup_new.zip (for example 201611180947162456_nprinting17.2.1.0_backup_new.zip).
Both backup files are stored in the folder %ProgramData%\NPrinting by default.
For example, if you are upgrading from Qlik NPrinting 17.2.0.0 to 17.2.1.0, Qlik NPrinting creates a backup 201611180947162456_nprinting17.2.0.0_backup_old.zip before making any changes to the repository database, and a backup 201611180947162456_nprinting17.2.1.0_backup_new.zip after upgrading the repository database. If, for any reason, you want to re-install Qlik NPrinting 17.2.0.0, you must restore the backup 201611180947162456_nprinting17.2.0.0_backup_old.zip.
We strongly recommend that you also manually create a backup before upgrading.