升级到 V4.0

本指南描述如何将 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 上进行升级的特殊指示信息。

选择安装环境的最佳描述选项

选择要升级的一个或多个应用程序:
您已经对 Jazz Team Server 进行升级吗?
选择部署拓扑:
选择应用程序服务器的操作系统:
选择应用程序服务器:
选择数据库服务器:
选择您在 CLM 3.0.1 中是否已配置数据仓库:
选择是否与其他产品进行集成:

根据您在前一页面中所作的下列配置,本指南将生成有关对产品进行升级的完整指示信息:

重要事项:

规划核对表

对 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 的应用程序都将脱机。还提供了一定时间对现有应用程序进行完整备份。  
了解数据库先决条件:
  • 您对 V3 数据库具有访问权,并且可以复制 derby/repositoryDB 目录。
  • 您有正确的用户名和密码。
    • 在 UNIX 系统中,请获取 DB2 实例所有者(通常为 db2inst1 用户)的密码。
  • 在开始升级过程之前,您将需要备份数据库。
  • 您有正确的用户名和密码。
  • 在开始升级过程之前,您将需要备份数据库。请参阅数据库供应商文档,以了解有关备份数据库的信息。
  • Rational solution for CLM 4.0 不再支持 JRE 5.0。受支持的 JRE 版本为 6.0 和 7.0。ojdbc5.jar 类库要求 JRE 5.0,而 ojdbc6.jar 类库要求 JRE 6.0 或更高版本。您必须使用 ojdbc6.jar。
  • 创建一个名为 ORACLE_JDBC_DRIVER_FILE 的环境变量,并使其指向 ojdbc6.jar JDBC 驱动程序。
  • 您有正确的用户名和密码。
  • 在开始升级过程之前,您将需要备份数据库。请参阅数据库供应商文档,以了解有关备份数据库的信息。
  • 已安装 Java 数据库连接 (JDBC) 驱动程序。Rational solution for CLM 4.0 不再支持 JRE 5.0。受支持的 JRE 版本为 6.0 和 7.0。sqljdbc4.jar 类库要求 JRE 6.0 或更高版本。您必须使用 sqljdbc4.jar。
  • 已启动 SQL 服务。
了解许可证发放。您必须购买 V4 的新许可证。V4 许可证将与 V3 应用程序兼容,但是,V3 许可证对于 V4 应用程序将不起作用。 管理许可证发放
检查浏览器兼容性:
  • 要允许显示各个向导,请在 Web 浏览器中启用 JavaScript。
  • 对用于迁移的 Web 浏览器,请确保已禁用弹出式窗口拦截器。
 

[可选] 登台测试环境以进行升级过程

对生产环境进行升级之前,您可以设置测试环境以避免产生问题。有关更多信息,请参阅登台测试环境以进行升级过程。

请求服务器复位

访问 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),然后单击请求服务器复位。

记录服务器名称、节点名以及已安装的 3.0.1 应用程序名称

  1. 登录到 WebSphere Application Server 集成解决方案控制台。
  2. 展开服务器 > 服务器类型,然后选择 WebSphere Application Server。
  3. 记录服务器名称和节点名。
  4. 展开应用程序 > 应用程序类型,然后选择 WebSphere 企业应用程序。
  5. 记录下列已安装的应用程序的名称:
    • Jazz Team Server
    • CLMHelp
    • 变更和配置管理
    • 质量管理
    • 需求管理
    • 转换器

对 Rational Reporting for Development Intelligence (RRDI) 进行升级

注意:对 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,请遵循下列步骤:

  1. 备份 Rational Reporting for Development Intelligence V1.0.2 安装版本。有关更多信息,请参阅备份 Rational Reporting for Development Intelligence 1.0.2.x 的文件。
  2. 卸载 Rational Reporting for Development Intelligence 1.0.2 和 WebSphere Application Server。
  3. 安装 Rational Reporting fro Development Intelligence 2.0。
  4. 安装 WebSphere Application Server。
  5. 运行设置应用程序以配置 Rational Reporting for Development Intelligence。
  6. 配置和测试报告服务器。
  7. 通过运行现有报告和仪表板以确认不存在回归来测试 Java ETL 作业执行情况。

有关更多信息,请参阅将 Rational Reporting for Development Intelligence 从 V1.0.2.x 升级到 V2.0。

升级到 Rational solution for CLM 4.0 之后,请下载最新的报告样本和资源并将它们装入到报告服务器。有关完整的指示信息,请参阅对报告工件进行升级。

安装 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 许可证”步骤。

备份 WebSphere Application Server 概要文件

要备份 WebSphere Application Server 概要文件,请访问每个应用程序服务器并执行下列步骤。
  1. 打开命令提示符,并切换到 WebSphere Application Server 安装目录的 bin 文件夹。例如,C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\bin。
  2. 运行以下命令。请注意,如果启用了 WebSphere Application Server 安全性,那么您还必须提供用户名和密码:
  3. 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。

  1. 打开命令提示符,并切换到 WebSphere Application Server 安装目录的 bin 文件夹。例如,/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin。
  2. 运行以下命令。请注意,如果启用了 WebSphere Application Server 安全性,那么您还必须提供用户名和密码:
  3. ./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。

  1. 打开命令提示符,并切换到 WebSphere Application Server 安装目录的 bin 文件夹。例如,/usr/IBM/WebSphere/AppServer/profiles/AppSrv01/bin。
  2. 运行以下命令。请注意,如果启用了 WebSphere Application Server 安全性,那么您还必须提供用户名和密码:
  3. ./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 中卸载 3.0.1 应用程序

