Linux installation prerequisites and procedures
The following topic lists the prerequisites for installing Qlik Replicate on Linux and explains how to perform the installation.
Prerequisites
-
Run the following command to untar the Qlik Replicate RPM:
tar xf areplicate_<version>_<buildnum>_Linux_X64.tar.gz
- Copy the Qlik Replicate RPM file to any location on the Linux computer
-
Port 3552 (the default rest port) needs to be opened for outbound and inbound communication, unless you override it as described below.
Installing Qlik Replicate on Linux
The default installation directory for Qlik Replicate is: /opt/attunity/replicate
You can choose to install to a different directory as described below.
To install Qlik Replicate, run the following command:
[user=username] [group=groupname] [verbose=true|debug=true] [nocredentials=true] [data=replicate_data_directory] [iport=number] [rport=number] [nologin=true] rpm -i[vh] [--prefix dirname] areplicate-<version-build>.x86_64.rpm
Example:
user=mike group=sales verbose=true iport=1024 rport=1025 rpm -i[vh] --prefix /opt/mydir/ areplicate-6.4.0-102.x86_64.rpm
Viewing the RPM changelog
To see the changelog of the RPM, run the following command:
rpm -q --changelog areplicate
Example output:
* Sun May 12 2024 Support https://support.qlik.com
- version: 2024.5.0
- https://help.qlik.com/en-US/replicate/Content/Replicate/Main/Release_Notes/features.htm
For description of the optional parameters, see the Command parameters table below.
Verifying the RPM
Verifying a package compares information about the installed files in the package with information about the files taken from the package metadata stored in the RPM database. Among other things, verifying compares the size, digest, permissions, type, owner and group of each file.
To verify the RPM before the installation run the following command:
rpm -qp --verify areplicate-<version>-<buildnum>.x86_64.rpm
To verify the RPM after the installation run the following command:
rpm -q --verify areplicate
Installation command parameters
| Parameter | Description |
|---|---|
|
[user=username] |
The default user under which Qlik Replicate is installed is attunity. You can choose to install the product under a different user by adding the parameter user=username to the command. See also the [nocredentials=true] parameter below. |
|
[pass=password] |
Sets the server password. Users will be prompted for this password when connecting to the Replicate server through the Replicate Web Console. You can either set this password when installing Replicate (recommended) or you can set it later as described in Changing the server password. |
|
[group=groupname] |
The default group under which Qlik Replicate is installed is attunity. You can choose to install the product under a different group by adding the prefix group=group to the command. See also the [nocredentials=true] parameter below. |
|
If the specified user or group is not defined locally (namely, in Active Directory), you must include this parameter in the command. Otherwise, the installation will fail. |
|
|
[data=replicate_data_directory] |
The default Qlik Replicate "data" directory is: <product_dir>/data. Use this parameter to install the Replicate data directory to a non-default location. Example: data=/opt/mydata |
|
[--prefix dirname] |
Prefixes the attunity/replicate application directory with the path specified by dirname. So, for example, if --prefix /opt/mydir, then Replicate will be installed to: /opt/mydir/attunity/replicate This is only required when installing Qlik Replicate to a non-default path. |
|
[verbose=true|debug=true] |
Specify verbose=true for additional information during the installation, or debug=true for detailed debug messages during the installation. |
|
[runservice=false] |
This parameter prevents the services from starting. The value can only be "false". This parameter can be used when installing/upgrading the product but not when creating a Replicate instance. |
|
[iport] |
The internal port, which must be a decimal number greater than 1023 but less than 65535. This parameter is required when creating a Replicate instance but optional when installing/upgrading the product. |
|
[rport] |
The REST port, which must be a decimal number greater than 1023 but less than 65535. This parameter is required when creating a Replicate instance but optional when installing/upgrading the product. |
|
[nologin=true] |
The default/specified user created by the RPM installation does not have a login shell and will therefore not be able to log in. Despite not having a login shell, Replicate service(s) will run as the default/specified user. Information noteInstalling or upgrading using nologin=true while the default/specified user already exists in the system, will not change the user shell to nologin.
|
|
[systemd=no] |
Intended for container installation. When Replicate is installed on a container:
|
The installation procedure will perform the following actions:
- Create a new user and group named attunity (unless you chose to use a different user and a group and/or a user namedattunity already exists).
- Change the Qlik Replicate installation directory owner to the attunity user and group, or to your preferred user and group.
- Install the application files.
-
Start the service (areplicate).
The Replicate /lib directory must precede the local lib64 directory (for example, /usr/lib64) in the LD_LIBRARY_PATH environment variable.
The environment variable is set in the <product_dir>/bin/arep_login.sh file.
Example:
export LD_LIBRARY_PATH=/opt/attunity/replicate/lib:/usr/lib64
Additional changes to LD_LIBRARY_PATH in the files site_arep_login.sh and/or instancename_arep_login.sh should be made with caution.