Welcome
Managing HCL Local License Server
After you receive your license entitlements, you must verify the system requirements, perform preinstallation tasks, and then install the HCL Local License Server (LLS) product.
Verifying HCL Local License Server Installation
After you have installed HCL Local License Server (LLS), you must verify that the installation completed successfully and that the server is reachable and operational.

HCL Licensing - Overview
You must license your HCLSoftware product to get access to a full-featured version of your HCLSoftware product for an extended duration and HCLSoftware support.
Managing HCL Local License Server
After you receive your license entitlements, you must verify the system requirements, perform preinstallation tasks, and then install the HCL Local License Server (LLS) product.
- System Requirements
  Before you install HCL Local License Server, ensure that your system meets the hardware and software requirements.
- Preinstallation Tasks
  Before you install HCL Local License Server (LLS), you must perform some necessary tasks to prepare your system and environment.
- Installing HCL Local License Server
  After completing the pre-installation tasks, you can begin installing HCL Local License Server (LLS) 5.3 as a new installation. On Windows, you can also use the upgrade feature to update an existing LLS version (5.0, 5.1, or 5.2) to 5.3. Once installed, you can use it to manage HCLSoftware product licenses.
- Version Upgrade Behavior
  On Windows, an existing HCL Local License Server (LLS) installation can be upgraded to a later version, and the licenses, logs, TLS certificate, and port are retained. On Linux, upgrading from an earlier version to 5.3.0 is not supported.
- Backup and Restore
  When HCL Local License Server (LLS) is uninstalled using the uninstall.bat/sh file, the license files, logs, TLS certificate, and port setting are saved to a backup directory. The installer can restore them during the next installation instead of requiring the server to be configured again.
- Post-installation: Generating the license file
  After installing the HCL Local License Server (LLS), you must create deployments in My HCLSoftware (MHS) to manage your entitlements. Each deployment generates a license file that must be copied to the licenses folder on your LLS host machine.
- Verifying HCL Local License Server Installation
  After you have installed HCL Local License Server (LLS), you must verify that the installation completed successfully and that the server is reachable and operational.
- Configuring HCL Local License Server
  You can configure HCL Local License Server (LLS) to update parameters such as the TLS certificate or the port number using the update.bat/sh file provided in the installer package.
- Uninstalling HCL Local License Server
  When you no longer require HCL Local License Server (LLS) on your system, you can remove it by running the uninstall.bat/sh file located in the installation directory.
- Troubleshooting HCL Local License Server
  You can troubleshoot some common issues that you might encounter during the installation or operation of HCL Local License Server (LLS).
Managing HCL Cloud License Server
After you receive your license entitlements, you can set up HCL Cloud License Server (CLS) for your HCLSoftware product license configuration.
Notices
This document provides information about copyright, trademarks, terms and conditions for the product documentation.

Verifying HCL Local License Server Installation

After you have installed HCL Local License Server (LLS), you must verify that the installation completed successfully and that the server is reachable and operational.

About this task

You can verify your LLS installation using any of the following methods.

Procedure

Check the LLS health using an API request.
Use the following GET API request to check the server health:
```
https://<FQDNhostname>:<LLSport>/v1/health
```
The response is similar to the following:
```
{
    "status": "Active",
    "uptime": "42 hours, 22 minutes, 2 seconds",
    "timestamp": "2025-05-26T11:38:03.397Z"
}
```
A response of this form confirms that your LLS instance is running and reachable.
Verify the LLS service status.
Ensure that the LLS service is running properly.

On Windows:
- Open Windows Services (services.msc).
- Locate HCL Local License Server in the list.
- Check that its Status is set to Running.
To manage the service manually, right-click it and select Start, Stop, or Restart.

On Linux, run the following command:
```
systemctl status HCL-Local-License-Server-5.3.0.service
```
To start, stop, or restart the service:
```
systemctl stop HCL-Local-License-Server-5.3.0.service
systemctl start HCL-Local-License-Server-5.3.0.service
systemctl restart HCL-Local-License-Server-5.3.0.service
```
Check that LLS can retrieve license pool information.
Open the following URL in a browser:
```
https://<FQDNhostname>:<LLSport>/v1/licensepools/<poolID>
```
Alternatively, from the command line on Linux:
```
curl --cacert /path/to/your/certificate.crt https://<FQDNhostname>:<LLSport>/v1/licensepools/<poolID>
```
Where:
- <FQDNhostname> is the Fully Qualified Domain Name of the LLS host.
- <LLSport> is the port number used during installation, for example 443 or 8080.
- <poolID> is the unique ID of your deployment.
Locate the Pool ID.
You can find the Pool ID in either of the following ways.

From the log file:
```
<lls_install_directory>/logs/hcl_lls_pools.log
```
Or by using the API endpoint:
```
https://<FQDNhostname>:<LLSport>/v1/licensepools
```

Results

If the API and service checks return valid results, your HCL Local License Server 5.3 installation is verified and ready for configuration.