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,
• and 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 <INSTALL>/tomcat/LicenseServer/conf/ file directory contains configurations for License Server.
• The PSTSecConfig.xml file located in the <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 will 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.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.
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 back up directories to their original locations and restart Tomcat.