升级到全分布式企业拓扑

您可以使用本主题中描述的过程,将 Rational Team Concert™ 的安装升级到 V3.0.1,其中包含全新的分布式 CCM 和 JTS 应用程序。

开始之前

要点: 请确保所有机器上的时钟都已使用网络时间协议 (NTP) 进行同步。时间是关键元素,可允许将一个网络节点上的事件映射至另一个网络节点上的相应事件。如果要避免问题,可通过 NTP 服务的企业部署来解决这些问题。有关 NTP 的更多信息,请访问 http://www.ntp.org/。
注: 这里的示例适用于 Jazz Team Server 及更改和配置管理。可以对“质量管理”应用程序使用同一过程。

有关“全分布式 Rational Team Concert 3.0.1 企业拓扑”的示例,请查看全分布式 Rational Team Concert 2.0 至 3.0.1 企业拓扑示例主题。

将 JTS 应用程序分发到单独的服务器时,请确保您要将 JTS 部署到的第二个服务器具有相同的操作系统和应用程序服务器配置。使用相同的操作系统和应用程序服务器会降低文件迁移的复杂性。

请确保两个服务器对其用户都使用相同的认证方法和用户域。

查看并考虑使用单点登录进行部署。如果您正在使用 WebSphere,那么这将在多服务器环境中实施认证。

V3.0.1 安装结束时,在“您要启动的程序”下选择无。您必须仅在完成文件和存储库的迁移之后才运行 JTS 设置向导。

父主题: 升级 Rational Team Concert

准备配置文件

过程

  1. 在“机器 A”(具有要升级的 RTC 2.x 服务器的机器)上,安装 V3.0.1 更改和配置管理应用程序,但没有 Jazz Team Server (JTS) 和 RTC 试用许可证。
    注: 请确保在上下文根面板中选择使用 Rational Team Concert 2.x 上下文根。
  2. 在“机器 B”上,在将变成共享 JTS 的服务器上,安装 V3.0.1 Jazz Team Server (JTS) 应用程序和 RTC 试用许可证,但没有更改和配置管理。
    注: 请确保在上下文根面板中选择使用 Rational Team Concert 2.x 上下文根。
  3. 在“机器 A”上,打开一个新的命令窗口,并浏览到 3.0.1_install_dir/server。
  4. 运行以下命令,以合并 Jazz 和 Tomcat 配置文件:
    repotools-jazz -migration_ccm_updateConfigurationFiles oldJazzHome=2.x_install_dir/server/conf
    注: 缺省情况下,-migration_ccm_updateConfigurationFiles 命令会同时更新 Jazz 和 Tomcat 配置文件。如果未安装 Tomcat,且您希望只更新 Jazz 配置文件,那么必须指定 updateType=JAZZ 参数。
    repotools-jazz -migration_ccm_updateConfigurationFiles oldJazzHome=2.x_install_dir/server/conf updateType=JAZZ
  5. 在“机器 A”上,转至 3.0.1_install_dir/server/conf/jazz,并复审 RTC teamserver.properties 文件的内容。请特别注意数据库连接和公用 URL 条目,并确认它们对于“机器 A”的主机名是否正确。
    警告:
    您应该复审所合并文件的内容,特别是 Jazz 和 JTS teamserver.properties 文件中的数据库连接和公用 URL 条目。Jazz (RTC/CCM) teamserver.properties 位于“机器 A”上的 RTC3.0_install_dir/server/conf/jazz 下,而要编辑和移动的 JTS teamserver.properties 位于“机器 A”上的 3.0.1_install_dir/server/jts-migration/conf/jts 下。

    应该针对这两个 teamserver.properties 文件所在服务器的正确服务器主机名,编辑和更新(如有必要)这两个文件。

    有关验证点的更多信息和示例,请参阅“升级 Rational Team Concert”下“准备配置文件”中的步骤 3 至 6。

  6. 在“机器 A”上编辑 JTS teamserver.properties 之后,将它复制到“机器 B”下的 3.0.1_install_dir/server/conf/jts。备份现有的 teamserver.properties 文件,然后再进行替换。
  7. 如果在 Tomcat 上进行部署,那么您需要将 3.0.1_install_dir/tomcat/conf/tomcat-users.xml 和 3.0.1_install_dir/tomcat/conf/server.xml 文件从“机器 A”复制到“机器 B”上的 3.0.1_install_dir/tomcat/conf 文件夹。先备份现有文件的副本,然后再进行替换。
  8. 如果在 Tomcat 上进行部署并使用 LDAP,那么您将需要完成以下任务,才能使用已编辑的 web.xml 文件部署 JTS:
    1. 在“机器 B”上,使用 server.startup 启动 JTS 服务器,以解压缩 JTS.war 文件。
    2. 在“机器 B”上,使用 server.shutdown 命令停止 JTS 服务器。
    3. 在“机器 B”上,先备份 3.0.1_install_dir/server/tomcat/webapps/jts/WEB-INF/web.xml,然后再使用“服务器 A”的等效 web.xml 文件副本进行替换。

