Skip to main content

Running the upgrade application

ON THIS PAGE

Running the upgrade application

To upgrade your deployment, you run the Qlik Sense installer on each node in your Qlik Sense deployment, starting with the central node.

Before you start the upgrade

You need to download the installer, verify the system requirements, and ensure your system is ready to upgrade.

  1. Check your system requirements.

  2. Download your installer and the release notes and save them locally on the node you are upgrading.

  3. Log into the central node server as an admin user with a password.

    Note: The admin user password cannot be blank. If the admin user does not have a password, create one before starting the upgrade.
  4. Verify that your Qlik Sense services are running with a service account, not a local account. To change the service account user, see Changing the user account to run Qlik Sense services.

  5. Get your Qlik Sense Repository Database superuser password, as this is needed during the upgrade. You created this password when you first installed Qlik Sense.

  6. Create a backup of the Qlik Sense deployment before upgrading.

  7. You can optionally remove the root certificate from the central node and all certificates from the rim nodes if you want the QPS to recreate them during the upgrade.

Tip: If you have any problems during or after the upgrade, refer to the Troubleshooting your upgrade topic to find solutions to common upgrade problems.

Upgrading a Qlik Sense node

For a multi-node upgrade, start with the central node. When finished, repeat these steps for each node in your site.

  1. From the Windows services app, stop the Qlik Sense services.

  2. Right-click the Qlik_Sense_setup.exe file that you saved locally and click Run as administrator.

    The installer checks to see if any applications that are running need to be closed before starting. Follow the instructions until the installer detects your system is ready for upgrading.

    Two screen for upgrade app

    Note: The installer also checks your root certificate. If it is unsupported, you must remove it before upgrading. Click the Remove button to remove unsupported certificates.
  3. Select Upgrade.

    Upgrade start window

  4. On the License Agreement window, read and accept the Qlik User License Agreement.

  5. On the Service Credentials page, enter the username and password for the Qlik Sense service account.

    Note: If the username is a member of a domain, enter the user name as <domain>/<username>.
  6. Enter the Qlik Sense Repository Database superuser password.

    Upgrade repo password window

  7. On the Ready to upgrade window, select the installer options.

    • In the Ready to upgrade section, select the relevant options.
    • In the Supported object bundles section, optionally install the object bundles. Then, select which object bundles you want to install from the list of those available for your Qlik Sense Enterprise on Windows installation.

      Note: If you are installing object bundles, read and accept the object bundles license agreement.
    • In the Help Us Improve section, select if you want to anonymously share system data with Qlik.

    • Click Next when you have selected your options, then click Upgrade.

  8. Click Finish.