本主题描述将
Rational® Quality Manager V2 手动升级到 V3 的过程。
开始之前
在开始执行升级之前,请确保所有机器上的时钟都已使用网络时间协议 (NTP) 进行同步。时间是关键元素,可允许将一个网络节点上的事件映射至另一个网络节点上的相应事件。如果要避免问题,可通过 NTP 服务的企业部署来解决这些问题。有关 NTP 的更多信息,请访问http://www.ntp.org/。此外,所有服务器对其用户必须使用相同的认证方法。
如果您计划升级多款产品,请参阅升级顺序以帮助您确定首先升级的产品。
在 WebSphere® Application Server 环境中,建议您将安装路径更改为不含任何空格的路径,例如 C:\IBM\JazzTeamServer。如果任何文件名或文件路径参数包含空格,那么您必须将此参数括在双引号内。
如果您正在从 V2.0.1 iFix02 或更高版本升级,请先升级到 V2.0.1.1
或更高版本,然后再导出数据。接着,在 V2 服务器上运行以下
repotools 命令以避免导出/导入过程的潜在错误。
Windows:repotools -repairRequests
Unix/Linux:./repotools.sh -clean -repairRequests
V2.0.1 iFix02
以前的版本的用户可以忽略此步骤。
过程
- 根据需要,查看有关计划部署和升级的部分中的主题。
- 验证现有 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
- 从 jazz.net 上的相应项目页面下载 Rational Quality Manager
软件。有关指示信息,请参阅下载产品安装介质。
- 停止 V2 服务器。
注: 如果您正在分布式环境中工作,并且已安装
Jazz™ Team Server V3.0.1
来最大程度地缩短
Jazz Team Server 和其他应用程序的停机时间,那么可以选择性地使服务器处于运行状态,直到完成将 V2 数据导入到 V3 质量管理 (QM) 数据库中为止。此时,必须停止
Jazz Team Server。完成将用户和许可证发放数据导入到
Jazz Team Server (
14) 中后,可以将其重新启动。
- 将 V2 数据库和 teamserver.properties
文件备份到临时位置。在缺省情况下,teamserver.properties 文件位于
V2 中的 InstallDir\server\conf\jazz\teamserver.properties。要获取备份指示信息,请参阅下列主题:
- 使用 repotools -export 命令从现有 V2 存储库导出数据,将文件保存在 Rational Quality Manager 目录结构外部,如 V2.0.1 中的以下示例所示:
repotools -export toFile=c:\export.tar teamserver.properties=c:\Program%20Files\IBM\RQM201\server\conf\jazz\teamserver.properties
其中 toFile 会指定将存储库导出到的 TAR 文件名称,teamserver.properties 会指定 teamserver.properties 文件的路径。
- 如果您尚未安装 Jazz Team Server,请在磁盘上的新位置安装此服务器、“质量管理”应用程序和必需的基本许可证密钥。如果已安装服务器,请安装“质量管理”应用程序。有关指示信息,请参阅使用 IBM Installation Manager 进行安装。
要点: 与 V2 不同,“质量管理”应用程序中将不再创建需求、缺陷和其他工作项。想要利用这些功能的测试团队还必须安装“需求管理”和“更改和配置管理”。在分布式环境中,可以单独安装这些应用程序。
在安装期间,请选择使用 Rational Quality Manager 2.x 上下文根。这会将 QM 应用程序安装到 /jazz 上下文根,而不是 /qm 上下文根。要保留指向
QM 工件的链接,必须选择此选项。如果未选择此选项,那么将导致升级失败。有关详细信息,请参阅了解部署和升级过程。
- 安装结束时,请为您要启动哪个程序选择无。
- 如果您正在使用除缺省的 Derby 数据库以外的数据库,请创建 V3 数据库。
“Jazz Team Server”、“质量管理”、“更改和配置管理”以及“数据仓库”都需要数据库。您无需为“需求管理”创建数据库,这是因为“需求管理”将 Jazz Team Server 数据库用作数据存储器。有关每个数据库的详细信息,请参阅设置数据库中的主题。
- 在 V3.0.1 (RQM301InstallDir/server) 中打开新的命令窗口并输入
repotools-jazz -migration_qm_updateConfigurationFiles oldApplicationHome=RQM2InstallDir/server/conf,以便将 V2 Jazz 配置文件与 V3 的配置文件合并。
如果您将 Jazz Team Server V3.0.1 与 QM 应用程序分开安装(例如分布式部署中的情况),请执行下列操作:
- 安装 Jazz Team Server 所安装在的驱动器或文件系统。
- 在 -migration_qm_updateConfigurationFiles 命令行中,通过包括
-newJTSHome 参数指定 Jazz Team Server 3.0.1 的位置。
此命令会完成下列任务:
- 根据 V2 Jazz teamserver.properties 文件中的信息,更新应用程序和 JTS 的 V3 teamserver.properties 文件
- 复制 Tomcat 用户 XML 文件的内容
- 复制 friendsconfig.rdf 文件(此文件包含已进行跨存储库集成设置的服务器的列表)
- 将 V2 server.xml 和 web.xml(LDAP 设置)文件的内容与 V3 合并
- 验证配置文件。有关详细信息,请参阅在升级期间验证配置文件和-migration_qm_updateConfigurationFiles。
- 如果您正在 WebSphere Application Server 上进行部署,请停止并卸载 V2
jazz.war 和 help.war 应用程序。
- 使用 repotools-jazz -import 命令,将 Rational Quality Manager 数据从已导出的 V2 存储库导入新的 V3 质量管理 (QM) 存储库,如以下示例所示:
repotools-jazz -import fromFile=c:\export.tar
其中 fromFile 会指定将要从其中导入存储库的 TAR 文件名称。
注: 为“质量管理”3.0.1 导入大型存储库可能会导致 OutOfMemoryException
错误。拥有大量项目和工件的客户应该将 repotools-jazz.bat 或 repotools-jazz.sh
脚本中的 -Xmx 参数由缺省值 1500M 增大为更大的值。如果机器有足够的内存且正在运行 64 位操作系统,那么建议您使用 4096M。
- 创建新的 Jazz Team Server (JTS) 数据库并从质量管理数据库传输用户和许可证发放数据。
- 使用下列 repotools-jazz 命令从质量管理应用程序导出用户数据:
repotools-jazz -migration_exportJTSData toFile=jtsData.tar
- 使用以下 repotools-jts 命令将用户和许可证发放数据导入到 Jazz Team Server 数据库中。
要点: 如果这是新安装的 Jazz Team Server 和任何“协作生命周期管理”产品,那么 repotools-jts 命令可以包括 createTables 参数(这将创建新的 JTS 数据库)。如果目前已经有 JTS 数据库,那么在此命令行中不要包括 createTables 参数,因为这将覆盖现有数据库。
repotools-jts -migration_importJTSData fromFile=jtsData.tar createMappingFile=mapping-qm.txt createTables
- 使用下列 repotools-jazz 命令将用户映射数据导入 QM 数据库。该映射由 QM 应用程序用来与 JTS 数据库通信。
repotools-jazz -migration_importUserMapping fromMappingFile=mapping-qm.txt
- 如果您创建了安全证书以与先前发行版配合使用,那么从先前发行版复制该证书,或者创建一个新证书。有关详细信息,请参阅配置安全证书。
- 如果您正在将 Tomcat 应用程序服务器作为 Windows 服务运行,那么必须除去该服务并重新安装。请参阅在 Apache Tomcat 中作为 Windows 服务运行(32 位,Rational Quality Manager),以获取命令语法。
- 如果是在 WebSphere Application Server 上进行部署,请部署 3.0 WAR 文件并将安全角色映射至用户或组。
有关详细信息,请参阅设置 WebSphere Application Server 以进行 V3 升级和在 WebSphere Application Server 上部署 CLM 应用程序。
- 启动应用程序服务器(Jazz Team Server V3 或 WebSphere Application Server V3)。
- 对安装的服务器以及任何 CLM 应用程序进行配置。
如果您正在随“质量管理”或任何 CLM 应用程序一起升级 Jazz Team Server,请运行服务器设置向导(请参阅运行设置向导)。如果您正在将“质量管理”添加到已建立的 Jazz Team Server,请使用管理 Web 界面(请参阅向 Jazz Team Server 注册应用程序)。
- 转至 jazz/admin 并验证是否存在任何错误。
- 将您的需求从 V2 迁移至需求管理 (RM) 应用程序。有关详细信息,请参阅迁移基于工作项的需求。
注: 如果在 Rational Quality Manager 内以内部方式维护 V2 需求,那么此步骤是必需的。
如果使用外部需求提供者,那么不需要此步骤。
- 打开浏览器,清除浏览器高速缓存并重新连接项目。
- 升级许可证。有关简要概述,请参阅了解许可。
然后,按照安装和管理许可证密钥中的步骤进行操作。
注: V2 中的“质量管理员”许可证和“实验室管理员”许可证在 V3 中现在称为“质量专家”许可证。不再有单独的“实验室管理员”许可证。V2 中的“连接者”许可证现在仍然称为“连接者”许可证,而 V2 中的“查看者”许可证现在称为“添加者”许可证。
- 如果帮助应用程序 (clmhelp.war) 与当前应用程序在不同的服务器上,请配置帮助位置。有关详细信息,请参阅在分布式环境中配置帮助的位置。
- 升级仪表板。
以管理用户身份登录应用程序,并浏览到任何包含仪表板的页面。然后,单击迁移以升级所有仪表板。
- 更新报告。
- 首先,请迁移 V2 数据仓库。有关详细信息,请参阅从 V2 迁移报告数据。
- 然后,启动 Rational Team Concert 客户机并更新到最新报告模板。有关详细信息,请参阅更新预定义报告模板。
- 如果您曾在 V2 中使用 Rational Common Reporting,那么必须将报告迁移到
Rational Reporting for Development Intelligence。有关详细信息,请参阅迁移到 Rational Reporting for Development Intelligence。
- 确认升级完成。有关详细信息,请参阅验证升级。
下一步做什么
在升级完成后,转到
在升级之后配置 Jazz Team Server 以及第一个应用程序。
注: 如果您正在从 Rational Common Reporting 进行迁移,请在配置服务器之前备份现有的 Rational Common Reporting 数据仓库数据库。要获取备份指示信息,请参阅托管数据仓库的关系数据库管理系统的文档。