Attempts to connect to a mail server result in Error CRJZS5074E

Technote (troubleshooting)


Problem(Abstract)

Attempts to connect to a mail server result in Error CRJZS5074E: Unexpected exception sending mail when using IBM Rational Team Concert (RTC).

Symptom

You are configuring the email notification settings in IBM Rational Jazz Team Server (JTS) setup wizard. When clicking on 'Test Connection', it results in the following warning message:

"The server could not be contacted: Can't send command to SMTP host; nested exception is: javax.net.ssl.SSLHandshakeException: com.ibm.jsse2.util.h: PKIX path building failed: java.security.cert.CertPathBuilderException: PKIXCertPathBuilderImpl could not build a valid CertPath.; internal cause is: java.security.cert.CertPathValidatorException: The certificate issued by CN=<server>, OU=<organization>, C=<country> is not trusted; internal cause is: java.security.cert.CertPathValidatorException: Certificate chaining error"

Corresponding error in jts.log:
2012-03-05 10:46:31,091 [ http-9443-Processor25] ERROR com.ibm.team.jfs - CRJZS5074E Unexpected exception sending mail javax.mail.MessagingException: Can't send command to SMTP host; nested exception is: javax.net.ssl.SSLHandshakeException: com.ibm.jsse2.util.h: PKIX path building failed: java.security.cert.CertPathBuilderException: PKIXCertPathBuilderImpl could not build a valid CertPath.; internal cause is: java.security.cert.CertPathValidatorException: The certificate issued by CN=<server>, OU=<some_ou>, C=US is not trusted; internal cause is:
java.security.cert.CertPathValidatorException: Certificate chaining error

Steps to reproduce:

  1. On the Jazz Team Server machine, ensure that you can telnet to the SMTP server at the non-secure port

  2. Navigate to the Jazz Team Server setup page (jts/setup)

  3. In the 'Configure Email notification' step, enter all the required information to connect to the SMTP server at non-secure port

  4. Test connection and confirm that the connection is successful

  5. Change the 'Use STARTTLS' from 'false' to true'.

  6. Test connection and confirm that it fails with the error message as described in the 'Symptom' section of this technote.

  7. Change the 'Use STARTTLS' back to 'false'

  8. Test connection and confirm that it still fails with the same error message

  9. Click on the Next button to save change to teamserver.properties file

  10. Clear browser cache and start a new session

  11. Log in to the Jazz Team Server setup page (jts/setup) and navigate to the 'Configure Email notification' step

  12. Confirm the email notification settings configured earlier are saved and the 'Use STARTTLS' is false

  13. Test connection and confirm that it still fails


Cause

The 'Use STARTTLS' property was set to 'true'. Test connection to the mail server will fail even after switching the value of 'Use STARTTLS' property back to 'false'.


STARTTLS is a command used when connecting to an SMTP server using SSL (TLS). It initiates a secure connection between the two servers, and once the communication is made, all subsequent connections will be secure. The reason that the second test connection fails when the STARTTLS is set to false is because the secure connection still remains between the two servers.


Resolving the problem

You need to restart the server to resolve the problem.


A server restart resolves this issue because it will drop the connection between the SMTP server and the JTS and create a new one, thus using non-secure transmission.

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.


Cross reference information
Segment Product Component Platform Version Edition
Software Development Rational Quality Manager Team Server 3.0.1, 3.0.1.1, 3.0.1.2
Software Development Rational Requirements Composer Team Server 3.0.1, 3.0.1.1, 3.0.1.2

Rate this page:

(0 users)Average rating

Document information


More support for:

Rational Team Concert
Repository

Software version:

3.0.1, 3.0.1.1, 3.0.1.2

Operating system(s):

AIX, Linux, Solaris, Windows

Reference #:

1586864

Modified date:

2012-03-27

Translate my page

Machine Translation

Content navigation