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

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.
  - Installing Link Offline
  - 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 9 for the Link application
    This procedure defines the steps to manually update the installed Apache Tomcat 9 software for the Link application. If the currently installed version of Apache Tomcat 9 has a security issue that is resolved in a later version, you can follow these steps to update it.
- Linux Installation
  You can install Unica Link in two modes:
- Setting up Journey and Campaign for Unica Link
- 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
- 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.
- 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.
- Troubleshooting
- Known issues
  Summary of known issues in this version of the product.

Manually updating Apache Tomcat 9 for the Link application

This procedure defines the steps to manually update the installed Apache Tomcat 9 software for the Link application. If the currently installed version of Apache Tomcat 9 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 9 for Link application on windows platform, complete the following steps:

Procedure

Download the latest 64-bit Windows binaries of Apache Tomcat 9 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 9 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
```

Rate this topic

5 stars 4 stars 3 stars 2 stars 1 star

Comment on this topic.

By clicking this box, you acknowledge that you are NOT a U.S. Federal Government employee or agency, nor are you submitting information with respect to or on behalf of one. HCL provides software and services to U.S. Federal Government customers through its partners immixGroup, Inc. Contact this team at https://hcltechsw.com/resources/us-government-contact. Do not include any personal data in this Comment box.