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 utility provided in the installer package.

About this task

Configuration of LLS is optional.

Perform configuration only if you need to modify:

  • The existing TLS certificate, or

  • The port number used by LLS.

Configuration also supports updating the TLS mode (BASIC / SECURED / MODERN) directly through the update utility.

Procedure

  1. Navigate to the Installation Directory. Go to the directory where the update utility is located.
    OS File Name Location
    Windows update.bat <lls_install_directory>\update.bat
    Linux update.sh /opt/hcl-lls/update.sh
    Note:
    <lls_install_directory> refers to the directory that was specified during the LLS installation process.
  2. Run the Update Program
    • On Windows: Run the update.bat file as an administrator:
    • On Linux: Enter the following commands with root privileges:
      chmod +x update.sh
      ./update.sh
  3. Follow the Prompts on Screen, When the update utility starts, the following menu is displayed:
    Select the parameter you want to update:
    1. TLS Certificate
    2. Port
    3. Update Both TLS and Port
    4. Quit and Update
    5. Press any key to exit
    Press 1 to Update TLS Certificate

    • Provide the path to a new valid TLS certificate — either self-signed (generated using tlsutil) or third-party CA-signed.

    • The system copies all new certificate files to the installed location.

    Note:
    The new certificate path and validity details are automatically logged in
    
<lls_install_directory>/logs/hcl_lls_features.log

    Press 2 to Update Port

    • Modify the LLS port number.

      After update, a new fingerprint will be automatically generated and displayed:
       v3.lls.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    • The fingerprint details are saved in the 
      installer.txt
      file.
    Note:

    • Changing the port invalidates existing license files.

    • You must re-generate license files from My HCLSoftware (MHS) using the new fingerprint.

    • Perform port modifications and TLS certificate updates during designated maintenance/downtime windows, as these actions restart the server service and can affect active license checkouts.

    Press 3 to Update Both TLS and Port

    • Update both TLS certificate and port in a single operation.

    • The system will sequentially prompt for certificate and port inputs, then restart the LLS service after applying changes.

    Press 4 to Apply and Exit

    • Quit and Apply Updates to save changes.

    • The system applies all modifications and automatically restarts the LLS service.

Results

A confirmation message appears:

Service started successfully.
Note:

All configuration updates (certificate, port) are recorded in the log file:

 <lls_install_directory>/logs/hcl_lls_features.log

You have now successfully reconfigured HCL Local License Server (LLS 5.3) with the latest updates.

Note:

TLS certificates cannot be renewed or extended after expiration. If a TLS certificate has expired, you must regenerate it by following the steps outlined in Generating a Self-Signed TLS Certificate.