First Time Installation (No Previous LLS Detected)

Procedure

  1. Go to the directory where the installer package is located.
    OS File Name Location
    Windows install.bat <unzipped-installer-files>\hcl-lls-5.3-windows\Application\Windows\install.bat
    Linux install.sh <unzipped-installer-files>/hcl-lls-5.3-linux/Application/Linux/install.sh

  2. From the command line, run the installation program:

    On Windows: Run the install.bat file as Administrator.

    On Linux:

    chmod +x install.sh
./install.sh

  3. Provide configuration information when prompted by the installer.

    Specify whether you want to use the existing installation directory or create a new directory for HCL Local License Server installation: Specify the installation path for LLS.
    • For Linux: LLS installs by default under /opt/hcl-lls-5.3.
    • For Windows, avoid installing in system or user-specific directories like C:\Program Files or C:\Windows. It is recommended to install in a non-system directory such as: C:\HCL_LLS5.3
    • A license folder will be automatically created in the installation path to store license files post-installation. (You can add license files later.)

  4. Enter the TLS Certificate:

    Provide the full path to the certificate file generated by the utility program or from a third-party CA.

    Example: C:\HCL_LLS5.3\certificates\server.crt

    Note:

    • The valid format is PEM (.crt).

    • The certificate chain must follow this order: Server certificate → Intermediate certificate → Root certificate

    • Keep track of TLS certificate expiry dates and renew before expiry.

      LLS does not send expiry notifications.

  5. Enter the TLS Key:

    • Provide the path to the private key file. Example: C:\HCL_LLS5.3\certificates\server.key
    • If the key is encrypted, you can enter the passphrase when prompted.

  6. Enter the Port Number:

    Specify the port on which LLS should run. Default or recommended port: 443 (You can choose any port between 1024–65535.)

    In LLS 5.3, a fingerprint is automatically generated and displayed in the console with the prefix v3.lls. Example output:

    Enter the port number (port:443 preferred): 8080
Generating fingerprint...
Fingerprint: v3.lls.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Fingerprint generated successfully.
    Note:

    • The fingerprint is automatically generated based on the port entered during installation.

    • Fingerprint details are displayed in the console and also saved to installer.txt.

    • It is recommended to copy the full fingerprint along with the prefix v3.lls for license activation.

      Example:

      Enter the port number (port:443 preferred): 8080

    Important:

    • The MAC address used for fingerprint generation is automatically selected from the available network interfaces at the time of installation.

    • If a temporary or unstable network adapter (such as Wi-Fi that may be disabled, disconnected, or removed later) is used, it can lead to fingerprint mismatch errors during license activation or future validations.

    • To avoid issues, ensure that a stable and permanent network interface (typically a wired Ethernet adapter) is active during fingerprint creation.

    A confirmation message is displayed:

    [SC] CreateService SUCCESS
[SC] ChangeServiceConfig2 SUCCESS
The HCL Local License Server 5.3.0 service is starting.
The HCL Local License Server 5.3.0 service was started successfully.
  7. TLS certificate expiry details are displayed in the console and saved to hcl_lls_features.log: 
    2025/11/06 10:47:11 TLS certificate [Self-Signed, PEM] is valid. Expiry date: 2025-11-07 12:27:17 +0000 UTC

  8. Press any key to terminate the install program.

    LLS has been successfully installed on your system.

    TLS expiry information is also logged in: <lls_install_directory>/logs/hcl_lls_features.log

  9. Generate your license file, See Post-installation : Generating the license file. Place the generated license file in the: <lls_install_directory>/license

    Note:
    License file management is independent of the LLS installation. You can add or remove license files anytime. Any update in the license folder is logged automatically in <lls_install_directory>/logs/hcl_lls_features.log.

What to do next

  • Pool ID: from <installed_directory>/logs/hcl_lls_pools.log or API endpoint: https://FQDNhostname:LLSport/v1/licensepools
  • For configuring your specific HCL product to point to the newly installed LLS, please refer to the licensing configuration section within your respective HCL product documentation.