本指南描述如何将 Rational Team Concert 3.0 或者“协作生命周期管理”(CLM) V3.0.1 的服务器应用程序升级到 CLM V4.0。
注意:从 V2 升级到 V4 这一过程包括两个步骤。您必须先将服务器升级到 V3.0.1,然后再升级到 V4.0。有关从 V2 升级到 V3.0.1 的指示信息,请参阅 3.0.1 信息中心。
有关在 z/OS 上对 CLM 应用程序进行升级的信息,请参阅有关在 z/OS 上进行升级的特殊指示信息。
根据您在前一页面中所作的下列配置,本指南将生成有关对产品进行升级的完整指示信息:
注意:在开始升级过程之前,请确保 CLM 3.0.1 teamserver.properties 中与 Derby 数据库和数据仓库数据库的连接包含绝对路径。
注意:尽管 Rational solution for CLM 4.0 使用现有数据库,但是它不再支持 JRE 5.0。受支持的 JRE 版本为 6.0 和 7.0。ojdbc6.jar 类库要求 JRE 6.0 或更高版本。您必须使用 ojdbc6.jar。有关更多信息,请参阅设置 Oracle 数据库。
注意:尽管 Rational solution for CLM 4.0 使用现有数据库,但是它不再支持 JRE 5.0。受支持的 JRE 版本为 6.0 和 7.0。sqljdbc4.jar 类库要求 JRE 6.0 或更高版本。您必须使用 sqljdbc4.jar。有关更多信息,请参阅设置 SQL Server 数据库。
对 Rational solution for Collaborative Lifecycle Management 产品进行升级之前,您务必复查以下规划核对表中的信息。
| 规划任务 | 更多信息 | |
|---|---|---|
| 使用升级数据表:可以使用升级数据表来帮助收集和记录升级过程中需要的特定数据集。这些数据包括 URL 和用户标识之类的项,以及对部署进行升级和配置时需要的其他元素。 | 对数据表进行升级 | |
| 请确认硬件和软件满足最低系统需求:对于 V4.0,存在许多新需求,例如,仅支持 64 位服务器操作系统。请单击位于右边的链接以了解这些新需求,以及了解当前系统是否满足最低系统需求。 | 系统需求 | |
| 获取产品安装介质:对于本地存储库下载,您大约需要五千兆字节 (5 GB) 的硬盘驱动器空间来下载和解压缩产品安装介质。 | 您可以从 jazz.net 下载服务器安装文件 | |
| 复审升级拓扑示例 | 分布式企业拓扑示例 | |
| 使所有机器上的时钟同步:在分布式环境中,请确保所有机器上的时钟都已使用网络时间协议 (NTP) 进行同步。 | 有关 NTP 的更多信息,请访问 ntp.org | |
| 了解部署和升级过程:请参阅本主题以了解升级过程、了解局限性和注意事项以及对每个应用程序进行升级估计将耗用的时间。 | 了解部署和升级过程 | |
| 针对应用程序不可用的情况进行计划:针对在您备份每个对象时应用程序短期不可用的情况进行计划,并将应用程序更新为 V4.0。在 Jazz Team Server 脱机时,所有连接至 Jazz Team Server 的应用程序都将脱机。还提供了一定时间对现有应用程序进行完整备份。 | ||
了解数据库先决条件:
|
||
| 了解许可证发放。您必须购买 V4 的新许可证。V4 许可证将与 V3 应用程序兼容,但是,V3 许可证对于 V4 应用程序将不起作用。 | 管理许可证发放 | |
检查浏览器兼容性:
|
对生产环境进行升级之前,您可以设置测试环境以避免产生问题。有关更多信息,请参阅登台测试环境以进行升级过程。
访问 3.0.1 Jazz Team Server 管理站点 (https://qualified.host.name:port/jts/admin?internal#action=com.ibm.team.repository.admin.serverReset),然后单击请求服务器复位。
访问 3.0.1“变更和配置管理”管理站点 (https://qualified.host.name:port/ccm/admin?internal#action=com.ibm.team.repository.admin.serverReset),然后单击请求服务器复位。
访问 3.0.1“质量管理”管理站点 (https://qualified.host.name:port/qm/admin?internal#action=com.ibm.team.repository.admin.serverReset),然后单击请求服务器复位。
注意:对 Rational solution for Collaborative Lifecycle Management 进行升级之前,您必须对 Rational Reporting for Development Intelligence 进行升级。您不需要将数据仓库与 Rational Reporting for Development Intelligence 一起进行升级,因为数据仓库是在对 Rational solution for CLM 进行升级期间升级的。
如果您具有 Rational Reporting for Development Intelligence V1.0.2,但是想要升级到 V2.0,请遵循下列步骤:
有关更多信息,请参阅将 Rational Reporting for Development Intelligence 从 V1.0.2.x 升级到 V2.0。
升级到 Rational solution for CLM 4.0 之后,请下载最新的报告样本和资源并将它们装入到报告服务器。有关完整的指示信息,请参阅对报告工件进行升级。
安装 CLM 4.0 应用程序,但是不运行设置向导。对于分布式配置,请安装与您已安装的 3.0.1 应用程序相对应的 CLM 4.0 应用程序。有关安装服务器的信息,请参阅使用 IBM Installation Manager 进行安装。
安装 CLM 4.0 应用程序,但是不运行设置向导。对于分布式配置,请安装与您已安装的 3.0.1 应用程序相对应的 CLM 4.0 应用程序。有关安装服务器的信息,请参阅在 IBM i 上使用许可程序进行安装。
注意:您必须始终先对 Jazz Team Server 进行升级。在分布式环境中,务必安装 V4 许可证之后才安装其他 CLM 应用程序。有关更多信息,请参阅“激活试用 V4 许可证或者安装 V4 许可证”步骤。
backupConfig.bat 用于创建概要文件 WAS 主要管理用户名 WAS 管理密码备份的新压缩文件的路径(例如,backupConfig.bat C:\WAS_backup\clm_301_profile.zip -username WAS admin -password WAS admin password)
注意:此目录必须预先存在。
提示:如果需要,可以通过运行 restoreConfig.bat 命令来复原已备份的概要文件,例如,restoreConfig.bat C:\WAS_backup\clm_301_profile.zip。
./backupConfig.sh 用于创建概要文件 WAS 主要管理用户名 WAS 管理密码备份的新压缩文件的路径(例如,./backupConfig.sh /root/WAS_backup/clm_301_profile.zip -username WAS admin -password WAS admin password)
注意:此目录和 .zip 文件必须预先存在。
提示:如果需要,可以通过运行 ./restoreConfig.sh 命令来复原已备份的概要文件,例如, ./restoreConfig.sh /root/WAS_backup/clm_301_profile.zip。
./backupConfig.sh 用于创建概要文件 WAS 主要管理用户名 WAS 管理密码备份的新压缩文件的路径(例如,./backupConfig.sh /root/WAS_backup/clm_301_profile.zip -username WAS admin -password WAS admin password)
注意:此目录和 .zip 文件必须预先存在。
提示:如果需要,可以通过运行 ./restoreConfig.sh 命令来复原已备份的概要文件,例如, ./restoreConfig.sh /root/WAS_backup/clm_301_profile.zip。
注意:有关详细信息,请参阅设置 WebSphere Application Server。
stopServer.bat server1 -user admin_userid -password admin_password
./stopServer.sh server1 -user admin_userid -password admin_password
WAS_profile_root\wscache(例如:C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
WAS_profile_root\temp(例如:C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)
WAS_profile_root/wscache(例如:opt/IBM/WebSphere/AppServer/profiles/AppSrv01/wscache)
WAS_profile_root/temp(例如:opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)
WAS_profile_root/wscache(例如:usr/IBM/WebSphere/AppServer/profiles/AppSrv01/wscache)
WAS_profile_root/temp(例如:usr/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)
WAS_profile_root\logs(例如:C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\logs)
WAS_profile_root/logs(例如:opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs)
WAS_profile_root/logs(例如:usr/IBM/WebSphere/AppServer/profiles/AppSrv01/logs)
停止所有 3.0.1 应用程序服务器。
server.shutdown.bat
./server.shutdown.sh
打开命令提示符并输入下列命令以清除缺省 4.0 Derby repositoryDB 目录。
打开命令提示符并输入下列命令以将 Derby 数据库从 3.0.1 复制到 4.0。
注意:下列命令假定您正在使用随已打包的产品一起提供的 Derby 数据库。如果您已经更改了 Derby 数据库的位置,那么应将这些命令更新为使用现有 3.0.1 数据库位置。
备份 DB2 数据库(其中包括数据仓库数据库)。有关备份 DB2 数据库的信息,请参阅备份和复原 DB2 数据库。
备份 Oracle 数据库(其中包括数据仓库数据库)。请参阅 Oracle 文档以了解有关备份数据库的指示信息。
备份 SQL Server 数据库(其中包括数据仓库数据库)。请参阅 SQL Server 文档以了解有关备份数据库的指示信息。
开始升级之前,请遵循下列步骤来确认应用程序的属性文件中的索引位置指向文件系统上的绝对路径,而不是指向相对路径。
要将 Jazz Team Server 配置文件升级,请切换至 4.0JTS_install_dir/server 并运行下列命令:
repotools-jts.bat -migration_jts_updateConfigurationFiles oldJTSHome=3.0.1JTS_install_dir/server/conf
repotools-jts.bat -addTables
repotools-jts.bat -upgradeWarehouse
repotools-jts.bat -migration_jts_updateConfigurationFiles oldJTSHome=3.0.1JTS_install_dir/server/conf updateTomcatFiles=no
repotools-jts.bat -addTables
repotools-jts.bat -upgradeWarehouse
./repotools-jts.sh -migration_jts_updateConfigurationFiles oldJTSHome=3.0.1JTS_install_dir/server/conf
./repotools-jts.sh -addTables
./repotools-jts.sh -upgradeWarehouse
./repotools-jts.sh -migration_jts_updateConfigurationFiles oldJTSHome=3.0.1JTS_install_dir/server/conf updateTomcatFiles=no
./repotools-jts.sh -addTables
./repotools-jts.sh -upgradeWarehouse
要将“变更和配置管理”应用程序配置文件升级,请切换至 4.0CCM_install_dir/server 并运行下列命令:
缺省应用程序上下文根为 jazz。如果升级路径源自 V3.x,请在命令中使用 applicationContextRoot=ccm 开关。
repotools-ccm.bat -migration_ccm_updateConfigurationFiles oldApplicationHome=3.0.1CCM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=ccm
repotools-ccm.bat -addTables
repotools-ccm.bat -migration_ccm_updateConfigurationFiles oldApplicationHome=3.0.1CCM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=ccm updateTomcatFiles=no
repotools-ccm.bat -addTables
./repotools-ccm.sh -migration_ccm_updateConfigurationFiles oldApplicationHome=3.0.1CCM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=ccm
./repotools-ccm.sh -addTables
./repotools-ccm.sh -migration_ccm_updateConfigurationFiles oldApplicationHome=3.0.1CCM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=ccm updateTomcatFiles=no
./repotools-ccm.sh -addTables
要将“质量管理”应用程序配置文件升级,请切换至 4.0QM_install_dir/server 并运行下列命令:
缺省应用程序上下文根为 jazz。如果升级路径源自 V3.x,请在命令中使用 applicationContextRoot=qm 开关。
repotools-qm.bat -migration_qm_updateConfigurationFiles oldApplicationHome=3.0.1QM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=qm
repotools-qm.bat -addTables
repotools-qm.bat -migration_qm_updateConfigurationFiles oldApplicationHome=3.0.1QM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=qm updateTomcatFiles=no
repotools-qm.bat -addTables
./repotools-qm.sh -migration_qm_updateConfigurationFiles oldApplicationHome=3.0.1QM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=qm
./repotools-qm.sh -addTables
./repotools-qm.sh -migration_qm_updateConfigurationFiles oldApplicationHome=3.0.1QM_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=qm updateTomcatFiles=no
./repotools-qm.sh -addTables
要将“需求管理”应用程序配置文件升级,请遵循下列步骤:
upgrade\rm\rm_upgrade.bat -oldApplicationHome C:\Temp\RM3.0.1\server\conf -oldJTSHome 3.0.1JTS_install_dir\server\conf -newJTSHome 4.0JTS_install_dir\server\conf applicationContextRoot=rm
缺省应用程序上下文根为 rdm。如果升级路径源自 V3.x,请在命令中使用 applicationContextRoot=rm 开关。
upgrade\rm\rm_upgrade.bat -oldApplicationHome C:\Temp\RM3.0.1\server\conf -oldJTSHome 3.0.1JTS_install_dir\server\conf -newJTSHome 4.0JTS_install_dir\server\conf -updateTomcatFiles=no applicationContextRoot=rm
缺省应用程序上下文根为 rdm。如果升级路径源自 V3.x,请在命令中使用 applicationContextRoot=rm 开关。
upgrade/rm/rm_upgrade.sh -oldApplicationHome opt/tmp/rm3.0.1/server/conf -oldJTSHome 3.0.1JTS_install_dir/server/conf -newJTSHome 4.0JTS_install_dir/server/conf applicationContextRoot=rm
缺省应用程序上下文根为 rdm。如果升级路径源自 V3.x,请在命令中使用 applicationContextRoot=rm 开关。
upgrade/rm/rm_upgrade.sh -oldApplicationHome opt/tmp/rm3.0.1/server/conf -oldJTSHome 3.0.1JTS_install_dir/server/conf -newJTSHome 4.0JTS_install_dir/server/conf -updateTomcatFiles=no applicationContextRoot=rm
缺省应用程序上下文根为 rdm。如果升级路径源自 V3.x,请在命令中使用 applicationContextRoot=rm 开关。
上述命令将执行下列任务:
记住:仅限于 Tomcat 用户数据库。将复制 tomcat-users.xml 文件,而不是将其与现有文件合并。如果您正在升级多个使用公共
JTS 的 CLM 应用程序,那么必须以手动方式合并 tomcat-users.xml
文件中的用户和组信息。如果用户包含在不同应用程序中的不同组中,那么用户和组信息将有所不同。例如,userA
在 CCM 中具有 JazzAdmins 角色,但在 QM 中具有 JazzUsers 角色。另外,如果某些用户存在于一个应用程序中,但在另一个应用程序中不存在(反之亦然),那么您必须以手动方式将其添加到 tomcat-users.xml 文件。
有关这些存储库工具命令的更多信息,请参阅:
重要事项:虽然此脚本文件位于 upgrade/application context root 目录下,但是必须从 server 目录中运行此脚本文件。并且,如果路径包含空格,请确保将路径名括在双引号中。
注意:要在 CLM 应用程序与 Jazz Team Server 分开安装的分布式环境中使用升级脚本,升级脚本必须能够访问已安装该应用程序的驱动器或文件系统。例如,在 Windows 上,此安装必须采用以下格式:mounted drive letter:\server\conf。绝对路径(例如,\\machine name\JTS40InstallDir\server\conf)将无效。安装的驱动器必须配置为,将“读/写/执行”特权授予管理员帐户。
要将 Jazz Team Server 升级,打开命令提示符,切换至 JTS_4.0_install_dir\server 目录并运行以下命令:
upgrade\jts\jts_upgrade.bat
upgrade\jts\jts_upgrade.bat -oldJTSHome JTS_3.0.1_install_dir\server\conf
升级期间,在合并配置文件之后,会打开一个记事本窗口,您可以在此窗口中验证 Jazz Team Server teamserver.properties 文件。如果 com.ibm.team.fulltext.indexlocation 属性的位置是相对路径,那么不需要更改该路径。如果该位置是绝对路径,请确保该目录是稳定目录,将不会由于进行卸载而删除。绝对稳定路径看起来应类似于 com.ibm.team.fulltext.indexLocation=JTS_4.0_install_dir/server/conf/jts/indices/workitemindex,其中 JTS_4.0_install_dir 是 Jazz Team Server 4.0 的安装位置。
要将“变更和配置管理”应用程序升级,打开命令提示符,切换至 CCM_4.0_install_dir\server 目录并运行以下命令:
upgrade\ccm\ccm_upgrade.bat -oldApplicationHome CCM_3.0.1_install_dir\server\conf
upgrade\ccm\ccm_upgrade.bat -oldApplicationHome CCM_3.0.1_install_dir\server\conf -newJTSHome JTS_4.0_install_dir\server\conf
升级期间,在合并配置文件之后,会打开一个记事本窗口,您可以在此窗口中验证“变更和配置管理”teamserver.properties 文件。如果该位置是绝对路径,请确保该目录是稳定目录,将不会由于进行卸载而删除。绝对稳定路径看起来应类似于 com.ibm.team.fulltext.indexLocation=CCM_4.0_install_dir/server/conf/ccm/indices/workitemindex,其中 CCM_4.0_install_dir 是“变更和配置”应用程序 4.0 的安装位置。
要将“质量管理”应用程序升级,打开命令提示符,切换至 QM_4.0_install_dir\server 目录并运行以下命令:
upgrade\qm\qm_upgrade.bat -oldApplicationHome QM_3.0.1_install_dir\server\conf
upgrade\qm\qm_upgrade.bat -oldApplicationHome QM_3.0.1_install_dir\server\conf -newJTSHome JTS_4.0_install_dir\server\conf
升级期间,在合并配置文件之后,会打开一个记事本窗口,您可以在此窗口中验证“质量管理”teamserver.properties 文件。如果该位置是绝对路径,请确保该目录是稳定目录,将不会由于进行卸载而删除。绝对稳定路径看起来应类似于 com.ibm.team.fulltext.indexLocation=QM_4.0_install_dir/server/conf/qm/indices/workitemindex,其中 QM_4.0_install_dir 是“质量管理”应用程序 4.0 的安装位置。
要将“需求管理”应用程序升级,打开命令提示符,切换至 QM_4.0_install_dir\server 目录并运行以下命令:
upgrade\rm\rm_upgrade.bat -oldApplicationHome RM_3.0.1_install_dir\server\conf
upgrade\rm\rm_upgrade.bat -oldApplicationHome RM_3.0.1_install_dir\server\conf -newJTSHome JTS_4.0_install_dir\server\conf -oldJTSHome JTS_3.0.1_install_dir\server\conf
要将 Jazz Team Server 升级,打开命令 Shell,切换至 JTS_4.0_install_dir/server 目录并运行以下命令:
upgrade/jts/jts_upgrade.sh
upgrade/jts/jts_upgrade.sh -oldJTSHome JTS_3.0.1_install_dir/server/conf
升级期间,在合并配置文件之后,会打开一个 vi 编辑器,您可以在此编辑器中验证 Jazz Team Server teamserver.properties 文件。如果该位置是绝对路径,请确保该目录是稳定目录,将不会由于进行卸载而删除。绝对稳定路径看起来应类似于 com.ibm.team.fulltext.indexLocation=JTS_4.0_install_dir/server/conf/jts/indices/workitemindex,其中 JTS_4.0_install_dir 是 Jazz Team Server 4.0 的安装位置。
要将“变更和配置管理”应用程序升级,打开命令 Shell,切换至 CCM_4.0_install_dir/server 目录并运行以下命令:
upgrade/ccm/ccm_upgrade.sh -oldApplicationHome CCM_3.0.1_install_dir/server/conf
upgrade/ccm/ccm_upgrade.sh -oldApplicationHome CCM_3.0.1_install_dir/server/conf -newJTSHome 4.0JTS_install_dir/server/conf
升级期间,在合并配置文件之后,会打开一个 vi 编辑器,您可以在此编辑器中验证“变更和配置管理”teamserver.properties 文件。如果该位置是绝对路径,请确保该目录是稳定目录,将不会由于进行卸载而删除。绝对稳定路径看起来应类似于 com.ibm.team.fulltext.indexLocation=CCM_4.0_install_dir/server/conf/ccm/indices/workitemindex,其中 CCM_4.0_install_dir 是“变更和配置”应用程序 4.0 的安装位置。
要将“质量管理”应用程序升级,打开命令 Shell,切换至 QM_4.0_install_dir/server 目录并运行以下命令:
upgrade/qm/qm_upgrade.sh -oldApplicationHome QM_3.0.1_install_dir/server/conf
upgrade/qm/qm_upgrade.sh -oldApplicationHome QM_3.0.1_install_dir/server/conf -newJTSHome JTS_4.0_install_dir/server/conf
升级期间,在合并配置文件之后,会打开一个 vi 编辑器,您可以在此编辑器中验证“质量管理”teamserver.properties 文件。如果该位置是绝对路径,请确保该目录是稳定目录,将不会由于进行卸载而删除。绝对稳定路径看起来应类似于 com.ibm.team.fulltext.indexLocation=QM_4.0_install_dir/server/conf/qm/indices/workitemindex,其中 QM_4.0_install_dir 是“质量管理”应用程序 4.0 的安装位置。
要将“需求管理”应用程序升级,打开命令 Shell,切换至 RM_4.0_install_dir/server 目录并运行以下命令:
upgrade/rm/rm_upgrade.sh -oldApplicationHome RM_3.0.1_install_dir/server/conf
upgrade/rm/rm_upgrade.sh -oldApplicationHome RM_3.0.1_install_dir/server/conf -newJTSHome JTS_4.0_install_dir/server/conf -oldJTSHome JTS_3.0.1_install_dir/server/conf
要将 Jazz Team Server 升级,打开命令提示符,切换至 JTS_4.0_install_dir\server 目录并运行以下命令:
upgrade\jts\jts_upgrade.bat -updateTomcatFiles=no
upgrade\jts\jts_upgrade.bat -oldJTSHome JTS_3.0.1_install_dir\server\conf -updateTomcatFiles=no
升级期间,在合并配置文件之后,会打开一个记事本窗口,您可以在此窗口中验证 Jazz Team Server teamserver.properties 文件。如果此文件中的 com.ibm.team.fulltext.indexlocation 属性的位置是相对路径,那么必须将其更改为绝对路径,并确保该特定目录是稳定目录,将不会由于进行卸载而删除。3.0.1_install_dir 就是不稳定目录的一个示例,它可能会被卸载,从而使您失去索引文件。绝对稳定路径看起来应类似于 com.ibm.team.fulltext.indexLocation=JTS_4.0_install_dir/server/conf/jts/indices/workitemindex,其中 JTS_4.0_install_dir 是 Jazz Team Server 4.0 的安装位置。
要将“变更和配置管理”应用程序升级,打开命令提示符,切换至 CCM_4.0_install_dir\server 目录并运行以下命令:
upgrade\ccm\ccm_upgrade.bat -oldApplicationHome CCM_3.0.1_install_dir\server\conf -updateTomcatFiles=no
upgrade\ccm\ccm_upgrade.bat -oldApplicationHome CCM_3.0.1_install_dir\server\conf -newJTSHome JTS_4.0_install_dir\server\conf -updateTomcatFiles=no
升级期间,在合并配置文件之后,会打开一个记事本窗口,您可以在此窗口中验证“变更和配置管理”应用程序 teamserver.properties 文件。如果此文件中的 com.ibm.team.fulltext.indexlocation 属性的位置是相对路径,那么必须将其更改为绝对路径,并确保该特定目录是稳定目录,将不会由于进行卸载而删除。3.0.1_install_dir 就是不稳定目录的一个示例,它可能会被卸载,从而使您失去索引文件。绝对稳定路径看起来应类似于 com.ibm.team.fulltext.indexLocation=CCM_4.0_install_dir/server/conf/ccm/indices/workitemindex,其中 CCM_4.0_install_dir 是“变更和配置管理”应用程序 4.0 的安装位置。
要将“质量管理”应用程序升级,打开命令提示符,切换至 QM_4.0_install_dir\server 目录并运行以下命令:
upgrade\qm\qm_upgrade.bat -oldApplicationHome QM_3.0.1_install_dir\server\conf -updateTomcatFiles=no
upgrade\qm\qm_upgrade.bat -oldApplicationHome QM_3.0.1_install_dir\server\conf -newJTSHome 4.0JTS_install_dir\server\conf -updateTomcatFiles=no
升级期间,在合并配置文件之后,会打开一个记事本窗口,您可以在此窗口中验证“质量管理”应用程序 teamserver.properties 文件。如果此文件中的 com.ibm.team.fulltext.indexlocation 属性的位置是相对路径,那么必须将其更改为绝对路径,并确保该特定目录是稳定目录,将不会由于进行卸载而删除。3.0.1_install_dir 就是不稳定目录的一个示例,它可能会被卸载,从而使您失去索引文件。绝对稳定路径看起来应类似于 com.ibm.team.fulltext.indexLocation=QM_4.0_install_dir/server/conf/qm/indices/workitemindex,其中 QM_4.0_install_dir 是“质量管理”应用程序 4.0 的安装位置。
要将“需求管理”应用程序升级,打开命令提示符,切换至 4.0RM_install_dir\server 目录并运行以下命令:
upgrade\rm\rm_upgrade.bat -oldApplicationHome RM_3.0.1_install_dir\server\conf -updateTomcatFiles=no
upgrade\rm\rm_upgrade.bat -oldApplicationHome RM_3.0.1_install_dir\server\conf -newJTSHome JTS_4.0_install_dir\server\conf -oldJTSHome JTS_3.0.1_install_dir\server\conf -updateTomcatFiles=no
要将 Jazz Team Server 升级,打开命令 Shell,切换至 JTS_4.0_install_dir/server 目录并运行以下命令:
upgrade/jts/jts_upgrade.sh -updateTomcatFiles=no
upgrade/jts/jts_upgrade.sh -oldJTSHome JTS_3.0.1_install_dir/server/conf -updateTomcatFiles=no
升级期间,在合并配置文件之后,会打开一个 vi 编辑器,您可以在此编辑器中验证 Jazz Team Server teamserver.properties 文件。如果此文件中的 com.ibm.team.fulltext.indexlocation 属性的位置是相对路径,那么必须将其更改为绝对路径,并确保该特定目录是稳定目录,将不会由于进行卸载而删除。3.0.1_install_dir 就是不稳定目录的一个示例,它可能会被卸载,从而使您失去索引文件。绝对稳定路径看起来应类似于 com.ibm.team.fulltext.indexLocation=JTS_4.0_install_dir/server/conf/jts/indices/workitemindex,其中 JTS_4.0_install_dir 是 Jazz Team Server 4.0 的安装位置。
要将“变更和配置管理”应用程序升级,打开命令 Shell,切换至 4.0CCM_install_dir/server 目录并运行以下命令:
upgrade/ccm/ccm_upgrade.sh -oldApplicationHome CCM_3.0.1_install_dir/server/conf -updateTomcatFiles=no
upgrade/ccm/ccm_upgrade.sh -oldApplicationHome CCM_3.0.1_install_dir/server/conf -newJTSHome JTS_4.0_install_dir/server/conf -updateTomcatFiles=no
升级期间,在合并配置文件之后,会打开一个 vi 编辑器,您可以在此编辑器中验证“变更和配置管理”应用程序 teamserver.properties 文件。如果此文件中的 com.ibm.team.fulltext.indexlocation 属性的位置是相对路径,那么必须将其更改为绝对路径,并确保该特定目录是稳定目录,将不会由于进行卸载而删除。3.0.1_install_dir 就是不稳定目录的一个示例,它可能会被卸载,从而使您失去索引文件。绝对稳定路径看起来应类似于 com.ibm.team.fulltext.indexLocation=CCM_4.0_install_dir/server/conf/ccm/indices/workitemindex,其中 CCM_4.0_install_dir 是“变更和配置管理”应用程序 4.0 的安装位置。
要将“质量管理”应用程序升级,打开命令 Shell,切换至 QM_4.0_install_dir/server 目录并运行以下命令:
upgrade/qm/qm_upgrade.sh -oldApplicationHome QM_3.0.1_install_dir/server/conf -updateTomcatFiles=no
upgrade/qm/qm_upgrade.sh -oldApplicationHome QM_3.0.1_install_dir/server/conf -newJTSHome JTS_4.0_install_dir/server/conf -updateTomcatFiles=no
升级期间,在合并配置文件之后,会打开一个 vi 编辑器,您可以在此编辑器中验证“质量管理”应用程序 teamserver.properties 文件。如果此文件中的 com.ibm.team.fulltext.indexlocation 属性的位置是相对路径,那么必须将其更改为绝对路径,并确保该特定目录是稳定目录,将不会由于进行卸载而删除。3.0.1_install_dir 就是不稳定目录的一个示例,它可能会被卸载,从而使您失去索引文件。绝对稳定路径看起来应类似于 com.ibm.team.fulltext.indexLocation=QM_4.0_install_dir/server/conf/qm/indices/workitemindex,其中 QM_4.0_install_dir 是“质量管理”应用程序 4.0 的安装位置。
要将“需求管理”应用程序升级,打开命令 Shell,切换至 RM_4.0_install_dir/server 目录并运行以下命令:
upgrade/rm/rm_upgrade.sh -oldApplicationHome RM_3.0.1_install_dir/server/conf -updateTomcatFiles=no
upgrade/rm/rm_upgrade.sh -oldApplicationHome RM_3.0.1_install_dir/server/conf -newJTSHome JTS_4.0_install_dir/server/conf -oldJTSHome JTS_3.0.1_install_dir/server/conf -updateTomcatFiles=no
以上脚本使用存储库工具命令来更新配置文件,并将数据库模式和数据仓库模式更新为 V4.0。有关更多信息,请参阅将脚本文件升级。
upgrade/jts/jts_upgrade.sh -oldJTSHome /QIBM/UserData/JazzTeamServer301/server/conf -oldJTSVersion 3.0.1
upgrade/ccm/ccm_upgrade.sh -oldApplicationHome /QIBM/UserData/JazzTeamServer301/server/conf -oldApplicationVersion 3.0.1 -ignoreJTSVersionCheck
upgrade/qm/qm_upgrade.sh -oldApplicationHome /QIBM/UserData/JazzTeamServer301/server/conf -oldApplicationVersion 3.0.1 -ignoreJTSVersionCheck
upgrade/rm/rm_upgrade.sh -oldApplicationHome /QIBM/UserData/JazzTeamServer301/server/conf -oldApplicationVersion 3.0.1 -ignoreJTSVersionCheck
upgrade/was_upgrade.sh profileName serverName nodeName wasVersion wasOption maxHeapSize adminId adminPwd jvmVersion jazzAppName jtsAppName clmHelpAppName qmAppName rmAppName adminAppName
其中:
重要事项:仅当 teamserver.properties 文件中的索引文件的位置是相对路径,或者它们是指向不稳定目录的绝对路径时,才执行这些步骤。3.0.1_install_dir 就是不稳定目录的一个示例,它可能会被卸载,从而使您失去索引文件。
将 JFS/text 索引从 3.0.1 复制到 4.0。对于分布式系统,请转至适当的服务器并复制这些文件。
要将 JFS/text 索引从 3.0.1 复制到 4.0,请执行下列步骤。对于分布式系统,请转至适当的服务器并复制这些文件。
注意:请确保您已将 JDBC 环境变量切换为指向 JRE6 JDBC 驱动程序。有关更多信息,请参阅设置 Oracle 数据库。
注意:请确保您已将 JDBC 环境变量切换为指向 JRE6 JDBC 驱动程序。有关更多信息,请参阅设置 SQL Server 数据库。
startServer.bat server1 -user admin_userid -password admin_password
./startServer.sh server1 -user admin_userid -password admin_password
注意:如果您使用了 IBM Installation Manager 来安装 CLM 应用程序,并且在安装期间已取消选中 Tomcat 7 Application Server 的复选框,那么缺省情况下会将 Web 应用程序文件 (.war) 复制到 JazzInstallDir/server/webapps 目录中。如果您在安装期间选择了 Tomcat 7 Application Server,那么会将 Web 应用程序文件 (.war) 复制到 JazzInstallDir/server/tomcat/webapps 目录中。
有关详细信息,请参阅在 WebSphere Application Server 上部署 CLM 应用程序。
重要事项:如果您所在的环境(例如 AIX 或 Solaris)不支持转换器,那么必须在专用转换器上安装 4.0 版本的 converter.war。有关详细信息,请参阅 Rational Requirements Composer 转换器应用程序安装。
注意:请确保您已将 JDBC 环境变量切换为指向 JRE6 JDBC 驱动程序。有关更多信息,请参阅设置 Oracle 数据库。
注意:请确保您已将 JDBC 环境变量切换为指向 JRE6 JDBC 驱动程序。有关更多信息,请参阅设置 SQL Server 数据库。
启动所有 4.0 应用程序服务器
server.startup.bat
./server.startup.sh
您必须购买 V4.0 的新许可证。V4 许可证将与 V3 应用程序兼容,但是,V3 许可证对于 V4 应用程序将不起作用。安装 V4.0 浮动许可证、令牌许可证或者“授权用户单个安装”许可证(如果已经使用了它们的 V3 等效许可证)。安装 V4 许可证期间,将保持已分配的现有 V3 用户许可证。
如果您尚未购买 V4 许可证,那么您可以激活并限期使用试用许可证。要激活试用许可证,请遵循下列步骤:
注意:如果您正在使用试用许可证,那么在运行下一步“迁移 Rational Requirements Composer”之前,您必须为执行 RRC 升级的 admin 用户分配试用许可证。
有关许可证的更多信息,请参阅管理许可证。
注意:将 Requirements Composer 升级到 V4.0 的过程中,从您重新启动 Requirements Composer 应用程序开始,会使 Jazz Team Server 处于只读方式,直到您完成联机迁移向导为止。
重要事项:开始升级之后,您就无法取消此操作,直到完成升级为止。
如果您已跳过在 CLM 3.0.1 安装版本中配置数据仓库,但是想要在 V4.0 中配置数据仓库,请遵循下列步骤:
完成升级过程之后,使用以下核对表来确定是否一切正常。
| 验证任务 | 更多信息 | |
|---|---|---|
确认已将下列应用程序配置文件从 V3.0.1 复制到 V4.0:
|
||
请确认每个 teamserver.properties 文件都包含以下信息:
|
||
验证应用程序服务器:
|
部署和启动服务器 | |
验证服务器日志:检查下列服务器日志以确保包含升级后信息:
|
||
| 验证公用 URL:如果您升级了 Jazz Team Server、“变更和配置管理”或“质量管理”应用程序,请验证该应用程序的状态摘要页面中的公用 URL 是否与先前版本中使用的公用 URL 相同。 | ||
| 验证 Jazz Team Server 管理 Web 界面中的链接:打开 Web 浏览器并访问 Jazz Team Server 的“管理”页面 (https://[hostname.example.com]:9443/jts/admin),确认未显示任何错误。 | Jazz Team Server 管理 Web 界面 | |
| 验证应用程序管理 Web 界面中的链接:打开 Web 浏览器并访问应用程序的“管理”页面 (https://[hostname.example.com]:9443/[application context root]/admin),确认未显示任何错误。 | 应用程序管理 Web 界面 | |
验证用户、许可证和链接工件:
|
验证用户、许可证和链接工件 |
Rational Developer for System z
Rational Developer for System z 与 System z 上的 Rational Team Concert 进行集成,以便为 z/OS 开发者提供集成的协作应用程序开发环境。此集成解决方案为 Rational Developer for System z 的各个开发环境提供 Rational Team Concert 的团队协作功能。有关更多信息,请参阅 Rational Team Concert 和 Rational Developer for System z。
Rational ClearQuest
Rational Team Concert 提供了多个工具来帮助您将工作与 Rational ClearQuest 集成。Rational ClearQuest Synchronizer、Rational ClearQuest 网桥和 Rational ClearQuest 导入器。有关更多信息,请参阅 Rational Team Concert 和 Rational ClearQuest。
您可以使用 ClearQuest Synchronizer(以前称为 Connector)将 Rational Quality Manager 与 Rational ClearQuest 缺陷跟踪系统进行集成。有关更多信息,请参阅 Rational Quality Manager 和 Rational ClearQuest。
您可以将 Rational Requirements Composer 与 Rational ClearQuest 进行集成并且配置这两个应用程序,以使需求与缺陷、任务、改进请求和其他记录类型相关联。有关更多信息,请参阅 Rational Requirements Composer 和 Rational ClearQuest。
Rational ClearCase
Rational Team Concert 提供了 ClearCase 连接器,这些连接器支持在 Rational Team Concert 与 Rational ClearCase 之间执行操作。有关更多信息,请参阅 Rational Team Concert 和 Rational ClearCase。
Rational Build Forge
Rational Team Concert 与 Rational Build Forge 进行集成时,允许创建 Rational Build Forge 构建引擎和定义,以便与 Build Forge 项目进行集成。有关更多信息,请参阅 Rational Team Concert 和 Rational Build Forge。
Hudson
Rational Team Concert 与 Hudson 之间的集成允许创建 Hudson 构建引擎和定义,以便与 Hudson 项目进行集成。有关更多信息,请参阅 Rational Team Concert 和 Hudson。
Subversion
Rational Team Concert 为团队提供了多种同时使用 Subversion 和 Rational Team Concert 源代码控制来进行协作的方法。有关更多信息,请参阅 Rational Team Concert 和 Subversion。
Rational DOORS
您可以使用 Rational DOORS 来管理需求,还可以使用 Rational Team Concert 工作项能力使这些需求受变更控制。有关更多信息,请参阅 Rational Team Concert 和 Rational DOORS。
您可以将 Rational Quality Manager 与 Rational DOORS 进行集成,以跟踪 Rational DOORS 中的需求并使其与测试计划或测试用例相关联。有关更多信息,请参阅 Rational Quality Manager 和 Rational DOORS。
Rational Focal Point
您可以使用 Rational Focal Point 来捕获业务需要、确定它们的优先顺序,以及将它们作为项目导出到 Rational Team Concert 中。有关更多信息,请参阅 Rational Team Concert 和 Rational Focal Point。
Lotus Connections
Rational Team Concert 提供了与 Lotus Connections 的集成,它将“变更和配置管理”资源和工件与 Lotus Connections 社区资源和工件连接起来。有关更多信息,请参阅 Rational Team Concert 和 Lotus Connections。
Rational Developer for Power Systems Software
Rational Team Concert 与 Rational Developer for Power Systems Software 进行集成,以对 IBM i 开发者提供集成的协作应用程序开发环境。此集成解决方案为 Rational Developer for Power Systems Software 的各个开发环境提供 Rational Team Concert 的团队协作功能的值。有关更多信息,请参阅 Rational Team Concert 和 Rational Developer for Power Systems Software。
Rational RequisitePro
借助 Rational Quality Manager 与 Rational RequisitePro 之间的集成,您可以将 Rational RequisitePro 的需求视图和程序包添加至“质量管理”应用程序中的测试计划。有关更多信息,请参阅 Rational Quality Manager 和 Rational RequisitePro。
Rational Change
您可以使用 IBM Rational Change Open Services for Lifecycle Collaboration Change Management (OSLC-CM) API 来提交新变更请求并直接从“质量管理”Web 界面将执行结果链接到变更请求。有关更多信息,请参阅 Rational Quality Manager 和 Rational Change。
Rational 测试工具
可以使用 Rational Quality Manager 来运行位于测试实验室机器或共享网络位置的自动化测试。有关更多信息,请参阅 Rational Quality Manager 和 Rational 测试工具。
Selenium
通过使用 JUnit Selenium 适配器来实现与 Selenium 进行集成,使用此适配器可以在“质量管理”应用程序中运行 Selenium V2.0 WebDriver JUnit4 测试。有关更多信息,请参阅 Rational Quality Manager 和 Selenium。
软件库存和自动工具
可以将 Rational Quality Manager 与 Rational Build Forge、Software Testing Automation Framework (STAF) 和 Software Testing Automation Framework Execution Engine (STAX) 之类的软件库存和自动工具进行集成。有关更多信息,请参阅 Rational Quality Manager 以及软件库存和自动工具。
Rational Software Architect Design Manager
注意事项:Design Management 被认为是测试版功能,仅用于评估。有关更多信息,请参阅 Jazz.net 上的 Design Management project。
您可以将 IBM Rational Software Architect Design Manager 与 Rational solution for Collaborative Lifecycle Management (CLM) 中的“需求管理”(RM) 应用程序和“变更和配置管理”(CCM) 应用程序进行集成。可以通过进行此集成将设计模型和模型资源与需求、与需求相关的工件、工作项和其他开发工件联系起来。有关更多信息,请参阅 Rational Requirements Composer 和 Rational Software Architect Design Manager。