How to run Qlik Replicate in a Docker container

Creation date: 04/10/2024 11:42 Updated: 10/10/2024 16:28 container docker docker container docker image dockercontainer dockerimage image

How to run Qlik Replicate in a Docker container.

This article will get you started with a barebones Qlik Replicate Docker container with a license. Detailed steps on how to add drivers to the container will be added soon.

Prerequisites: A supported version of Qlik Replicate must be installed on the Linux server. We installed QR November 2023.

(Step 1) Install docker on the Linux server, and make sure that it is running

(Step 2) Install or upload the Qlik Replicate installation file to the Linux server. Place this rpm file in the folder /kit. If it doesn't exist then create it.

(Step 3) Run the following commands one by one:

mkdir -p /kit/ar_docker

cd /kit

rpm2cpio areplicate-2024.5.0-357.x86_64.rpm | cpio -iv --make-directories --no-absolute-filenames -D ar_docker/ ./opt/attunity/replicate/addons/samples/docker/*

mv ./ar_docker/opt/attunity/replicate/addons/samples/docker/* ./ar_docker

rm -rf ./ar_docker/opt

(Step 4) Prepare the docker files, run these commands:

cd /kit/ar_docker
cp ../areplicate-2023.11.0-468.x86_64.rpm .

./create-dockerfile.sh  

At this point, your ar_docker file should look like this. If it doesn't or if you ran into any issues with the commands, you can manually copy the contents of /opt/attunity/replicate/addons/samples/docker and your Qlik Replicate rpm file into the /kit/ar_docker folder to make it appear as shown below.

(Step 5)

In the "ar_docker" folder, run these commands which will create the "systemctl" file and a Dockerfile:

echo "ls" > systemctl

chmod u+x systemctl


./create-dockerfile.sh

Note: If you get any warnings about the drivers, you can rename the "drivers" folder. Later, once you are able to successfully create and launch a Qlik Replicate container, you can can create a new container with your required drivers.

(Step 6) Open the Dockerfile and add this line if it is not already there:

# Install dummy systemd
ADD systemctl /usr/sbin

Also add a password that satisfies the requirements:

Save the document.

(Step 7) Add your license file to the ar_docker folder.

I copied my license text and pasted it into a json file, then named it "license.json". It will not work if it is not named correctly.

(Step 8) Once the document is saved, run this command to build the docker image:

docker build --no-cache -t ibtqr/replicate:2023.11 .

Don't forget the period at the end "."

ibtqr/replicate:2023.11 is the image tag. You can rename it to whatever you want.

(Step 9) Startup and run the docker image by running the following command:

docker run -d --name areplicatecontaineribt --hostname cdc2 -e ReplicateRestPort=3552 -p 4552:3552 -v /dockermount/data/replicate/data:/replicate/data ibtqr/replicate:2023.11

Qlik Replicate on the host linux machine uses port 3552 by default. To avoid any conflict, remap the port to a number that is not in use. We mapped it to port 4552

(Step 10) Once the container is running, test to see if you can access the Qlik Replicate UI using this URL syntax:

https://<your_machine_ip>:<your_chosen_port>/attunityreplicate/

If all steps were followed correctly, then you should now have access to the GUI.

This is just a basic tutorial to get you started with running Qlik Replicate on a Docker container. We will later add instructions on how to install drivers.

Helpful Links:

https://community.qlik.com/t5/Official-Support-Articles/How-to-install-Qlik-Replicate-on-a-docker-image/ta-p/2460059

Files		Sort by Name Sort by Date
	DataImage91.png 128 KB
	DataImage75.png 30 KB
	DataImage87.png 31 KB
	DataImage64.png 121 KB
	DataImage86.png 97 KB
	DataImage67.png 115 KB
	DataImage14.png 49 KB

How to run Qlik Replicate in a Docker container

Contents