Planning your upgrade
A successful upgrade requires some planning. Before you can upgrade, you must know your upgrade path, that is, you need to know which version you currently have and which version you want to upgrade to. You also need to collect other information about your deployment, the details of which are covered in this guide.
Planning your upgrade path
Not all versions have a direct upgrade path to the latest or newer version of Qlik Sense Enterprise. It is good practice to use the release notes as a guide to determine when major changes between versions are introduced. You might be required to upgrade to an intermediate version to pick up dependencies before upgrading to your desired version of Qlik Sense Enterprise.
Considerations about older versions
Some Qlik Sense Enterprise versions introduced significant changes. The table below lists major changes you should consider when upgrading. This list will help you decide which intermediate version you might need to upgrade to before upgrading to later versions.
Versions | Considerations |
---|---|
Qlik Sense 3.1 SR1 and earlier | Must upgrade to June 2017 before upgrading to later versions. |
Qlik Sense June 2017 and later | Support only the shared persistence model. |
Qlik Sense September 2017 and later | Does not support configuring centralized logging through the installer. |
Qlik Sense November 2017 and later | Does not support soft delete records. |
Qlik Sense February 2020 and later | Changed NodeJS version. Must re-create certificates generated with versions June 2019 and earlier. |
Qlik Sense February 2021 and later | Support only .NET framework 4.8 or higher. Must upgrade to November 2020 first. This version also requires Visual C++ 2019 distributable package. |
Qlik Sense February 2022 and later | Does not support centralized logging. |
Qlik Sense August 2022 and later |
PostgreSQL 9.6 is not supported when upgrading. However, if you have PostgreSQL 9.6 installed locally when you upgrade Qlik Sense, it will still be used after the upgrade, even if it is no longer supported. The easiest way to upgrade to PostgreSQL 12.5 is to use the Qlik PostgreSQL Installer, which upgrades the database from 9.6 to 12.5 – if the database has been installed by Qlik Sense. Other versions of PostgreSQL need to be installed manually. If you have PostgreSQL 12.5 installed locally when you upgrade Qlik Sense, the database will still be used after an upgrade. For other versions of the database, the installed version will continue to be used after an upgrade. |
Considerations about multi-node deployments
A single note site is simpler to upgrade than a multi-node site. If you have more than one node in a site, you must upgrade each node separately.
-
Each node in a multi-node site must run the same version of Qlik Sense.
-
You should upgrade the central node first.
-
All nodes should be offline when you upgrade.
-
Use the same login account for the upgrade as you did with the original installation. If you use a different login account, the node will not find the certificates on the node.
Considerations about logging
As of Qlik Sense February 2022, centralized logging is no longer supported. See Logging for general information and log locations.
Considerations about custom configurations
If your current deployment includes custom configuration files, they are retained during the upgrade process. The option Keep current service settings is selected by default in the Ready to upgrade dialog. Clear the selection if you don't want to retain the custom configuration files.
The following files are by default retained during an upgrade:
-
%ProgramFiles%\Qlik\Sense\Repository\Repository.exe.config
-
%ProgramFiles%\Qlik\Sense\Proxy\Proxy.exe.config
-
%ProgramFiles%\Qlik\Sense\Scheduler\Scheduler.exe.config
-
%ProgramFiles%\Qlik\Sense\ServiceDispatcher\services.conf
Consideration about your Qlik Sense Repository Database
In earlier versions of Qlik Sense, the Qlik Sense Repository Database used PostgreSQL version 9.6, which no longer is supported. Starting at Qlik Sense Enterprise on Windows May 2021, the bundled PostgreSQL has been upgraded to version 12.5. However, PostgreSQL 12.5 will only be deployed during a fresh installation of Qlik Sense Enterprise on Windows May 2021 and above. If you are upgrading Qlik Sense Enterprise on Windows from an earlier version that uses PostgreSQL version 9.6, the version will remain on 9.6, even if it is no longer supported.
The easiest way to upgrade to PostgreSQL 12.5 is to use the Qlik PostgreSQL Installer, which upgrades the database from 9.6 to 12.5 – if the database has been installed by Qlik Sense. Other versions of PostgreSQL need to be installed manually. For information about upgrading PostgreSQL, see: Qlik Sense May 2021 - Upgrade bundled PostgreSQL to 12.5 version and Upgrading Qlik Sense Repository Database from PostgreSQL 9.6 to 12.5 - New tool available.
If you have PostgreSQL 12.5 installed locally when you upgrade Qlik Sense, the database will still be used after an upgrade. For other versions of the database, the installed version will continue to be used after an upgrade. All your data and settings are migrated to the new version. However, if you have custom configurations for your PostgreSQL installation they must be recreated after the upgrade.
Here are some other important things to note regarding your Qlik Sense Repository Database upgrade:
-
The version of PostgreSQL that is included in the Qlik Sense June 2017 or later does not include pgAdmin tools. For information about manually installing the PostgreSQL database, see Installing and configuring PostgreSQL.
-
The Qlik Sense installer cannot use SSL encryption for establishing a connection to PostgreSQL. When SSL encryption is enabled, the installer does not recognize any already installed PostgreSQL databases, as a result, the installation cannot be completed. You should temporarily disable SSL during installation or upgrade.