IBM Support

When the Jazz SSL certificate changes, re-import it into Rational DOORS

Troubleshooting


Problem

An error occurred while starting the Rational DOORS RQMi server. The error message states: ERROR: IOException: javax.net.ssl.SSLHandshakeException: com.ibm.jsse2.util.h: PKIX path building failed: java.security.cert.CertPathBuilderException: unable to find valid certification path to requested target. DOORS: version 9.3 QM: build CALM-I20110514-0100

Symptom

The SSLHandshakeException displays while starting the DOORS9.3 RQMi Server.

Cause

The Jazz SSL certificate, which is used by the DOORS RQMi server, changed before it could be included in the latest version of DOORS RQMi.

Environment

Windows, Linux

Diagnosing The Problem

The Jazz SSL certificate was updated in Jazz Foundation, causing it to be inconsistent with the certificate used in DOORS 9.3--Version 9.3.0.4 of the DOORS RQMi server will contain the correct version of the Jazz SSL certificate.

Resolving The Problem

Upgrade to version 9.3.0.4 of the DOORS RQMi server. If this problem occurs before you can upgrade, re-import the Jazz SSL certificate into DOORS RQMi server following these steps:


1. Get the self signed SSL certificate from the RQM server.

For Internet Explorer:


For Firefox – if the certificate has already been accepted:


1. Tools Settings
2. Advanced Encryption

IBM localhost

Select your RQM server

Export

For Firefox – if the certificate has not been accepted:


2. Open a command prompt

3. CD to the < DOORS Installation Directory>\ibm_jre\bin directory

4. Run the following command to import the certificate to generate a new trustStore in the DOORS server:

keytool -import -alias localhost -file <complete path to the certificate your downloaded> -keystore <DOORS INSTALLATION DIRECTORY>\RQMInterface\Server\IM\certificates\jssecacerts.

When prompted for the DOORS key Store password, enter Rational.

3. Be sure that the following argument is added to the Java command in the RQMI serversstart.bat script to use the new trustStore:
-Djavax.net.ssl.trustStore=../certificates/jssecacerts.

For more information, see the following Help topic in the DOORS information center:


http://publib.boulder.ibm.com/infocenter/doorshlp/v9/topic/com.ibm.doors.install.doc/topics/c_installingrqmi.html

[{"Product":{"code":"SSUVV6","label":"IBM Engineering Test Management"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Integrations: IBM","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"3.0","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSKR2T","label":"IBM Engineering Requirements Management DOORS"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"General Information","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"9.3;9.3.0.1;9.3.0.2;9.3.0.3;9.3.0.4","Edition":"All Editions","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Product Synonym

Rational Quality Manager

Document Information

Modified date:
01 May 2020

UID

swg21500479