本主题描述如何手动执行用于以脱机方式将服务器从
IBM® Rational® Requirements Composer
V2 迁移到 V3.0.1 的升级步骤。
开始之前
在开始执行升级之前,请确保所有机器上的时钟都已使用网络时间协议 (NTP) 进行同步。时间是关键元素,它使一个网络节点上的事件能够映射至另一个网络节点上的相应事件。可以通过 NTP 服务的企业部署来解决这些问题。有关 NTP 的更多信息,请访问http://www.ntp.org/。此外,所有服务器对其用户必须使用相同的认证方法。
如果您计划升级多款产品,请参阅升级顺序以帮助您确定首先升级的产品。
在
IBM WebSphere® Application Server 环境中,请将安装路径更改为不含任何空格的路径,例如
C:\IBM\JazzTeamServer。但是,如果任何文件名或文件路径参数包含空格,那么您必须将此参数括在双引号内。例如,"C:\Program Files\IBM"。
过程
- 查看了解部署和升级过程主题。另外,还要根据需要查看计划部署和升级部分中的主题。
要点: - 所有 RM 工件的原始 RM V2 上下文根 (/rdm) 和 URI
都将保持不变。Jazz™ Team Server 的上下文根将由 /jazz 更改为 /jts。
- 如果在 V2 安装中设置了公用 URI,那么必须在 V3.0.1 中使用同一个公用 URI。
- 验证您的硬件和软件是否满足或超出应用程序的最低要求。请参阅系统要求。检索现有的
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
- 从 Jazz.net 下载
Rational Solution for Collaborative Lifecycle Management (CLM) 中要安装的
IBM Rational Requirements Composer 软件和其他应用程序。有关指示信息,请参阅下载产品安装介质。
- 停止 IBM Rational Requirements Composer V2 服务器。
- 将 IBM Rational Requirements Composer V2
数据库和 teamserver.properties 文件备份到临时 (tmp) 位置。teamserver.properties 文件包含数据库位置,每个应用程序都需要此位置信息来连接到数据库。缺省情况下,在 V2 中,此文件是
InstallDir\server\conf\jazz\teamserver.properties。有关备份指示信息,请参阅下列主题:
- 从现有的 IBM Rational Requirements Composer V2 数据库中导出数据。
- 切换到 IBM Rational Requirements Composer V2 RRC2InstallDir\server 目录。
- 运行 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 使用条款进行管理,并且按原样提供,而没有任何形式的保证。
- 如果您已安装 Jazz Team Server V3.0.1,请停止所有 V3.0.1 服务器(包括
Jazz Team Server 和其他 CLM 应用程序)并备份
Jazz Team Server V3.0.1 数据库和环境。请转到步骤 10。
- 如果您尚未安装 Jazz Team Server V3.0.1,请安装 Jazz Team Server。请不要运行设置向导。
- 如果您尚未安装 Jazz Team Server V3.0.1,并且正在使用除缺省的 Derby 数据库以外的数据库,那么必须创建 Jazz Team Server 数据库。
Jazz Team Server 和数据仓库需要数据库。您不必为“需求管理”应用程序创建数据库,这是因为该应用程序将
Jazz Team Server 数据库用作数据存储器。有关每个数据库的详细信息,请参阅设置数据库中的主题。
- 将“需求管理”应用程序安装到另一台机器。有关指示信息,请参阅使用 IBM Installation Manager 进行安装。
在安装期间,请选择使用 Rational Requirements Composer 2.x 上下文根。这将使用保留 RM 的 /rdm V2 上下文根所需的选项来安装 RM 应用程序,这对于保留指向 RM 工件的链接而言是必需的。如果您未选择此选项,那么升级将失败。有关详细信息,请参阅了解部署和升级过程。
- 安装结束时,请对您要启动哪个程序选择无,单击完成,然后单击退出。
- 如果您正在 WebSphere Application Server 上进行部署,请停止并卸载下列 V2 .war 文件:converter.war、jazz.war、rrc-help.war 和
rdm.war。有关更多信息,请参阅设置 WebSphere Application Server 以进行 V3 升级。
- 从 Jazz Team Server V3.0.1 的安装位置打开新的命令窗口,浏览到
JTS301InstallDir\server,并使用以下命令将 V2 配置文件与 V3.0.1 的配置文件合并:repotools-jts -migration_rm_updateConfigurationFiles oldApplicationHome=RRCS20InstallDir/server/conf。
如果您将 Jazz Team Server V3.0.1 与 RM 应用程序分开安装(例如分布式部署情况),那么必须指定
RM 应用程序的位置并从 Jazz Team Server V3.0.1
安装目录中运行此脚本。在这种情况下,请指定 newApplicationHome 参数。
repotools-jts -migration_rm_updateConfigurationFiles
oldApplicationHome=RRC2InstallDir/server/conf newApplicationHome=<JTS301_install_dir>/server/conf -jtsURL https://<fully qualified domain name>:<port>/jts
注: -jtsURL
参数是 Jazz Team Server 的公用 URI。缺省情况下,Jazz Team Server 公用 URI 派生自应用程序的公用 URI。在 Jazz Team Server 与 RM 应用程序不在同一服务器实例上运行的分布式部署中,必须指定此参数。
此命令会完成下列任务:
- 根据 V2 Jazz JazzInstallDir/server/conf/jazz/teamserver.properties
文件中的信息,更新 V3 JazzInstallDir/server/conf/app/teamserver.properties
文件。您将有机会编辑值(例如,Jazz Team Server 数据库位置属性),这些是脚本无法从 V2 获取的信息。
注: 如果您尚未安装和配置
Jazz Team Server V3.0.1,那么此时您必须输入先前在步骤
9 中创建的新
Jazz Team Server 数据库的数据库位置属性。
- 复制 V2 Tomcat 用户 .xml 文件。
- 将 V2 friendsconfig.rdf 文件(此文件包含已进行跨存储库集成设置的服务器的列表)与 V3.0.1 合并。
- 将 V2 server.xml 和 web.xml(LDAP 设置)文件的内容与 V3.0.1 合并。
有关其他详细信息,请参阅合并配置文件和-migration_updateConfigurationFiles。
- 通过使用 repotools-jts -importapplicationdata 命令将
Rational Requirements Composer 数据从已导出的 V2
存储库导入到新的 V3 需求管理 (RM) 存储库中,如以下示例所示:
repotools-jts migration_importapplicationdata fromFile=c:\export.tar
其中 fromFile 变量指定将要从其中导入存储库的 .tar 文件的名称。
注: - 如果这是新安装的 Jazz Team Server 和任何“协作生命周期管理”产品,并且您首次将用户数据导入到 Jazz Team Server 中,那么可以在命令链接中包括 createTables 参数。createTables 参数将创建 Jazz Team Server 数据库并导入 .tar 文件的内容。如果目前已经有 Jazz Team Server 数据库,那么在此命令行中不要包括 createTables 参数,因为这将覆盖现有数据库。
- 如果您在 IBM Rational Requirements Composer V2
中使用了浮动许可证,那么存在一个已知问题,即,您可能必须先停止升级脚本、启动
Jazz Team
Server 并安装 V3.0.1 浮动许可证,然后才能从
IBM Rational Requirements Composer
V2 数据库导入数据。有关如何执行此操作的更多信息,请参阅 https://jazz.net/library/article/659。
- 为“需求管理”V3.0.1 导入大型存储库可能会导致 OutOfMemoryException
错误。如果您拥有大量项目和工件,请将
repotools-jts.bat 或 repotools-jts.sh 脚本中的 -Xmx 参数由缺省值 1500M 增大为更大的值。如果机器有足够的内存,那么使用 4096M 可以获得最佳结果。
- 要查看对配置文件所作的更改的详细 Rational Requirements Composer 列表,请参阅Rational Requirements Composer 更改。
- 验证存储库数据和配置文件。有关详细信息,请参阅在升级期间验证配置文件。
- 完成脱机迁移后,将 Jazz Team Server V3.0.1
数据库和环境备份到有别于 V2 数据库备份位置的位置。请先进行备份,然后再接着执行联机迁移。切勿覆盖 V2 数据库备份。
- 如果您创建了安全证书以与先前发行版配合使用,那么复制该证书或者创建一个新证书。有关详细信息,请参阅配置安全证书。
- 如果您正在将 Tomcat 应用程序服务器作为 Windows 服务运行,那么必须除去该服务并重新安装。请参阅在作为 Windows 服务(32 位)的 Apache Tomcat 中运行,以获取命令语法。
- 如果是在 IBM WebSphere Application Server 上进行部署,请部署 V3.0 WAR 文件并将安全角色映射至用户或组。有关详细信息,请参阅设置 WebSphere Application Server 以进行 V3 升级和在 WebSphere Application Server 上部署 CLM 应用程序。
- 备份完成之后,请继续执行联机迁移中的步骤。请参阅联机迁移升级步骤。