This article outlines the configuration process for a Multi-Node Qlik Sense environment using the Vizlib Management Console (VMC).
TABLE OF CONTENTS
Before you start the configuration, make sure you've gone through the items on this checklist, completing each process and collecting each piece of information.
- Vizlib Server - You need to have Vizlib Server installed on the target server. You can find instructions on installing Vizlib Server in our article here.
- SSL Certificates - You'll need a separate set of SSL certificates (Figure 1) for each node, for an environment with 3 nodes, you should have 3 folders containing their SSL Certificates, each with a unique name. Exported SSL certificates can be found under the path.
/Qlik/Sense/Repository/Exported Certificates/.Local Certificates
Figure 1: SSL Certificates
- A username and password for the Vizlib Management Console (VMC).
- Port numbers and host URLs for the QlikSense Proxy Service (QPS) and the QlikSense Repository Server (QRS).
VMC Configuration - SSL Certificates
Store the folders with the SSL certificates on the target server where Vizlib Server is installed. Ideally they should be stored in the same directory as the local certificates.
Log into the VMC, then navigate to System Settings > Qlik Sense to open the configuration screen.
Enter the configuration for the central node (Figure 2). Select the Certificate Type, then add the paths for each certificate. Tip: Click on the icon to bring up instructions on exporting Qlik Sense certificates.
Figure 2: Central Node Configuration
Click Restart (upper right corner of the VMC screen) when the information has been added.
Check that a green tick is showing in the Qlik Sense panel on the dashboard (Figure 3), to show the configuration is correct.
Figure 3: Dashboard Example
- Repeat the process for each rim node in your environment. Start by Clicking on Add QS Node (Figure 4).
Figure 4: Add QS Node
Note on Adding QS Nodes: While each new node will have similar settings to the central node there are a couple of important differences.
- The URL paths of the certificates should be saved in a separate directory with a unique name. We recommend using the node name, see the example below for a node Rim01.
- The domain used for QPS and QRS settings should include the node name.
For each node you configure, should see a green tick on the dashboard.
Figure 5: QPS / QRS Successful Configuration
QMC Configuration - Virtual Proxies
Now, you can go to the Qlik Management Console (QMC) and edit the default virtual proxies. You can find these in the QMC under Configure System > Virtual Proxies. The example in Figure 6 shows 3 Default Virtual Proxies (Central Proxy, Rim_Node_01 Proxy and Rim_Node_02 Proxy) and 3 replicated Virtual Proxies (VizlibProxy, VizlibProxy 1, and VizlibProxy 2).
Remove the vizlib prefix from the first replicated proxy, for this example, it's VizlibProxy 1.
Add a different prefix to the corresponding Default Virtual Proxy, in this example it's Rim_Node 01 Proxy.
Repeat this process for each paired Virtual Proxy / Default Virtual Proxy.
Figure 6: QMC Virtual Proxies
Once you've completed this step, you should be able to navigate through Vizlib Teamwork and access any comments.
Note on Connection Errors: If you return a connection error (Figure 7), please clear cookies from your browser, and restart the Qlik Sense Hub.
Figure 7: Connection Error