当从 ClearQuest V7.0.x 升级到 V7.1.x 时,必须手动迁移 DCT.properties 文件中的 Rational® ClearQuest® Web 设置。
开始之前
注意: 用于迁移在 Windows®、Linux® 和 UNIX® 系统上运行的 DCT.properties 文件的工具。
对于 Linux 和 UNIX 系统,在命令示例中用 /opt/rational/ 替代 C:\Program Files\IBM\RationalSDLC\。
过程
- 计划:开始升级前,将 DCT.properties 文件备份到临时目录中。缺省情况下,DCT.properties 文件位于:C:\Program Files\Rational\Common\rwp\EmbeddedExpress\profiles\profile1\installedApps\DefaultNode\RationalClearQuestWeb.ear\CQWebModule.war\WEB-INF\classes\wpf\conf。
- 安装:完成 Rational ClearQuest V7.1.x 的安装。
- 安装后:通过将两个 jar 文件(cqwebapp.jar 和 json.jar)添加到类路径来准备运行 DCT.properties 转换工具。
缺省情况下,jar 文件位于:C:\Program Files\IBM\RationalSDLC\common\CM\profiles\cmprofile\installedApps\dfltCell\TeamEAR.ear\CQWebModule.war\WEB-INF\lib。 例如,set CLASSPATH=%CLASSPATH%;"C:\Program
Files\IBM\ RationalSDLC\common\CM\profiles\cmprofile\installedApps\dfltCell\TeamEAR.ear\CQWebModule.war\WEB-INF\lib\cqwebapp.jar";"C:\Program
Files\IBM\ RationalSDLC\common\CM\profiles\cmprofile\installedApps\dfltCell\TeamEAR.ear\CQWebModule.war\WEB-INF\lib\json.jar"
- 安装后:运行 Java™ 程序 com.ibm.rational.cq.web.utils.CQSiteConfigConverter,
以将 DCT.properties 文件迁移到新格式。该程序接受两个命令行参数:要转换的旧 DCT.properties 文件的完整路径名和要创建的新属性文件的完整路径名。该新文件可以保存在任意目录中,但应命名为 cqSiteConfig.pref。 以下示例从 C:\temp 目录中的旧 DCT.properties 文件获取设置,然后创建文件 C:\temp\cqSiteConfig.pref:
C:\Program Files\IBM\RationalSDLC\common\JAVA5.0\jre\bin\java com.ibm.rational.cq.web.utils.CQSiteConfigConverter "C:\temp\DCT.properties" "C:\temp\cqSiteConfig.pref"
- 安装后:升级 Rational ClearQuest 后,会在以下位置创建缺省版本的 cqSiteConfig.pref 文件:C:\Program Files\IBM\RationalSDLC\common\CM\profiles\cmprofile\installedApps\dfltCell\TeamEAR.ear\CQWebModule.war\WEB-INF\config\cqSiteConfig.pref。保存该文件的备份副本,然后使用在前一步骤中创建的新 cqSiteConfig.pref 文件来覆盖该文件。