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.
For a Docker deployment, run the following command from the installation directory. The STATUS column shows Up when the container is running.
```
docker ps --filter name=hcl-lls-server
```
To view the startup messages:
```
docker compose logs
```
For a native installation on Windows:
- Open Windows Services (services.msc).
- Locate HCL Local License Server 5.4.0 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.

For a native installation on Linux, run the following command:
```
systemctl status HCL-Local-License-Server-5.4.0.service
```
To start, stop, or restart the service:
```
systemctl stop HCL-Local-License-Server-5.4.0.service
systemctl start HCL-Local-License-Server-5.4.0.service
systemctl restart HCL-Local-License-Server-5.4.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 (LLS) 5.4 installation is verified and ready for configuration.

Note:

For a Docker deployment, you can also read the fingerprint and deployment details from the container:

docker exec hcl-lls-server cat /app/installer.txt