Applying HCL licenses to agents

You can apply licenses to HCL DevOps Deploy (Deploy) agents to run deployments in your production environment.

Before you begin

  • You must have an entitled agent license and must have acquired the HCL Local License Server (LLS) or HCL Cloud License Server (CLS) URL.
  • Check if the license server is reachable by opening the license server URL in your browser or by using the following curl command:
    curl --cacert /path/to/your/certificate.crt https://FQDNhostname:LLSport/v1/licensepools/deploymentID
    You can check the number of allocated licenses and used licenses on a successful connection. Refer to the HCL Licensing documentation for more information.

About this task

As an administrator or a license manager, you can configure Deploy to use the entitled license.

Procedure

  1. Click Settings > System > License Management on the dashboard.
  2. Set the Automatic Agent License Type field to automatically apply licenses to newly created agents.
    Note: The available license types are stated by the current server license mode. For example, set the Automatic Agent License Type as HCL_Agent for standard agents or HCL_Agent_Z for z/OS agents.
  3. Enter the license server URL in the License Server Path field.
    The example URLs for your license type are as follows:
    • HCL Local License Server:
      https://lls-host:lls-port/v1/licensepools/deploymentID
    • HCL Cloud License Server:
      https://cloud_server/v1/licensepools/deploymentID
  4. Click Save Connection.

Results

Deploy is configured with the HCL license server and displays the license status in the License Management page.

What to do next

After applying the license, you confirm that the license is active by clicking Resources > Agents. The licensed agents are listed and flagged as true in the License column. In case of floating licenses, the License column shows true only when the agent is in use for deployment.

You can also enable logging for licensing. See Managing the logs. The enabled licensing log is displayed as True in the log table. You can find the licensing log information in the var\log\licensing.out file.