Enabling Unica Link to run on HTTP protocol for Windows and Linux Installation

Enabling Unica Link for Microsoft Windows

About this task

This documentation describes how to enable the Unica Link to run on HTTP protocol before running the link install command for the Microsoft windows installation.

To enable the Unica Link to run link server and rest on http port 8080 and client on http port 4443. Modify below files and complete the following steps:

Procedure

Modify config.yaml.


set HIP_HTTP=true
set HIP_HTTPS_PORT=443
set HIP_HTTP_PORT=4443

::HIP server host location

set HIP_SERVER_HOST=localhost:8080

Modify config.yaml - 

authentication.server=http://localhost:8080tomcat:
  inbound:

Run install.bat command
Set the environment variable HIP_SERVER_USE_HTTP= True, and complete the following steps:
1. Click This PC.
2. Select properties and click Advanced System Settings.
3. Under the Advance tab, click Environment Variables and add a system variable as mentioned in Step 3.
Run Start.bat command.

Check client log for the following message:


<Link installation folder>\DesignServer\client\daemon\hcllinkwebui.out.log

Server listening at http://0.0.0.0:4443
Using server backend at url: http://localhost:8080

Launch the Link UI and log in.

Enabling Unica Link for Linux Native and Docker for Port 8080

About this task

This documentation describes how to enable the Unica Link to run on HTTP protocol before running the link install command for the Native and Docker installation.

To enable the Unica Link to run on HTTP 8080 protocol for the Native and Docker installation, complete the following steps:

Procedure

Open the config.yaml file.

In client configuration section, for inbound and outbound connections, change the protocol properties from https to http as shown below in the following example:


client:
  # Settings for inbound connections to the client such as when accessing
  # via a web browser.
  inbound:
    # Protocol for inbound connections. Valid options are [http, https].
    # Previously: HIP_HTTP
    protocol: "http"
    # Port to listen on for inbound connections. This value must be >1000
    # to run the client process as a non-root user.
    # Previously: HIP_HTTPS_PORT, HIP_HTTP_PORT
    port: 4443
  # Settings for outbound connections from client
  outbound:
    # Connection from client to backend server
    server:
      # Protocol for connection. Valid options are [http, https].
      # Previously: HIP_SERVER_USE_HTTP
      protocol: "http"

In the Rest configuration section perform these steps:

Change the settings in authentication.enabled as follows:
```
authentication.enabled=true
```

Change the server property from https://localhost:8443 to http://localhost:8080 as shown in the following example:


rest:
    authentication:
      # Specify if inbound API calls should be authenticated.
      # Previously: authentication.enabled
      enabled: true
      # The authentication server MUST point to the Server instance configured
      # for this installation. The format is {protocol}://{host}:{port}
      # [NATIVE] Default: 'https://localhost:{.server.inbound.ports.https}'
      # [CONTAINERIZED] Default: 'https://hip-server:8443'
      # Previously: authentication.server
      server: "http://localhost:8080"

In the tomcat configuration section, the default configuration for http port is 8080 and https port is 8443. Any mismatch found in default configuration will require changing ports as shown in the following example:


tomcat:
  inbound:
    # [NATIVE-ONLY] Ports to listen on for connections. Neither protocol can be
    # disabled directly from this configuration file. To do so, complete
    # installation first then go to the Tomcat configuration files for advanced
    # options.
    # To set ports for docker installations use the .rest.inbound.ports and
    # .server.inbound.ports to configure on a per-container basis. Native
    # installations share the same Tomcat instance between rest and server.
    ports:
      http: 8080
      https: 8443
      shutdown: 8005"

Save the config.yaml file.
Execute ./Link install and ./Link start.

Note: The Link Runtime server should also use HTTP URL.

Enabling Unica Link for Linux Native for Port 8443

About this task

To enable the Unica Link to run on HTTP 8443 protocol for the Native installation, complete the following steps:

Procedure

Open the config.yaml file.

In client configuration section, for inbound and outbound connections, change the protocol properties from https to http as shown below in the following example:


client:
  # Settings for inbound connections to the client such as when accessing
  # via a web browser.
  inbound:
    # Protocol for inbound connections. Valid options are [http, https].
    # Previously: HIP_HTTP
    protocol: "http"
    # Port to listen on for inbound connections. This value must be >1000
    # to run the client process as a non-root user.
    # Previously: HIP_HTTPS_PORT, HIP_HTTP_PORT
    port: 4443
  # Settings for outbound connections from client
  outbound:
    # Connection from client to backend server
    server:
      # Protocol for connection. Valid options are [http, https].
      # Previously: HIP_SERVER_USE_HTTP
      protocol: "http"

In the Rest configuration section perform these steps:

Change the settings in authentication.enabled as follows:
```
authentication.enabled=true
```

Change the server property from https://localhost:8443 to http://localhost:8443 as shown in the following example:


rest:
    authentication:
      # Specify if inbound API calls should be authenticated.
      # Previously: authentication.enabled
      enabled: true
      # The authentication server MUST point to the Server instance configured
      # for this installation. The format is {protocol}://{host}:{port}
      # [NATIVE] Default: 'https://localhost:{.server.inbound.ports.https}'
      # [CONTAINERIZED] Default: 'https://hip-server:8443'
      # Previously: authentication.server
      server: "http://localhost:8443"

In the tomcat configuration section, change the http port to 8443 and https port to 8444 as shown in the following example:


tomcat:
  inbound:
    # [NATIVE-ONLY] Ports to listen on for connections. Neither protocol can be
    # disabled directly from this configuration file. To do so, complete
    # installation first then go to the Tomcat configuration files for advanced
    # options.
    # To set ports for docker installations use the .rest.inbound.ports and
    # .server.inbound.ports to configure on a per-container basis. Native
    # installations share the same Tomcat instance between rest and server.
    ports:
      http: 8443
      https: 8444
      shutdown: 8005"

Save the config.yaml file.
Execute ./Link install and ./Link start.

Note: The Link Runtime server should also use HTTP URL.