Welcome
Installation Guide
Microsoft Windows installation
This section describes how to install Link using the Windows Installer.
Manually updating Apache Tomcat version for the Link application
This procedure defines the steps to manually update the installed Apache Tomcat version software for the Link application. If the currently installed version of Apache Tomcat version has a security issue that is resolved in a later version, you can follow these steps to update it.

Unica Link Documentation
Welcome to the Unica Link 12.1.9 documentation, where you can find information about how to administer and use Unica Link.
Release Notes
System Requirements
Installation Guide
- Introduction to Unica Link
  Unica Link is a component that can be installed separately from the Unica application.
- Unica Link prerequisites
  Ensure that these prerequisites are met before installing Unica Link.
- Microsoft Windows installation
  This section describes how to install Link using the Windows Installer.
  - Licensing
  - Installation prerequisites
    Unica Link requires the Link Runtime server to be installed.
  - Starting and stopping Unica Link
    After installation, to start and stop Link, complete the following steps:
  - Accessing Unica Link
    After the Link is installed, user can access the server by pointing the Web browser to local URL https://localhost:<port>/login.
  - Customizing the installation
    You can customize Link by editing settings in the file C:\HCL\Link_<version-number>\config\config.yaml.
  - Customizing the Redis and Link Database
    Link installation includes Redis server. If you want to use a preinstalled Redis server, you must customize your Link installation.
  - Customizing Link URL and Selecting HTTPS protocol
    The Link default URL: https://localhost:4443/login uses HTTPS protocol on port 4443.
  - Installing connectors
    Use these steps to install connectors:
  - Setting up Campaign
    Steps to set up Campaign.
  - Setting up Journey
    Steps to set up Journey.
  - Uninstalling Link
    To uninstall Link, complete the following steps:
  - Verify that the following ports are available on your machine <>
    The following table lists the required ports and the corresponding Link configuration properties:
  - Installing Apache Kafka-link
    These instructions describe how to install Apache Kafka-link on Windows.
  - Troubleshooting the installation
    In the case of Link Install, Start, or Stop errors, review the logs files from the following folders:
  - Manually updating Apache Tomcat version for the Link application
    This procedure defines the steps to manually update the installed Apache Tomcat version software for the Link application. If the currently installed version of Apache Tomcat version has a security issue that is resolved in a later version, you can follow these steps to update it.
- Offline installation of Unica Link
- Linux Installation
  You can install Unica Link in the following modes:
- Upgrading the Unica Link Multi Partition Utility
  Admin tool guide to update the multi partition upgrade utility for Linux Docker, Windows and Linux Native.
- Setting up Journey and Campaign for Unica Link
- Guidelines for Unica Link Installation and Integration Enablement
  Follow these guidelines for enabling Unica-Link Installation and Integration:
- Link Cosmos DB integration
  The purpose of this document is to guide on integrating your web application with Azure Cosmos DB for MongoDB. By following the steps outlined herein, you will seamlessly incorporate Cosmos DB into your application's data storage and retrieval processes.
- Logging
  Logs are produced for your use by Link, the Runtime REST API, and Kafkalink.
- Enabling Unica Link to run on HTTP protocol for Windows and Linux Installation
- Mandatory Configuration to verify in config.yaml before using Unica Link framework
- Encrypting the password in the properties file
  To enhance security and safeguard sensitive information, encrypt the password stored in the properties file adding a layer of protection to the data.
- Encrypting the config.yaml properties
  This section describes how to encrypt the config.yaml properties for Linux -A and Windows.
- Verifying the config.yaml file
  This section describes how to verify the validity of your config.yaml file after making changes in it. When editing the config.yaml file, ensure that the modifications you make are valid. To verify the validity of your config.yaml file after making changes, perform one of the following procedures based on your setup:
- Configuring SSL Certificates for Link
  After installing Link, setup the custom SSL certificates for the Link web UI and the Link runtime application server.
- JWT Configuration for Connectors
  To configure the JWT (JSON Web Token) there are two options for a customer regarding certificate.
- Troubleshooting
User Guides
Licensing Guide
PDFs
Notices

Manually updating Apache Tomcat version for the Link application

This procedure defines the steps to manually update the installed Apache Tomcat version software for the Link application. If the currently installed version of Apache Tomcat version has a security issue that is resolved in a later version, you can follow these steps to update it.

Before you begin

Important: Ensure that you back up the <Link installation folder>/restapi/ folder.

About this task

To manually update Apache Tomcat version for Link application on windows platform, complete the following steps:

Procedure

Download the latest 64-bit Windows binaries of Apache Tomcat version in ZIP format from the official Apache Tomcat website.
Copy the downloaded ZIP archive into the <Link installation folder>/restapi/tomcat folder.
Complete the following steps:
1. Type WINDOWS+R.
2. Right-click the Command Prompt window and select Run as Administrator.
3. In the Command Prompt window, change the current directory to <Link installation folder>\DesignServer.
Run the following command to clean any existing Apache Tomcat installation:
```
clean.bat
```
Use a Text Editor to modify the dtxtomcat.ini configuration file located at the <Link installation folder>\restapi\tomcat\ location. Update the string TomcatVersion=9.0.XX to match the version of the downloaded Apache Tomcat version from Step 1. Save the changes.
From the same command prompt window folder, as mentioned in Step 3, run the following command to install Apache Tomcat:
```
install.bat
```