使用升级脚本将 Rational Quality Manager 升级到 3.0.1

本主题描述如何使用 qm_upgrade 脚本将 Rational® Quality Manager V2 升级到 V3。

开始之前

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

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

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

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

如果您正在从 V2.0.1 iFix02 或更高版本升级,请先升级到 V2.0.1.1 或更高版本,然后再导出数据。接着,运行以下 repotools 命令以防止导出/导入过程发生潜在的错误。

Windows:repotools -repairRequests

Unix/Linux:./repotools.sh -clean -repairRequests

V2.0.1 iFix02 以前的版本的用户可以忽略此步骤。

过程

  1. 根据需要,查看有关计划部署和升级的部分中的主题。
  2. 验证现有 V2 teamserver.properties 文件中的公用 URL 属性 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 中,必须使用同一个公用 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. 从 jazz.net 上的相应项目页面下载 Rational Quality Manager 软件。有关指示信息,请参阅下载产品安装介质。
  4. 停止 V2 服务器。
    注: 如果您正在分布式环境中工作,并且已安装 Jazz Team Server V3.0.1 来最大程度地缩短 Jazz Team Server 和其他应用程序的停机时间,那么可以选择性地使服务器处于运行状态,直到升级脚本完成将 V2 数据导入到 V3 质量管理 (QM) 数据库中为止。此时,必须停止 Jazz Team Server。在该脚本完成将用户和许可证发放数据导入到 Jazz Team Server 中后,可以将其重新启动。
  5. 将数据库和 teamserver.properties 文件备份到临时位置。在缺省情况下,teamserver.properties 文件位于 V2 中的 InstallDir\server\conf\jazz\teamserver.properties。要获取备份指示信息,请参阅下列主题:
    • 备份和恢复 Derby 数据库
    • 备份和恢复其他受支持的数据库
    • 备份和恢复 Jazz Team Server(如果您正在将“质量管理”添加到现有的 Jazz Team Server)
  6. 从现有的 V2 存储库导出数据。
    1. 切换到 V2 RQM2InstallDir\server 目录。
    2. 运行 repotools -export 命令并将文件保存在 Rational Quality Manager 目录结构外面,如 V2.0.1 中的下列示例所示:

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

    Unix/Linux:./repotools.sh -export toFile=/tmp/export.tar

    其中 toFile 会指定将存储库导出到的 TAR 文件名称。

    注: 您可以在存储库迁移入门和 Repotools 命令行参考中找到有关使用 repotools 的详细指示信息。请确保使用现有 V2 产品所包含的 repotools 版本。
  7. 如果您尚未安装 Jazz Team Server,请下载并在磁盘上的新位置安装此服务器、“质量管理”应用程序和必需的基本许可证密钥。如果已安装服务器,请安装“质量管理”应用程序。有关指示信息,请参阅使用 IBM Installation Manager 进行安装。
    要点: 与 V2 不同,“质量管理”应用程序中将不再创建需求、缺陷和其他工作项。想要利用这些功能的测试团队还必须安装“需求管理”和“更改和配置管理”。在分布式环境中,可以单独安装这些应用程序。

    在安装期间,请选择使用 Rational Quality Manager 2.x 上下文根。这会将 QM 应用程序安装到 /jazz 上下文根,而不是 /qm 上下文根。要保留指向 QM 工件的链接,必须选择此选项。如果未选择此选项,那么将导致升级失败。有关详细信息,请参阅了解部署和升级过程。

  8. 安装结束时,请为您要启动哪个程序选择无。
  9. 如果您正在 WebSphere Application Server 上进行部署,请停止并卸载 V2 jazz.war 和 help.war 应用程序。
  10. 如果您正在使用除缺省的 Derby 数据库以外的数据库,请创建 V3 数据库。

    “Jazz Team Server”、“质量管理”、“更改和配置管理”以及“数据仓库”都需要数据库。您无需为“需求管理”创建数据库,这是因为“需求管理”将 Jazz Team Server 数据库用作数据存储器。有关每个数据库的详细信息,请参阅设置数据库中的主题。

    注: 如果您正在使用 Oracle 或 SQL Server 数据库,那么确保将数据库驱动程序复制到正确的位置。有关详细信息,请参阅设置 Oracle 数据库和设置 SQL Server 数据库。
  11. 在 V3 安装中,打开新的命令窗口,浏览到 JazzInstallDir\server 并运行 upgrade\qm_upgrade.bat 脚本(对于 Windows)或 upgrade/qm_upgrade.sh 脚本(对于 UNIX 系统)。
    注: 可以通过在命令行中指定所有参数来运行脚本。另外,如果您要反复运行升级脚本,那么还可以编辑此脚本的参数文件并运行缩略的命令行。有关参数文件的指示信息,请参阅12。
    要点: 虽然此脚本文件在 upgrade 目录下,但它必须从 server 目录中运行。并且,如果路径包含空格,请确保将其括在双引号中。

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

    Windows:

    upgrade\qm_upgrade.bat -oldApplicationHome RQM201InstallDir\server\conf -importFromFile c:\tmp\export.tar -createJTSTables

    Unix/Linux:

    ./upgrade/qm_upgrade.sh -oldApplicationHome RQM201InstallDir/server/conf -importFromFile /tmp/export.tar -createJTSTables
    注: -createJTSTables 参数适用于 Jazz Team Server 3.0.1 的第一次安装。

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

    Windows:

    upgrade\qm_upgrade.bat -oldApplicationHome RQM201InstallDir\server\conf -importFromFile c:\tmp\export.tar -newJTSHome JTS301InstallDir\server\conf

    Unix/Linux:

    ./upgrade/qm_upgrade.sh -oldApplicationHome RQM201InstallDir/server/conf -importFromFile /tmp/export.tar -newJTSHome JTS301InstallDir\server\conf
    注:
    • 如果您使用分布式部署并且尚未配置 Jazz Team Server V3.0.1,那么可以对以上命令行示例添加 -createJTSTables 参数。
    • -jtsURL 参数是 Jazz Team Server 的公用 URI。缺省情况下,Jazz Team Server 公用 URI 派生自应用程序的公用 URI。在 Jazz Team Server 与 QM 应用程序不在同一服务器实例上运行的分布式部署中,必须指定此参数。
    • 如果 Jazz Team Server V3.0.1 仍处于运行状态,那么您必须先将其停止,然后脚本才能开始迁移用户和许可证信息的过程。Jazz Team Server 以及任何依赖于其的应用程序都将处于脱机状态。

    如果您需要更多有关命令行选项的详细信息,请输入以下命令:

    Windows:upgrade\qm_upgrade.bat -help

    Unix/Linux:./upgrade/qm_upgrade.sh -help

    此脚本将完成下列任务:

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

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

    1. 要了解您所采用的语言的相应参数文件的准确名称,请从 JazzInstallDir\server\upgrade 目录中运行 locale.bat -qm -showParamFileName(对于 Windows)和 ./locale.sh -qm -showParamFileName(对于 UNIX 系统)。
    2. 打开 qm_params 或者它的翻译版本,以便编辑和指定各个参数的值。其中一个必须设置的参数是 OLD_APPLICATION_HOME 目录的路径。如果路径包含空格,请确保将其括在双引号中。有关每个参数的信息,请参阅 JazzInstallDir\server\upgrade\doc\qm_help.txt。
  13. 验证配置文件。有关详细信息,请参阅在升级期间验证配置文件和-migration_qm_updateConfigurationFiles。
  14. 如果您创建了安全证书以与先前发行版配合使用,那么从先前发行版复制该证书,或者创建一个新证书。有关详细信息,请参阅配置安全证书。
  15. 如果您正在将 Tomcat 应用程序服务器作为 Windows 服务运行,那么必须除去该服务并重新安装。请参阅在作为 Windows 服务(32 位)的 Apache Tomcat 中运行,以获取命令语法。
  16. 如果是在 WebSphere Application Server 上进行部署,请部署 3.0 WAR 文件并将安全角色映射至用户或组。 有关详细信息,请参阅设置 WebSphere Application Server 以进行 V3 升级和在 WebSphere Application Server 上部署 CLM 应用程序。
  17. 启动应用程序服务器(Jazz Team Server V3 或 WebSphere Application Server V3)。
    注: 如果 QM 应用程序是单独安装的,那么您还需要启动 CLM 应用程序。
  18. 对安装的服务器以及任何 CLM 应用程序进行配置。

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

  19. 将您的需求从 V2 迁移至需求管理 (RM) 应用程序。有关详细信息,请参阅迁移基于工作项的需求。
    注: 如果在 Rational Quality Manager 内以内部方式维护 V2 需求,那么此步骤是必需的。 如果使用外部需求提供者,那么不需要此步骤。
  20. 打开浏览器,清除浏览器高速缓存并重新连接项目。
  21. 升级许可证。有关简要概述,请参阅了解许可。 然后,按照安装和管理许可证密钥中的步骤进行操作。
    注: V2 中的“质量管理员”许可证和“实验室管理员”许可证在 V3 中现在称为“质量专家”许可证。不再有单独的“实验室管理员”许可证。V2 中的“连接者”许可证现在仍然称为“连接者”许可证,而 V2 中的“查看者”许可证现在称为“添加者”许可证。
  22. 如果帮助应用程序 (clmhelp.war) 与当前应用程序在不同的服务器上,请配置帮助位置。有关详细信息,请参阅在分布式环境中配置帮助的位置。
  23. 升级仪表板。

    以管理用户身份登录应用程序,并浏览到任何包含仪表板的页面。然后,单击迁移以升级所有仪表板。

  24. 更新报告。
    1. 首先,请迁移 V2 数据仓库。有关详细信息,请参阅从 V2 迁移报告数据。
    2. 然后,启动 Rational Team Concert 客户机并更新到最新报告模板。有关详细信息,请参阅更新预定义报告模板。
    3. 如果您曾在 V2 中使用 Rational Common Reporting,那么必须将报告迁移到 Rational Reporting for Development Intelligence。有关详细信息,请参阅迁移到 Rational Reporting for Development Intelligence。
  25. 确认升级完成。有关详细信息,请参阅验证升级。

下一步做什么

在升级完成后,转到在升级之后配置 Jazz Team Server 以及第一个应用程序和向 Jazz Team Server 注册其他应用程序。
注: 如果您正在从 Rational Common Reporting 迁移,请先备份现有的 Rational Common Reporting 数据仓库数据库,然后再配置服务器。要获取备份指示信息,请参阅托管数据仓库的关系数据库管理系统的文档。
注: jazz.net 库中有关升级 Rational Quality Manager 的最新条目
父主题: 升级 Rational Quality Manager
相关概念:
设置数据库
许可证管理概述
相关任务:
设置 WebSphere Application Server

反馈