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
- 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).
- 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.
- 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
- Now, from Windows Cluster Manager, move your cluster to the next cluster node and install Qlik Replicate as described in Steps 1-2
- 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
- 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.
- From Cluster Manager, task the Attunity Replicate Server Service offline and Qlik UI server offline.
- Rename the folder F:\Program Files\Attunity\Replicate\data\endpoint_srv\data to data_old
- 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
- From Cluster Manager, move the cluster to Next Node.
- Repeat step 3 on all remaining Nodes.
- Once all nodes are complete with command 3, bring the qlik Replicate Services back online.
