How to install Qlik Replicate on a docker image

[john_wang]

This article provides a guide on installing Qlik Replicate on a docker image.

Overview

1. (Optional) Remove older versions of Docker
2. Install Docker on the host Linux Server
3. FTP upload the rpm file to the Linux Server folder
4. Follow the Installing Qlik Replicate on docker steps
5. Prepare the docker build files
6. Modify the Dockerfile
7. Build the docker image
8. Startup and run the docker image

Steps

1. (Optional) Remove older versions of Docker
   

   sudo rpm -qa|grep docker 
   sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-laster-logrotate docker-logrotate docker-engine

2. Install Docker on host Linux Server

   sudo yum install -y yum-utils device-mapper-persistent-data lvm2  
   sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
   
   sudo yum install --allowerasing docker-ce docker-ce-cli containerd.io
   
   sudo systemctl start docker
   sudo systemctl enable docker  
   

3. FTP upload the Qlik Replicate rpm installation file to Linux Server folder "/kit" The /kit directory is a temporary folder used to store installation files. In the example below, the RPM file is areplicate-2024.5.0-357.x86_64.rpm. Once the installation is complete, the entire /kit folder can be safely deleted.
4. Follow the Installing Replicate on a docker steps

   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  
   

5. Prepare the docker build files

   cd /kit/ar_docker
   cp ../areplicate-2024.5.0-357.x86_64.rpm .
   
   ./create-dockerfile.sh  
   

6. Change the line of file /kit/ar_docker/Dockerfile , from:

   RUN yum -y install /tmp/areplicate-*.rpm

   to

   RUN systemd=no yum -y install /tmp/areplicate-*.rpm

NOTE!
The parameter systemd=no is used to solve the below error you may hit during the docker build stage: This rpm is not supported on your system (no systemctl), exiting. error: %prein(areplicate-2024.5.0-357.x86_64) scriptlet failed, exit status 43

NOTE!
The password should not be empty and must be strong enough.

WARNING!
If you want to install ODBC Drivers, please make the corresponding ODBC Drivers rpm files are ready in this folder. If you want to skip the ODBC Drivers installation at present, rename or delete the file "drivers" in this folder.

7. Build the docker image

   docker build --no-cache -t johnw/replicate:2024.5 .

   where /johnw/replicate:2024.5 is the image tag.

Do not forget the last period "."

8. Startup and Run the docker image

   docker run -d --name ar --hostname cdc2 -e ReplicateRestPort=3552 -p 3552:3552 -v /dockermount/data/replicate/data:/replicate/data johnw/replicate:2024.5

Now Qlik Replicate is running in the docker and can be accessed from Qlik Replicate Console GUI.

Environment

• Qlik Replicate 2024.5  SP03 and above builds
• Qlik Replicate 2023.11 SP05 and above builds
• Linux 8.x and 9.x

[suprajar]

@john_wang  - Qlik replicate window installation is not supported dockers right? 

If i need to automate a Qlik replicate version (window) by image - installation to server or upgrade? any suggestion or option is available?   

[john_wang]

Hello @suprajar ,

In general, Docker is primarily used on Linux platforms.
If you want to automate the installation or upgrade of Qlik Replicate on Windows, you can use the silent installation or upgrade method. For detailed instructions, refer to the User Guide:

• Silently Installing Qlik Replicate

• Silently Upgrading Qlik Replicate

Hope this helps.

John.

[suprajar]

@john_wang  - Thanks for the update

Yes, we have implemented silent installation for Qlik Replicate. However, we are looking for a way to automatically download the latest version in case any changes or updates occur in the Qlik Replicate package on the Qlik download site.

I’m currently checking if there is any possibility to achieve this through GitHub, such as accessing the latest downloadable version of Qlik Replicate from a repository or any automated integration available.Please let me know if you are aware of any such option or can suggest an alternative approach.

[john_wang]

Hell @suprajar ,

You may download the latest build of Qlik Replicate from GitHub:

https://github.com/qlik-download/replicate/releases

Hope it helps.

John.

[suprajar]

Thanks @john_wang , Hope GIT hub will be updated with correct version as always.