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 License & Delivery 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_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_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_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

Feedback