In this section:

Introduction

License Server is available as a self-deployed distribution or as a web archive that can be deployed to your Tomcat server (see Installing License Server). 

About License Server 5.4.3 and Older

All files for License Server 5.4.3 and older were installed in a single directory, but the current version of License Server installs into two main directories:

• The application directory that contains binaries, the web server, and other files
• A data directory that contains configuration files and data

In this documentation, <LS_INSTALL> refers to the application directory location and <LS_DATA_DIR> refers to the data directory location for both operating systems. 

User Administration Configuration File

License Server includes the PSTSecConfig.xml file, which contains configuration settings for the User Administration module. 

License Server 2020.1 and later ships with a single PSTSecConfig.xml in the <LS_DATA_DIR>/conf directory.

License Server 5.4.3 and older ships with two instances of the PSTSecConfig.xml file:

• The PSTSecConfig.xml file located in the <LS_INSTALL>/tomcat/LicenseServer/conf/ file directory contains configurations for License Server.
• The PSTSecConfig.xml file located in the <LS_INSTALL>/tomcat/webapps/pstsec/conf file directory contains configurations for User Administration (pstsec).

If you made changes to either or both PSTSecConfig.xml files for License Server 5.4.3 or older, you need to make corresponding changes in the single PSTSecConfig.xml file after upgrading.

Upgrading the Self-deployed Distribution

This topic describes upgrading the self-deployed License Server that ships with its own Tomcat server.

Windows

1. Run the stopLS.bat script as an administrator for the License Server you are upgrading from.
2. Unzip the latest License Server to a temporary directory.
3. Open a command prompt and navigate to the <LS_TEMP>/app directory.

4. Run the upgrade.bat script as an administrator with the -o option and specify the path to the old version of License Server:

   upgrade.bat -o <absolute_path_to_old_LS_install_dir>

   You can also run the script with the -h option to print the script help to the console.

5. The script makes a backup of the existing installation and updates the old installation location with the latest version.
6. Delete the temporary directory (step 2).

Linux

1. Run the stopLS.sh script as an administrator for the License Server you are upgrading from.
2. Unzip the latest License Server to a temporary directory.
3. Open a command prompt and navigate to the <LS_TEMP>/app directory.

4. Run the upgrade.sh script as an administrator with the -o option and specify the path to the old version of License Server:

    ./upgrade.sh -o <absolute_path_to_old_LS_install_dir>

   You can also run the script with the -h option to print the script help to the console.

5. The script makes a backup of the existing installation and updates the old installation location with the latest version.

Upgrading Web Archive Distribution 

This topic describes how to upgrade the licenseserver.war and pstsec.war files.  

1. Stop the Tomcat server and create a backup of the following directories:
   • <TOMCAT>/LicenseServer
   • <TOMCAT>/webapps/pstsec/pstsec
   • <TOMCAT>/webapps/pstsec/conf
2. Delete the following items from <TOMCAT>/webapps directory:
   • licenseserver.war file
   • pstsec.war file
   • licenseserver subdirectory
   • pstsec subdirectory
3. Delete the following directories:
   • <TOMCAT>/work/Catalina/localhost/licenseserver
   • <TOMCAT>/work/Catalina/localhost/pstsec
4. Copy the new licenseserver.war and pstsec.war files into the <TOMCAT>/webapps directory and start Tomcat.
5. Stop Tomcat after the applications have finished deploying.
6. Copy the webapps/pstsec/pstsec and webapps/pstsec/conf backup directories to their original locations and restart Tomcat.

Upgrading License Server in Docker

The process for upgrading your License Server in Docker is described below. You will need to back up your current License Server data directory and run the new container using the same volumes that your old container did. More information about the volumes used when the License Server container was created can be found here: Deploying License Server in Docker.

1. Back up your License Server data directory.
2. Download the latest License Server container image from Docker Hub: https://hub.docker.com/r/parasoft/lss.

3. Stop your current License Server container.

   docker stop <name-of-container>

4. Using the License Server image downloaded in Step 2, run a new container with the same configuration that your old container.
   • If you want to keep the old License Server container, make sure the new container has a different name or it will not start.

Post-Upgrade Steps

After an upgrade, you might need to manually recreate certain configurations previously made in the setVars.sh / setVars.bat file located in the <LSS_INSTALL>/app/ directory. Configurations you might have made include:

• Configuring License Server to be FIPS-compliant
• Authenticating via JWT Access Token for OAuth 2.0

You might also need to manually restore configurations you made previously if you are using a custom keystore file and its path is not <LSS_INSTALL>/app/tomcat/conf/.keystore.