Step 1: Install Qlik Replicate in the cluster

To install Qlik Replicate in your cluster environment, perform steps 1-3 on each of the cluster nodes:

1. Run the Qlik Replicate setup wizard on the first node that is part of your cluster. Install Qlik Replicate 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:\Replicate\data.

   For more information, see Setting up Qlik Replicate on Windows.

2. Open a command prompt as an administrator and change the working directory to the Replicate bin directory. Then, run the following three commands, where Command 1 should only be run on the first cluster node.

   Warning note

   • The new_master_user_key must be identical on all participating cluster nodes.

     For more information on the role played by the master user key in Replicate, see Encrypting the user permissions file.

   • Setting the admin password using the setserverpassword command will invalidate the master key. Therefore, make sure to set the admin password before running the setmasterkey command.

   • The setmasterkey command overrides the mk.dat file, rendering all stored secrets invalid (as they were encrypted using the old key). Therefore, after changing the master key, you need to reenter the passwords in all of the relevant places. For more information, see Changing and protecting the master key.

     Additionally, because the Replicate server password is also stored in the mk.dat file, you need to reset it as described in Changing the server password

   Command 1:

   repctl -d "replicate_data_folder" setmasterkey new_master_key master_key_scope=1

   Command 2:

   RepUiCtl -d "replicate_data_folder" masterukey set -p new_master_user_key

   where:

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

   Command 3:

   The following command adds the Endpoint Server "data" folder:

   rependctl -d replicate_endpoint_server_data_folder masterukey set --password password

   where:

   replicate_endpoint_server_data_folder is the endpoint server "data" folder (as shown in the example below) and not the Replicate "data" folder.

   Example:

   rependctl -d "e:\Program Files\Attunity\Replicate\data\endpoint_srv\data" masterukey set --password J8kaFbTUi22Mu5vSHdEBA5fHm36h8sqD
3. Stop the Replicate services.

4. Now move your cluster to the next cluster node and install Qlik Replicate as described in Steps 1-3 above, making sure only to run the second command in Step 2.

5. After Replicate is installed on all nodes, edit the ServiceConfiguration.xml file in the "data" folder and change the Https:// and Http:// entries to use the Client Access Point name.