Upgrade the License Server

This document describes the generic procedure for the upgrade of Semarchy xDI License Server.

Pre-Upgrade Steps

This section describes the operations to perform before upgrading Semarchy xDI License Server.

Review the Release Notes

The Release Notes provides the latest information about the Semarchy xDI Release, including new features, bug fixes and breaking changes.

System Requirements

Review the system requirements for this release.

Stop the License Server

Stop the current installation of the License Server. If it is run as a service, make sure the service does not restart automatically.

Prepare the spring-context.xml File

The License Server uses the spring-context.xml file under the ./conf folder to provide specific configurations. You must configure the new file and adapt it to your previous configuration (See Configure the License Server).

The spring-context.xml file is mandatory since version 5.3.6. If you upgrade from a previous version that did not require this file, make sure to configure it while upgrading. See Configure the License Server

If you upgrade from a License Server 1.x release to the License Server 5.3, you must modify the content of the previous spring-context.xml to follow the renaming of plugins introduced in the 5.3 version:

  1. Create a local copy of the spring-context.xml.

  2. Replace all occurrences of com.stambia.licence with com.semarchy.licence.server in this file.

  3. Use the modified file for the new installation.

Retrieve a new License File

When you upgrade from a License Server 1.x release to the License Server 5.3, you need a new compatible license file.

Semarchy can provide you the new license file to deploy in your license server. You can reach your usual contact to obtain this new file.

Retrieve a new License Key

The License Server 5.3 supports serving licenses for:

  • Semarchy xDI Designer 5.3

  • Semarchy xDI Designer versions prior to 5.3

The license key to enter inside Semarchy xDI Designer depends on the Designer version. Make sure to provide the proper license key to the Designer users depending on the version they are using.

Semarchy can provide you the correct license keys to enter in Semarchy xDI Designer depending on the versions. You can reach your usual contact to get them.

Upgrade Steps

Perform the following operations to download and install the new version of Semarchy xDI License Server:

  1. Download the new version of Semarchy xDI License Server from the Semarchy website.

  2. Uncompress the downloaded file and move the archive content to the target installation folder, which must be different from the previous version’s installation folder.

  3. Configure the spring-context.xml file and adapt it to your previous configuration (see Prepare the spring-context.xml File).

  4. Copy the license file to the new installation folder.

  5. Start the License Server: refer to Start the License Server or, if the server is run as a service, refer to License Server as a Service.

Post-Upgrade Steps

Once you have verified the License Server is running properly and is successfully accessed by the Designer, perform the following operations:

  1. Remove the previous installation folder.

  2. Remove the service running the previous version of the License Server (if applicable).