Setting up licenses on Linux (Ubuntu)

Before you use HCL DevOps Test Integrations and APIs Agent (Test Integrations and APIs Agent), you must set up and apply the licenses by using a license server.
You can apply the licenses for the product by using any of the following methods that is based on your network set up:

After you have set up the licenses, you might want to change the location of the system cache that stores the license information temporarily or if you want to add the logging details for the licensing issues that you can use to troubleshoot such issues. See Troubleshooting licensing issues.

Setting up licenses by using the Cloud License Server

You can set up licenses for HCL DevOps Test Integrations and APIs Agent (Test Integrations and APIs Agent) by using the HCL Cloud License Server, if the computers on which you install the product can access the internet.

Before you begin

You must have completed the following tasks:
  • Purchased the licenses.
  • Configured the URL of a HCL Cloud License Server with the appropriate entitlements.
  • Been issued the Server ID of the HCL Cloud License Server.

Procedure

  1. Open a terminal.
  2. Add the following environment variables to /etc/environment:
    Environment variable Value
    HCL_DT_LICENSING_URL URL of the licensing server. You get this URL when you activate your deployment in the My HCLSoftware Portal. For example, https://my.hcllicenserver.com.
    HCL_DT_LICENSING_ID Your server ID or deployment ID.
    Note: If you have set up the environment variables for previous versions of the products, you can continue to use those variables too.

Results

You have set up the licenses by using the HCL Cloud License Server.

What to do next

You can perform the following tasks:

Setting up licenses by using a Local License Server

When you install the product on computers which cannot access the internet and are behind a firewall, you must set up a Local License Server.

Before you begin

You must have completed the following tasks:
  • Purchased the licenses.
  • Installed the Local License Server. For example, the Local License Server can be in the following form: myServer:portNumber.
  • Configured the Local License Server with the appropriate entitlements. For more information about installing and configuring the Local License Server, see My HCLSoftware Licensing.
  • Created a self-signed certificate, if you want to use the HTTPS method to check out the licenses from the Local License Server.

Procedure

  1. Open a terminal.
  2. Perform the following steps:
    1. Import a self-signed certificate into the Java key store by running the following commands:

      cd <install_dir>\HCL\<product>\jre\bin\

      keytool -printcert -sslserver <LLS_host>:<LLS_port> -rfc | keytool -import -noprompt -alias hclfnls -keystore "<install_dir>\HCL\<product>\jre\lib\security\cacerts" -storepass changeit

      Substitute the following variables with the values as indicated in the following table:
      Variable Value
      install_dir The path on your computer where the product is installed.
      product The folder of the product that is installed. For example, you installed Test Integrations and APIs Agent that is in the Agent folder.
      LLS_host The hostname of the Local License Server.
      LLS_port The port number of the Local License Server.
    2. Add the following environment variable to /etc/environment:
      Environment variable Value
      HCL_DT_LICENSING_URL https://<myServer:portNumber>/request
      HCL_DT_LICENSING_ID Your server ID or deployment ID.
      Substitute the following variables with the values as indicated in the following table:
      Variable Value
      myServer The hostname of the Local License Server.
      portNumber The port number of the Local License Server.

Results

You have set up the licenses by using a Local License Server.

What to do next

You can perform the following tasks:

Setting up licenses by using a proxy License Server

Before you begin

You must have completed the following tasks:
  • Purchased the licenses.

Procedure

  1. Open a terminal.
  2. Add the following environment variables to /etc/environment:
    Environment variable Value Description
    HCL_DT_LICENSING_PROXY_URL http://<ProxyServer Host name The value points to the hostname of the proxy license server that you want to use.
    HCL_DT_LICENSING_PROXY_PORT ProxyServer Port number The value points to the port number of the proxy license server that you want to use.
    HCL_DT_LICENSING_PROXY_USER ProxyServer user name The value points to the user configured to use the proxy license server.
    HCL_DT_LICENSING_PROXY_PASS ProxyServer password The value points to the password for the user configured to use the proxy license server.

Results

You have set up the licenses by using a proxy license server.

What to do next

You can perform the following tasks: