Installing QlikView Server

This documentation outlines the steps you need to follow to install and license QlikView Server. For a description of how to install QlikView Desktop, see: Installing QlikView Desktop.

Before Installing QlikView Server

Before installing QlikView Server, you need to consider:

  • If Microsoft IIS is to be used as web server, it must be installed prior to QlikView Server.
  • It is not possible to install QlikView Server to a server that acts as a domain controller.
  • Internet protocol IPv4 or IPv6 is required for installation of QlikView Server.
  • When installing QlikView Server/Publisher, several security groups are created. Several other security groups must be created following the installation. These must be properly configured to ensure that the appropriate services can run, and to ensure that users can access the appropriate functionality. Before you begin the installation, see Security Groups in QlikView Publisher Repository.
  • It is recommended not to move folder locations after the QlikView Server installation is complete, since many settings depend on the initial file locations. If the location of QlikView Server has to be changed after the installation, uninstall QlikView Server and then reinstall.
  • Any previously defined tasks are deleted when the QlikView Publisher license is activated.

Setup Procedure

  1. Run the QlikView Server installation executable:
    • Microsoft Windows x64 version: QlikViewServer_x64Setup.exe
  2. If the User Account Control dialog is displayed, click Yes to allow the program to make changes on this computer.
  3. Click Next in the Welcome dialog.
  4. Select the region for the location of the server. Click Next to continue.
  5. Read the license agreement, select I accept the terms in the license agreement, and click Next to continue.
  6. Enter the customer information for QlikView Server. Click Next to continue.
  7. All files are installed in the specified folder. To change the root folder for the installed files, click Change to specify the preferred location. Finally, click Next to continue.
  8. Select the type of installation you want to perform:
    • Full installation, Single machine with QlikView Webserver: Used to run all components on a single machine with QlikView Web Server as web server.
    • Full installation, Single machine with Microsoft IIS: Used to run all components on a single machine with Microsoft IIS as web server. This option is only available if IIS is installed on the target machine.
    • Custom installation, select profiles: If this option is selected you select the profiles you want to be included in the installation from the Profiles section in the dialog:
      • QlikView Server: Installs QlikView Server, Directory Service Connector, and the QlikView Server example documents.
      • Reload/ Distribute Engine: Installs the Reload Engine and the QlikView Distribution Service.
      • Management Console: Installs the QlikView Management Service together with the QlikView Management Console (QMC).
      • Webserver: Installs the QlikView Web Server.

    To make further configuration of features to be installed, click Config. When done, click Next.

    To use pre-defined configuration of features, click Next.

  9. Set the account that the QlikView Server and Publisher services are to run under. Click Next to continue.

    Note: The account that is used to run the QlikView services must have local administrator privileges.

    You can also select I want to specify the account to be used for the services later.

  10. Select the IIS Website from the drop-down list and click Next.

    Note: This step is only applicable if Full installation, Single machine with Microsoft IIS was selected in Step 8. If not, proceed directly to the next step.
  11. Select the Service Authentication method:
    • Use digital certificates: Authenticate communication between QlikView servers using digital certificates and SSL. This alternative is recommended in environments where not all servers have access to a common Windows Active Directory or when the security provided by certificate authentication is required. Note that digital certificates are only supported by Windows Server 2008 R2 and later.
    • Use QlikView Administrators Group: Authenticate communication between QlikView services based on membership in the local Windows group QlikViewAdministrators. This alternative can be used in environments where all servers that are part of the QlikView installation can authenticate using a common Windows Active Directory.

    Click Next to continue.

  12. Click Install to start the installation.

    Note: This may take several minutes to complete.
  13. Click Finish when the installation is complete.

  14. Log off from Windows® and then log on again, so that group memberships added during the installation are updated.

    Note: It may be sufficient to log off from Windows and then log on again. However, it is recommended to restart the machine to enable the QlikView Server functionality.

Logging the Installation

The setup procedure is logged when running the QlikView Server installation executable. The log files are as follows:

  • Microsoft Windows x64 version: QlikViewServerx64.wil

The log files are stored in the Temp folder of the user (for example, %UserProfile%\AppData\Local\Temp). Each time an installation is executed, a new file is generated, over-writing the previous log file.

Obtaining the MSI package

If the MSI package is needed for the installation, proceed as follows to extract it from the .exe file:

  1. Start the installation from the .exe file and wait until the first dialog opens.
  2. Locate the MSI file (often stored with a random name, for example, ed34g.msi) in the Temp folder in %UserProfile%\AppData\Local.
  3. Copy the .msi file to another location.
  4. Exit the .exe installation.
  5. Install QlikView Server using the .msi file.
  6. Silent Installation

    Deploying MSI Packages with Group Policies.

Completing the Installation

After successfully installing QlikView Server, a license must be registered in QlikView Management Console (QMC) to activate the installed software.

Note: If access is denied when starting QMC, log off from Windows and then log on again, so that group memberships added during the installation are updated.
Note: Running real-time anti-virus protection on the server degrades the performance of QlikView Server. It is recommended that the user documents, source documents, log directories, and .pgo files are excluded from the anti-virus scanning.

Running Microsoft IIS

Handling Timeouts

Note: This is only needed when using very large QlikView documents that return timeouts.

Proceed as follows to handle timeouts:

  1. Open the %ProgramFiles%\QlikView\Server\QlikViewClients\QlikViewAjax\web.config file in a text editor (for example, Notepad).
  2. Search for the following text:
  3. <httpRuntime requestValidationMode="2.0" />

  4. Edit the text so that it becomes:
  5. <httpRuntime requestValidationMode="2.0" executionTimeout="900"/>

  6. Save the file.

Enabling ASP.NET

If Microsoft IIS is used as web server, enable ASP.NET to ensure proper operation of the QlikView Server sample pages and the extended functions (for example, QlikView Server tunnel).

Optimizing the Performance

To optimize the performance when running Microsoft IIS and AJAX, turn on compression in the web server.

For information on how to configure IIS http compression:

Licensing

The licensing is used to authenticate QlikView Server and allow it to run on a specific machine.

Proceed as follows to enter the license for QlikView Server:

  1. Go to System>Licenses in the QMC.
  2. Select a QlikView Server or Publisher.
  3. Fill in the Serial number and Control fields on the QlikView Server License or QlikView Publisher License tab (depending on whether QlikView Server or Publisher was chosen).
  4. Note: Any previously defined tasks are deleted when the QlikView Publisher license is activated.

    QlikView Server/Publisher License tab in QMC

The license is checked every time a document is opened. If the time limit specified by the License Enabler File (LEF) is reached, the QVS automatically enters offline mode, which means that it is reachable from the QMC, but not operational.

The License Enabler File (LEF), lef.txt, for QlikView Server is automatically saved in %ProgramData%\QlikTech.

The PubLef.txt file for QlikView Publisher is saved in %ProgramData%\QlikTech\ManagementService\Publisher LEF.

Click Update License from Server to download a new lef.txt file from the QlikView LEF server. This is primarily used when updating the number of Client Access Licenses (CALs).

If the LEF information cannot be accessed through the Internet, it can be obtained from the local vendor. In that case, copy the entire lef.txt file to the location mentioned above, or paste the LEF data using the corresponding field on the QlikView Server/Publisher License tab in QMC. Contact the local vendor for specific instructions.

Did this information help you?

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