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

Technote (troubleshooting)


Problem(Abstract)

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


Cross Reference information
Segment Product Component Platform Version Edition
Software Development Rational DOORS General Information Linux, Windows 9.3, 9.3.0.1, 9.3.0.2, 9.3.0.3, 9.3.0.4 All Editions

Rate this page:

(0 users)Average rating

Document information


More support for:

Rational Quality Manager
Integrations: IBM

Software version:

3.0

Operating system(s):

Linux, Windows

Reference #:

1500479

Modified date:

2011-12-08

Translate my page

Machine Translation

Content navigation