升级到 v2.0(WebSphere Application Server 环境)

本主题描述在已安装先前发行版的产品时,如何在 WebSphere® Application Server 环境中安装 IBM® Rational® Quality Manager 2.0。
关于此任务
注: 实际并没有升级到 Rational Quality Manager 2.0, 而是将数据从先前发行版中导出,安装 2.0,然后再将数据导入到 2.0 中。

V1 的缺省安装目录为 C:\Program Files\IBM\RQM。V2 的缺省安装目录为 C:\Program Files\IBM\RQM20。在 WebSphere Application Server 环境中,建议将安装路径更改为不包含任何空格,如 C:\IBM\RQM20

要在 WebSphere Application Server 环境中升级到 v2.0,请执行下列操作:

  1. 停止 WebSphere Application Server。
  2. 使用 repotools -export 命令从现有存储库中导出数据并且将 TAR 文件保存在 Rational Quality Manager 目录结构外,如以下示例所示:
    repotools -export toFile=c:\export.tar teamserver.properties=c:\Program%20Files\IBM\RQM\server\teamserver.properties

    其中 toFile 会指定将存储库导出到的 TAR 文件名称,teamserver.properties 会指定 teamserver.properties 文件的路径。

    注: 可以在以下地址找到使用 repotools 的指示信息:https://jazz.net/learn/LearnItem.jsp?href=content/docs/repo-migration/index.html。请确保使用现有产品所包含的 repotools 版本。
  3. 将数据库和 teamserver.properties 文件备份到 Rational Quality Manager 安装目录以外的临时位置。

    teamserver.properties 文件包含数据库位置,Rational Quality Manager 需要连接到该数据库。缺省情况下,此文件位于 InstallDir\server\conf\jazz\teamserver.properties

  4. 备份 InstallDir\server\conf\jazz\provision_profiles 目录。
  5. 如果是从 v1.0.0.x 进行升级,请确保通知所有对缺省 Quality Manager 项目区域具有访问权的用户。在 v2.0 中,需要将这些用户手动添加到 Quality Manager 项目区域。如果先前版本为 1.0.1 或更高版本,那么应通过安装来对此进行处理。
  6. 启动 WebSphere Application Server。
  7. 卸载 jazz.warhelp.war 文件。
  8. 停止 WebSphere Application Server。
  9. 删除 C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\temp\<server>Node01\server1 位置的 jazz_warhelp_war 目录。
  10. 通过使用 Installation Manager,单击安装,然后遵循安装过程以安装最新版本的 Rational Quality Manager

    如果已安装了 Rational Quality Manager 的其他版本,那么将看到通知消息。单击继续以将该程序包安装到新程序包组。

    注: 无法将 V2.0 安装到与先前版本相同的程序包组和位置中。
  11. 当完成安装后,请将先前已备份的 teamserver.properties 文件复制到新安装位置。

    缺省情况下,此文件位于 InstallDir\server\conf\jazz\teamserver.properties

  12. 根据需要复原先前备份的 provision_profiles 目录并更新供应概要文件,以确保其对于此版本的 Rational Quality Manager 准确无误。

    供应概要文件包括 profile.ini、nlprofile.ini、rqm-license-profile.ini 和 rqm-profile.ini。在大多数情况下,必须更新这些文件中的目录路径。

  13. 重新启动 WebSphere Application Server。
  14. 在“Java™ 虚拟机”页面上的“通用 JVM 参数”部分中,使用新目录路径更新 JVM 参数。
    注: 在 v2.0 中,已向 JVM 参数部分添加了新参数。此外,还请确保选中 WAS 安全设置“在访问不受保护 URI 时使用可用认证数据”。有关进一步详细信息,请参阅设置 WebSphere Application Server
  15. 安装新的 jazz.warhelp.war 文件。
  16. 更新用户和组到 jazz_war 应用程序的映射。

    这些映射为各用户和组指定存储库许可权。

  17. 使用 2.0 版本的 repotools -import 命令从已导出的存储库导入数据,如以下示例所示:
    repotools -import fromFile=c:\export.tar teamserver.properties=c:\Program%20Files\IBM\RQM20\server\conf\jazz\teamserver.properties

    其中 fromFile 会指定将从其中导入存储库的 TAR 文件名称,teamserver.properties 会指定 teamserver.properties 文件的路径。

    注: 请确保使用新安装产品所包含的 repotools 版本。
  18. 启动 jazz.warhelp.war
  19. 升级许可证。
  20. 启动 Rational Team Concert 客户机并更新报告。
  21. 打开浏览器,清除浏览器高速缓存,然后重新连接到 Rational Quality Manager 项目区域。
  22. 验证导入的内容是否位于其中。

反馈