Upgrade Apache Tomcat on an Existing ThingWorx Navigate Installation

Follow the steps in this topic to upgrade Apache Tomcat on an existing ThingWorx Navigate installation.

◦ <Tomcat Home>\webapps\Thingworx.war

◦ <Tomcat Home>\conf\server.xml

◦ <Tomcat Home>\conf\web.xml

◦ <Tomcat Home>\bin\setenv.bat

◦ <Tomcat Home>\conf\sslkeystore.jks (if Tomcat is configured using SSL)

◦ (Optional) ThingworxPlatform and ThingworxStorage folders located in the ThingWorx installation directory.

◦ If you installed ThingWorx with an MSSQL database, back up <Tomcat Home>\lib\mssql-jdbc-<version>.jre8.

◦ If your ThingWorx is configured to use Windchill as the IDP, back up <Tomcat Home>\webapps\Thingworx\WEB-INF\web.xml and <Tomcat-Home>\webapps\Thingworx\WEB-INF\lib\ptc-identity-provider-authentication-filter-<version>.jar

3. Perform one of the following actions based on your installation type:

◦ If you installed ThingWorx Navigate using the installer, delete the contents of the <Navigate-Install>/tomcat/apache-tomcat-8.5.23/*.* tomcat folder. Also, note the installer service name (for instance, "ThingWorx-Foundation") and then delete the service. You will need this name later during the installation.

◦ If you installed ThingWorx Navigate manually, uninstall Apache Tomcat.

4. Download the required Apache Tomcat version using the 32-bit/64-bit installer.

◦ Ensure that the installed ThingWorx Platform version supports the Apache Tomcat version you want to install. To check compatibility information, search for the System Requirements document for the applicable ThingWorx Platform version at PTC Reference Documents.

◦ If you installed ThingWorx Navigate using the installer:

▪ Install the new Tomcat in the tomcat folder of the installation directory. Path: <navigate-installation>/tomcat/apache-tomcat-{version}.

▪ Name the Tomcat service as "ThingWorx-Foundation" (same name as the service you deleted in step 3). This helps ensure that the ThingWorx Navigate Configurator works as expected after the Tomcat upgrade.

◦ Refer to the setenv.bat file for the locations of Tomcat install and JAVA.

◦ Instructions for installing Apache Tomcat are available in the Installing ThingWorx section of the ThingWorx Platform 8 Help Center. For locating the Installing ThingWorx guide for any other ThingWorx Platform versions, visit the PTC Reference Documents page.

▪ You can ignore the JAVA install instructions in the document since JAVA would be already installed within a ThingWorx Navigate installation.

▪ Make sure you update the owner permissions of the tomcat folder based on the ThingWorx Navigate installed before the manual installation of Apache Tomcat.

6. After completing the installation and setup of Apache Tomcat, place the copied Thingworx.war file (as instructed in step 2) in the <Tomcat Home>webapps folder.

7. If a non-standard path is used for the ThingworxPlatform folder, update the system environment variable for THINGWORX_PLATFORM_SETTINGS, if it is affected by the Apache Tomcat upgrade.

8. Update the PATH variable at <Tomcat Home>\webapps with the Tomcat location.

9. If you made any changes in the configuration files (web.xml, server.xml), paste these files (copied in step 2) in their respective locations of the new installation.

10. If your existing Tomcat was configured using SSL and you copied server.xml before upgrading (as instructed in step 2), perform either of the following actions:

◦ Copy the sslkeystore.jks file from the existing Tomcat configuration folder to the new installation.

◦ Update the path to the correct sslkeystore.jks location in server.xml.

11. If your ThingWorx Navigate is configured with Windchill authentication, place the web.xml and ptc-identity-provider-authentication-filter-<version>.jar files back in their respective locations.

You have successfully upgraded ThingWorx Navigate. Time to get started using the new version.

If ThingWorx Composer is not accessible and a 500 error occurs after the update, see CS315394.