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 Tomcat version 8.5.32. 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.

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.0.91, 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" 
   

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

This section applies only if running Web Viewer on Windows,

The service must run as a Local System Account. Because the JDK is required with Tomcat 9
Use Tomcat9w and select the browse ... to point to the jvm.dll
Click on the Java tab to increase the heap size
Reminder here: run startup.bat as admin.

3.     Make sure the Tomcat Services Properties under the Log On tab was changed from "This account" to "Local System account" after WAR files are re-deployed.

4.     Follow the instructions below to remove the Tomcat8 Service (for example) and Install the Tomcat9 Service with Web Viewer 12.1

Make sure JRE_HOME or JDK_HOME is set correctly Go to Services App Right Click on Apache Tomcat 8 and the properties box will come up
1. Copy the Service name for use in the command below (It may be different for you)
   
2. Run the Command Prompt as administrator
3. Go to the C:\Program Files\CA\CA_OM_Web_Viewer\apache-tomcat-8.5.4\bin directory
4. Type

service.bat remove Tomcat8forCAOMWebViewer12

8. Type Enter
9. Go to the C:\Program Files\CA\CA_OM_Web_Viewer\apache-tomcat-9.0.91\bin directory
10. Type
    service.bat install(NOTE: you do not need the service name)
11. Type Enter
12. Leave the command prompt box
13. Go to Control Panel->All Control Panel Items->Administrative Tools->Services
14. Right Click on Apache Tomcat and the properties box will come up
15. Click on the down arrow next to Startup Type and select automatic
16. Click on Start under Service Startup
17. Click Apply, OK