Home
Installation Guide
Microsoft Windows installation
This section describes how to install Link using the Windows Installer.
Verify that the following ports are available on your machine
The following table lists the required ports and the corresponding Link configuration properties:

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:
- Linux Installation
  You can install Unica Link in two modes:
- Setting up Journey and Campaign for Unica Link
- 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
- Configuring SSL Certificates for Link
  After installing Link, setup the custom SSL certificates for the Link web UI and the Link runtime application server.
- Encrypting the password in the properties file
  To enhance security and safeguard sensitive information, encrypt the password stored in the properties file to add a layer of protection to the data.
- Troubleshooting
- Known issues
  Summary of known issues in this version of the product.

Verify that the following ports are available on your machine

The following table lists the required ports and the corresponding Link configuration properties:


Default port	Used by Link features	Configuration file location (relative to the Link installation folder)	Configuration property name
`4443`	Link server	config\config.yaml	/client/inbound/port used with /client/inbound/protocol Formerly: `HIP_HTTPS_PORT`, `HIP_HTTP_PORT`
`80`	Link server	config\config.yaml	/client/inbound/port used with /client/inbound/protocol Formerly: `HIP_HTTPS_PORT`, `HIP_HTTP_PORT`
`8080`	Runtime and Link server	config\config.yaml	/tomcat/inbound/ports/http /rest/inbound/ports/http /keycloak/serverUrl (used only if the Keycloak feature is enabled, /keycloak/enabled) Formerly: `authentication.keycloak.serverUrl` `HIP_KEYCLOAK_SERVER_URL`
`8443`	Runtime and Link server	config\config.yaml	/tomcat/inbound/ports/https /server/inbound/ports/https /client/outbound/server/port /rest/inbound/authentication/server Formerly: `authentication.server` `HIP_SERVER_HOST`
`8005`	Runtime and Link server	config\config.yaml	/tomcat/inbound/ports/shutdown
`15901`	Event Reporter	config\config.yaml	/rest/eventReporter/port Formerly: `event.logger.port`
`15901`	Event Reporter	eventreporter.properties	`LISTENING_PORT`

The Link Windows installation opens a dialog that allows you to configure the Link design time (Link UI ) ports. Typically, the Link UI ports are ports 4443 and 80. The Windows installation verifies that the ports are available on the machine. The installation does not continue if these ports are not available.

Also, the Link Windows installation opens a dialog that allows you to configure Link application server ports (typically ports 8080, 8443 and 8005). The Windows installation verifies that the selected ports are available on the machine. The installation does not continue if those ports are not available.

The Event Reporter port (port 15901) must be manually verified to ensure that it is available.

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.