Rational ClearQuest Web site configuration settings cannot be migrated during installation

Technote (troubleshooting)


Problem(Abstract)

IBM Installation Manager cannot convert the properties file from an earlier version of Rational ClearQuest to a new properties file. You must manually convert the properties file when migrating from 7.0.x versions.

Cause

If you see the error Unable to find the com.ibm.rational.cq.web.utils.CQSiteConfigConverter class, it is possible that the current CLASSPATH environment variable on the system has been modified so that the CQSiteConfigConverter utility cannot find the needed .jar files.

Environment

The IBM Rational ClearQuest Web site configuration is stored in the file DCT.properties.

To migrate DCT.properties to a new site configuration file, use the CQSiteConfigConverter utility.

The utility is contained in the package com.ibm.rational.cq.web.utils inside cqwebapp.jar.

For instructions, see the following topics in the Rational ClearQuest information center:

Resolving the problem

WORKAROUND:

Run the java command with the -classpath option and the class paths shown in the following example:

java -classpath "<install_dir>\common\CM\profiles\cmprofile\installedApps
\<hostname>CMProfileNode01Cell\RationalClearQuestWeb.ear
\CQWebModule.war\WEB-INF\lib\cqwebapp.jar";
"<install_dir>\common\CM\profiles\cmprofile\installedApps
\<hostname>CMProfileNode01Cell\RationalClearQuestWeb.ear
\CQWebModule.war\WEB-INF\lib\json.jar"


Note: Replace the variables <install_dir> and <hostname> with the installation directory and hostname for your system.

Related information

IBM Rational ClearQuest Information Center


Cross reference information
Segment Product Component Platform Version Edition
Software Development Rational ClearQuest Web Server (7.1)

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Rational ClearQuest
Installation

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.1.5, 7.1.1.6, 7.1.1.7, 7.1.1.8, 7.1.1.9, 7.1.2, 7.1.2.1, 7.1.2.2, 7.1.2.3, 7.1.2.4, 7.1.2.5, 7.1.2.6, 7.1.2.7, 7.1.2.8, 7.1.2.9, 7.1.2.10, 7.1.2.11, 7.1.2.12, 7.1.2.13

Operating system(s):

Linux, Solaris

Reference #:

1323427

Modified date:

2014-03-19

Translate my page

Machine Translation

Content navigation