How to install Qlik Replicate on Linux and set up browser access

[avidary_qlik]

We have compiled a quick guide on how to install Qlik Replicate on Linux.

For additional information and a list of supported Linux platforms, see 
Setting up Qlik Replicate on Linux as well as Linux installation prerequisites and procedures. 

Index:

• Installation steps
• Troubleshooting
• Setting up the browser
• Related Content
• Video Walkthrough

Installation steps

1. Log in to your Linux server
2. Copy the tar file to the Linux file system
3. Untar the file:
   tar -xvf <the name of your tar file> 
   
   Example: areplicate-2022.11.0-289.x86_64.tar.gz
   
   
4. Type ls to check if the files were untared.
   
   In our example, the above file was extracted to rpm:  areplicate-2022.11.0289.x86_64.rpm
   
   
5. Extract the data from the rpm file using the following command:
   
   rpm -ivh areplicate-2022.11.0-289.x86_64.rpm
   
   Please consider that the above will install the software with all the default parameters, if you would prefer to customize it in alignment with your business requirements, please refer to the link to Linux installation prerequisites and procedures.
   
   
   
   
6. Qlik Replicate will install at the following directory /opt/attunity/replicate and the Qlik Replicate server will automatically start.
   
   
7. Check if the Qlik Replicate server is running:
   
   type - ps -ef |grep repctl
   
   
   
   
8. Go to the bin directory under replicate 
   
   cd /opt/attunity/replicate/bin
   
   Before running a repctl command in a Linux shell session for the first time, you need to set the environment, either by invoking the login script manually (using: $ source arep_login.sh) or by adding that line to the ~/.bashrc script. For all command line operations involving files such as arep_login.sh, only the bash shell is supported.
9. Reset the password:
   
   ./repctl SETSERVERPASSWORD <PASSWORD>
   
   Note: The server password must be strong enough to prevent brute-force or dictionary attacks. Save the password for future use.
   
   
   
   
10. Restart the Qlik Replicate service:
    
    ./areplicate restart
    
    
11. After the restart, verify that the service is running:
    
    ./areplicate status
    
    
    

Troubleshooting

If at this point you are given an error related to unable to find an so file (shared object), then set and export LD_LIBRARY_PATH to attunity installation directory's lib sub-directory and try setting the password again.

1. Execute:
   
   export LD_LIBRARY_PATH=/opt/attunity/replicate/lib
   
   
2. Reset the password (see step 11 above)
3. Restart Qlik Replicate:
   
   ./areplicate restart.

If receive an error about arepbase.so missing libraries:

1. Execute:
   
   source arep_login.sh
   
   
2. Restart Qlik Replicate:
   
   ./areplicate restart
   

Setting up the browser

1. From the Linux machine find the machine's IP. 
2. For instance, Run ifconfig to find your IP address and save it for future use.
   
   
   
   

3. Please ensure that your firewall allows inbound and outbound traffic on the REST port (default 3552).
   
   In most systems using firewalls, you can use the following to add exceptions to specific ports. For instance:
   
   sudo firewall-cmd --zone=public --add-port=3552/tcp --permanent
   sudo firewall-cmd --reload

   Note: If you would need additional information related to how those need to be set up you may need to consult the OS vendor's recommendation and your business case and requirements.

4. Open your browser and navigate to:
   
   https:\\<IP of the Linux machine>:3552/attunityreplicate
   
   If the URL is not accessible, verify that the port, 3552, is allowed on any network devices or firewalls.
   
   
5. Log in using:
   
   USERID: admin
   PASSWORD: <Password>
   
   Where password is the one you previously chose during repctl SETSERVERPASSWORD.
   
   
   
   
6. You are connected to the Replicate server on the Linux machine.
   
   

 

Related Content

How to connect Active Directory users to Qlik Replicate on Linux 

Video Walkthrough