Uninstalling HCL Local License Server

When you no longer require HCL Local License Server (LLS) on your system, you can remove it by running the uninstall.bat/sh file located in the installation directory.

About this task

Important:

On Linux, change to the LLS installation directory before you run the uninstall.sh file. A backup of the license files, logs, TLS certificate, and port is taken from the directory the file is run from, so running it from any other location produces an empty backup. See Backup and Restore.

Procedure

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

    For Windows

    Name: uninstall.bat

    Location: <lls_install_directory>\uninstall.bat

    For Linux

    Name: uninstall.sh

    Location: /opt/hcl-lls/uninstall.sh for a native installation, or /opt/hcl-lls-docker/uninstall.sh for a Docker deployment.

    Note:
    <lls_install_directory> refers to the directory that was specified during the LLS installation process. On Linux, LLS always installs into /opt/hcl-lls.
  2. Run the uninstall.bat/sh file.
    • On Windows, run the uninstall.bat file as an administrator.
    • On Linux, enter the following commands with root privileges:
      chmod +x uninstall.sh
      ./uninstall.sh
  3. Confirm the uninstallation.
    • When prompted, type Y to start the uninstallation process.
    • The program stops the LLS service, backs up the license files, logs, TLS certificate, and port, and then removes the installation files.

    On Windows, the prompt is similar to the following:

    Note: Please make sure to run the "uninstall.bat" file from the LLS installation directory.
    Are you sure you want to uninstall HCL Local License Server from this directory? This action cannot be undone.
    Type Y for Yes or N for No: Y

    On Linux, the prompt is similar to the following:

    Note: Please make sure to run the 'uninstall.sh' file from the LLS installation directory.
    Are you sure you want to uninstall HCL-Local-License-Server-5.4.0 from /opt/hcl-lls? (y/n): y

    When the process finishes, the following message is displayed:

    Uninstall and backup complete.

Results

The uninstall.bat/sh file:

  • Stops the LLS service and removes the associated system service entry.
  • Backs up the license files, logs, TLS certificate, and port setting.
  • Deletes the files in the installation directory.

HCL Local License Server 5.4.0 is now removed from the host machine.

Note:

On a native installation, the license files, logs, and TLS certificate are not lost. They are retained in the backup directory and can be restored during the next installation. See Backup and Restore.

Important:

For a Docker deployment, uninstalling also removes the hcl-lls-server container and the hcl-lls:5.4.0 image. Backup and restore does not apply to a Docker deployment: the installation directory and everything in it is deleted. Before you uninstall, copy the license files from the licenses folder and the TLS certificate and key from the certs folder to another location. The database and logs folders cannot be carried over to a new deployment.

What to do next

Verify that no LLS services remain active:

  • On Windows, open Windows Services (services.msc) and confirm that HCL Local License Server is no longer listed.
  • On Linux, run the following command:
    systemctl list-units | grep HCL-Local-License-Server
  • For a Docker deployment, run the following command and confirm that hcl-lls-server is not listed:
    docker ps -a

If the installation directory was not completely removed, delete any remaining folders manually, for example /opt/hcl-lls or C:\HCL_LLS5.4.