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 and key, or

  • The port number used by LLS.

The update.bat/sh file works the same way for a native installation and a Docker deployment.

To change the TLS mode or the log settings, edit the config.json file instead. See TLS Security Configuration and Log Configuration.

Procedure

  1. Go to the installation directory, where the update.bat/sh file is located.
    Deployment Name Location
    Windows, native update.bat <lls_install_directory>\update.bat
    Windows, Docker update.bat <lls_install_directory>\update.bat
    Linux, native update.sh /opt/hcl-lls/update.sh
    Linux, Docker update.sh /opt/hcl-lls-docker/update.sh
    Note:
    <lls_install_directory> refers to the directory that was specified during the LLS installation process.
  2. Run the update.bat/sh file.
    • 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 and Key
2. Port
3. Update Both TLS Certificate/Key and Port
4. Quit and Update
  4. Press 1 to update the TLS certificate and key.

    • Enter the path to a new valid TLS certificate (.crt file), either self-signed (generated using the utility.bat/sh file) or third-party CA-signed.

    • Enter the path to the new TLS key (.key file). If the key is encrypted, enter the decryption password when prompted.

    • The new certificate files are copied to the installed location and the service is restarted.

    Note:

    The new certificate path and validity details are logged in <lls_install_directory>\logs\hcl_lls.log, and the certificate status is recorded in installer.txt.

  5. Press 2 to update the port.

    Enter the new port number. The file verifies that the port is not already in use. After the update, a new fingerprint is generated automatically and displayed:

    v3.lls.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

    For a Docker deployment, the fingerprint uses the v3.lls.uid. prefix.

    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. See Post-installation: Generating the license file.

    • Perform port updates during maintenance or downtime, as they can affect active license checkouts.

  6. Press 3 to update both the TLS certificate and key and the port.

    You are prompted for the certificate, key, and port in sequence. The LLS service is restarted after the changes are applied.

  7. Press 4 to quit and apply the updates.

    All modifications are applied and the LLS service is restarted automatically.

Results

A confirmation message appears:

Service started successfully.

You have now reconfigured HCL Local License Server (LLS) 5.4.

Note:

All configuration updates are recorded in <lls_install_directory>\logs\hcl_lls.log.

Note:

TLS certificates cannot be renewed or extended after expiration. If a TLS certificate has expired, you must regenerate it. See Generating a self-signed TLS certificate.