Upgrading an Existing Installation to Version 5.3

On Windows, if an earlier version of HCL Local License Server is already installed, the installer detects it and offers to upgrade. The licenses, logs, TLS certificate, and port are carried over to the new version.

Before you begin

Important:

This procedure applies to Windows only. Upgrading from an earlier version to 5.3.0 is not supported on Linux — uninstall the earlier version first. See Version Upgrade Behavior.

Only one HCL Local License Server 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 first.

Procedure

  1. Extract the HCL Local License Server 5.3.0 package to a directory on the host machine.

    For Windows

    Name: install.bat

    Location: <unzipped-installer-files>\hcl-lls-5.3.0-windows\install.bat

  2. Go to the extracted directory and run the install.bat file as an administrator.
  3. Confirm the upgrade when you are prompted.

    The installer displays the version it detected and asks whether 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

    Type Y to continue, or N to cancel the upgrade.

  4. Choose the installation directory. 
    Upgrade in the same directory (C:\LLS_Directory)? (Y to use same, N to customize):
    • Type Y to install 5.3.0 in the existing directory.
    • Type N to enter a different installation directory.
    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, whichever directory you choose.

Results

A backup of the earlier version is created in the backup directory (C:\HCL-LLS-Backup) and restored into the new installation automatically. HCL Local License Server 5.3.0 is installed with the license files, logs, TLS certificate, and port setting from the previous version applied to it. The installer does not prompt for the certificate, key, or port.

Note:

A fingerprint is generated during the upgrade. It is unchanged only if both the network adapter used to generate it and the port number are the same as before. If either has changed, a new license file must be generated from My HCLSoftware using the new fingerprint. See Post-installation: Generating the license file.

Important:

On Windows Server, run the following command as an administrator after the version upgrade, and then restart the service, so that the log files continue to be updated.

icacls "<lls_install_directory>" /grant "*S-1-5-19:(OI)(CI)M" /T

For more information, see Troubleshooting.

For details of what is preserved and where it is stored, see Backup and Restore.