Changing the user account to run Qlik Sense services

Before you install, change or upgrade your Qlik Sense installation, you must choose an administrator or non-administrator account to run the Qlik Sense services. For example your company policy may require you to run the Qlik Sense services as a user without administrator privileges.

Warning: If you want to upgrade from Qlik Sense 3.1 SR2 or later to Qlik Sense June 2017 you must use a service user account (local or domain) and not a Local System account to run the services. If you use a Local System account to upgrade, you will get an error.
See: Upgrading from Qlik Sense 3.1 SR2 or later to Qlik Sense June 2017 or later

Using an account without administrator privileges to run the Qlik Sense services during the installation of a node

To install a rim node in this way you need to run an additional bootstrap command from an elevated command prompt to register the rim node on the central node.

Note: If you are installing a central node you can follow the same procedure as a regular administrator installation.

To install a node:

  1. Log in to the computer where you plan to install Qlik Sense as an administrator.

    See: User accounts.

  2. Download the Qlik_Sense_setup.exe file from www.qlik.com
  3. On the Create or join a cluster screen, select Join cluster.
  4. On the Shared persistence database connections settings screen, ensure that you specify the correct hostname and password to the repository database that you want to connect to.
  5. See: Installing Qlik Sense

  6. On the Service Credentials screen, enter your non-administrator user account, user name, and password. For example, enter your user name as follows: .\senseserviceuser or domain\senseserviceuser.
  7. Note: If you enter a username that is more than 20 characters long, it must be in UPN format, and must include the full domain name. For example, longusername@full.domain.name.

On the final screen of the installation program, you do not have the option to start the Qlik Sense services, instead the following message is displayed: The service user does not have administrator privileges. See the documentation for more information.

Next, run the bootstrap command in an elevated command prompt while registering the rim node with a certificate.

To run the bootstrap command:

  1. On the rim node, open an elevated command prompt window. The bootstrap command elevates your rights enabling you to perform tasks that require an administrator, such as installing certificates and adding performance counters.

  2. In the command prompt, navigate to the installed location: Program Files\Qlik\Sense\Repository and run the Repository.exe -bootstrap command. The Qlik Sense Service Dispatcher must be running before the Repository.exe -bootstrap is executed. While the bootstrap is running, in the QMC on the central node, register the rim node with a certificate that is generated.
    For more information, in Services, see the Repository service.
  3. On the central node, register the rim node in the QMC, see: Adding a Qlik Sense node. After you have registered the rim node the bootstrap process will terminate.

  4. Exit the command prompt.
  5. In Windows, Services, start all Qlik Sense services. You must start the Qlik Sense Service Dispatcher (QSD) before starting the Qlik Sense Repository Service (QRS).

Changing the user account type to run the Qlik Sense services on an existing site

Follow the instructions in this section if you used an administrator user account when installing Qlik Sense, and later wish to change to use an account without administrator privileges to run the Qlik Sense services.

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
  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.

Did this information help you?

Thanks for letting us know. Is there anything you'd like to tell us about this topic?

Can you tell us why it did not help you and how we can improve it?