ALERT: Some images may not load properly within the Knowledge Base Article. If you see a broken image, please right-click and select 'Open image in a new tab'. We apologize for this inconvenience.

Upgrading Apache Tomcat to 9.0.31 with 12.1 Web Viewer


Article ID: 198433


Updated On:


Output Management Web Viewer


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 PTF SO12509 (Tomcat Version 9.0.31), what's next?

Are there any issues when upgrading from an earlier Tomcat to 9.0.31?


Release : 12.1



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.31, 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 and Install the Tomcat9 Service with CA 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

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