要卸载 3.0.1 应用程序 war 文件,请访问每个应用程序服务器并执行下列步骤。
  1. 登录到 WebSphere Application Server 集成解决方案控制台 (https://hostname:9043/ibm/console/logon.jsp)。
  2. 单击应用程序 > 应用程序类型 > WebSphere 企业应用程序。
  3. 记下下列 3.0.1 应用程序的安全角色映射,以帮助您为 4.0 等效件重新映射这些安全角色:
    • jts_war
    • ccm_war
    • qm_war
  4. 停止并卸载下列 3.0.1 应用程序:
    • jts_war
    • clmhelp_war
    • admin_war
    • ccm_war
    • qm_war
    • rm_war
    • converter_war
  5. 当系统提示您时,将变更保存到主配置。

更新 JAZZ_HOME 和 log4j.configuration 定制属性

在每个应用程序服务器上执行下列步骤。
  1. 登录到 WebSphere Application Server 集成解决方案控制台 (https://hostname:9043/ibm/console/logon.jsp)。
  2. 单击服务器 > 服务器类型 > WebSphere Application Server。
  3. 单击服务器名称以将其打开。缺省服务器名称为 server1。
  4. 在“服务器基础结构”部分,单击 Java 和过程管理 > 过程定义。
  5. 在“其他属性”下,单击 Java 虚拟机。
  6. 在“其他属性”下,单击定制属性。
  7. 单击 JAZZ_HOME 并将其值更新为 file:///4.0_install_dir/server/conf。例如,file:///C:/PROGRA~2/IBM/JazzTeamServer_4.0/server/conf。
  8. 单击 JAZZ_HOME 并将其值更新为 file:///4.0_install_dir/server/conf。例如,file:///opt/IBM/JazzTeamServer_4.0/server/conf。
  9. 单击 JAZZ_HOME 并将其值更新为 file:///4.0_install_dir/server/conf。例如,file:///usr/IBM/JazzTeamServer_4.0/server/conf。
  10. 单击 log4j.configuration 并将其值更新为 file:///4.0_install_dir/server/conf/startup_log4j.properties。例如,file:///C:/PROGRA~2/IBM/JazzTeamServer_4.0/server/conf/startup.log4j.properties。
  11. 单击 log4j.properties 并将其值更新为 file:///4.0_install_dir/server/conf/startup_log4j.properties。例如,file:///opt/IBM/JazzTeamServer_4.0/server/conf/startup_log4j.properties。
  12. 单击 log4j.properties 并将其值更新为 file:///4.0_install_dir/server/conf/startup_log4j.properties。例如,file:///usr/IBM/JazzTeamServer_4.0/server/conf/startup_log4j.properties。
  13. 如果您正在连接至 Oracle 数据库,请确保 ORACLE_JDBC_DRIVER_FILE 指向正确的 JDBC 驱动程序文件。
  14. 如果您正在连接至 SQL Server 数据库,请确保 SQLSERVER_JDBC_DRIVER_FILE 指向正确的 JDBC 驱动程序文件。
  15. 当系统提示您时,将变更保存到主配置。

注意:有关详细信息,请参阅设置 WebSphere Application Server。

停止 WebSphere Application Server

要停止 WebSphere Application Server,请访问每个服务器并执行下列步骤:
  1. 打开命令提示符,并切换到 WAS_profile_root\bin 目录。
  2. 请输入以下命令:
  3. stopServer.bat server1 -user admin_userid -password admin_password

  1. 打开命令提示符,并切换到 WAS_profile_root/bin 目录。
  2. 请输入以下命令:
  3. ./stopServer.sh server1 -user admin_userid -password admin_password

清除 WebSphere Application Server temp 目录

请访问每个应用程序服务器,并从概要文件中的 wscache 和 temp 目录下除去与 CLM 相关的内容。根据先前已安装的应用程序,概要文件下将出现下列目录,可以除去这些目录:
从概要文件中的 wscache 和 temp 目录下除去与 CLM 相关的内容。根据先前已安装的应用程序,概要文件下将出现下列目录,可以除去这些目录:
  • jts_war
  • ccm_war
  • qm_war
  • rm_war
  • converter_war
  • admin_war
  • clmhelp_war

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)

清除 logs 目录

请访问每个应用程序服务器,并从概要文件中的 logs 目录下除去与 CLM 相关的日志。
从概要文件中的 logs 目录下除去与 CLM 相关的日志。

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 应用程序服务器。

  1. 打开命令提示符,并切换到 3.0.1_install_dir\server 目录。
  2. 请输入以下命令:
  3. server.shutdown.bat

  1. 打开命令提示符,并切换到 3.0.1_install_dir/server 目录。
  2. 请输入以下命令:
  3. ./server.shutdown.sh

从 3.0.1 安装目录复制 Derby 数据库

打开命令提示符并输入下列命令以清除缺省 4.0 Derby repositoryDB 目录。

del /s /f 4.0_install_dir\server\conf\jts\derby\repositoryDB
del /s /f 4.0_install_dir\server\conf\jts\derby\warehouseDB
del /s /f 4.0_install_dir\server\conf\ccm\derby\repositoryDB
del /s /f 4.0_install_dir\server\conf\qm\derby\repositoryDB
rm -rf 4.0_install_dir/server/conf/jts/derby/repositoryDB
rm -rf 4.0_install_dir/server/conf/jts/derby/warehouseDB
rm -rf 4.0_install_dir/server/conf/ccm/derby/repositoryDB
rm -rf 4.0_install_dir/server/conf/qm/derby/repositoryDB

打开命令提示符并输入下列命令以将 Derby 数据库从 3.0.1 复制到 4.0。

注意:下列命令假定您正在使用随已打包的产品一起提供的 Derby 数据库。如果您已经更改了 Derby 数据库的位置,那么应将这些命令更新为使用现有 3.0.1 数据库位置。

xcopy /s 3.0.1_install_dir\server\conf\jts\derby\repositoryDB 4.0_install_dir\server\conf\jts\derby\repositoryDB
xcopy /s 3.0.1_install_dir\server\conf\jts\derby\warehouseDB 4.0_install_dir\server\conf\jts\derby\warehouseDB
xcopy /s 3.0.1_install_dir\server\conf\ccm\derby\repositoryDB 4.0_install_dir\server\conf\ccm\derby\repositoryDB
xcopy /s 3.0.1_install_dir\server\conf\qm\derby\repositoryDB 4.0_install_dir\server\conf\qm\derby\repositoryDB
cp -R 3.0.1_install_dir/server/conf/jts/derby/repositoryDB 4.0_install_dir/server/conf/jts/derby/repositoryDB
cp -R 3.0.1_install_dir/server/conf/jts/derby/warehouseDB 4.0_install_dir/server/conf/jts/derby/warehouseDB
cp -R 3.0.1_install_dir/server/conf/ccm/derby/repositoryDB 4.0_install_dir/server/conf/ccm/derby/repositoryDB
cp -R 3.0.1_install_dir/server/conf/qm/derby/repositoryDB 4.0_install_dir/server/conf/qm/derby/repositoryDB

备份数据库

备份 DB2 数据库(其中包括数据仓库数据库)。有关备份 DB2 数据库的信息,请参阅备份和复原 DB2 数据库。

备份 Oracle 数据库(其中包括数据仓库数据库)。请参阅 Oracle 文档以了解有关备份数据库的指示信息。

备份 SQL Server 数据库(其中包括数据仓库数据库)。请参阅 SQL Server 文档以了解有关备份数据库的指示信息。

确认索引位置

开始升级之前,请遵循下列步骤来确认应用程序的属性文件中的索引位置指向文件系统上的绝对路径,而不是指向相对路径。

  1. 对于 Jazz Team Server,请转至 JTS_3.0.1_install_dir/server/jts,然后打开 temserver.properties 文件以进行编辑。
  2. 对于变更和配置管理应用程序,请转至 CCM_3.0.1_install_dir/server/ccm,然后打开 temserver.properties 文件以进行编辑。
  3. 对于质量管理应用程序,请转至 QM_3.0.1_install_dir/server/qm,然后打开 temserver.properties 文件以进行编辑。
  4. 搜索 com.ibm.team.fulltext.indexlocation 行。
  5. 如果位置是相对路径,那么索引将位于相对于托管应用程序的 WebSphere Application Server 概要文件的位置。请将该位置更改为绝对路径:
    • 对于 Jazz Team Server,输入 com.ibm.team.fulltext.indexLocation=WAS_Install_Dir/IBM/WebSphere/appServer/profiles/Appsrv01/conf/jts/indices/workitemindex,其中 WAS_Install_Dir 是 WebSphere Application Server 安装目录,Appsrv01 是应用程序服务器概要文件名称。
    • 对于变更和配置管理应用程序,输入 com.ibm.team.fulltext.indexLocation=WAS_Install_Dir/IBM/WebSphere/appServer/profiles/Appsrv01/conf/ccm/indices/workitemindex,其中 WAS_Install_Dir 是 WebSphere Application Server 安装目录,Appsrv01 是应用程序服务器概要文件名称。
    • 对于质量管理应用程序,输入 com.ibm.team.fulltext.indexLocation=WAS_Install_Dir/IBM/WebSphere/appServer/profiles/Appsrv01/conf/qm/indices/workitemindex,其中 WAS_Install_Dir 是 WebSphere Application Server 安装目录,Appsrv01 是应用程序服务器概要文件名称。
  6. 升级期间,在合并属性之后,此脚本将打开 4.0 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 应用程序的安装位置。
    • com.ibm.team.fulltext.indexLocation=CCM_4.0_install_dir/server/conf/ccm/indices/workitemindex,其中 CCM_4.0_install_dir 是“变更和配置管理 4.0”应用程序的安装位置。
    • com.ibm.team.fulltext.indexLocation=QM_4.0_install_dir/server/conf/qm/indices/workitemindex,其中 QM_4.0_install_dir 是“质量管理 4.0”应用程序的安装位置。
    然后,此脚本会将索引从 3.x 复制到新的 4.0 稳定目录。

运行用于将存储库工具升级的命令

要将 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

要将“需求管理”应用程序配置文件升级,请遵循下列步骤:

  1. 转至安装了“需求管理”应用程序(旧版本和 V4.0)的物理机器。
  2. 将 4.0RM_install_dir/server 和 3.0.1RM_install_dir/server 的内容复制到可移动驱动器上的两个不同的目录。
  3. 转至安装了 Jazz Team Server 4.0 的物理机器,并将此可移动驱动器的内容复制到一个临时目录。您应该让每个 RM 版本都有一个目录。例如,C:\Temp\RM4.0 和 C:\Temp\RM3.0.1。
  4. 打开命令提示符,并将目录切换至 C:\Temp\RM4.0\server,然后运行以下命令:

    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 开关。

  5. 在 JTS 机器上完成升级之后,请将 C:\Temp\RM4.0 的内容复制到可移动驱动器中。
  6. 转至安装了“需求管理”应用程序的物理机器,并将此可移动驱动器的内容粘贴到 4.0RM_install_dir/server 目录中并覆盖现有内容。
  1. 转至安装了“需求管理”应用程序(旧版本和 V4.0)的物理机器。
  2. 将 4.0RM_install_dir/server 和 3.0.1RM_install_dir/server 的内容复制到可移动驱动器上的两个不同的目录。
  3. 转至安装了 Jazz Team Server 4.0 的物理机器,并将此可移动驱动器的内容复制到一个临时目录。您应该让每个 RM 版本都有一个目录。例如,C:\Temp\RM4.0 和 C:\Temp\RM3.0.1。
  4. 打开命令提示符,并将目录切换至 C:\Temp\RM4.0\server,然后运行以下命令:

    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 开关。

  5. 在 JTS 机器上完成升级之后,请将 C:\Temp\RM4.0 的内容复制到可移动驱动器中。
  6. 转至安装了“需求管理”应用程序的物理机器,并将此可移动驱动器的内容粘贴到 4.0RM_install_dir/server 目录中并覆盖现有内容。
  1. 转至安装了“需求管理”应用程序(旧版本和 V4.0)的物理机器。
  2. 将 4.0RM_install_dir/server 和 3.0.1RM_install_dir/server 的内容复制到可移动驱动器上的两个不同的目录。
  3. 转至安装了 Jazz Team Server 4.0 的物理机器,并将此可移动驱动器的内容复制到一个临时目录。您应该让每个 RM 版本都有一个目录。例如,opt/tmp/rm4.0 和 opt/tmp/rm3.0.1。
  4. 打开命令 Shell,并将目录切换至 opt/tmp/rm4.0/server,然后运行以下命令:

    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 开关。

  5. 在 JTS 机器上完成升级之后,请将 opt/tmp/rm4.0 的内容复制到可移动驱动器中。
  6. 转至安装了“需求管理”应用程序的物理机器,并将此可移动驱动器的内容粘贴到 4.0RM_install_dir/server 目录中并覆盖现有内容。
  1. 转至安装了“需求管理”应用程序(旧版本和 V4.0)的物理机器。
  2. 将 4.0RM_install_dir/server 和 3.0.1RM_install_dir/server 的内容复制到可移动驱动器上的两个不同的目录。
  3. 转至安装了 Jazz Team Server 4.0 的物理机器,并将此可移动驱动器的内容复制到一个临时目录。您应该让每个 RM 版本都有一个目录。例如,opt/tmp/rm4.0 和 opt/tmp/rm3.0.1。
  4. 打开命令 Shell,并将目录切换至 opt/tmp/rm4.0/server,然后运行以下命令:

    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 开关。

  5. 在 JTS 机器上完成升级之后,请将 opt/tmp/rm4.0 的内容复制到可移动驱动器中。
  6. 转至安装了“需求管理”应用程序的物理机器,并将此可移动驱动器的内容粘贴到 4.0RM_install_dir/server 目录中并覆盖现有内容。

上述命令将执行下列任务:

  • 根据 V3.0.1 文件中的信息来更新 V4 teamserver.properties 文件。
  • 向数据库添加表。
  • 将数据仓库模式升级。
  • 复制 Tomcat 用户 XML 文件的内容。

    记住:仅限于 Tomcat 用户数据库。将复制 tomcat-users.xml 文件,而不是将其与现有文件合并。如果您正在升级多个使用公共 JTS 的 CLM 应用程序,那么必须以手动方式合并 tomcat-users.xml 文件中的用户和组信息。如果用户包含在不同应用程序中的不同组中,那么用户和组信息将有所不同。例如,userA 在 CCM 中具有 JazzAdmins 角色,但在 QM 中具有 JazzUsers 角色。另外,如果某些用户存在于一个应用程序中,但在另一个应用程序中不存在(反之亦然),那么您必须以手动方式将其添加到 tomcat-users.xml 文件。

  • 将 V3.0.1 server.xml 和 web.xml 文件的内容与 V4 进行合并。
  • 将 V3.0.1 fronting.properties 文件的内容复制到 V4。
  • 将 V3.0.1 friendsconfig.rdf 文件的内容复制到 V4。

有关这些存储库工具命令的更多信息,请参阅:

运行升级脚本

重要事项:虽然此脚本文件位于 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。有关更多信息,请参阅将脚本文件升级。

在 IBM i 上运行升级脚本

  1. 使用具有 QSECOFR 权限的用户标识登录到 IBM i 操作系统。
  2. 在 QShell 中,浏览到 Jazz Team Server 4.0 安装目录 /QIBM/UserData/JazzTeamServer40/server。
  3. 输入以下命令以对 Jazz Team Server 进行升级:

    upgrade/jts/jts_upgrade.sh -oldJTSHome /QIBM/UserData/JazzTeamServer301/server/conf -oldJTSVersion 3.0.1

  4. 输入以下命令以对“变更和配置管理”应用程序进行升级:

    upgrade/ccm/ccm_upgrade.sh -oldApplicationHome /QIBM/UserData/JazzTeamServer301/server/conf -oldApplicationVersion 3.0.1 -ignoreJTSVersionCheck

  5. 输入以下命令以对“质量管理”应用程序进行升级:

    upgrade/qm/qm_upgrade.sh -oldApplicationHome /QIBM/UserData/JazzTeamServer301/server/conf -oldApplicationVersion 3.0.1 -ignoreJTSVersionCheck

  6. 输入以下命令以对“需求管理”应用程序进行升级:

    upgrade/rm/rm_upgrade.sh -oldApplicationHome /QIBM/UserData/JazzTeamServer301/server/conf -oldApplicationVersion 3.0.1 -ignoreJTSVersionCheck

  7. 运行以下命令以更新 WebSphere Application Server 3.0.1 以及部署 CLM 4.0 的 .war 文件。此脚本还会执行备份、更新 JVM 设置、更新环境变量设置、删除临时目录以及重新启动服务器:

     

    upgrade/was_upgrade.sh profileName serverName nodeName wasVersion wasOption maxHeapSize adminId adminPwd jvmVersion jazzAppName jtsAppName clmHelpAppName qmAppName rmAppName adminAppName

    其中:

    • profileName 是 3.0.1 概要文件名称。
    • serverName 是 3.0.1 服务器名称。
    • nodeName 是 3.0.1 服务器节点名称。
    • wasVersion 是 WebSphere Application Server 版本(V7 或 V8)。
    • wasOption 是您为 IBM i 上的 Jazz Team Server 3.0.1 服务器选择的 WebSphere Application Server 选项(Base、ND 或 Express)。
    • maxHeapSize 是您需要用于应用程序服务器的最大堆大小。
    • adminId 和 adminPwd 是您用来保护 IBM i 上的 WebSphere Application Server 的标识和密码。
    • jvmVersion 是 Java 虚拟机 (JVM) 版本 (std64 for V6R1 /V7R1)。
    • jazzAppName 是“变更和配置管理”应用程序的名称。
    • jtsAppName 是 Jazz Team Server 的名称。
    • qmAppName 是“质量管理”应用程序的名称。
    • rmAppName 是“需求管理”应用程序的名称。
    • clmHelpAppName 是 CLM 帮助应用程序的名称。
    • adminAppName 是“生命周期项目管理”应用程序的名称。

复制索引文件

重要事项:仅当 teamserver.properties 文件中的索引文件的位置是相对路径,或者它们是指向不稳定目录的绝对路径时,才执行这些步骤。3.0.1_install_dir 就是不稳定目录的一个示例,它可能会被卸载,从而使您失去索引文件。

将 JFS/text 索引从 3.0.1 复制到 4.0。对于分布式系统,请转至适当的服务器并复制这些文件。

  1. 打开命令提示符并输入以下命令以清除缺省 4.0 indices 目录:
  2. Del /s /f JTS_4.0_install_dir\server\conf\jts\indices
    Del /s /f CCM_4.0_install_dir\server\conf\ccm\indices
    Del /s /f QM_4.0_install_dir\server\conf\qm\indices
    rm -rf JTS_4.0_install_dir/server/conf/jts/indices
    rm -rf CCM_4.0_install_dir/server/conf/ccm/indices
    rm -rf QM_4.0_install_dir/server/conf/qm/indices
  3. 打开命令提示符并输入以下命令以将索引从 3.0.1 复制到 4.0
  4. copy JTS_3.0.1_install_dir\server\conf\jts\indices JTS_4.0_install_dir\server\conf\jts\indices
    copy CCM_3.0.1_index_location\server\conf\ccm\indices CCM_4.0_install_dir\server\conf\ccm\indices
    copy QM_3.0.1_index_location\server\conf\qm\indices QM_4.0_install_dir\server\conf\qm\indices
    cp -R JTS_3.0.1_index_location/server/conf/jts/indices JTS_4.0_install_dir/server/conf/jts/indices
    cp -R CCM_3.0.1_index_location/server/conf/ccm/indices CCM_4.0_install_dir/server/conf/ccm/indices
    cp -R QM_3.0.1_index_location/server/conf/qm/indices QM_4.0_install_dir/server/conf/qm/indices

要将 JFS/text 索引从 3.0.1 复制到 4.0,请执行下列步骤。对于分布式系统,请转至适当的服务器并复制这些文件。

  1. 打开命令提示符并输入以下命令以清除缺省 4.0 indices 目录:
  2. Del /s /f JTS_4.0_install_dir\server\conf\jts\indices
    Del /s /f CCM_4.0_install_dir\server\conf\ccm\indices
    Del /s /f QM_4.0_install_dir\server\conf\qm\indices
    rm -rf JTS_4.0_install_dir/server/conf/jts/indices
    rm -rf CCM_4.0_install_dir/server/conf/ccm/indices
    rm -rf QM_4.0_install_dir/server/conf/qm/indices
  3. 打开每个应用程序的 teamserver.properties 文件并搜索 com.ibm.team.fulltext.indexlocation。
  4. 如果属性 com.ibm.team.fulltext.indexlocation 指向相对路径(例如,com.ibm.team.fulltext.indexLocation=conf/ccm/indices/workitemindex),那么索引将位于相对于托管应用程序的 WebSphere Application Server 概要文件的位置。例如,WAS_Install_Dir/IBM/WebSphere/AppServer/profiles/Appsrv01。在 CLM 4.0 应用程序的 teamserver.properties 文件中将此相对路径更改为指向一个稳定位置。绝对稳定位置的一个示例看起来应类似于 com.ibm.team.fulltext.indexLocation=4.0_install_dir/server/conf/ccm/indices/workitemindex,其中 4.0_install_dir 是 CLM 4.0 应用程序的安装位置。打开命令提示符并输入以下命令以将完整文本索引从 3.0.1 复制到 4.0
  5. copy WAS_profile_dir\conf\jts\indices JTS_4.0_install_dir\server\conf\jts\indices
    copy WAS_profile_dir\conf\ccm\indices CCM_4.0_install_dir\server\conf\ccm\indices
    copy WAS_profile_dir\conf\qm\indices QM_4.0_install_dir\server\conf\qm\indices
    cp -R WAS_profile_dir/conf/jts/indices JTS_4.0_install_dir/server/conf/jts/indices
    cp -R WAS_profile_dir/conf/ccm/indices CCM_4.0_install_dir/server/conf/ccm/indices
    cp -R WAS_profile_dir/conf/qm/indices QM_4.0_install_dir/server/conf/qm/indices
  6. 如果属性 com.ibm.team.fulltext.indexlocation 指向不稳定的绝对路径(例如,指向可能会卸载和删除的 3.0.1_install_dir 目录),请将其更改为指向稳定位置的绝对路径。绝对稳定位置的一个示例看起来应类似于 com.ibm.team.fulltext.indexLocation=4.0_install_dir/server/conf/ccm/indices/workitemindex,其中 4.0_install_dir 是 CLM 4.0 应用程序的安装位置。打开命令提示符并输入以下命令以将完整文本索引从 3.0.1 复制到 4.0
  7. copy JTS_3.0.1_install_dir\server\conf\jts\indices 4.0_install_dir\server\conf\jts\indices
    copy CCM_3.0.1_install_dir\server\conf\ccm\indices 4.0_install_dir\server\conf\ccm\indices
    copy QM_3.0.1_install_dir\server\conf\qm\indices 4.0_install_dir\server\conf\qm\indices
    cp -R JTS_3.0.1_install_dir/server/conf/jts/indices 4.0_install_dir/server/conf/jts/indices
    cp -R CCM_3.0.1_install_dir/server/conf/ccm/indices 4.0_install_dir/server/conf/ccm/indices
    cp -R QM_3.0.1_install_dir/server/conf/qm/indices 4.0_install_dir/server/conf/qm/indices
  8. 打开命令提示符并输入以下命令以将 JFS 索引从 3.0.1 复制到 4.0
  9. copy JTS_3.0.1_install_dir\server\conf\jts\indices JTS_4.0_install_dir\server\conf\jts\indices
    copy CCM_3.0.1_install_dir\server\conf\ccm\indices CCM_4.0_install_dir\server\conf\ccm\indices
    copy QM_3.0.1_install_dir\server\conf\qm\indices QM_4.0_install_dir\server\conf\qm\indices
    cp -R JTS_3.0.1_install_dir/server/conf/jts/indices JTS_4.0_install_dir/server/conf/jts/indices
    cp -R CCM_3.0.1_install_dir/server/conf/ccm/indices CCM_4.0_install_dir/server/conf/ccm/indices
    cp -R QM_3.0.1_install_dir/server/conf/qm/indices QM_4.0_install_dir/server/conf/qm/indices

启动 WebSphere Application Server

要启动 WebSphere Application Server,请访问每个服务器并执行下列步骤:

注意:请确保您已将 JDBC 环境变量切换为指向 JRE6 JDBC 驱动程序。有关更多信息,请参阅设置 Oracle 数据库。

注意:请确保您已将 JDBC 环境变量切换为指向 JRE6 JDBC 驱动程序。有关更多信息,请参阅设置 SQL Server 数据库。

  1. 打开命令提示符,并切换到 WAS_profile_root\bin 目录。
  2. 请输入以下命令:
  3. startServer.bat server1 -user admin_userid -password admin_password

  1. 打开命令提示符,并切换到 WAS_profile_root/bin 目录。
  2. 请输入以下命令:
  3. ./startServer.sh server1 -user admin_userid -password admin_password

将 4.0 war 文件部署在 WebSphere Application Server 中

要部署 4.0 应用程序 war 文件,请访问每个应用程序服务器并执行下列步骤:

注意:如果您使用了 IBM Installation Manager 来安装 CLM 应用程序,并且在安装期间已取消选中 Tomcat 7 Application Server 的复选框,那么缺省情况下会将 Web 应用程序文件 (.war) 复制到 JazzInstallDir/server/webapps 目录中。如果您在安装期间选择了 Tomcat 7 Application Server,那么会将 Web 应用程序文件 (.war) 复制到 JazzInstallDir/server/tomcat/webapps 目录中。

  1. 登录到 WebSphere Application Server 集成解决方案控制台 (https://hostname.example.com:9043/ibm/console/logon.jsp)。
  2. 单击应用程序 > 应用程序类型 > WebSphere 企业应用程序。
  3. 安装以下 Web 应用程序文件:
    • jts_war
    • ccm_war
    • qm_war
    • rm_war
    • converter_war
    • clmhelp_war
    • admin_war
  4. 适当地为以下应用程序映射安全角色:
    • jts_war
    • ccm_war
    • qm_war

有关详细信息,请参阅在 WebSphere Application Server 上部署 CLM 应用程序。

重要事项:如果您所在的环境(例如 AIX 或 Solaris)不支持转换器,那么必须在专用转换器上安装 4.0 版本的 converter.war。有关详细信息,请参阅 Rational Requirements Composer 转换器应用程序安装。

启动应用程序

在“企业应用程序”页面中启动下列应用程序:
登录到每个应用程序服务器上的集成解决方案控制台,并启动下列应用程序:
  • jts_war
  • ccm_war
  • qm_war
  • rm_war
  • converter_war
  • admin_war
  • clmhelp_war

启动服务器

注意:请确保您已将 JDBC 环境变量切换为指向 JRE6 JDBC 驱动程序。有关更多信息,请参阅设置 Oracle 数据库。

注意:请确保您已将 JDBC 环境变量切换为指向 JRE6 JDBC 驱动程序。有关更多信息,请参阅设置 SQL Server 数据库。

启动所有 4.0 应用程序服务器

  1. 打开命令提示符,并切换到 4.0_install_dir\server 目录。
  2. 请输入以下命令:
  3. server.startup.bat

  1. 打开命令提示符,并切换到 4.0_install_dir/server 目录。
  2. 请输入以下命令:
  3. ./server.startup.sh

激活试用 V4 许可证或者安装 V4 许可证

您必须购买 V4.0 的新许可证。V4 许可证将与 V3 应用程序兼容,但是,V3 许可证对于 V4 应用程序将不起作用。安装 V4.0 浮动许可证、令牌许可证或者“授权用户单个安装”许可证(如果已经使用了它们的 V3 等效许可证)。安装 V4 许可证期间,将保持已分配的现有 V3 用户许可证。

如果您尚未购买 V4 许可证,那么您可以激活并限期使用试用许可证。要激活试用许可证,请遵循下列步骤:

  1. 以管理员身份登录到 4.0 Jazz Team Server。https://host.example.com:9443/jts/admin
  2. 单击服务器 > 许可证密钥管理。
  3. 单击激活试用许可证以激活试用许可证。

注意:如果您正在使用试用许可证,那么在运行下一步“迁移 Rational Requirements Composer”之前,您必须为执行 RRC 升级的 admin 用户分配试用许可证。

有关许可证的更多信息,请参阅管理许可证。

迁移 Rational Requirements Composer

注意:将 Requirements Composer 升级到 V4.0 的过程中,从您重新启动 Requirements Composer 应用程序开始,会使 Jazz Team Server 处于只读方式,直到您完成联机迁移向导为止。

  1. 打开浏览器,清除浏览器高速缓存,然后浏览到 Requirements Manager Web 客户端。指定以下 URL 中的服务器名称和端口:https://hostname.example.com:port/rm/web/projects/migration。缺省端口是 9443。此页面会检测是否正在进行迁移,并启动迁移向导。
  2. 接受 Rational Requirements Composer - 分析人员客户访问许可证
  3. 单击打开“升级服务”面板,然后在升级向导中单击下一步以开始进行 Rational Requirements Composer 升级。正在进行升级时,会将关于正在处理哪个存储区域以及何时开始建立索引的状态通过迁移 Web 页面报告给管理员。

    重要事项:开始升级之后,您就无法取消此操作,直到完成升级为止。

  4. 完成升级之后,会对 Rational Requirements Composer 数据重新建立索引。
  5. 重新建立索引之后,应用程序会对已迁移的数据执行验证和一致性检查,并向管理员提供反馈。此时将显示“已完成升级”消息。单击关闭。您将被重定向到 Rational Requirements Composer 应用程序。
  6. 在服务器已启动之后,执行发布服务初始化 (https://[hostname.example.com]:9443/[application context root]/publish/initialize)。

配置数据仓库

如果您已跳过在 CLM 3.0.1 安装版本中配置数据仓库,但是想要在 V4.0 中配置数据仓库,请遵循下列步骤:

  1. 创建要用作数据仓库的数据库。有关更多信息,请参阅设置数据库。
  2. 运行安装向导,跳到配置数据仓库步骤,配置数据仓库。有关更多信息,请参阅配置数据仓库。

    注意:设置 4.0 服务器时不需要运行安装向导;安装向导仅用来配置数据仓库(如果在 CLM 3.0.1 中未配置数据仓库)。

验证核对表

完成升级过程之后,使用以下核对表来确定是否一切正常。

  验证任务 更多信息
确认已将下列应用程序配置文件从 V3.0.1 复制到 V4.0:
  • 对于 Jazz Team Server:[4.0_install_dir]/server/conf/jts/teamserver.properties
  • 对于“变更和配置管理”应用程序:[4.0_install_dir]/server/conf/ccm/teamserver.properties
  • 对于“质量管理”应用程序:[4.0_install_dir]/server/conf/qm/teamserver.properties
  • 对于“生命周期项目管理”应用程序:[4.0_install_dir]/server/conf/admin/admin.properties
  • 对于“生命周期项目管理”应用程序:[4.0_install_dir]/server/conf/admin/friends.rdf
  • 对于“需求管理”应用程序:[4.0_install_dir]/server/conf/rm/friendsconfig.rdf
  • 对于“需求管理”应用程序:[4.0_install_dir]/server/conf/rm/fronting.properties
 
请确认每个 teamserver.properties 文件都包含以下信息:
  • 从 V3.0.1 teamserver.properties 中复制的属性
  • 相异的有效公用 URL com.ibm.team.repository.server.webapp.url(V4 应用程序的 URL 必须与用于 V3 的 URL 相同)
  • 有效的数据库供应商条目(请确保 /conf/jts/teamserver.properties 中指定的数据库存在)
 
验证应用程序服务器:
  • 请确认 [4.0_install_dir]/server/tomcat/conf/tomcat-users.xml 包含 V3.0.1 中的信息。
  • 如果您正在使用 LDAP 注册表或者您已禁用 HTTPS 或 FORM 认证,请确认 [4.0_install_dir]/server/tomcat/conf/server.xml 包含下列代码段:

    <Realm className="org.apache.catalina.realm.JNDIRealm"
    ...>
    </Realm>

    并且不包含下列代码段:

    Realm className="org.apache.catalina.realm.UserDatabaseRealm"
    resourceName="UserDatabase"
    ...>
    </Realm>

    注意:如果您在 [3.0.1_install_dir]/server/tomcat/conf/server.xml 文件中具有其他定制设置,请确认已将它们复制到 [4.0_install_dir]/server/tomcat/conf/server.xml。

  • 请确认 web.xml 文件具有正确的 <security-role> 标记:
    • 对于 Jazz Team Server:[4.0_install_dir]/server/tomcat/webapps/jts/WEB-INF/web.xml
    • 对于“变更和配置管理”应用程序:[4.0_install_dir]/server/tomcat/webapps/ccm/WEB-INF/web.xml
    • 对于“质量管理”应用程序:[4.0_install_dir]/server/tomcat/webapps/qm/WEB-INF/web.xml
    • 对于“需求管理”应用程序:[4.0_install_dir]/server/tomcat/webapps/rm/WEB-INF/web.xml
    • 对于“生命周期项目管理”应用程序:[4.0_install_dir]/server/tomcat/webapps/admin/WEB-INF/web.xml
  • 请确保已部署并且已启动下列应用程序:
    • jts.war
    • ccm.war
    • qm.war
    • rm.war
    • converter.war
    • admin.war
    • clmhelp.war
部署和启动服务器
验证服务器日志:检查下列服务器日志以确保包含升级后信息:
  • 如果您正在使用 Tomcat 服务器,那么日志文件位于 [4.0_install_dir]/server/logs 目录中。
  • 如果您正在使用 WebSphere Application Server,那么日志文件位于 [WAS_install_dir]/profiles/AppSrv01/logs 目录中。
 
验证公用 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 界面
验证用户、许可证和链接工件:
  • 检查用户和许可证
  • 验证已链接的工件
  • 验证 Web 客户机
  • 使用搜索来验证建立索引
  • 验证 Rational Team Concert Eclipse 客户机或 Visual Studio 客户机
验证用户、许可证和链接工件

与其他产品进行集成

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。