使用升级脚本以脱机方式升级到 3.0.1

本主题描述如何通过使用 rm_upgrade 脚本将 IBM® Rational® Requirements Composer 从 V2 升级到 V3.0.1。

开始之前

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

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

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

如果您使用单一服务器部署,或者使用分布式部署并且可以从 Jazz Team Server 和“需求管理”安装驱动器,那么可以遵循这些有关使用升级脚本的升级指示信息。

如果您正在使用分布式网络部署并且无法安装驱动器,或者您是高级管理员并且打算手动完成每个步骤,那么可以遵循以脱机方式手动升级到 3.0.1中的指示信息。手动步骤将详细说明所执行的脚本。

在 IBM WebSphere® Application Server 环境中,请将安装路径更改为不含任何空格的路径,例如 C:\IBM\JazzTeamServer。但是,如果任何文件名或文件路径参数包含空格,那么您必须将此参数括在双引号内,例如 "C:\Program Files\IBM"。

过程

  1. 查看了解部署和升级过程主题。另外,还要根据需要查看计划部署和升级部分中的主题。
    要点:
    • 所有 RM 工件的原始 RM V2 上下文根 (/rdm) 和 URI 都将保持不变。Jazz Team Server 的上下文根将由 /jazz 更改为 /jts。
    • 如果在 V2 安装中设置了公用 URI,那么必须在 V3.0.1 中使用同一个公用 URI。
  2. 验证您的硬件和软件是否满足或超出应用程序的最低要求,请参阅系统要求。验证当前 V2 teamserver.properties 文件中的以下信息:
    • 公用 URI 属性 - com.ibm.team.repository.server.webapp.url
    • 用于连接到数据库服务器的信息(通常为 com.ibm.team.repository.db.vendor、com.ibm.team.repository.db.jdbc.location 和 com.ibm.team.repository.db.jdbc.password)。

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

    teamserver.properties 文件中的公用 URI 行类似于:
    com.ibm.team.repository.server.webapp.url=https\://hostname.example.com\:9443/jazz
  3. 从 Jazz.net 上的相应项目页面下载 Rational Solution for Collaborative Lifecycle Management (CLM) 中要安装的 IBM Rational Requirements Composer 软件和任何其他应用程序。有关指示信息,请参阅下载产品安装介质。
  4. 停止 IBM Rational Requirements Composer V2 服务器。
  5. 将 IBM Rational Requirements Composer V2 数据库和 teamserver.properties 文件备份到临时 (tmp) 位置。teamserver.properties 文件包含数据库位置,每个应用程序都需要此位置信息来连接到数据库。缺省情况下,在 V2 中,此文件是 InstallDir\server\conf\jazz\teamserver.properties。有关备份指示信息,请参阅下列主题:
    • 备份和恢复 Derby 数据库
    • 备份和恢复其他受支持的数据库
    • 备份和恢复 Jazz Team Server(如果您正在将“需求管理”添加到现有的 Jazz Team Server。)
  6. 从现有的 IBM Rational Requirements Composer V2 数据库中导出数据:
    1. 切换到 IBM Rational Requirements Composer V2 RRC2InstallDir\server 目录。
    2. 运行 repotools -export 命令(对于 Windows)或者 ./repotools.sh - export 命令(对于 AIX® 或 Linux 系统),并将文件保存在 IBM Rational Requirements Composer 目录结构外部,如 V2.0.1 中的以下示例所示:

    Windows:repotools -export toFile=c:\tmp\rrcdata.tar

    AIX 或 Linux:repotools -export toFile=/tmp/rrcdata.tar

    其中 toFile 变量指定要将数据库导出到的 .tar 文件的名称。

    注:
    • 您可以在存储库迁移入门和 Repotools 命令行参考中找到有关使用 repotools 的详细指示信息。请确保使用现有 V2 产品所包含的 repotools 版本。
    • Jazz.net 上的内容按 Jazz.net 使用条款进行管理,并且按原样提供,而没有任何形式的保证。
  7. 如果您已安装 Jazz Team Server V3.0.1,请停止所有 V3.0.1 服务器(包括 Jazz Team Server 和其他 CLM 应用程序)并备份 Jazz Team Server V3.0.1 数据库和环境。请转到步骤 10。
  8. 如果您尚未安装 Jazz Team Server V3.0.1,请安装 Jazz Team Server。请不要运行设置向导。
  9. 如果您尚未安装 Jazz Team Server V3.0.1,并且正在使用除缺省的 Derby 数据库以外的数据库,那么必须创建 Jazz Team Server 数据库。

    Jazz Team Server 和数据仓库需要数据库。您不必为“需求管理”应用程序创建数据库,这是因为该应用程序将 Jazz Team Server 数据库用作数据存储器。有关每个数据库的详细信息,请参阅设置数据库中的主题。

    注: 如果您正在使用 Oracle 或 SQL Server 数据库,那么确保将数据库驱动程序复制到正确的位置。有关详细信息,请参阅设置 Oracle 数据库和设置 SQL Server 数据库。
  10. 将“需求管理”应用程序安装到另一台机器。有关指示信息,请参阅使用 IBM Installation Manager 进行安装。

    在安装期间,请选择使用 Rational Requirements Composer 2.x 上下文根。这将使用保留 RM 的 /rdm V2 上下文根所需的选项来安装 RM 应用程序,这对于保留指向 RM 工件的链接而言是必需的。如果未选择此选项,那么将导致升级失败。有关详细信息,请参阅了解部署和升级过程。

  11. 安装结束时,请对您要启动哪个程序选择无,单击完成,然后单击退出。
  12. 如果您正在 WebSphere Application Server 上进行部署,请停止并卸载下列 V2 .war 文件:converter.war、jazz.war、rrc-help.war 和 rdm.war。有关更多信息,请参阅设置 WebSphere Application Server 以进行 V3 升级。
  13. 运行脱机升级脚本。从 Jazz Team Server V3.0.1 的安装位置打开新的命令窗口,浏览到 JTS301InstallDir\server 并运行 upgrade\rm_upgrade.bat 升级脚本(在 Windows 上)或 upgrade/rm_upgrade.sh 升级脚本(在 AIX 或 Linux 系统上)。此脚本运行时,它将使用计算机语言环境的语言设置。
    注: 可以通过在命令行中指定所有参数来运行此脚本。另外,如果您要反复运行升级脚本,那么还可以编辑脚本参数文件并运行缩略的命令行。有关参数文件的指示信息,请参阅步骤 14。
    要点:
    • 虽然此脚本文件在 upgrade 目录下,但它必须从 server 目录中运行。并且,如果路径包含空格,请确保将路径名括在双引号中。
    • 如果您在 Rational Requirements Composer V2 中使用了浮动许可证,那么存在一个已知问题,即,您可能必须先停止升级脚本、启动 Jazz Team Server 并安装 V3.0.1 浮动许可证,然后才能从 IBM Rational Requirements Composer V2 数据库导入数据。有关如何执行此操作的更多信息,请参阅 https://jazz.net/library/article/659。

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

    Windows:

    upgrade\rm_upgrade.bat -oldApplicationHome RRC2InstallDir\server\conf -importFromFile c:\tmp\export.tar -createJTSTables 

    AIX 或 Linux:

    ./upgrade/rm_upgrade.sh -oldApplicationHome RRC2InstallDir/server/conf -importFromFile /tmp/export.tar -createJTSTables 
    注: -createJTSTables 参数适用于 Jazz Team Server V3.0.1 和任何“协作生命周期管理”产品的首次安装。如果您正在单独安装 RM 应用程序,那么不必在命令中包括此参数,这是因为 Jazz Team Server V3.0.1 存在于其他位置。createTables 参数将创建 Jazz Team Server 数据库并导入 .tar 文件的内容。如果目前已经有 Jazz Team Server 数据库,那么在此命令行中不要包括 createTables 参数,因为这将覆盖现有数据库。

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

    Windows:

    JTS301InstallDir\server upgrade\rm_upgrade.bat -oldApplicationHome RRCS2InstallDir\server\conf -importFromFile c:\tmp\export.tar -newApplicationHome RRC301InstallDir\server\conf -jtsURL https://fully qualified domain name:port/jts

    AIX 或 Linux:

    JTS301InstallDir/server ./upgrade/rm_upgrade.sh -oldApplicationHome RRCS2InstallDir/server/conf -importFromFile /tmp/export.tar -newApplicationHome RRC301InstallDir/server/conf -jtsURL https://fully qualified domain name:port/jts
    注:
    • 如果您使用分布式部署并且尚未配置 Jazz Team Server V3.0.1,那么可以对以上命令行示例添加 -createJTSTables 参数。
    • -jtsURL 参数是 Jazz Team Server 的公用 URI。缺省情况下,Jazz Team Server 公用 URI 派生自应用程序的公用 URI。在 Jazz Team Server 与 RM 应用程序不在同一服务器实例上运行的分布式部署中,必须指定此参数。

    有关命令行选项的更多详细信息,请输入下列其中一个命令:

    Windows:upgrade\rm_upgrade.bat -help

    AIX 或 Linux:./upgrade/rm_upgrade.sh -help

    由于要迁移的信息量较大,因此完成脱机迁移所需的时间较长。
    注意: 脱机迁移期间,您必须复审用于显示所合并文件内容的提示,特别是 teamserver.properties 文件中指定的数据库连接,并根据需要编辑已合并的文件。

    此脚本将完成下列任务:

    1. 按以下方式更新 V3.0.1 配置文件:
      • 运行 -migration_rm_updateConfigurationFiles 命令并更新配置和 Tomcat 文件。请输入 [E] 以执行命令,输入 [S] 跳过步骤,或者按 [Enter] 键取消脚本执行。
        要点: 请不要修改属性来连接到数据仓库数据库,即使这些属性当前设置为 Derby 也是如此。只能使用服务器设置向导来修改这些属性。
        注: 如果您尚未安装 Jazz Team Server V3.0.1,那么现在必须为您先前在步骤 9 中创建的新 Jazz Team Server 数据库输入数据库位置属性。
      • 在成功地合并配置文件之后,请输入 [C] 继续。这将打开一个记事本窗口(在 AIX 或 Linux 系统上,将打开 vi 编辑器),您可以在此窗口中验证 Jazz Team Server teamserver.properties 文件。验证 com.ibm.team.repository.server.webapp.url 属性所指定的公用 URI 根是否正确。并且,验证数据库属性是否正确。完成后,请保存更改(如果有)并关闭编辑器以继续执行脚本。
      • 复制 V2 Tomcat 用户 .xml 文件。
      • 将 V2 friendsconfig.rdf 文件(此文件包含已进行跨存储库集成设置的服务器的列表)与 V3.0.1 合并。
      • 将 V2 server.xml 和 web.xml(LDAP 设置)文件的内容与 V3.0.1 合并。
    2. 通过使用 repotools-jts -import 命令(对于 Windows)或者 ./repotools-jts.sh -import 命令(对于 AIX 或 Linux 系统),将先前导出的 RM V2 数据从 .tar 文件导入到 Jazz Team Server V3.0.1 数据库中。
      注:
      • 为“需求管理”应用程序 V3.0.1 导入大型存储库可能会导致 OutOfMemoryException 错误。如果您拥有大量项目和工件,请将 repotools-jts.bat 或 repotools-jts.sh 脚本中的 -Xmx 参数由缺省值 1500M 增大为更大的值。如果机器有足够的内存,那么使用 4096M 可以获得最佳结果。
      • 要查看对配置文件所作的更改的详细 Rational Requirements Composer 列表,请参阅Rational Requirements Composer 更改。
  14. 可选:作为对上一步骤的替代,您可以打开脚本参数文件,修改缺省值,然后运行命令行的简略格式。有关这些值的详细信息,请参阅rm_upgrade。

    参数文件的英语版本和翻译版本都在 JazzInstallDir\server\upgrade\params\rm_params.bat(对于 Windows)或者 ./params/rm_params.sh(对于 AIX 或 Linux 系统)目录中。

    1. 要了解您所采用的语言的相应参数文件的准确名称,请从 JazzInstallDir\server\upgrade 目录中运行 locale.bat -rm -showParamFileName 命令(对于 Windows)和 ./locale.sh -rm -showParamFileName 命令(对于 AIX 或 Linux 系统)。
    2. 打开 rm_params 文件或者它的翻译版本,以便编辑和指定各个参数的值。其中一个必须设置的参数是 OLD_APPLICATION_HOME 目录的路径。请确保此路径未包含任何空格。但是,如果任何文件名或文件路径参数包含空格,那么您必须将此参数括在双引号内。例如,设置 OLD_APPLICATION_HOME="C:\Program Files\IBM\RRCS2002\server\conf"。有关每个参数的信息,请参阅 JazzInstallDir\server\upgrade\doc\rm_help.txt 文件。
  15. 确认已更新存储库数据和配置文件。有关详细信息,请参阅在升级期间验证配置文件和-migration_rm_updateConfigurationFiles。
  16. 完成脱机迁移之后,将 Jazz Team Server V3.0.1 数据库和整个服务器目录备份到与您备份 V2 数据库所在位置不同的位置。请先进行备份,然后再接着执行联机迁移。切勿覆盖 V2 数据库备份。
  17. 如果您创建了安全证书以与先前发行版配合使用,那么复制该证书或者创建一个新证书。有关详细信息,请参阅配置安全证书。
  18. 如果您正在将 Tomcat 应用程序服务器作为 Windows 服务运行,那么必须除去该服务并重新安装。请参阅在作为 Windows 服务(32 位)的 Apache Tomcat 中运行,以获取命令语法。
  19. 如果是在 IBM WebSphere Application Server 上进行部署,请部署 V3.0 WAR 文件并将安全角色映射至用户或组。有关详细信息,请参阅设置 WebSphere Application Server 以进行 V3 升级。
  20. 备份完成之后,请继续执行联机迁移中的步骤。请参阅联机迁移升级步骤。
    注: jazz.net 库中有关升级 Rational Requirements Composer 的最新条目
父主题: 升级 Rational Requirements Composer
相关概念:
迁移升级局限性
Rational Requirements Composer 2.0 到 3.0.1 升级过程示例
全分布式 Rational Requirements Composer 2 至 3.0.1 企业拓扑示例
许可证管理概述

反馈