Installing HCL Local License Server

After you finish the pre-installation task, you can begin the installation of HCL Local License Server (LLS). You can then manage the licenses of HCLSoftware products.

Before you begin

You must have the information such as the path to a TLS certificate and TLS key.

About this task

Note:
You can install only one instance of LLS.

Procedure

  1. Go to the directory where the installer package is located.

    For Windows

    Name: install.bat

    <unzipped-installer-files>\hcl-lls-5.2-windows\Application\Windows\install.bat

    For Linux

    Name: install.sh

    Location:<unzipped-installer-files>/hcl-lls-5.2-linux/install.sh

    Example: <unzipped-installer-files> refers to the directory created after extracting the LLS installer package

  2. From the command-line, run the install program:
    • On Windows, run the install.bat file as an administrator.
    • On Linux, enter the following commands with root privileges:
      chmod +x install.sh
      ./install.sh
  3. Specify the configuration information as the install program prompts you.
    Enter the Installation Directory:
    Specify the installation directory for the LLS for Windows OS.
    Note:
    In the Linux operating system, the "installation directory" is not prompted and LLS will be installed in /opt/hcl-lls-5.2
    Note:
    For Windows, it is recommended not to install server applications in the user specific directories and system directories like C:\Program Files, C:\Windows, C:\Program Files (x86). To avoid permission issues, install the application in a non-system directory such as: C:\HCL_LLS5.2.
    A license folder is created in the installation folder for you to place the license files post-installation. It is not mandatory to add license files during installation.
    Enter the TLS certificate:
    Specify the path of the certificate file generated by the utility program or a third-party generated TLS certificate. For example, path_to_certificateFilename.crt.
    Note:
    The best practice for using a valid TLS certificate is by keeping a record of your TLS certificate expiry dates and update the certificates before they expire for an uninterrupted communication. LLS does not provide any notification on expired or expiring TLS certificates.
    Consider the following points if you are using a third-party TLS certificate:
    • The PEM format with the .crt extension is the valid certificate format.
    • The chain of certificates must be in the order: server certificate, intermediate certificate, and root certificate.
    Enter the TLS key:
    Type the path of a valid certificate key file. For example, path_to_certificateKeyFilename.key.
    Note:
    If the private key is encrypted, you can enter the passcode.
    Enter the port (port:443 preferred):
    Type the port number on which you want to run LLS. 443 is the preferred port number or you can specify a number between 1024 and 65535.
    Note:
    Fingerprint will be automatically generated with the port entered and fingerprint details are displayed in the console and also saved to installer.txt. We recommend to copy fingerprint details along with the prefix v3.lls
    Enter the port number (port:443 preferred):8080 

Generating fingerprint...
Fingerprint: v3.lls.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Fingerprint generated successfully.
    The above example message is displayed indicating that the fingerprint generation is complete.
    A confirmation message is displayed.
    Service started successfully.
  4. TLS certificate expiry details are displayed in the console and also saved to hcl_lls_features.log, 
    2025/05/26 00:33:37 TLS certificate is valid. Expiry date: 2026-05-16 11:09:27 +0000 UTC
  5. Press any key to terminate the install program.
    You have installed LLS on your system.
  6. Generate the license file by following the Post-installation : Generating the license file, and then add your license file to the license folder.
    The license folder is located at the <lls_install_directory>/license path.
    Note:
    The license file updation is independent of the LLS install program. After you install LLS, you can any time add or remove your license files in the license folder. Any changes in the license folder is logged in the <lls_install_directory>/logs/hcl_lls_features.log file.

What to do next

Verify your server installation, see Verifying HCL Local License Server installation. Additionally, you can get the:
  • Pool ID from the installed_directory/logs/hcl_lls_pools.log file or by using the following API endpoint: 
    https://FQDNhostname:LLSport/v1/licensepools
  • LLS URL from the hcl_lls_feature.log file to configure your product license information.