Installation of Unica Link in Native Mode

Dependencies

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

Prerequisites

  • MongoDB server

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.