本主题描述将 ClearQuest® 同步器 从前发行版升级到当前发行版所需的步骤。
过程
- 禁用外部存储库连接的出局同步。在 Eclipse IDE 的 Rational Team Concert™ 客户机中,显示“同步规则”视图。展开“外部存储库连接”节点。双击外部存储库连接以将其打开。选择禁用自动出局同步。单击确定。
- 禁用 Jazz™ Team Server 的出局同步。在 Web 客户机的管理页面中,单击高级属性。滚动到项互操作组件。对于 com.ibm.team.interop.service.internal.InteropService,单击编辑。对于已启用的出局同步,在下拉列表中选择 false。单击保存。
- 停止“ClearQuest 网关”。
- 停止 Jazz Team Server。
- 升级服务器。请参阅从 V2 进行升级(此过程包括两个步骤)或者升级到 V4.0。
- 启动服务器,并验证以下项:
- 您可以使用 ClearQuest 连接器所用的 Jazz 用户帐户进行登录,并且可以连接到项目区域。
- 外部存储库连接已存在。请参阅“同步规则”视图。
- 同步规则已存在。请参阅“同步规则”视图。
- 先前使用 ClearQuest 记录创建和同步的工作项已存在。
- Jazz Team Server 仍设置为禁用出局同步。
- 安装新版本的 ClearQuest 同步器。请参阅使用 IBM Installation Manager 来安装 Rational Team Concert ClearQuest 同步器。
注: 如果您正在从 V3.x 进行升级,那么可以使用 Installation Manager 中的“更新”选项。如果您正在从 V2.X 进行升级,那么您必须选择“安装”选项,然后卸载 V2.X(请参阅
步骤 17)。从 V3.0 开始,缺省安装目录名为 ClearQuest Synchronizer,而不是 ClearQuest Connector。
- 浏览到 install-directory/ClearQuest Synchronizer/gateway 目录,并启动“ClearQuest 网关”。
- 停止“ClearQuest 网关”。 启动并停止“ClearQuest 网关”会创建 install-directory/ClearQuest Synchronizer/gateway/tomcat/webapps/cqconnector 目录。
- 如果您正在从 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 文件,以使此文件包含您已对先前版本所作的任何变更。
- 可选。将最新版本的 JazzInterop 程序包应用到您的 ClearQuest 模式,然后使用新模式版本升级 ClearQuest 用户数据库。请参阅使用新版 JazzInterop 程序包升级用户数据库,以获取详细信息。
- 启动“ClearQuest 网关”。
- 转至状态页面(网址为 http://host-name.example.com:8081/cqconnector/gateway),检查“网关”的状态。该页面应该显示“网关”正在接受所有请求。
- 启用外部存储库连接的出局同步。
- 启用服务器的出局同步。
- 通过执行以下步骤,验证该同步是否起作用:
- 在 ClearQuest 用户数据库中创建一些记录。验证是否在 Rational Team Concert 项目区域中创建了相应的工作项。
- 在项目区域中创建一些工作项。验证是否在 ClearQuest 用户数据库中创建了相应的记录。
- 编辑已在前发行版中同步的一些工作项。验证更改是否已传播到相应的 ClearQuest 记录。
- 编辑已在前发行版中同步的一些 ClearQuest 记录。验证更改是否已传播到相应的工作项。
- 如果您正在从 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