Setting up licenses on Windows

Before you use HCL OneTest™ API 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 OneTest™ API Agent by using the FlexNet 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 FlexNet Cloud License Server with the appropriate entitlements. The URL of the FlexNet Cloud License Server is in this form: https://hclsoftware.compliance.flexnetoperations.com
  • Been issued the Server ID of the FlexNet 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_ONETEST_LICENSING_URL https://hclsoftware.compliance.flexnetoperations.com
    HCL_ONETEST_LICENSING_ID The value specifies the ID of the licensing server. The ID provided is a 12-digit alphanumeric code. For example, 1234567890AB.

Results

You have set up the licenses by using the FlexNet 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. You must install the Local License Server on a physical computer and not on a Virtual Machine.

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 the documentation for the Local License Server on the HCL Software License & Download portal.

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 variable:
    Environment variable Value
    HCL_ONETEST_LICENSING_URL http://<myServer:portNumber>/request
    Substitute the following variables with the values as indicated in the following table:
    Variable Value
    <myServer> The host name 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

When you do not want to use the Cloud License Server or a Local License Server, you can use a proxy license server that mimics either the Cloud License Server or a Local 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_ONETEST_LICENSING_PROXY_URL http://<ProxyServer Host name> The value points to the host name of the proxy license server that you want to use.
    HCL_ONETEST_LICENSING_PROXY_PORT <ProxyServer Port number> The value points to the port number of the proxy license server that you want to use.
    HCL_ONETEST_LICENSING_PROXY_USER <ProxyServer user name> The value points to the user configured to use the proxy license server.
    HCL_ONETEST_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: