Upgrade the Tricentis License Server

This chapter contains information on how to upgrade to Tricentis License Server version 5.0.

Upgrade to version 5.0

  1. Create a backup of your trusted storage in case you run into issues during the upgrade.

  2. Create a backup of the LicenseUsageStatistics.exe.config file in <your installation directory>/License Usage Tracking. This is only necessary if you have changed values or added custom values to the file.

    When you uninstall the Tricentis License Server, the system automatically deletes the file. If you create a backup, you can populate the new file with the values from your backup after you install the new server.

  3. If you intend to install the new license server on a different machine than the old license server, deactivate your licenses from the old machine.

  4. Download the setup file Tricentis License Server<version number>.msi from the Tricentis Support Hub.

  5. Uninstall the old license server.

  6. Optionally, upgrade Oracle Java Runtime Environment or OpenJDK (64-bit) to version 11.

  7. Execute the setup file of the new license server and follow the installation process described in chapter "Install an on-premise license server".

  8. Populate the LicenseUsageStatistics.dll.config file with the custom values from your backup of the LicenseUsageStatistics.exe.config file. Don't replace the new file with your backup or overwrite the entire content of the new file. You might accidentally delete new settings and break the installation.

  9. If you installed the new Tricentis License Server on a different machine than the old license server, activate your licenses on the new machine:

Changed functionality

This section explains changed functionality of Tricentis License Server, compared to previous versions.

Name change of the License Usage Statistics configuration file

With version 4.1, we have renamed the LicenseUsageStatistics.exe.config file to LicenseUsageStatistics.dll.config. You can find the file in the License Usage Tracking folder in your installation directory.

License Usage Tracking: Elasticsearch custom settings

If you upgrade to Tricentis License Server 4.0 or later and include License Usage Tracking during the setup, you need to manually re-enter any previously created custom entries in the elasticsearch.yml settings file. To simplify this process, use the automatically created elasticsearch.yml.<Timestamp>.bak backup file at C:\Windows\ServiceProfiles\NetworkService\TRICENTIS\TricentisLicenseUsageStatistics\Elasticsearch\config as a reference.

Only use the backup file for reference; do not replace the current settings file with the backup file.

Configure the Java Runtime Environment

As of version 2.0.0, the Tricentis License Server setup no longer contains Java Runtime Environment.

To configure the Java Runtime Environment, follow the steps below:

  1. Install Oracle Java Runtime Environment or OpenJDK (64-bit) version 8 or 11 (recommended).

  2. Create a system environment variable named JAVA_HOME that refers to the Java installation directory. If you already have a user environment variable named JAVA_HOME, make sure that it refers to the same Java installation directory.

The path to the Java installation directory must not be wrapped in quotation marks. For example:

C:\Program Files\Java\jre1.8.0_211

"C:\Program Files\Java\jre1.8.0_211"