IBM Support

Special upgrade instructions for the CQServerConn.properties file when upgrading from ClearQuest Versions 7.1.x.x earlier than V7.1.1.5, or V7.1.2.2 or V8.0, to Versions 7.1.1.5, 7.1.2.2, or 8.0 or later

Technote (troubleshooting)


Problem(Abstract)

This technote identifies an issue with IBM Rational ClearQuest Web and Change Management Server (CM Server). When you enable application security for WebSphere Application Server, administrator logon credentials are stored unencrypted in the CQServerConn.properties file.

Symptom

This issue does not affect running IBM Rational ClearQuest.


Cause

The logon credentials of the WebSphere Application Server administrator should not be stored in the CqServerConn.properties file. This issue is identified as a product defect in APAR PM10323.

Diagnosing the problem

The problem exists if the following property values are defined in the CqServerConn.properties file:


TEAM_SERVER_ADMIN_AUTHENTICATION_KEY=adminUserName
TEAM_SERVER_ADMIN_AUTHENTICATION_VALUE=adminPassword


where the variables are:

  • adminUserName: Logon name of the administrative user.
  • adminPassword: Password associated with adminUserName.

Here is the default location of the CqServerConn.properties file:

C:\Program Files\IBM\RationalSDLC\common\CM\profiles\cmprofile\installedApps\dfltCell\RationalClearQuestWeb.ear\CQWebModule.war\WEB-INF\classes

Resolving the problem

This defect is fixed in Rational ClearQuest Versions 7.1.1.5, 7.1.2.2, and 8.0.


To resolve the issue in your deployment, perform the next steps.

Procedure

  1. Upgrade Rational ClearQuest.
  2. Remove the adminUserName and adminPassword values from the CqServerConn.properties file:

    TEAM_SERVER_ADMIN_AUTHENTICATION_KEY=
    TEAM_SERVER_ADMIN_AUTHENTICATION_VALUE=

With this fix, it is no longer necessary to store the administrator logon credentials for WebSphere Application Server in the CqServerConn.properties file. When WebSphere Application Server security is enabled, and a user attempts to view or modify the MBean attributes by using the Site Configuration window, or a user attempts to view ClearQuest Web server statistics by using the Site Monitoring window, a dialog box displays that asks for the administrator logon credentials.

Document information

More support for: Rational ClearQuest
Web Server (7.1)

Software version: 7.1, 7.1.0.1, 7.1.0.2, 7.1.1, 7.1.1.1, 7.1.1.2, 7.1.1.3, 7.1.1.4, 7.1.2, 7.1.2.1

Operating system(s): Windows

Reference #: 1424905

Modified date: 28 May 2013