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
- For the installation to succeed, at least one of the following must already exist in the system:
- The user specified in the installation command
- The /home dir
-
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=user] [group=group] [verbose=true|debug=true] [nocredentials=true] [data=replicate_data_directory] [iport=number] [rport=number] 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
For description of the optional parameters, see the Linux installation prerequisites and procedures table below.
| Parameter | Description |
|---|---|
|
[user=user] |
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 prefix user=user to the command. See also the [nocredentials=true] parameter below. Information note
The login shell of the Replicate user must be set to bash. |
|
[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=group] |
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. |
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 Qlik Replicate/lib directory must precede the /usr/lib64 directory 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.