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.

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.

The update.bat/sh file also supports changing the TLS mode (BASIC, SECURED, or MODERN).

Procedure

  1. Go to the installation directory, where the update.bat/sh file is located.

    For Windows

    Name: update.bat

    Location: <lls_install_directory>\update.bat

    For Linux

    Name: update.sh

    Location: /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.bat/sh file 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
  4. Press 1 to update the TLS certificate.

    • Provide the path to a new valid TLS certificate — either self-signed (generated using the utility.bat/sh file) 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.log.

  5. Press 2 to update the port.
    • Modify the LLS port number. After the update, a new fingerprint is generated automatically 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 updates during maintenance/downtime, as it can affect active license checkouts.

  6. Press 3 to update both the TLS certificate and the 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.

  7. Press 4 to quit and apply the updates.

    • 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.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.