Skip to main content

Upgrading from Qlik Sense 3.1 SR2 or later to Qlik Sense June 2017 or later

Before you upgrade, if your Qlik Sense 3.1 SR2 or later installation is running services using a Local System account, you need to change this to use a service user account (local or domain) before upgrading to Qlik Sense June 2017 or later. If you continue to use a Local System account to run the services when upgrading you will get an error.

Changing the user account type to run the Qlik Sense services on a central node

Do the following:

  1. In Windows, either create a new or use an existing domain or local user account to run the Qlik Sense services.
  2. If the service account user does not have administrator privileges, you must add the user to the following groups in Computer Management > System Tools > Local Users and Groups > Groups.

    • Qlik Sense Service Users

    • Performance Monitor Users

    The service account user also needs access to shared folders.

  3. Open the Control Panel and then select System and Security>Administrative Tools>Services.
  4. Stop all services except the Repository Database.
  5. Assign Full control permission for the dedicated service account to the folder %ProgramData%\Qlik\Sense.
  6. As an administrator, open an elevated command prompt.
  7. Navigate to the Program Files\Qlik\Sense\Proxy folder and run Proxy.exe -bootstrap.

    Qlik Sense proxy service

  8. Navigate to the Program Files\Qlik\Sense\Scheduler folder and run Scheduler.exe -bootstrap.

    Qlik Sense scheduler service

  9. Navigate to the Program Files\Qlik\Sense\Repository folder and run Repository.exe -bootstrap.

    If you are changing the user account on your primary or central node, run Repository.exe -bootstrap -iscentral. The Qlik Sense Service Dispatcher must be running before the Repository.exe -bootstrap is executed.

    Qlik Sense repository service

  10. Close the elevated command prompt.
  11. Change the log on credentials for each of the Qlik Sense services as follows:
    1. Right-click the service and select Properties.
    2. Select the Log On tab and then This account.
    3. Enter the credentials for the dedicated service account and click OK.

    Services

    Note: If you are using a user account with administrative privileges, keep the Qlik Sense Repository Database running under the Local System account. Do not change the account.
    Note: Depending on your setup some of the services may not be available.
  12. Start the Qlik Sense Service Dispatcher, and then the Qlik Sense Repository Service (QRS).
  13. Start the rest of the Qlik Sense services.

For additional support on changing the Qlik Sense Service account or troubleshooting installation issues, see Changing the Qlik Sense Service Account and what to consider and Interactive Logon Rights for Qlik Sense installation.

Upgrading from Qlik Sense 3.1 SR2 or later with a shared persistence model to Qlik Sense June 2017 or later

Do the following:

  1. Stop your Qlik Sense services on all nodes in the deployment.
  2. Upgrade your central node by launching the Qlik Sense setup file (Qlik_Sense_setup.exe) as an administrator.
  3. If an unsupported Qlik Sense root certificate is detected on the central node, the root certificate must be removed as part of the upgrade. You cannot proceed with the upgrade if you do not select to remove the root certificate.

    Select Remove certificate(s) and click Next.

    Warning: Selecting Remove certificate(s) and clicking Next will delete the Qlik Sense root certificate from this node. The certificate is automatically recreated after the upgrade.

    Make sure that you have backed up your Qlik Sense deployment before you continue

  4. Select Upgrade to upgrade your existing shared persistence deployment.
  5. Accept the license agreement and click Next.
  6. On the Service Credentials page, enter the Username and Password for your Windows Qlik Sense service user account.

    If the user is member of a domain, enter the service account as <domain>\<username>. For more information, see User accounts.

  7. On the Ready to upgrade page, select the appropriate check boxes if you want the setup to create desktop shortcuts and automatically start the Qlik Sense services when the setup is complete, and click Upgrade.
  8. Check that all of the Qlik Sense services have started successfully.
  9. Upgrade the remaining nodes by following the applicable steps above for all nodes in the Qlik Sense cluster.

    If an unsupported Qlik Sense root certificate is detected on non-central node, all Qlik Sense certificates must be removed as part of the upgrade.

    Warning: Selecting Remove certificate(s) and clicking Next will delete all Qlik Sense certificates from this node. The certificates must be manually redistributed as described in the next step.

    Make sure that you have already upgraded the Central node.

  10. If you removed the Qlik Sense certificates as described in the previous step, perform one of the following two steps depending on your setup.

    • Account running the Qlik Sense services has administrator privileges:

      1. Open the Qlik Management Console (QMC) and redistribute the certificates according to Redistributing a certificate.

      2. Restart all the services on the node and make sure they are using the newly distributed certificates.
    • Account running the Qlik Sense service does not have administrator privileges:

      1. In the command prompt, navigate to the install location, for example Program Files\Qlik\Sense\Repository, and run Repository.exe -bootstrap.
      2. When the Waiting for certificates to be installed.. message is displayed, redistribute the certificates according to Redistributing a certificate.
      3. Once the bootstrap mode has terminated, start the Qlik Sense Service Dispatcher, then start the Qlik Sense Repository Service (QRS), and finally the remaining Qlik Sense services.
  11. Note: Any custom manual configurations that you make to the PostgreSQL database must be manually reproduced after the upgrade.