Setting up licensing

Before you begin

You must have completed the following tasks if you want to set up a cloud server:

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.

You must have completed the following tasks if you want to set up a local license server:

Purchased the licenses.
Configured the Local License Server with the appropriate entitlements.

About this task

You must set up either a cloud license server or a local license server by configuring environment variables based on the operating system.

Setting up a Cloud License Server

Before you start the product, you must configure the following environment variable on the computer on which you have installed Test Embedded

You can add the licensing parameters as environment variables described in the following table:


Environment variable	Description
HCL_LICENSING_URL	The value specifies the URL of the cloud server. If it is not set, it points to the HCL cloud license.
HCL_LICENSING_ID	The license server ID that was provided to you. You can copy the ID from the HCL® License & Delivery portal.

When you launch the product, it connects to the HCL® License & Delivery portal to verify this server ID and if there is a license available, it is checked out so that you can use the product. If the license is not available, a message is displayed about it, in the console.

Note: If the license is not used for 15 minutes, the license is returned to the License server for others to consume it.

Setting up 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 or a virtual machine. For more information about installing and configuring the Local License Server, see the documentation of the local license server from where you downloaded the product bits. As part of configuration, the local license server maps your entitlements of software with the Local License Server to serve your requests.

Note: If the license is not used for 15 minutes, the license is returned to the License server for others to consume it.

Before you start the product, you must set the following environment variable as described in the following table:


Environment variable	Description
HCL_LICENSING_URL	The value specifies the URL of the local license server. The URL must be set up to point to your local server. Example: `HCL_LICENSING_URL=http://myServer:portNumber`
HCL_LICENSING_ID	The environment variable must be blank or undefined. If you enter a value, the local server acts like a cloud server, and the licenses do not apply.

Note: Ensure the HCL_LICENSING_URL matches the hostname of your computer where the local server is installed. You must be attentive to the case sensitivity of the licensing server URL. You can obtain the accurate and case-sensitive information from the system administrators responsible for installing the local server. This information is important for you to properly configure and establish connectivity on the local server for licensing services.