IBM Support

Updating ClearCase to a newer version removes ClearQuest web from the IHS configuration

Troubleshooting


Problem

Update of ClearCase removes ClearQuest web from the IHS configuration.

Cause

When updating ClearCase to a newer version when ClearQuest is installed, ClearQuest web is removed from the IHS configuration. The IHS plugin-cfg.xml file is generated with sections for both CCRC and ClearQuest web. When updating ClearCase to a newer version, the entry for ClearQuest web are removed from the plugin-cfg.xml file. The automatic configuration of IHS involves the merging of the plugin-cfg.xml file for the Rational CCRC WAN servers with the plugin-cfg.xml file for the Rational ClearQuest web server into the plugin-cfg.xml file that controls the web server plugin for IHS. The merging of these files is incorrectly generating <UriGroup> sections with ClearQuest web removal from plugin-cfg.xml. The following example shows the cqweb is removed from <UriGroup> sections.
<UriGroup> sections of plugin-cgf.xml on ClearCase and ClearQuest installed system:
  
<UriGroup Name="default_host_server1_dfltNode_Cluster_URIs_0">
        <Uri AffinityCookie="JSESSIONID"
            AffinityURLIdentifier="jsessionid" Name="/ccrc/*"/>
        <Uri AffinityCookie="JSESSIONID"
            AffinityURLIdentifier="jsessionid" Name="/rview/*"/>
    </UriGroup>
 <UriGroup Name="default_host_server1_dfltNode_Cluster_URIs_1">
        <Uri AffinityCookie="JSESSIONID"
            AffinityURLIdentifier="jsessionid" Name="/help/*"/>
        <Uri AffinityCookie="JSESSIONID"
            AffinityURLIdentifier="jsessionid" Name="/TeamWeb/*"/>
        <Uri AffinityCookie="JSESSIONID"
            AffinityURLIdentifier="jsessionid" Name="/oslc/*"/>
        <Uri AffinityCookie="JSESSIONID"
            AffinityURLIdentifier="jsessionid" Name="/cqemailrelay/*"/>
        <Uri AffinityCookie="JSESSIONID"
            AffinityURLIdentifier="jsessionid" Name="/cqreportlauncher/*"/>
        <Uri AffinityCookie="JSESSIONID"
            AffinityURLIdentifier="jsessionid" Name="/cqweb/*"/>
    </UriGroup>
After updating ClearCase to a newer version, the entries for ClearQuest web are removed from plugin-cfg.xml. 
<UriGroup Name="default_host_server1_dfltNode_Cluster_URIs_0">
        <Uri AffinityCookie="JSESSIONID"
            AffinityURLIdentifier="jsessionid" Name="/ccrc/*"/>
        <Uri AffinityCookie="JSESSIONID"
            AffinityURLIdentifier="jsessionid" Name="/rview/*"/>
    </UriGroup>

 

Resolving The Problem

To work around the issue, run the following command on a terminal window to merge the plugin files.
On Windows System:
"C:\Program Files\IBM\RationalSDLC\common\ccrcprofile\bin\pluginCfgMerge.bat" "C:\Program Files\IBM\RationalSDLC\clearcase\web\ccrc_plugin_cfg.xml" "C:\Program Files\IBM\ClearQuest\cqweb_plugin_cfg.xml" "C:\Program Files\IBM\WebSphere\Plugins\config\webserver1\plugin_cfg.xml"
On Linux System:
/opt/ibm/RationalSDLC/common/ccrcprofile/bin/pluginCfgMerge.sh /opt/ibm/RationalSDLC/clearcase/web/ccrc_plugin_cfg.xml /opt/ibm/clearquest/cqweb_plugin_cfg.xml /opt/IBM/WebSphere/Plugins/config/webserver1/plugin-cfg.xml
Note: The above path can be different if user choses different path for ClearCase/ClearQuest and WAS during installation.
 

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSSH27","label":"IBM Rational ClearCase"},"ARM Category":[{"code":"a8m0z000000bo4qAAA","label":"ClearCase-\u003EInstallation\/Upgrade"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
03 October 2023

UID

ibm17042109

Page Feedback