对 ClearQuest 同步器 进行升级

本主题描述将 ClearQuest® 同步器 从前发行版升级到当前发行版所需的步骤。

过程

  1. 禁用外部存储库连接的出局同步。在 Eclipse IDE 的 Rational Team Concert™ 客户机中,显示“同步规则”视图。展开“外部存储库连接”节点。双击外部存储库连接以将其打开。选择禁用自动出局同步。单击确定。
  2. 禁用 Jazz™ Team Server 的出局同步。在 Web 客户机的管理页面中,单击高级属性。滚动到项互操作组件。对于 com.ibm.team.interop.service.internal.InteropService,单击编辑。对于已启用的出局同步,在下拉列表中选择 false。单击保存。
  3. 停止“ClearQuest 网关”。
  4. 停止 Jazz Team Server。
  5. 升级服务器。请参阅从 V2 进行升级(此过程包括两个步骤)或者升级到 V4.0。
  6. 启动服务器,并验证以下项:
    • 您可以使用 ClearQuest 连接器所用的 Jazz 用户帐户进行登录,并且可以连接到项目区域。
    • 外部存储库连接已存在。请参阅“同步规则”视图。
    • 同步规则已存在。请参阅“同步规则”视图。
    • 先前使用 ClearQuest 记录创建和同步的工作项已存在。
    • Jazz Team Server 仍设置为禁用出局同步。
  7. 安装新版本的 ClearQuest 同步器。请参阅使用 IBM Installation Manager 来安装 Rational Team Concert ClearQuest 同步器。
    注: 如果您正在从 V3.x 进行升级,那么可以使用 Installation Manager 中的“更新”选项。如果您正在从 V2.X 进行升级,那么您必须选择“安装”选项,然后卸载 V2.X(请参阅步骤 17)。从 V3.0 开始,缺省安装目录名为 ClearQuest Synchronizer,而不是 ClearQuest Connector。
  8. 浏览到 install-directory/ClearQuest Synchronizer/gateway 目录,并启动“ClearQuest 网关”。
  9. 停止“ClearQuest 网关”。 启动并停止“ClearQuest 网关”会创建 install-directory/ClearQuest Synchronizer/gateway/tomcat/webapps/cqconnector 目录。
  10. 如果您正在从 V2.X 进行升级,那么将已修改并且任何用户都可以配置的文件从 ClearQuest Connector 2.0.0.2x 安装目录复制到 ClearQuest Synchronizer 安装目录。具体来说,复制:
    • cqconnector.properties,从 install-directory/ClearQuestConnector/gateway 到 install-directory/ClearQuestSynchronizer/gateway。
    • log4j.properties,从 install-directory/ClearQuestConnector/gateway 到 install-directory/ClearQuestSynchronizer/gateway。
    • tomcat-users.xml,从 install-directory/ClearQuestConnector/gateway/tomcat/conf 到 install-directory/ClearQuestSynchronizer/gateway/tomcat/conf。
    • web.xml,从 install-directory/ClearQuestConnector/gateway/tomcat/webapps/cqconnector/WEB-INF 到 install-directory/ClearQuestSynchronizer/gateway/tomcat/webapps/cqconnector/WEB-INF。
    如果您正在从 V3.x 进行升级,并且在 Installation Manager 中选择“更新”选项,那么已修改的配置文件会存储在备份目录中。将已修改的配置文件从备份目录复制到新的安装目录中。
    注:

    在 V4.0 之前的发行版中使用的 server.xml 文件与 V4.0 不兼容。因此,您无法将其从 install-directory/ClearQuestConnector/gateway/tomcat/conf 或者从备份目录复制到 install-directory/ClearQuestSynchronizer/gateway/tomcat/conf。改为编辑新的安装目录 (install-directory/ClearQuestSynchronizer/gateway/tomcat/conf) 中的 4.0 server.xml 文件,以使此文件包含您已对先前版本所作的任何变更。

  11. 可选。将最新版本的 JazzInterop 程序包应用到您的 ClearQuest 模式,然后使用新模式版本升级 ClearQuest 用户数据库。请参阅使用新版 JazzInterop 程序包升级用户数据库,以获取详细信息。
  12. 启动“ClearQuest 网关”。
  13. 转至状态页面(网址为 http://host-name.example.com:8081/cqconnector/gateway),检查“网关”的状态。该页面应该显示“网关”正在接受所有请求。
  14. 启用外部存储库连接的出局同步。
  15. 启用服务器的出局同步。
  16. 通过执行以下步骤,验证该同步是否起作用:
    • 在 ClearQuest 用户数据库中创建一些记录。验证是否在 Rational Team Concert 项目区域中创建了相应的工作项。
    • 在项目区域中创建一些工作项。验证是否在 ClearQuest 用户数据库中创建了相应的记录。
    • 编辑已在前发行版中同步的一些工作项。验证更改是否已传播到相应的 ClearQuest 记录。
    • 编辑已在前发行版中同步的一些 ClearQuest 记录。验证更改是否已传播到相应的工作项。
  17. 如果您正在从 V2.X 进行升级,或者未在 Installation Manager 中选择“更新”选项,请卸载 ClearQuest Connector 的先前发行版。 卸载操作应该在 install-directory/ClearQuestConnector 目录中创建名为 backup-config-timestamp 的目录。验证此目录是否包含以下目录和文件:
    • gateway/cqconnector.properties
    • gateway/log4j.properties
    • gateway/tomcat/conf(目录包含一些文件和一个 Catalina 目录)
    • gateway/tomcat/webapps/cqconnector/WEB-INF/web.xml

反馈