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

avidary_qlik — Fri, 29 Dec 2023 10:26:45 GMT

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

Log in to your Linux server
Copy the tar file to the Linux file system
Untar the file:
tar -xvf <the name of your tar file>

Example: areplicate-2022.11.0-289.x86_64.tar.gz
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
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.
Qlik Replicate will install at the following directory /opt/attunity/replicate and the Qlik Replicate server will automatically start.
Check if the Qlik Replicate server is running:

type - ps -ef |grep repctl
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.
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.
Restart the Qlik Replicate service:

./areplicate restart
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.

Execute:

export LD_LIBRARY_PATH=/opt/attunity/replicate/lib
Reset the password (see step 11 above)
Restart Qlik Replicate:

./areplicate restart.

If receive an error about arepbase.so missing libraries:

Execute:

source arep_login.sh
Restart Qlik Replicate:

./areplicate restart

Setting up the browser

From the Linux machine find the machine's IP.
For instance, Run ifconfig to find your IP address and save it for future use.
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.
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.
Log in using:

USERID: admin
PASSWORD: <Password>

Where password is the one you previously chose during repctl SETSERVERPASSWORD.
You are connected to the Replicate server on the Linux machine.

article How to install Qlik Replicate on Linux and set up browser access in Official Support Articles

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

Installation steps

Troubleshooting

Setting up the browser

Related Content

Video Walkthrough