Installing IBM HTTP Server Fixpack 126.96.36.199 and higher might prevent HTTPS from working if you have ClearQuest, ClearCase, ProjectConsole or RequisitePro installed
After upgrading to IBM HTTP Server Fixpack 188.8.131.52 or later, SSL connection requests from the IBM HTTP Server to a Rational product web server fail because the IBM HTTP Server cannot access the required version of the Global Security Kit (GSKit).
Note: This problem was reported as APAR PM54911 and has been fixed in ClearQuest 8.0.0, ClearCase 8.0.0, Requisite Pro 7.1.3. It has also been fixed for version 184.108.40.206 and later for Rational ClearCase, ClearQuest , and Requisite Pro.
In the Rational product web client, one of the following errors might occur:
Mozilla FireFox:: Problem loading page
Internet Explorer: Internet Explorer cannot display the webpage.
The Rational product installation programs for version 7.1.1, 7.1.2 and related fix packs install Global Security Kit (GSKit) version 220.127.116.11 in one of the following default locations.
C:\Program Files (x86)\IBM\GSK7
The installation also copies some of the GSKit libraries into <product installation directory>\common. Where the default location of <production installation directory> is one of the following:
C:\Program Files (x86)\IBM\RationalSDLC
The Rational product installation also adds the common folder to the PATH environment variable.
IBM HTTP Server maintenance fix pack, version 18.104.22.168 or later, requires GSKit version 22.214.171.124 or later to connect to IBM HTTP Server using SSL. This version of the GSKit is installed during the IBM HTTP Server fixpack installation process. However, when a connection request occurs, the IBM HTTP Server searches the PATH environment variable for the GSKit location and locates the older GSKit library in the Rational common folder. The connection request fails because the IBM HTTP Server tries to use the older library which is not supported.
This problem occurs in environments where IBM HTTP Server Fixpack 126.96.36.199 or later is used with version 7.1.1, 7.1.2, and related fix packs for the following Rational products. ClearQuest, ClearCase, ProjectConsole, and RequisitePro.
Diagnosing the problem
Check the Rational product error log (default path =
[notice] Using GSKit version 188.8.131.52 [notice] SSL0198I: System is running without a security library capable of directly rejecting insecure SSL client renegotiation. Aborting HTTPS requests that span SSL sessions [crit] SSL0193W: Error setting GSK_ALLOW_ONLY_EXTENDED_RENEGOTIATION to 0 (701) [error] Error retrieving GSKit defaults from VirtualHost localhost:0, using hard-coded defaults [notice] SSL0198I: System is running without a security library capable of directly rejecting insecure SSL client renegotiation. Aborting HTTPS requests that span SSL sessions [crit] SSL0193W: Error setting GSK_ALLOW_ONLY_EXTENDED_RENEGOTIATION to 0 (701)
Resolving the problem
You can avoid this issue completely by upgrading to one of the following product versions where the issue has been fixed:
- ClearQuest 8.0.0, ClearCase 8.0.0, Requisite Pro 7.1.3. version 184.108.40.206 and later for
Rational ClearCase, ClearQuest , and Requisite Pro.version 220.127.116.11 and later
If you do not upgrade, use the following information to work around the problem.
If you do not want to upgrade, use information in the following sections to resolve the GSKit version problem for the IBM HTTP Server.
Resolving the GSKit version problem for Rational ClearQuest, ClearCase, or ProjectConsole
Complete the following procedure to resolve the GSKit version conflict.
Important:: If your environment also includes Rational RequisitePro version 7.1.1 and 7.1.2, do not perform this procedure. See Resolving the GSKIT version problem for Rational Requisite Pro.
1. Edit the PATH environment variable of the account that is running IBM HTTP Server.
2. Locate the path value for the common folder. For example:
3. Insert the library path for GSKIT 18.104.22.168 or later before the path to the common folder. For example,
In installations where the paths include x86, add
C:\Program Files (x86)\IBM\GSK7\lib in the path before
C:\Program Files (x86)\IBM\RationalSDLC\common.
4. Restart the IBM HTTP Server.
Some Windows architectures, such as Windows 2008 R2, do not dynamically update the PATH statement. On these Operating Systems, reboot the system to apply the path changes.
Maintaining the solution across Rational product upgrades
If you upgrade to a subsequent fix pack for Rational ClearCase, Rational ClearQuest, Rational Project Console or Rational RequisitePro, complete the following steps to prevent the IBM HTTP Server failure from reoccurring.
- Uninstall the IBM HTTP Server and WebSphere maintenance fix pack.
This step is required to prevent the Rational product upgrade from failing and is also mentioned in the How to update the WebSphere Application Server components in Rational ClearCase and Rational ClearQuest 7.1. One reason the installation might fail is if the program tries to install an older version of the GSKit required by the Rational product when a newer version is already installed.
- Install the Rational product maintenance fix pack.
- Reinstall the IBM HTTP Server and WebSphere maintenance fix packs.
- Check the PATH environment variable and ensure that the path value for GSKIT 22.214.171.124 or later precedes the path value for the Rational common library.
- To apply any PATH changes, restart the IBM HTTP Server or reboot the system if required.
Rational Requisite Pro7.1.1, 7.1.2, and related maintenance fix packs only support GSKit version 126.96.36.199. Consequently, you cannot use IBM HTTP Server 188.8.131.52 or later with Rational Requisite Pro 7.1.1 because of the GSKit version conflict.
You can try any of the following options to work around the problem:
- Only allow non-SSL connection requests to the IBM HTTP Server.
- Run Rational Requisite Pro using IBM HTTP Server versions earlier than version 184.108.40.206.
- If you require secure connections using IBM HTTP Server version 220.127.116.11 or later, upgrade to Requisite Pro version 7.1.3. The GSKit version conflict has been fixed in that release.
Warning: If you have Rational Requisite Pro version 7.1.1 or 7.1.2 installed and update the PATH environment variable as described in Resolving the problem for Rational ClearQuest, ClearCase, or ProjectConsole, Rational RequisitePro Client for Windows and Rational RequisiteWeb might not work.
In the RequisitePro client for Web, the following error might occur:
Could not open RequisitePro project file...
The remote procedure call failed.
In the RequisitePro client for Windows, the following error might occur:
The procedure entry point... could not be located in the dynamic link library. gsk7cms.dll.
If these errors occur, update the PATH environment variable to remove the path value for GSKit 18.104.22.168 or later. Then, restart the IBM HTTP Server, the Rational RequisitePro web server, and the Rational RequisitePro Client if it is running. Depending on the Windows platform, you might have to reboot the system to apply the changes to the PATH environment variable. See the Windows system documentation for information.
|Software Development||Rational ClearCase||General Information|
|Software Development||Rational ProjectConsole||General Information|
|Software Development||Rational RequisitePro||General Information|
More support for:
Software version: 7.1.1, 22.214.171.124, 126.96.36.199, 188.8.131.52, 184.108.40.206, 220.127.116.11, 18.104.22.168, 22.214.171.124, 126.96.36.199, 7.1.2, 188.8.131.52, 184.108.40.206, 220.127.116.11, 18.104.22.168, 22.214.171.124, 126.96.36.199, 188.8.131.52, 184.108.40.206, 220.127.116.11, 18.104.22.168, 22.214.171.124, 126.96.36.199
Operating system(s): Windows
Reference #: 1578350
Modified date: 11 October 2013