Upgrading an Existing Installation to Version 5.4

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

This procedure applies to native installations. The supported source versions depend on the operating system:

  • On Windows, you can upgrade from 5.0, 5.1, 5.2, or 5.3, including their patch releases.
  • On Linux, you can upgrade from 5.3 and its patch releases, such as 5.3.1. Versions earlier than 5.3 must be uninstalled first, because they are not installed in /opt/hcl-lls, which is the directory the installer upgrades. See Version Upgrade Behavior.
Attention:

On Linux, do not run the 5.4 installer over a version earlier than 5.3. The installer may detect the old service by name and offer to upgrade, but the two are not compatible and the installation malfunctions. Uninstall the earlier version first, as described in Version Upgrade Behavior.

Important:

A Docker deployment cannot be upgraded in place. Perform a new installation instead. See First Time Installation.

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.4.0 package to a directory on the host machine.

    For Windows

    Name: install.bat

    Location: <unzipped-installer-package>\install.bat

    For Linux

    Name: install.sh

    Location: <unzipped-installer-package>/install.sh

  2. Go to the extracted directory and run the install.bat/sh file.
    • On Windows, run the install.bat file as an administrator.
    • On Linux, enter the following commands with root privileges:
      chmod +x install.sh
      ./install.sh
  3. Confirm the upgrade when you are prompted.

    The installer displays the version it detected and asks whether to upgrade. On Windows:

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

    On Linux:

    Detected installed service: HCL-Local-License-Server-5.3.0
Installed version: [5.3.0]
Existing installation directory: "/opt/hcl-lls"
Do you want to upgrade to 5.4.0? (Y/N): Y

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

  4. On Windows, choose the installation directory. 
    Upgrade in the same directory (C:\LLS_Directory)? (Y to use same, N to customize):
    • Type Y to install 5.4.0 in the existing directory.
    • Type N to enter a different installation directory.
    Note:

    This step does not apply to Linux. On Linux, HCL Local License Server always installs into /opt/hcl-lls and you are not prompted for a 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 and restored into the new installation automatically. HCL Local License Server 5.4.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.

The backup directory is C:\HCL-LLS-Backup on Windows and /opt/HCL-LLS-Backup on Linux.

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 a Windows Server native installation, 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.