Using a local license server

In some cases, your computer might not be connected to the open Internet. In these cases, you can set up a local license server behind your company firewall. You must install the server on a physical computer and not on a Virtual Machine.

Before you begin

As part of configuration, the local license server must already have mapped your entitlements and be able to serve your requests.

The local license server is supported on 64-bit Windows and Linux platforms.

About this task

You might be working from a lab that does not have access to the Internet. In such cases, you must install and set up a local license server behind your company's firewall. 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. After the server is installed and configured, when you start the product, you must specify the server URL in this format - http://<myServer:portNumber>/request. You must not specify the server ID.

Procedure

Procedure on Windows
  1. You must add these environment variables:
    1. Press Windows + Break to open the System Properties window. Select the Advanced tab then click Environment variables.
    2. Under System variables, click New to add the environment variable HCL_ONETEST_LICENSING_URL to the URL of the local license server in this form: http://<myServer:portNumber>/request.
Procedure on Linux (Ubuntu)
  1. Add the following environment variable to /etc/environment 
    HCL_ONETEST_LICENSING_URL=http://<myServer:portNumber>/request
Troubleshooting
  1. Enable the licensing debug logs by doing these steps:
    1. Append com.hcl.products.test.common.licensing.key.level=INFO to it-logging.properties in the HCL OneTest™ API installation directory
    2. Add the environment variable HCL_ONETEST_LICENSING_DEBUG and set it to true
    3. Start the HCL OneTest™ API from the command line by using the -console parameter
  2. The FlexNet local license server generates a log file. The default location is as follows:

    WINDOWS: c:\windows\ServiceProfiles\NetworkService\flexnetls\HCL\logs\flexnetls.log

    LINUX: /var/opt/flexnetls/HCL/logs/flexnetls.log

  3. After the product installation, when you apply the license to the product, the license information is cached in a system directory. If there are any permission issues accessing the directory or the directory is deleted, there is a licensing error when you start the product. The workaround is to create an environment variable HCL_ONETEST_LICENSING_STORAGE and specify a directory path. The licensing information is stored in this new directory, for example, C:\Users\<username>\HCLOneTest

What to do next

Configuring HCL OneTest API