Vizlib Community

Submit a ticket Sign in
Welcome
Login

Vizlib Collaboration - Prerequisites Vizlib Server (Enterprise only)

Prerequisites for the Vizlib Server

Before you begin the installation of Vizlib Server, please review the prerequisites below and verify that the points are fulfilled for the target environment. 



Installation on a Qlik Sense Node

  • Target server needs to be x64 Windows Server Machine (2016, 2012 R2 & R1, 2008 R2)

  • Recommended server is the Central QS node

  • Ports 1980 and 1982 (postgres db) need to be unused on target server

  • Port 1980 needs to be open (in firewall) for communication from where the end users connect to the server

  • Qlik Sense (QMC) needs to be set up with SSL browser certificate thumbprint

    • The certificate used in Qlik Sense needs to be stored on a drive accessible to the server in PFX file format. If the PFX file is protected with a password the password needs to be available during installation

    • Read more about Certificates here

  • Account with administrative privileges

  • Permission to write to C drive

  • Multi Node environments need to have the Virtual Proxy setup according to Virtual proxy and Session Cookie Domain

  • PM2 can not be used by another process on the server


Installation on a dedicated stand-alone server

  • Target server needs to be x64 Windows Server Machine (2016, 2012 R2 & R1, 2008 R2)

  • Ports 443 and 1982 (postgres db) needs to be unused on target server

  • Certificate issued for DNS to be used by the Vizlib Server

    • Needs to share the domain or be a subdomain of the DNS used by the clients to connect to Qlik Sense. E.g. vizlibserver.YOURDOMAIN.com

    • Read more about Certificates here

  • Virtual Proxy setup according to Virtual proxy and Session Cookie Domain

  • Account with administrative privileges

  • Permission to write to C drive

  • PM2 can not be used by another process on the server


Virtual Proxy and Session Cookie Domain

Vizlib Server uses the Qlik Sense Session to validate the authenticated user with the Qlik Proxy Service. By default the session cookie is valid only for the machine that the proxy is installed on.

If Vizlib Server is installed on the Central QS Node in a Single node environment, then the cookies will be shared between Qlik Sense and Vizlib Server with default Virtual Proxy configuration, because they will share the fully qualified domain name (FQDN). 

If Vizlib Server is installed on a stand-alone server the default Virtual Proxy will not be able to share cookies with Vizlib Server. Make sure that these criteria are fulfilled if you use a stand-alone server for Vizlib Server:

  • User should connect to Qlik Sense with a Virtual Proxy that is not the default

       

  • Dedicated server FQDN is on the same domain or subdomain that the Virtual Proxy Qlik Sense uses

  • Virtual Proxy property Session cookie domain needs to be set to the same domain in the URL that the users use to connect to Qlik Sense. E.g. YOURDOMAIN.com if the user uses qliksense.YOURDOMAIN.com and Vizlib Server is installed on machine vizlibserver.YOURDOMAIN.com.

       

 


Certificates

Certificates are used to SSL encrypt the communication with Vizlib Server. Use a certificate issued by a third party certificate authority, or from your own CA server (ask an IT technician at your company for help, they know what to do). Here are links to some recommended third party certificate authorities that sell certificates


Supported certificate files are:

  • PFX, without or with password

  • PEM


Workaround without third party certificates

If you don’t want to use or don’t have access to a proper certificate, choose one of these options:

 

Allow HTTP in the Qlik Sense Proxy and HTTPS disabled in Vizlib Server

Users need to connect over HTTP protocol e.g. http://qliksense.YOURDOMAIN.com/hub


NOTE! This is not recommended in production because the communication will be unencrypted between Qlik Sense and the user. Only use in test environments or with non-sensitive data. 


HTTPS disabled in Vizlib Server Management Console

 

Use exported certificates from Qlik Sense Node

This option will only work when Vizlib Server is installed on a Qlik Sense Node server. User will only be able to use Vizlib Collaboration if they RDP to the server to establish a secure connection in the browser. The exported PEM files are located at: C:\ProgramData\Qlik\Sense\Repository\Exported Certificate


Vizlib Server configured with Qlik Sense exported certificates



M
Michael is the author of this solution article.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.