Tomcat Windows Service fails after Java Upgrade with Web Viewer 12.1

book

Article ID: 40191

calendar_today

Updated On:

Products

Output Management Web Viewer

Issue/Introduction

After a Java upgrade, Tomcat service does not start and the System event log shows service-specific error code 1.
NOTE: Tomcat is running as a service.

 

Cause

After the Java upgrade, the catalina.bat file was not set to the correct Java version and the Tomcat service needed to be uninstalled and reinstalled to pick up the new Java environmental variables.

Environment

Java
Apache Tomcat
MS Windows Server
Output Management Web Viewer 12.1

Resolution

  • Stop the Tomcat service
  • Install the new Java
  • After the install of the new Java, verify that the Windows System environment variables are set for the new Java.
    NOTE: The JDK is required for Tomcat 9 and can be used with earlier versions
  • Edit catalina.bat in directory C:\Program Files\CA\CA_OM_Web_Viewer\apache-tomcat-9.0.54\bin   (for example)
  • Change this line:
    JRE_HOME=C:\Program Files\Java\jre1.8.0_191

    to
JRE_HOME=C:\Program Files\Java\jre1.8.0_281   (example for Oracle)


JRE_HOME=C:\Program Files\Eclipse Adoptium\jdk-11.0.14.101-hotspot (example for ADOPTIUM)

  • In the administrative command prompt, cd to C:\Program Files\CA\CA_OM_Web_Viewer\apache-tomcat-9.0.54\bin   (for example)
  • run service.bat remove 
  • run service.bat install
  • Start the Apache Tomcat Windows service  (see Additional Information below for Details if needed)
  • Important: Run tomcat9w //ES//Tomcat9* in the administrator command prompt and
    - Click on the Java tab to insert the Java virtual machine path
    - Check that the heap size is what it was before the Java upgrade
  • Recycle Tomcat

Additional Information

Please see Error #2 trying to start Apache Tomcat as a service with CA Output Management Web Viewer for Windows for exact instructions on how to uninstall and reinstall Tomcat as a service.

*If running Tomcat 8, use

  • Run tomcat8w //ES//Tomcat8forCAOMWebViewer12