Installing Qlik Sense on a single node

A basic installation of Qlik Sense can be done by installing all of the Qlik Sense services on a single node. This kind of deployment works best in a single time zone, where reloads of data can be done during the night. To determine if a single-node installation is the right choice for you, see Planning your deployment.

For information about multi-node deployments of Qlik Sense, see Installing Qlik Sense in a multi-node site.

Before you install:

  • Check that your environment meets the system requirements.

    See: System requirements for Qlik Sense

  • Check that the required ports are available.

    See: Ports

  • Check that your browser is supported.

    See: Browser supportati

  • Prepare the user accounts required to run the Qlik Sense services.

    See:User accounts

  • Understand how Qlik Sense uses LEF for site licensing and user access allocation, and have your license key available.

    See:Licensing

Procedere come indicato di seguito:

  1. Log in to the computer where you plan to install Qlik Sense as a local Windows administrator.

    See: User accounts.

  2. Create a file share before you run the Qlik Sense setup. The file share is a shared folder that stores all the Qlik Sense application data.
    1. Create a new folder.
    2. Right click on the folder, and click Properties.
    3. On the Sharing tab, and click Share.
    4. Enter the names of Windows users that you want to share the folder with, and click Add.

      Share this folder with your Windows Qlik Sense administrator and your Windows Qlik Sense services user. For more information, see User accounts.

    5. In the Permission level column, select Read/Write, and click Share.
      Nota: Make note of the network path displayed on the confirmation screen. You will enter this information during the Qlik Sense setup. The network path will be in the following format: \\server-name\QlikShare
  3. Download the Qlik_Sense_setup.exe file from www.qlik.com, and launch the setup.
  4. Procedere come indicato di seguito:

    1. Accept the license agreement, and click Next.
    2. On the Create or join a cluster screen, click Create cluster.
    3. On the Host Name screen, enter the name of the computer that you are installing Qlik Sense on and click Next.
    4. On the Shared persistence database connections settings screen, select the Install local database check box if you want to install a local repository or leave the check box unchecked if you want to connect to an existing repository database.
    5. Installing and configuring PostgreSQL

      If you want to connect to an existing repository database, then enter the following values:

      Field nameValue
      Database host nameEnter the full URL to your repository database.
      Database port 4432
      Database user

      Enter the username that will be used to access the database.

      Avviso: Do not enter the username postgres.
      Database user passwordCreate your own database user password to access your repository database in the PostgreSQL database.

    6. On the Database configuration screen, click Next.

      There is no need to configure the database service to allow connections from other nodes in a single-node installation.

    7. On the Shared persistence storage screen, enter the path or URL to your file share, for example \\<domain>\QlikShare, and click Next. Your file share can either be a local folder or a remote folder.
    8. On the Centralized Logging screen, leave the Configure centralized logging check box selected if you want to set up centralized logging, or clear the check box if you want logs to be written to files. If you decide not to set up centralized logging at this time, you can set it up later by using the logging service utility; see Qlik Logging Service.

    9. If you want to write logs to a new database that is installed with Qlik Sense, click New logging database. Enter the following values and click Next.

      Field name Value
      Log writer password Create a password for the qlogs_writer user to access the centralized PostgreSQL database.
      Log reader password

      Create a password for the qlogs_reader user to access the centralized PostgreSQL database.

      If you want to write logs to an existing database on the same node that you are installing Qlik Sense on or on another node, click Standalone logging database. Enter the following values and click Next.

      Field name Value
      Hostname Enter the host name or IP of the centralized PostgreSQL database.
      Port

      4432

      Log writer password

      Enter the password for the qlogs_writer user to access the centralized PostgreSQL database.

      Log reader password Enter the password for the qlogs_reader user to access the centralized PostgreSQL database.

      If you use a logging database on another node, ensure that this is a new and empty logging database before proceeding with the installation. If a QLogs db is already present on the remote database the schemas may be incompatible.
      See: Installing and configuring PostgreSQL

    10. On the Installation location screen, choose your own installation location or install Qlik Sense to the default location on the C:\ drive, and click Next.
    11. On the Repository Database Superuser Password screen, enter a password for the PostgreSQL repository database superuser. Confirm the password and click Next.

      See, User accounts.

    12. On the Service Credentials screen, enter the domain, user name and password for the account that you want use to run the Qlik Sense services, and click Next.

      Nota: 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.
    13. On the Ready to install screen, optionally select to create desktop shortcuts and automatic start of the Qlik Sense services when the setup is complete.
    14. Nota: If you selected local system as the user account type in the Service Credentials screen, but want to use a dedicated service account to run the Qlik Sense services, clear the Start the Qlik Sense services when the setup is complete selection.

    15. In the Extension bundles section, optionally select to install the extension bundles. Then, select which extension bundles you want to install from the list of those available for your Qlik Sense installation.
    16. You can always add or remove extension bundles from your Qlik Sense installation at a later moment. See: Modifying extension bundles installation

    17. If you have chosen not to install the extension bundles, click Install. Otherwise, click Next.
    18. If you are installing any of the extension bundles, accept the extension bundle license agreement. Then, click Install.
  5. You will see a message indicating that Qlik Sense has been installed successfully.
  6. Click Finish.

  7. If you selected local system as the user account type in the Service Credentials screen, but wish to use a dedicated service account to run the Qlik Sense services change the user account type and manually start the Qlik Sense services now. See Changing the user account to run Qlik Sense services

