Vizlib Home Try Vizlib

Vizlib Server Guides - Multi-Node Configuration (Enterprise) - QMC

If you're setting up a Qlik Sense multi-node environment to work with Vizlib Server you need to make configuration changes both the Vizlib Management Console (VMC) and the Qlik Management Console (QMC). This article contains instructions on configuring virtual proxies in the QMC. You can find instructions on the VMC configuration for a multi-node environment here and the Vizlib Server configuration reference here


The article uses an example the configuration of the Central node in a Qlik Sense multi-node environment which still has its default settings (no virtual proxies have been created).
The reason for configuring virtual proxies relates to sharing cookies with Vizlib Server. The Session Cookie Domain property in a default virtual proxy is read-only, but if it retains the read-only setting access to the system will be denied, locking out all users.  To resolve this, a new virtual proxy needs to be created which allows access via a change to the Session Cookie Domain


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. 

  • Check you have a QMC user account with permissions to add and change node settings.
  • Vizlib Server needs to have a DNS name equal to (or sharing) the same domain name as the Qlik Sense user environment. Note: We advise using a DNS name which is different to the host name. 
  • All ports used in the configuration architecture should be opened to the firewall and the network needs to be configured correctly. 
  • Create a naming system to group your virtual proxies clearly. 
  • Establish how many virtual proxies will be needed. You will need to complete the steps in this article for every default virtual proxy you use as part of your account e.g. if you have 4 default virtual proxies, you will need to create 4 more, for a total of 8. 
  • Confirm which default virtual proxy node needs to be linked to each new virtual proxy.
  • Check if virtual proxies are already set up and in use. If non-default virtual proxies are already created, you'll only need to change the session cookie domain to complete the configuration.
  • Note the configuration of each default virtual proxy as you will need to enter these settings for the new virtual proxy. 
  • Check which proxy link which needs to be added to the new virtual proxy e.g. if the default virtual proxy contains a proxy link to the Central node, the new virtual proxy must have the exact same link. 

Back to Contents

Example Configuration

Figure 1 shows the example configuration, with one Central node (Central) and two additional nodes (Rim_Node_01 and Rim_Node_02).

Figure 1: Initial Node Configuration

Back to Contents

Creating a Virtual Proxy

  • In the QMC, open the Virtual Proxies settings.
  • Click Create New to create the new virtual proxy (Figure 2), which will mirror the settings for the Central Node. 

Figure 2: Create New Virtual Proxy

Back to Contents

  • Select the Advanced properties from the menu on the right. 
  • Add the virtual proxy name in Description
  • Add the domain name you need to use in the Session Cookie Domain field (Figure 3). This setting will enable cookies to shared between the main domain and any subdomains.

Figure 3: Session Cookie Domain

Back to Contents

Prefix and Additional Settings

  • Add a Prefix for testing purposes (Figure 4). If the setup is successful, it can be removed. 

Figure 4: Prefix

  • Enter any additional settings to match the new virtual proxy configuration to the default virtual proxy configuration.

  • Open the Identification settings and change the Session cookie header name of your new virtual proxy (Figure 5). You need to enter a unique value here, as you can't link to the default virtual proxy with a name that's already being used and will return an error if you try.

Figure 5: Session Cookie Header Name

  • Click Apply to save your settings and create the new virtual proxy. 

Back to Contents

Linking to the Default Virtual Proxy

Once you've entered a unique Session cookie header name you can link the new virtual proxy to the relevant default virtual proxy. 

  • Click the virtual proxy Description to open edit mode.
  • Select Proxies from the Associated items settings.
  • Select Link at the bottom of the page (Figure 6) to open the Select proxy services menu.
  • Select the Node you want to link to from the list. 

Figure 6: Proxies

  • Check the properties for the default and new virtual proxies match , apart from the Session cookie domain, Prefix, and Cookies header name.
  • Change the Prefix in the default virtual proxy to default 
  • You can also remove the vizlib prefix from the new virtual proxy if it's no longer required. 

The new virtual proxy has now been created successfully. 

Back to Contents

Configuring the Remaining Nodes

To configure any remaining nodes, (Rim_Node1 and Rim_Node2 in this example) you can use this article by returning to Creating a Virtual Proxy and following the same steps for the other default virtual proxies. Figure 7 shows the completed configuration as it would appear in the QMC

Figure 7: Complete Configuration

The Vizlib Server Configuration article contains more information on post-install checks to ensure your installation has completed successfully. 

Back to Contents

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