Installation of Unica Link in Native Mode

Dependencies

  • bash (Bourne Again SHell)
  • ksh (KornShell)
  • libnsl
  • GNU sed
  • MongoDB server

Native System Configuration

Native system configuration includes:
  • 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:

  1. Create a new directory. Ensure that the noexec option is not used for mounting of the location.
  2. Check the output of the mount. For example, run the following commands:
    mkdir /opt/hiptmp
    chmod 777 /opt/hiptmp
  3. 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"
  4. 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"
  5. 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:

  1. Ensure that you are using root user privileges.
  2. Edit /etc/fstab and remove noexec from the mount options of /tmp.
  3. Either:
    1. Reboot the system, or
    2. 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.

If you are installing as 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:
Note: Install Unica Link before using setcap

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

Read the Link Utility documentation before following the installation steps. You may need to adjust commands according to your use-case.
  1. The following commands are intended for a quick-start scenario:
    1. Use the following command to generate configuration:
      ./Link configure –generate
    2. 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.
    3. ./Link configure --type native --integration unica
    4. ./Link install
    5. Change the kafkalink properties under <Link-install>/integration-context/kafka-link/.
    6. Either start all components or continue to the troubleshooting section for any errors.
      ./Link start
  2. 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.

  3. 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 port 8443:
    1. Export HIP_SERVER_USE_HTTP=true.
    2. Restart Link or add it to the bash profile and run it.
    3. 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.