使用升级脚本从 V2 升级到 3.0.1

您可以使用升级脚本来尽可能减少升级应用程序数据时必须手动运行的命令数。

开始之前

在升级服务器之前,请确保您有 Rational Team Concert V2 存储库数据库的最新有效备份。

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

要点: 要在“更改和配置管理”应用程序与 Jazz Team Server 分开安装的分布式环境中使用升级脚本,升级脚本必须能够访问 Jazz Team Server 所安装在的驱动器或文件系统。例如,在 Windows 上,映射格式必须为 <mapped drive letter>:\server\conf。绝对路径 (\\<machine name>\<installdir>server\conf) 无效。安装的驱动器必须配置为,将“读/写/执行”特权授予管理员帐户。

如果您正在使用 Derby 数据库,请将 Rational Team Concert 数据库 (<RTC2_install_dir>\server\repositoryDB) 从 V2 复制到 V3.0.1。有关更多信息,请参阅备份和恢复 Derby 数据库。

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

过程

  1. 根据需要,查看有关计划部署和升级的部分中的主题。
  2. 验证现有的 V2 teamserver.properties 文件的公用 URL 属性 com.ibm.team.repository.server.webapp.url。

    在 V3.0.1 中,必须使用同一个公用 URL。如果尚未设置公用 URL,请先使用 V2 管理 Web 界面(高级属性)来设置限定主机名 URL (https://hostname.example.com:port),然后再执行升级。

    teamserver.properties 中的公用 URL 行应该类似于:
    com.ibm.team.repository.server.webapp.url=https\://<hostname.example.com>\:9443/jazz
  3. 关闭 V2 服务器。
  4. 如果尚未将 Jazz Team Server 以及“更改和配置管理”(CCM) 应用程序安装到新位置,请进行此安装。如果您已安装 Jazz Team Server,并已升级到 V3.0.1,那么只需安装“更改和配置管理”应用程序。
  5. 在安装期间,请选择使用 Rational Team Concert 2.x 上下文根。
  6. 安装结束时,请为您要启动哪个程序选择无。
  7. 使用与 V2.x 数据库相同的参数但使用不同的数据库名称,来创建 Jazz Team Server 的单独数据库。 有关如何创建数据库的更多信息,请参阅设置数据库。
    注: 需要一个有别于 CCM 数据库的 Jazz Team Server 数据库。如果您尚未创建新的 JTS 数据库,请创建此数据库。
  8. 浏览到 <CCM3.0.1_install_dir>/server 并运行下列命令:
    注: 可以通过在命令行中指定所有参数来运行脚本。另外,如果您要反复运行升级脚本,那么还可以编辑此脚本的参数文件并运行缩略的命令行。有关参数文件的指示信息,请参阅下一个可选步骤。

    如果您需要更多有关命令行选项的详细信息,请参阅ccm_upgrade。

    要点: 虽然此脚本文件在 upgrade 目录下,但它必须从 server 目录中运行。并且,如果路径包含空格,请确保将其括在双引号中。

    如果您已将 Jazz Team Server V3.0.1 与 CCM 应用程序安装在一起,并且这是您要升级的第一个或唯一的应用程序,那么命令语法如下所示:

    Windows
    upgrade\ccm_upgrade.bat -oldApplicationHome <RTC2.x_install_dir>\server\conf -createJTSTables
    UNIX
    upgrade/ccm_upgrade.sh -oldApplicationHome <RTC2.x_install_dir>/server/conf -createJTSTables
    注: -createJTSTables 参数适用于 Jazz Team Server 3.0.1 的第一次安装。

    如果您已将 Jazz Team Server V3.0.1 与 CCM 应用程序分开安装(例如分布式部署中的情况),那么需要指定 Jazz Team Server 3.0.1 的位置并从 CCM 3.0.1 安装目录中运行此脚本。在这种情况下,请指定 -newJTSHome 参数。

    Windows
    upgrade\ccm_upgrade.bat -oldApplicationHome <RTC2.x_install_dir>\server\conf -newJTSHome <JTS3.0.1InstallDir>\server\conf
    UNIX
    upgrade/ccm_upgrade.sh -oldApplicationHome <RTC2.x_install_dir>/server/conf -newJTSHome <JTS3.0.1InstallDir>/server/conf
    注: 如果您使用分布式部署并且尚未配置 Jazz Team Server,那么可以对以上命令行示例添加 -createJTSTables 参数。
    此脚本将借助指示的用户交互完成下列任务:
    • 运行 -migration_ccm_updateConfigurationFiles 命令并更新配置和 Tomcat 文件。请输入 [E] 以执行命令,输入 [S] 跳过步骤,或者按 [Enter] 键取消脚本执行。
    • 在成功地合并配置文件之后,请输入 [C] 继续。这将打开一个记事本窗口(在 UNIX 系统上,将打开 vi 编辑器),您可以在此窗口中验证 CCM teamserver.properties 文件。验证 com.ibm.team.repository.server.webapp.url 属性所指定的公用 URI 根是否正确。并且,验证数据库属性是否正确。数据库位置不得与 JTS 数据库位置相同。完成后,请保存更改(如果有)并关闭编辑器以继续运行脚本。
      要点: 请不要修改属性来连接到数据仓库数据库,即使这些属性当前设置为 Derby 也是如此。只能使用服务器设置向导来修改这些属性。
      有关验证配置文件的信息,请参阅在升级期间验证配置文件。
    • 继续运行脚本,直到您看到指示 CCM 升级成功的消息为止。
  9. 可选:作为对上一步骤的替代,您可以打开脚本的参数文件,修改缺省值,然后运行命令行的简略格式。

    ccm_params 文件的英语版本和翻译版本都在 <3.0.1CCM_install_dir>/server/upgrade/params 目录中。

    1. 要了解您所采用的语言的参数文件的准确名称,请从 <3.0.1CCM_install_dir>\server\upgrade 目录中运行 locale.bat -ccm -showParamFileName(对于 Windows)或 locale.sh -ccm -showParamFileName(对于 UNIX 系统)。
    2. 打开 ccm_params 或者它的翻译版本,以便编辑和指定各个参数的值。其中一个必须设置的参数是 OLD_AAPLICATION_HOME 目录的路径。请确保此路径未包含任何空格。
  10. 如果是使用 Apache Tomcat,请参阅设置 Apache Tomcat。
  11. 如果是使用 WebSphere Application Server,请卸载先前安装的 Web 应用程序并重新部署 V3.0.1 安装版本随附的 jts.war、ccm.war 和 clmhelp.war。有关进一步的详细信息,请参阅设置 WebSphere Application Server 以进行 V3 升级。
  12. 对安装的服务器以及任何 CLM 应用程序进行配置。

    如果您正在随“更改和配置管理”或任何 CLM 应用程序一起升级 Jazz Team Server,请运行服务器设置向导。(请参阅运行设置向导)如果正在将“更改和配置管理”添加到已建立的 Jazz Team Server,请使用管理 Web 界面。(请参阅向 Jazz Team Server 注册应用程序。)

    注: jazz.net 库中有关升级 Rational Team Concert 的最新条目
父主题: 升级 Rational Team Concert

反馈