You are ready to license your Qlik Sense installation.

Licensing Qlik Sense

Before you can start using Qlik Sense you must activate your site license.

Procedere come indicato di seguito:

  1. Open the QMC.

    When you open the QMC for the first time the Site license properties screen is displayed.

  2. Enter the license information from the License Enabling File (LEF).

    The property group Site license contains properties related to the license for the Qlik Sense system. All fields are mandatory and must not be empty.

    Nota: If you want to set up Qlik Cloud Services or Qlik Sense Enterprise for elastic deployments, please contact your Qlik representative or Qlik Support to obtain a valid license for the setup.
    Property nameDescription
    Owner nameThe user name of the Qlik Sense product owner.
    Owner organizationThe name of the organization that the Qlik Sense product owner is a member of.
    Serial numberThe serial number assigned to the Qlik Sense software.
    Control numberThe control number assigned to the Qlik Sense software.
  3. Expand LEF access and click Get LEF and preview the license. If you received your LEF via email, you can copy and paste the information into the text field.
  4. Nota: Failed to get LEF from server is displayed if the serial number or control number is incorrect.
  5. Click Apply.

    Successfully licensed is displayed.

  6. Click Close.

You have activated your Qlik Sense site license.

You are ready to connect to a user directory (optional), allocate user access or professional access, and set up permissions.

Allocating user access or professional access

Your license is either user-based, with professional access allocation as an option, or token-based, with user access allocation as an option.

User-based license

Your Qlik Sense license includes a number of professional access allocations that are used to grant users in your organization access to Qlik Sense.

Procedere come indicato di seguito:

  1. In the QMC, from the Start menu, click License management.

    The License usage summary screen is displayed.

  2. Click the Professional access allocations tab.
  3. Click the + Allocate button.

    The Users screen is displayed.

  4. Select the users that you want to provide access to from the list and click Allocate.
    Nota: Allocate is disabled if the number of available allocations is insufficient for the number of selected users.

The users that you allocated access to appear in the Professional access allocations overview table.

Token-based license

Your Qlik Sense license includes a number of tokens that are used to allocate Qlik Sense access to users in your organization.

Procedere come indicato di seguito:

  1. In the QMC, from the Start menu, click License management.

    The License usage summary screen is displayed.

  2. Click the User access allocations tab.
  3. Click the + Allocate button.

    The Users screen is displayed.

  4. Select the users that you want to provide access to from the list and click Allocate.
    Nota: Allocate is disabled if the number of tokens available for allocation is insufficient for the number of selected users.

The users that you allocated access to appear in the User access allocations overview table.

Additional configuration

After you install Qlik Sense, you may wan to:

  • Create load balancing rules in the QMC to improve resilience and performance in a multi-node site. For more information, see Load balancing.
  • Configure the virtual proxy advanced settings to add your own hosts names to the white list. For more information, see Host white list.
  • Configure the user directory connector to retrieve users from a user directory. For more information, see User imports (UDC).

You are now ready to start using Qlik Sense. See: Get started.

Modifying extension bundles installation

You can add or remove extension bundles from your Qlik Sense deployment at any moment. If you have a multi-node installation, extension bundles are installed on the central node.

Suggerimento: You can see which extensions are installed in your deployment by checking the Extensions section in the Qlik Management Console (QMC).

Procedere come indicato di seguito:

  1. In Control Panel, open Programs and Features.
  2. In the list of programs, double-click the extension bundle that you want to modify.
  3. The Extension Bundle Setup Wizard opens. Click Next.
  4. Select Change.
  5. On the Custom setup screen, click on the bundle icon to select how to modify the bundle installation:
    • If the bundle is installed, select Entire feature will be unavailable to uninstall it.
    • If the bundle is not installed, select Entire feature will be installed on local hard drive to install it.

    Then, click Next.

  6. Click Change.
  7. When the setup modification is complete, a message invites you to manually restart the Qlik Sense Repository Service.
  8. Click Finish to close the Extension Bundle Setup Wizard.
  9. Manually restart the Qlik Sense Repository Service to make the changes effective.

You can verify that the changes have been correctly applied by checking the Extensions section in the QMC.