本主题描述如何执行用于以联机方式将项目内容从
IBM Rational® Requirements Composer V2 迁移到 V3.0.1 的升级步骤。
开始之前
在开始这些步骤之前,请先按照使用升级脚本以脱机方式升级到 3.0.1主题中的步骤进行操作。执行联机迁移时,下列条件适用:
- 不允许非管理用户登录“需求管理”(RM) Web 应用程序。系统会显示一则错误消息,指示正在进行迁移,服务器尚未准备就绪,无法使用。
- 如果管理员正在将 Rational Requirements Composer 合并到现有的
Jazz™ Team Server 部署中,那么在迁移完成之前,所有其他使用此
Jazz Team Server 的应用程序都将处于只读方式。
注: 如果联机迁移失败,请在完成脱机升级后复原已备份的
Jazz Team Server V3.0.1 服务器、数据库和
server/conf 目录,然后再次运行联机迁移。
过程
- 启动所有 V3.0.1 服务器。确保已按照部署和启动服务器中的指示信息启动了服务器。
- 打开浏览器,清除浏览器高速缓存,然后浏览到 RM Web 客户端。指定以下 URL 中的服务器名称和端口:https://server:port/rdm/web/projects/migration。缺省端口是 9443。此页面会检测是否正在进行迁移,并启动迁移向导。
- 接受 Rational Requirements Composer -
分析人员客户访问许可证。
- 单击打开迁移服务面板,然后单击以使用迁移向导来启动
Rational Requirements Composer 迁移。正在进行迁移时,会将关于正在处理哪个存储区域以及何时开始建立索引的状态通过迁移 Web 页面报告给管理员。
要点: 迁移开始之后,不能取消此操作,直到迁移完成为止。
- 迁移完成之后,将为 Rational Requirements Composer 数据重新建立索引。
- 重新建立索引之后,应用程序会对已迁移的数据执行验证和一致性检查,并向管理员提供反馈。此时将显示“已完成迁移”消息。单击下一步。您可以通过单击“复审迁移结果”面板上的链接来查看已迁移的项目的内容。否则,请单击下一步。
- 此时,可以更新任何指向数据库的项目链接。
注: 要在以后更新链接,请单击关闭。您随时都可以通过从管理菜单项中选择更新项目链接来更新链接。
- 项目更新时,将向管理员报告状态。系统可能会提示您输入远程服务器的登录详细信息。完成后,单击关闭。
注: 如果发生错误,您可以尝试通过从管理菜单项中选择更新项目链接再次更新链接。
- 完成迁移后,如果尚未安装 Jazz Team Server V3.0.1,请运行
Jazz Team Server 设置向导以确保为新的 Jazz Team Server
配置了数据仓库数据库,并确保 RM
已正确地向“生命周期项目管理”应用程序进行注册。有关更多信息,请参阅运行设置向导和配置服务器中的主题。
- 更新报告。如果您曾在
Rational Requirements Composer V2 中使用
Rational Publishing Engine 定制报告模板,那么必须迁移这些报告以使用
Rational Requirements Composer V3.0.1 模式。有关详细信息,请参阅https://jazz.net/wiki/bin/view/Main/RRC3MigrationOfRRC2CustomReports。
- 完成迁移后,请验证配置文件中的下列项:
- RM 应用程序已向 Jazz Team Server 注册。(您可以从服务器管理页面进行查看,方法是从左侧导航面板中单击已注册的应用程序链接。)
- RDM 仪表板可用。(在迁移结束时单击该链接,以访问仪表板。)
- 所导入的内容可用。
有关详细信息,请参阅验证升级。
- 如果您从 V2 应用程序的集成入手,并且只将 Rational Requirements Composer
和 Jazz Team Server 升级到 V3.0.1,那么必须以手动方式编辑
V2 Rational Team Concert 和
Rational Quality Manager 服务器上的
friendsconfig.rdf 文件,以确保仪表板
Viewlet(窗口小部件)在这些应用程序中正常工作:
注: 如果将 V2“更改和配置管理”(CCM) 和“质量管理”(QM) 应用程序升级到 V3.0.1,那么将自动执行下列修正。在这种情况下,不需要进行下列编辑。
- 在文本编辑器中,打开 V2 CCM 和 QM 应用程序服务器上的以下文件:InstallDir/server/conf/jazz/friendsconfig.rdf。
- 修订 oauthDomain URI 以使其指向 Rational Requirements Composer 服务器上的
/jts/rootservices(从而替换来自 V2 的值
/jazz/rootservices):
<jfs:oauthDomain>http://rrc_hostname:9445/rdm/rootservices,http://jts_hostname:9445/jts/rootservices" />
- 保存并关闭 friendsconfig.rdf 文件,然后重新启动 V2 应用程序服务器。
- 如果您计划创建报告的 PDF 版本,那么必须配置
fronting.properties 文件中的
com.ibm.rdm.fronting.server.publish.PDFFont
属性,以使用包含您的语言环境的 Unicode
字符的字体(如果缺省字体不支持这些字符)。例如,Microsoft Office
附带的 Arial Unicode MS 就是一种可用于优化 PDF 报告生成的字体。在除
Microsoft Windows
以外的操作系统中,必须配置包含必需字符的字体名。