Setting up licenses on Windows

Before you use HCL DevOps Test Integrations and APIs (Test Integrations and APIs), 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 Test Integrations and APIs 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. Press Windows + Break to open the System Properties window.
  2. Select the Advanced tab, and then click Environment variables.
  3. Click New under System variables and add the following environment variables:
    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.
  • 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

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\

    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 HCL DevOps Test Integrations and APIs (Test Integrations and APIs) that can be in the DevOpsTestAPI folder or HCL DevOps Test Integrations and APIs Agent (Test Integrations and APIs Agent) that can be in the DevOpsTestAPIAgent folder.
    LLS_host The hostname of the Local License Server.
    LLS_port The port number of the Local License Server.
  2. Press Windows + Break to open the System Properties window.
  3. Select the Advanced tab, and then click Environment variables.
  4. Click New under System variables and add the following environment variable:
    Environment variable Value
    HCL_DT_LICENSING_URL https://<myServer:portNumber>/request
    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.
    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. Press Windows + Break to open the System Properties window.
  2. Select the Advanced tab, and then click Environment variables.
  3. Click New under System variables and add the following environment variables:
    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.
    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 a proxy license server.

What to do next

You can perform the following tasks: