IBM Support

Unable to connect by using SSL in ClearCase Remote Client (CCRC) version 7.1

Troubleshooting


Problem

In the ClearCase Remote Client (CCRC) version 7.1, the following error message appears when you try to connect by using SSL to a Change Management Server (CM Server) with SSL enabled: The server cannot be contacted. Please contact your system administrator.

Cause

This issue occurs when either the signer of the server certificate is not in the JRE trust store for the ClearCase Remote Client, or the server certificate is invalid.

Resolving The Problem

Note: This issue exists only in ClearCase Remote Client version 7.1. For issues related to forcing an SSL connection to CM Server, see Unable to force an SSL connection to the Change Management (CM) Server.


If the server certificate is expired or invalid, you cannot accept the certificate for the ClearCase Remote Client session. You must use a valid certificate.

If the certificate is valid but is not trusted by the ClearCase Remote Client, the certificate must be manually installed into the JRE trust store. This applies to self-signed certificates also.

To manually install a server certificate:

  1. On the server machine, extract the certificate to a binary certificate file. You can use the IBM HTTP Server Key Management Utility tool to extract the certificate.
  2. Copy the file to the client computer.
  3. On the client computer, locate the JRE that is used to run the ClearCase Remote Client.
  4. In a command window, change to the JRE directory.
  5. Run the following command:

    bin\keytool.exe -import -alias certificate-name -file <path-to-cert-file> –keystore lib\security\cacerts

    The default keystore password should be changeit
  6. Using the ClearCase Remote Client, connect to the server by using SSL. For example:

    https://MySSLEnabledServer/TeamWeb/services/Team

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"ClearCase Remote Client","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"},{"code":"PF022","label":"OS X"}],"Version":"7.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Product Synonym

ClearCase

Document Information

Modified date:
01 August 2018

UID

swg21327881

Page Feedback