Version Upgrade Behavior

On Windows, an existing HCL Local License Server (LLS) installation can be upgraded to a later version, and the licenses, logs, TLS certificate, and port are retained. On Linux, upgrading from an earlier version to 5.3.0 is not supported.

Windows

Important:

Only one LLS instance should be present on the host before an upgrade. If more than one version is present on the same machine, uninstall the versions that are no longer needed before running the installer.

Version upgrade is supported on Windows. If an earlier version is already installed, the installer detects it and offers to upgrade:

Detected installed service: HCL Local License Server 5.2
Installed version: [5.2]
Existing installation directory: "C:\LLS_Directory"
Do you want to upgrade to 5.3.0? (Y/N): Y

If the upgrade continues, the installer then asks whether to install in the same directory:

Upgrade in the same directory (C:\LLS_Directory)? (Y to use same, N to customize):
  • Type Y to upgrade in the existing directory.
  • Type N to specify a different installation directory.

In both cases a backup of the earlier version is created in the backup directory and restored into the new version automatically, so the license files, logs, TLS certificate, and port setting carry over. The installer does not prompt for the certificate, key, or port. For details of what is preserved and where the backup is stored, see Backup and Restore.

Note:

No confirmation is requested for restoring the backup during a version upgrade. The backup is always restored as part of the version upgrade behavior.

Linux

Upgrading from an earlier version to 5.3.0 is not supported on Linux.

The earlier version must be uninstalled before 5.3.0 is installed. Installing over an existing earlier version may not complete correctly, and the licenses and TLS certificate might not be carried over.

To move to 5.3.0 on Linux:

  1. Copy the license files and the TLS certificate and key from the existing installation directory to a safe location.
  2. Uninstall the earlier version by running the uninstall.sh file from its installation directory.
  3. Remove the earlier installation directory if it still exists, for example /opt/hcl-lls-5.2 or /opt/hcl-lls-5.1.
  4. Install 5.3.0. See First Time Installation (No Previous LLS Detected).

Starting with 5.3.0, LLS always installs into /opt/hcl-lls on Linux. The installer does not prompt for an installation directory.

Installing an earlier or identical version

The installer does not install a version that is the same as, or earlier than, the version already installed. A message similar to the following is displayed and the installation stops:

You already have a higher or the same version [5.3.0] installed. If you still wish to
downgrade to [5.2], we recommend uninstalling the existing version manually by running
the uninstall script from the existing installation directory and then try installing again.

To install an earlier version, uninstall the current version first by running the uninstall.bat/sh file from its installation directory, and then run the installer for the required version.

Note:

Running the uninstall.bat/sh file creates a backup, so the installer for the earlier version detects it and displays a prompt to restore the licenses, logs, certificate, and port. See Backup and Restore.