Multi-Node Configuration (Enterprise) - VMC

Setting up a Qlik Sense multi-node environment to work with Vizlib Server requires configuration changes to both the Vizlib Management Console (VMC) and the Qlik Management Console (QMC).

This article contains instructions to configure virtual proxies in the VMC. Instructions for the next steps are:

This topic contains the following sections:

Pre Configuration Checklist

Before starting the configuration, ensure you've gone through the items on this checklist.

1. Vizlib Server Installed

Vizlib Server (Enterprise) must be installed on the target server.

2. Vizlib Management Console (VMC) credentials

Credentials required include the username and password for the Vizlib Management Console (VMC) of the Vizlib Server you want to use or a user account with Root Admin access. Read more about VMC user roles or view the VMC role matrix to view the permission options in a table.

3. Qlik Sense Node Certificates

Each node needs a separate Qlik Sense certificate (Figure 1). are required. Details of exported certificates are under the path on each node server.

C:\ProgramData\Qlik\Sense\Repository\Exported Certificates\.Local Certificates

Copy the node certificates for each node and store them on the Vizlib Server disk drive. We recommend creating a folder for each node with the node's name as the folder name.

Figure 1:  Qlik Sense Node Certificates

4. Qlik Sense Node network information

Port numbers and host URLs for the QlikSense Proxy Service (QPS) and the QlikSense Repository Server (QRS) for each node.

Note: Your Node Host URL and the port number used by the QRS, QPS, QES, and QPS RestAPI Services is by default 4242, 443, 4747, and 4243.

Figure 2:  Qlik node host port defaults

VMC Configuration

Note: While each new node will have similar settings to the central node, there are some important differences.

  • Save the URL paths of the certificates in a separate directory with a unique name. We recommend using the node name. The example below is for a node named Rim01.

/Qlik/Sense/Repository/Exported  Certificates/Rim01_Cert/client_key.pem

  • The domain used for QPS and QRS settings should include the node name.

Rim01.yourdomain.com

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

    Note: Click the question mark icon to show instructions on exporting Qlik Sense certificates.

Figure 3:  Central Node Configuration

  • Add the information, and click Restart (upper right corner of the VMC screen). You must restart Vizlib Server after you add a Virtual Proxy to save the updated settings.

  • Check that a green tick is showing in the Qlik Sense panel on the dashboard (Figure 4) to show the configuration is correct.

Figure 4:  Dashboard Example

  • Repeat the process for each rim node in your environment. Start by clicking on Add QS Node (Figure 5).

Figure 5:  Add QS Node

For each node you configure, a green check mark displays on the dashboard (Figure 6).

Figure 6:  QPS / QRS Successful Configuration

App Reloads On Rim Nodes

With versions prior to 4.11.1, Vizlib Server made writeback-related communication with Qlik's central node. This worked well for many cases. However, in some configurations you may have rim nodes that ensure better performance for app reloads. In this case, you can configure Vizlib Server in such a way that the software executes app reloads on a different node than Qlik’s central node. This feature applies to the following:

  • Multi-node Qlik environments
  • Vizlib Server v4.11.1 and above
  • Vizlib Writeback Table v4.11.1 and above

To enable such configuration, the following fields are available:

  • The Computer Name field in Vizlib Management Console (VMC) > System Settings > Qlik Sense.
  • The Custom Computer Name field in Vizlib Writeback Table > Destination after you set the destination to Vizlib Server.

For the feature to work, you need to fill in the Computer Name field in VMC and Custom Computer Name in Vizlib Writeback Table app with the same value.

Figure 7:  Computer Name field

If you want Vizlib Server to perform app reloads on Qlik Central Node, leave the Computer Name fields empty.

Next Steps - QMC Configuration

Next complete the configuration for a Multi-Node Qlik Sense Environment, by configuring virtual proxies using the Qlik Management Console (QMC).