Upgrading Apache Tomcat to the latest version available with OM Web Viewer 12.1

Products

• Output Management Web Viewer

Issue/Introduction

Apache Tomcat was installed on the server as part of the full install of the product.
We are currently running an early version of Tomcat. After downloading the latest version of Tomcat from the website, are there any issues when upgrading from an earlier Tomcat?

Environment

• Output Management Web Viewer 12.1
• Apache Tomcat®

Resolution

Check the following before updating Tomcat.

Note: If you are upgrading from earlier version of Tomcat 9, this was already done.

1. A JDK is required to install the Tomcat 9 service (not the case with Tomcat 8 or 7).
2. Verify that Java is set correctly in the System Environment variables and System path (Windows)

Checking the following immediately after updating your Web Viewer distributed Tomcat to version 9, will help you to avoid the handful of issues reported.

1. Check the server.xml file to insure that the secured connector protocol is the http11.nio2 protocol.  (If running secured)
2. Service.bat requires classloader in JVM options.
   set "CLASSPATH=%CATALINA_HOME%\bin\bootstrap.jar" 
   

------------------------------------------------------------------------------------------

After Installion

This section applies only if running Web Viewer on Windows.

1. 
2. Click on the Java tab to increase the heap size
3. The recommended maximum memory pool (-Xmx) is at least 4096 MB (4 GB), though 8192 MB (8 GB) is optimal for high-volume environments.  
4. Click Apply OK
5. Copy the server.xml file from the conf directory of the previous Tomcat installation to the new Tomcat 9 conf directory.
6. Click on the Log On tab  to make sure the Tomcat Services Properties under the  was changed from "This account" to "Local System account" after WAR files are re-deployed.
7. Go to Control Panel->All Control Panel Items->Administrative Tools->Services
8. Right Click on Apache Tomcat and the properties box will come up
9. Click on the down arrow next to Startup Type and select automatic
10. Click on Start under Service Startup
11. Click Apply, OK