Setting up licensing

To start using a product, you must first set up licensing.

Before you begin

You must have the URL of a configured FlexNet cloud license server with appropriate mapped entitlements. The cloud license server URL is this form:

About this task

Set up a cloud license server:
Before starting the product, you must set up the following environment variable: HCL_LICENSING_ID (mandatory) with the server ID that was provided to you or copy the ID from the HCL License & Delivery Portal. The HCL_LICENSING_URL environment variable is optional, it points to the HCL cloud license server by default. When you launch the product, it connects with 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 server for others to consume it.
Set up a local license server
Sometimes, 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 of the local license server on the same page from where you downloaded the product bits. As part of configuration, the local license server must already have mapped your entitlements and therefore can serve your requests. The environment variable HCL_LICENSING_URL (mandatory) must be set up to point to your local server. Example: HCL_LICENSING_URL=http://myServer:portNumber. The HCL_LICENSING_ID environment variable must be blank or undefined.
Note: The HCL Local License Server is supported on 32 and 64-bit Windows, and Linux platforms. You must install the server on a physical computer and not on a Virtual Machine.
  • Procedure on Windows:
    • Open the System Properties window. Select the Advanced tab then click Environment variables.
    • Under System variables, click New to add one of these environment variables:
      • HCL_LICENSING_URL to the URL of the FlexNet cloud license server.
      • HCL_LICENSING_ID to the Server ID of the cloud license server.
  • Procedure on Linux (Ubuntu):
    • Add one of the following environment variables to /etc/environment.
      • HCL_LICENSING_ID=1234567890AB

On some occasions, your computer might not be connected to the open Internet. For such cases, you can set up a local proxy server that can be on cloud or local.

To test the connection to the server, click Test Connection.

What to do next

You can now work with the product.