从 3.0 手动升级到 3.0.1

本主题描述使用存储库工具将 Rational Team Concert V3.0 手动升级到 3.0.1 的过程。

准备工作

在升级服务器之前,请确保您具有 Rational Team Concert 和 Jazz Team Server V3.0 存储库数据库的最新有效备份。

并且,请确保所有机器上的时钟都已使用网络时间协议 (NTP) 进行同步。时间是关键元素,可允许将一个网络节点上的事件映射至另一个网络节点上的相应事件。如果要避免问题,可通过 NTP 服务的企业部署来解决这些问题。有关 NTP 的更多信息,请访问 http://www.ntp.org/。另外,所有服务器必须对其用户使用相同的认证方法。

如果您计划升级多款产品,请参阅升级顺序以帮助您确定首先升级的产品。

如果您使用 Derby 数据库,请将 JTS 和 CCM 数据库从 3.0 复制到 3.0.1。有关更多信息,请参阅备份和恢复 Derby 数据库。
注: 如果要使用同一个数据库,那么不必进行数据迁移。但是,如果要在升级期间切换数据库,那么必须从先前数据库中导出数据并将其导入到新数据库中。

升级 Jazz Team Server (JTS)

  1. 根据需要,查看有关计划部署和升级的部分中的主题。
  2. 关闭 JTS 3.0 服务器。
  3. 如果尚未安装 Jazz Team Server 作为 CLM 安装的组成部分,请先将 Jazz Team Server 安装到磁盘上的新位置。如果已安装 Jazz Team Server 且升级到 V3.0.1,并且想安装并升级“更改和配置管理”应用程序,请转到升级“更改和配置管理”(CCM)。
  4. 在安装期间,请选择使用缺省 3.x 应用程序上下文根。
  5. 安装结束时,请为您要启动哪个程序选择无。
  6. 浏览到 <3.0.1JTS_install_dir>/server 并运行下列命令:

    如果是使用 WebSphere Application Server,请在命令中指定 updateTomcatFiles=no 参数。有关可以与此命令配合使用的所有可能参数的信息,请参阅-migration_jts_updateConfigurationFiles。

    repotools-jts -migration_jts_updateConfigurationFiles oldJTSHome=<3.0JTS_install_dir>/server/conf 

    此命令将完成下列任务:

    • 根据 V3.0 文件中的信息更新 V3.0.1 teamserver.properties 文件。
    • 复制 Tomcat 用户 XML 文件的内容。
      切记: (仅限于 Tomcat 用户数据库)将复制 tomcat-users.xml 文件,而不是将其与现有文件合并。如果您正在升级多个使用公共 JTS 的 CLM 应用程序,那么必须以手动方式合并 tomcat-users.xml 文件中的用户和组信息。如果用户包含在不同应用程序中的不同组中,那么用户和组信息将有所不同。例如,userA 在 CCM 中具有 JazzAdmins 角色,但在 QM 中具有 JazzUsers 角色。另外,如果某些用户存在于一个应用程序中,但在另一个应用程序中不存在(反之亦然),那么您必须以手动方式将其添加到 tomcat-users.xml 文件。
    • 将 V3.0 server.xml 和 web.xml 文件的内容与 V3.0.1 合并。
  7. 浏览到 <3.0.1JTS_install_dir>/server 并运行下列命令以创建 JTS 数据库表:
    repotools-jts -addTables
  8. 如果是使用 Apache Tomcat,请参阅设置 Apache Tomcat。
  9. 如果您正在使用 WebSphere Application Server,请卸载您先前安装的 Web 应用程序,然后重新部署 V3.0.1 安装版本提供的 jts.war、admin.war 和 clmhelp.war。有关进一步的详细信息,请参阅设置 WebSphere Application Server 以进行 V3 升级。
  10. 启动 JTS 服务器。
  11. 接着,运行设置向导以配置服务器。

升级“更改和配置管理”(CCM)

  1. 根据需要,查看有关计划部署和升级的部分中的主题。
  2. 关闭 CCM 3.0 服务器。
  3. 将 CCM 应用程序安装到磁盘上的新位置。
  4. 在安装期间,请选择使用缺省 3.x 应用程序上下文根。
    要点: 如果 Rational Team Concert V3.0 是先前从 V2 升级而来,请选中使用 Rational Team Concert 2.x 上下文根以保留 /jazz 上下文根。
  5. 安装结束时,请为您要启动哪个程序选择无。
  6. 浏览到 <3.0.1CCM_install_dir>/server 并运行下列命令:

    如果是使用 WebSphere Application Server,请在命令中指定 updateTomcatFiles=no 参数。有关可以与此命令配合使用的所有可能参数的信息,请参阅-migration_ccm_updateConfigurationFiles。

    注: 缺省的 applicationContextRoot 是 jazz。如果您正在从 V3 升级,请确保指定 applicationContextRoot 参数并将其设置为 ccm。
    repotools-ccm -migration_ccm_updateConfigurationFiles oldApplicationHome=<3.0CCM_install_dir>/server/conf applicationContextRoot=ccm

    此命令将完成下列任务:

    • 根据 V3.0 文件中的信息更新 V3.0.1 teamserver.properties 文件。
    • 复制 tomcat-users.xml 文件的内容。
      切记: (仅限于 Tomcat 用户数据库)将复制 tomcat-users.xml 文件,而不是将其与现有文件合并。如果您正在升级多个使用公共 JTS 的 CLM 应用程序,那么必须以手动方式合并 tomcat-users.xml 文件中的用户和组信息。如果用户包含在不同应用程序中的不同组中,那么用户和组信息将有所不同。例如,userA 在 CCM 中具有 JazzAdmins 角色,但在 QM 中具有 JazzUsers 角色。另外,如果某些用户存在于一个应用程序中,但在另一个应用程序中不存在(反之亦然),那么您必须以手动方式将其添加到 tomcat-users.xml 文件。
    • 将 V3.0 server.xml 和 web.xml 文件的内容与 V3.0.1 合并。
  7. 浏览到 <3.0.1CCM_install_dir>/server 并运行下列命令以创建 CCM 数据库表:
    repotools-ccm -addTables 
  8. 如果是使用 Apache Tomcat,请参阅设置 Apache Tomcat。
  9. 如果是使用 IBM WebSphere Application Server,请卸载先前安装的 Web 应用程序并重新部署 V3.0.1 安装版本随附的 ccm.war。有关进一步的详细信息,请参阅设置 WebSphere Application Server 以进行 V3 升级。
  10. 启动 CCM 服务器。
  11. 如果正在将“更改和配置管理”添加到已建立的 Jazz Team Server,请使用管理 Web 界面。请参阅向 Jazz Team Server 注册应用程序。
注: jazz.net 库中有关升级 Rational Team Concert 的最新条目
父主题: 升级 Rational Team Concert

反馈