Troubleshooting
Problem
After installing and configuring Apache Tomcat to run as a Windows service to use with IBM Rational Quality Manager, the service fails to start.
Symptom
You may or may not see an error thrown from Windows when the service fails to start.
Cause
It is possible that the default Java Options for tomcat5w.exe are missing.
Environment
Either 32 or 64-bit Windows
Diagnosing The Problem
Check the following for errors logged:
- Go to the Windows Event Viewer and look under Applications. See if there are any errors for Tomcat5.exe. An example of a captured error:
Faulting application name: tomcat5.exe, version: 1.0.2.0, time stamp: 0x4b7e5697
Faulting module name: J9PRT23.dll, version: 2.3.0.57823, time stamp: 0x4be80b50
Exception code: 0xc0000005
Fault offset: 0x000000000000ca5f
Faulting process id: 0x22c4
Faulting application start time: 0x01cc326a1d40ce8d
Faulting application path: C:\Program Files\IBM\JazzTeamServer\server\tomcat\bin\tomcat5.exe
Faulting module path: C:\program files\ibm\JazzTeamServer\server\jre\bin\J9PRT23.dll
Report Id: 5d6ffeaf-9e5d-11e0-953b-889ffaf61ab9
- Check the stderr_<date>.log file found under [JazzTeamServer Install Directory]\server\tomcat\logs\ and see if the following error is logged:
java.lang.ClassNotFoundException: org.apache.catalina.startup.Catalina
at java.net.URLClassLoader.findClass(URLClassLoader.java:497)
at java.lang.ClassLoader.loadClass(ClassLoader.java:639)
at java.lang.ClassLoader.loadClass(ClassLoader.java:605)
at org.apache.catalina.startup.Bootstrap.init(Bootstrap.java:222)
at org.apache.catalina.startup.Bootstrap.main(Bootstrap.java:410)
- Check the Java Options shown for tomcat5w.exe:
- Go to [JazzTeamServer Install Dir]\server\tomcat\bin\
- Double-click tomcat5w.exe
- Click the Java tab
- In the Java Options section, ensure that you have the following options listed in addition to the options found from the setup guide on how to run Apache Tomcat as a Windows service:
- Dcatalina.base=C:\Program Files\IBM\JazzTeamServer\server\tomcat
- Dcatalina.home=C:\Program Files\IBM\JazzTeamServer\server\tomcat
- Djava.endorsed.dirs=C:\Program Files\IBM\JazzTeamServer\server\tomcat\common\endorsed
- Djava.io.tmpdir=C:\Program Files\IBM\JazzTeamServer\server\tomcat\temp
- Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager
- Djava.util.logging.config.file=C:\Program Files\IBM\JazzTeamServer\server\tomcat\conf\logging.properties
Resolving The Problem
If you find the above errors logged and are missing the default Java Options, follow these steps:
- In the Apache Tomcat Properties window (tomcat5w.exe), add the following default Java options, making sure to edit the path to reflect the correct JazzTeamServer installation path
- Dcatalina.base=C:\Program Files\IBM\JazzTeamServer\server\tomcat
- Dcatalina.home=C:\Program Files\IBM\JazzTeamServer\server\tomcat
- Djava.endorsed.dirs=C:\Program Files\IBM\JazzTeamServer\server\tomcat\common\endorsed
- Djava.io.tmpdir=C:\Program Files\IBM\JazzTeamServer\server\tomcat\temp
- Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager
- Djava.util.logging.config.file=C:\Program Files\IBM\JazzTeamServer\server\tomcat\conf\logging.properties
- Click Apply to save the additions
- Close the Apache Tomcat Properties window
- Rename stderr_<date>.log to stderr_<date>.log.bak so that it generates a new error log when the service is started
- Start the service.
It should start successfully now that the default Java Options are restored.
If the service fails to start, check the event and tomcat logs again
[{"Product":{"code":"SSUVV6","label":"IBM Engineering Test Management"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"RQM Server","Platform":[{"code":"PF033","label":"Windows"}],"Version":"3.0.1","Edition":"Standard;Express","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]
Product Synonym
Rational Quality Manager
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21503767