Installing a Qlik Replicate Endpoint Server on a Windows Cluster

[SwathiPulagam]

The currently published User's Guide for installing Qlik Replicate is incomplete. Below is a more complete installation guide for a Qlik Replicate 2021.5 and 2021.11 installation.

Documentation reference: Step 1: Install Qlik Replicate in the cluster

 

Environment:

Qlik Replicate 2021.5 and 2021.11

Make sure the Windows Cluster is already configured and the role is set up with a cluster disk (this is used for the Qlik Replicate data folder).

Step 1: Install Qlik Replicate in the cluster

2. Run the Qlik Replicate setup wizard on the first node that is part of your cluster. Install Qlik Replicate program to a local folder. The default is:
   
   C:\Program Files\Attunity\Replicate
   
   In the setup wizard, specify a shared storage location for the "data" folder; for example:
   
   F:\Program Files\Attunity\Replicate\data
   
   For more information, see Setting up Qlik Replicate on Windows (page 36 in the user guide).
   
   
3. Once the installation is complete on the first Node, stop the Attunity Replicate Server and Qlik UI server services from Windows service on the first node.
4. Open a command prompt as an administrator and change the working directory to the Replicate bin directory. Then run the following two commands, where Command 1 should only be run on the first
   
   

   On the Cluster node:

   Where: replicate_data_folder is the shared storage location of the Replicate data folder defined earlier (e.g. F:\Program Files\Attunity\Replicate\data), new_master_key is the new master key, and new_master_user_key is the new master user key.
   
   Command 1:
   

   repctl -d "replicate_data_folder" setmasterkey new_master_key master_key_scope=1

   
   Run Command 2:
   

   RepUiCtl -d "replicate_data_folder" masterukey set -p new_master_user_key

   
   Example:
   

   C:\Program Files\~\replicate\bin>repctl -d "F:\Program Files\Attunity\Replicate\data" setmasterkey new_master_key master_key_scope=1

5. Now, from Windows Cluster Manager, move your cluster to the next cluster node and install Qlik Replicate as described in Steps 1-2
6. Open a command prompt as an administrator and change the working directory to the Replicate bin directory. Then run:
   
   Command 2:
   

   C:\Program Files\~\replicate\bin>RepUiCtl -d "F:\Program Files\Attunity\Replicate\data" masterukey set -p new_master_user_key​

7. After Replicate is installed on all nodes, edit the ServiceConfiguration.xml file in the "data" folder : example  "F:\Program Files\Attunity\Replicate\data" and change the Https:// and Http:// entries to use the Cluster Client Access Point name (Server Name) or the Cluster IP address.

Step 2: Add the Qlik Replicate services (same as user guide)

Step 2: Add the Qlik Replicate services

Step 3: Define the dependencies for each service (same as user guide)

Step 3: Define the dependencies for each service

Once you login to the Replicate console and register your license, you’re going to have a message error about endpoint server. Proceed to Step 4.

Step 4: Correct the Endpoint Server issue.

Starting with the last node on which you installed Qlik Replicate.

1.   From Cluster Manager, task the Attunity Replicate Server Service offline and Qlik UI server offline.
2.   Rename the folder F:\Program Files\Attunity\Replicate\data\endpoint_srv\data to data_old
3.  Open a command prompt as an administrator and change the working directory to the Replicate endpoint_srv bin directory.
   
   Then run:
   
   Command 3:
   

   C:\Program Files\~\endpoint_srv\bin>rependctl -d "F:\Program Files\Attunity\Replicate\data\endpoint_srv\data" masterukey set

   *Notes that you can copy and paste in the new_master_user_key, from notepad / tool / edit / paste*
   
   It does not show the pasted new_master_user_key ,but just hit enter.
   
   And should get a message:
   
   The master user password has been changed. The change will only take effect after the service is restarted.
   Status: 0 - Master user key successfully set
   
   
4. From Cluster Manager, move the cluster to Next Node.
5. Repeat step 3 on all remaining Nodes.
6. Once all nodes are complete with command 3, bring the qlik Replicate Services back online.