结果

这会完成配置文件迁移。

迁移存储库数据库

本节描述对分布式 JTS 应用程序执行存储库数据库迁移所需的步骤。

开始之前

在继续存储库数据库迁移之前,请验证是否已完成以下任务:
  • 已制作了现有 RTC 2.x 数据库的完整脱机备份。
  • 已迁移配置文件并将其放置在适当的位置(teamserver.properties、friendsconfig.rdf、tomcat-users.xml、server.xml 和 web.xml)。有关更多信息,请参阅准备配置文件。
  • 已创建 JTS 存储库数据库。有关更多信息,请参阅设置数据库。
  • 已关闭 Rational Team Concert V2.x 服务器。
  • 如果对 Rational Team Concert V2.x 服务器使用 Derby,请确保已将存储库数据库从 2.x_install_dir/server/repositoryDB 复制到 3.0.1_install_dir/server 目录。
  • 对于 WebSphere Application Server 迁移,请执行以下操作:
    • 确保已关闭 RTC 2.x 服务器。
    • 停止并卸载 jazz.war 应用程序。
    • 修改 JAZZ_HOME 属性以匹配新的安装路径 (3.0.1_install_dir/server/conf)。
    • 如有需要,请修改 Oracle 或 SQL Server JDBC 驱动程序属性。请参阅设置 WebSphere Application Server。
    • (可选)需要时调整内存设置。请参阅设置 WebSphere Application Server。
    • 停止并重新启动 WebSphere Application Server。

过程

  1. 在“机器 A”上,打开一个命令窗口,并切换到 3.0.1_install_dir/server 目录。
  2. 运行以下命令以向数据库添加表:
    repotools-jazz -addTables
  3. 运行以下命令以从 RTC 数据库导出用户信息:
    repotools-jazz -migration_exportJTSData toFile=jtsData.tar
  4. 在“机器 A”上,复制刚刚创建的 jtsData.jar 文件,并将它放置在“机器 B”上的 3.0.1_install_dir/server 目录中。
  5. 在“机器 B”上,运行以下命令以将用户信息导入到 JTS 数据库:
    要点: 如果未在使用缺省 Derby 数据库,请确保 conf/jts/teamserver.properties 中引用的 JTS 数据库已创建并存在。
    repotools-jts -migration_importJTSData fromFile=jtsData.tar createMappingFile=rtc-mapping.txt createTables
  6. 在“机器 B”上,复制刚刚创建的 rtc-mapping.txt 文件,并将它放置在“机器 A”上的 RTC3.0.1_install_dir/server 目录中。
  7. 在“机器 A”上,运行以下命令以将 JTS 用户信息导入到 RTC 数据库:
    repotools-jazz -migration_importUserMapping fromMappingFile=rtc-mapping.txt

迁移后存储库工具命令

过程

在“机器 A”上,运行以下命令以重建索引:

repotools-jazz -rebuildTextIndices

repotools-jazz -reindex

结果

这会完成存储库数据库迁移。

迁移后设置

关于此任务

迁移 RTC 服务器和分布 JTS 应用程序的迁移后步骤与在单一服务器环境中进行迁移的步骤相同,但是对于前者您还必须完成以下任务:

过程

在启动 Jazz Team Server 设置向导期间,由于环境为分布式环境,因此不会自动识别和预填充 CCM 应用程序。如果在 Jazz Team Server 设置期间未自动识别 CCM 应用程序,请参阅运行设置向导中的步骤 9c。

反馈