License Server ships with a fixed instance of Tomcat server that is used to run the applications included with License Server. The version of Tomcat that ships with License Server is the only one that has been verified to work with it, but if you need to upgrade the Tomcat server and cannot wait until for the next License Server release, the following instructions are provided as guidance. This should be done to upgrade Tomcat only; do not attempt to downgrade Tomcat. The procedure below has some Linux-specific details, but it applies generally to any OS.

We cannot verify that any given version of License Server will function as expected with any version of Tomcat other than the one with which it was shipped. This procedure is provided for reference only; upgrading your Tomcat server on your own is not recommended.

To upgrade your Tomcat server:

  1. Stop License Server.

  2. Download the Tomcat version to which you wish to upgrade (for example, apache-tomcat-<VERSION>.tar.gz) to <DOWNLOAD_DIR> and unarchive the .gz file:

    tar -xvzf apache-tomcat-<VERSION>.tar.gz

  3. Rename the directory to tomcat:

    mv apache-tomcat-<VERSION> tomcat

  4. Delete web apps shipped with Tomcat:

    cd tomcat/webapps
rm -rf *

  5. Make copies of the following configuration files and save them outside <LSS_INSTALL>/app:

    • server.xml in <LSS_INSTALL>/app/tomcat/conf/

    • catalina.properties in <LSS_INSTALL>/app/tomcat/conf/

    • (Optional) Your keystore file if you are using a file other than the .keystore file shipped with License Server in the <LSS_INSTALL>/app/tomcat/conf/ directory

  6. Copy the new tomcat directory into the <LSS_INSTALL>/app directory. This will upgrade Tomcat shipped with License Server:

    cp -rfv download_dir/tomcat/ <LSS_INSTALL>/app > cp.txt

  7. Verify that copy command has executed successfully by checking the cp.txt file

  8. If there are multiple versions of ecj-<VERSION>.jar libraries, remove the existing ecj-<VERSION>.jar library that is no longer needed:

    rm <LSS_INSTALL>/app/tomcat/lib/ecj-<VERSION>.jar

  9. Copy the configuration files you saved from the original <LSS_INSTALL>/app/tomcat/conf/ directory (step 5) into the new <LSS_INSTALL>/app/tomcat/conf/ directory:

    cp server.xml <LSS_INSTALL>/app/tomcat/conf/
cp catalina.properties <LSS_INSTALL>/app/tomcat/conf/
cp <YOUR_KEYSTORE_FILE> <LSS_INSTALL>/app/tomcat/conf/.keystore

  10. Start License Server.

  • No labels

Need assistance? Visit our support page