IBM Support

Tomcat as a Windows Service fails with SSLContext error when using Rational Team Concert

Troubleshooting


Problem

Attempts to configure Tomcat to run as a Microsoft Windows service for use with IBM Rational Team Concert results in the Catalina log showing an SSLContext not available error which prevents the server from starting correctly.

Symptom

The following error will be seen in the catalina.log file:


org.apache.coyote.http11.Http11BaseProtocol init SEVERE: Error initializing endpoint                                        
java.io.IOException: ${jazz.connector.sslProtocol} SSLContext not available 
at org.apache.tomcat.util.net.jsse.JSSE14SocketFactory.init(JSSE14SocketFactory.java:132)
at org.apache.tomcat.util.net.jsse.JSSESocketFactory.createSocket(JSSESocketFactory.java:96)
at org.apache.tomcat.util.net.PoolTcpEndpoint.initEndpoint(PoolTcpEndpoint.java:293)

Cause

When configuring Tomcat to run as a Windows service, the Java Options should include Secure Socket Layer, or SSL, configuration. This is a new feature to IBM Rational Team Concert 3.0, and was not a required parameter for IBM Rational Team Concert 2.x versions.

Resolving The Problem

  1. Open the Java Options for the Tomcat service by running the <JazzInstallDir>\server\tomcat\bin\tomcat5w.exe

  2. Click the Java tab

  3. Under Java Options, Ensure that the following parameter is included:-Djazz.connector.sslProtocol=SSL_TLS
  4. Proceed with the instructions on configuring IBM Rational Team Concert and Tomcat as a Windows service.
  5. Ensure that you select "Apply" and "OK" once finished.

Leverage the Jazz Community

Jazz and Rational Team Concert have an active community that can provide you with additional resources. Browse and contribute to the User forums, contribute to the Team Blog and review the Team wiki.
Refer to technote 1319600 for details and links.

[{"Product":{"code":"SSUC3U","label":"IBM Engineering Workflow Management"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Web App Server","Platform":[{"code":"PF033","label":"Windows"}],"Version":"3.0","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Product Synonym

Rational Team Concert

Document Information

Modified date:
16 June 2018

UID

swg21460726