You must manually migrate the Rational®
ClearQuest® web
settings in the DCT.properties file when you
upgrade Rational
ClearQuest.
Before you begin
The tool to migrate the DCT.properties file runs on Windows, Linux, and UNIX systems. For Linux and UNIX systems, substitute /opt/rational/ for C:\Program Files\IBM\RationalSDLC\
in the command examples.
Procedure
- PLAN: Before beginning the upgrade, back up your DCT.properties file to a
temporary directory. By default, the DCT.properties file is located in:
C:\Program
Files\IBM\RationalSDLC\common\CM\profiles\cmprofile\installedApps\dfltCell\TeamEAR.ear\CQWebModule.war\WEB-INF\classes\wpf\conf.
- INSTALL: Complete the Rational
ClearQuest
installation.
- POST-INSTALL: Prepare to run the DCT.properties conversion tool by adding
two jar files to the class path: cqwebapp.jar and
json.jar. By default, the jar files are located in: C:\Program
Files\IBM\RationalSDLC\common\cq-profile-dir\profiles\cmprofile\installedApps\dfltCell\TeamEAR.ear\CQWebModule.war\WEB-INF\lib.
- POST-INSTALL: Run the Java™ program, com.ibm.rational.cq.web.utils.CQSiteConfigConverter, to migrate the
DCT.properties files to the new format. This program accepts two command line
parameters: the full path name of the old DCT.properties file that you want to
convert and the full path name of the new properties file you are creating. The new file can be
saved in any directory, but should be called cqSiteConfig.pref. The following example takes the settings from the old DCT.properties
file in the directory C:\temp directory and creates a file:
C:\temp\cqSiteConfig.pref:
- POST-INSTALL: When you upgraded Rational
ClearQuest,
a default version of the cqSiteConfig.pref file
was created. Save
a backup copy of this file and then overwrite it with the new cqSiteConfig.pref file
that you created in the previous step.