Installation of Unica Link in Native Mode
Dependencies
bash
(Bourne Again SHell)ksh
(KornShell)libnsl
- GNU
sed
- MongoDB server
Native System Configuration
- changing the temporary directory, or
- removing
noexec
from the /tmp directory.
Changing the Link Temporary Directory
To change the Link tempaorary directory, complete the following steps:
- Create a new directory. Ensure that the
noexec
option is not used for mounting of the location. - Check the output of the mount. For example, run the following
commands:
mkdir /opt/hiptmp
chmod 777 /opt/hiptmp
- To specify the new directory, add a new line to
hip-server-native.env For
example:
JAVA_OPTS="$JAVA_OPTS -Djava.io.tmpdir=/opt/hiptmp"
- For the long and short workers, modify the existing lines in
hip-server-native.env. For
example:
HIP_LONG_WORKER_JVM_OPTIONS="-Xmx2g -Djava.io.tmpdir=/opt/hiptmp" HIP_SHORT_WORKER_JVM_OPTIONS="-Djava.io.tmpdir=/opt/hiptmp"
- To copy the new configuration into the Link installation, execute the following
command:
cp hip-server-native.env tomcat-context/install/hip-server.env
Changing the Mount Option for /tmp
The /tmp directory must be mounted with noexec
.
To verify, run the following commands:
mount | grep /tmp
tmpfs on /tmp type tmpfs (rw,nosuid,nodev,noexec,relatime)
If /tmp directory is already mounted with
noexec
, you can change the mount option for
/tmp directory. To change the the mount option for /tmp
directory, complete the following steps:
- Ensure that you are using root user privileges.
- Edit /etc/fstab and remove noexec from the mount options of /tmp.
- Either:
- Reboot the system, or
- Run the following
command:
mount -o remount /tmp
Configuration
You must configure Unica Link before running any installation commands. If you choose not to, you may have to reinstall for the updated configurations to take effect.
There are two files to configure before installation (use ‘native’ post-fixed versions):
- hip-server-native.env
- tx-rest-native.properties
To reconfigure after installation, update those files, and run the install command. This will overwrite the configuration files in the install directory.
You will observe several directories specified in those configuration files. If the user or group you install as, does not have read/write access to these directories, you will need a system administrator to create them and transfer ownership.
non-root
(recommended), you must change the
HIP_HTTPS_PORT
specified in
hip-server-native.env to a number above 1024. The standard
Linux kernel prevents regular users from starting processes that bind to any port
below 1024. Alternatively, you can use setcap to overcome this
limitation:
sudo setcap ‘cap_net_bind_service=+ep’ <link_package>/node-context/install/nodejs/bin/npm
sudo setcap ‘cap_net_bind_service=+ep’ <link_package>/node-context/install/nodejs/bin/node
Installation
- The following commands are intended for a quick-start scenario:
- Use the following command to generate
configuration:
./Link configure –generate
- Change the Unica Journey/Unica Campaign/Unica Platform properties under <Link installer>/ integration-context/apps/ and place the connectors under <Link installer>/ integration-context/connectors.
-
./Link configure --type native --integration unica
-
./Link install
- Change the kafkalink properties under <Link-install>/integration-context/kafka-link/.
- Either start all components or continue to the troubleshooting
section for any errors.
./Link start
- Use the following command to generate
configuration:
- When Link is up and running, navigate to the location that is set for the
environment variable HIP_HIPREST_DIR and create a new
folder tmp.
Refer to the file hip-server-native.env, present in the installation location, to see the folder path that is set for the HIP_HIPREST_DIR parameter. The default path is /opt/hip-rest. If the default path is /opt/hip-rest, the tmp folder file path is /opt/hip-rest/tmp.
- Changing HIP_SERVER_USE_HTTP if Link server is enabled to
run on HTTP port in reference to
authentication.server
setting.Perform following steps to enable link to run on http port8443
:- Export
HIP_SERVER_USE_HTTP=true
. - Restart Link or add it to the bash profile and run it.
- Note: Perform the following step only if the server is on port other than 8443, or not running on localhost.Add
HIP_SERVER_HOST={hostname}:{port}
i.e.HIP_SERVER_HOST=localhost:8444
.
- Export