将 Design Management 升级至 V4.0.6

使用本指南将以下 Rational Design Management (DM) 升级到 V4.0.6:

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

选择要升级的应用程序:

注意:在 Rational Design Management 中,必须首先升级 Jazz Team Server。在分布式拓扑中,每次选择一个要升级的应用程序。

选择当前的产品版本:
选择部署拓扑:
选择应用程序服务器的操作系统:
选择应用程序服务器:
选择数据库服务器:

用于将产品升级到 V4.0.6 的完整指示信息将根据您在上一页中作出的选择而生成。

重要:请先阅读这些重要说明,然后再进行升级。

完成规划核对表

使用此规划核对表确保您已作好升级准备。

  规划任务 更多信息
使用软件产品兼容性报告:在此页面上,您可以搜索并生成特定产品的报告。信息包括先决条件、特定语言的产品翻译、服务终止时间和服务器虚拟化环境等。 软件产品兼容性报告
针对 Linux 上的 Rhapsody Design Managment:确保 X 服务器正在运行,且 DISPLAY 环境变量正确设置为运行服务器的范围。
使用升级数据表:在升级数据表上,您可以收集和记录升级过程中需要的特定数据,例如 URL 和用户标识。 对数据表进行升级
验证硬件和软件是否满足最低系统需求:V4.0.3 及更高版本有新需求,包括必须使用 64 位服务器操作系统。要了解这些新需求以及当前系统是否满足最低需求,请单击系统需求链接。 系统需求
获取产品安装介质:对于本地存储库下载,您大约需要 5 GB 的硬盘驱动器空间来下载和解压缩产品安装介质。 您可以从 jazz.net 下载服务器安装文件
复审升级拓扑示例。
同步所有服务器上的时钟:在分布式环境中,确保通过使用网络时间协议 (NTP) 来同步所有服务器上的时钟。 有关 NTP 的更多信息,请访问 ntp.org
了解升级过程:了解升级过程以及升级会如何影响部署。 了解部署和升级过程
针对应用程序不可用的情况进行规划:在备份所有内容以及将应用程序更新到 V4.0.3 的过程中,您的应用程序在短时间内将不可用。Jazz Team Server 脱机时,所有连接至 Jazz Team Server 的应用程序都将脱机。确保预留时间,以便完全备份现有应用程序。  
满足数据库先决条件
  • 您可以访问先前发行版的数据库,并复制 derby/repositoryDB 目录
  • 您具有正确的用户名和密码。
    • 在 UNIX 系统上,请使用 DB2 实例所有者(通常为 db2inst1 用户)的密码。
  • 启动升级过程之前已备份数据库。
  • 您具有正确的用户名和密码。
  • 启动升级过程之前已备份数据库。有关备份数据库的更多信息,请参阅数据库供应商的文档。
  • 您正在使用 JRE V6.0 或 V7.0,并且正在使用 ojdbc6.jar。Design Managment 4.0.3 和更高版本不再支持 JRE V5.0。 仅支持 JRE V6.0 和 V7.0。ojdbc5.jar 类库需要 JRE V5.0,而 ojdbc6.jar 类库需要 JRE V6.0 或更高版本。
  • 已创建名为 ORACLE_JDBC_DRIVER_FILE 的环境变量,并已使其指向 ojdbc6.jar JDBC 驱动程序。
  • 您具有正确的用户名和密码。
  • 启动升级过程之前已备份数据库。有关备份数据库的信息,请参阅数据库供应商的文档。
  • 确保已安装 Java 数据库连接 (JDBC) 驱动程序,并且您正在使用 sqljdbc4.jar。Design Management 4.0.3 和更高版本不再支持 JRE V5.0。 仅支持 JRE V6.0 和 V7.0。sqljdbc4.jar 类库需要 JRE 6.0 或更高版本。
  • 已启动 SQL 服务。
了解许可证发放您已指示您正在从 Design Management 3.0 进行升级。您必须获取 V4.0.3 许可证。您已指示您正在从 Design Management 3.0.1.x 进行升级。您必须获取 V4.0.3 许可证。您已指示您正在从 Design Management 4.0.0.x 进行升级。您无需获取 V4.0.3 的新许可证。 您已指示您正在从 Design Management 4.0.1 进行升级。您无需获取 V4.0.3 的新许可证。您已指示您正在从 Design Management 4.0.2 进行升级。您无需获取 V4.0.3 的新许可证。 管理许可证发放
检查浏览器兼容性
  • 在 Web 浏览器中启用 JavaScript,以便可以显示向导。
  • 对于用于迁移的 Web 浏览器,请确保弹出窗口阻止程序处于禁用状态。
 
检查 Java 虚拟机选项:确保 Java 虚拟机具有适当的堆大小设置。
如果使 Jazz Team Server 在 Apache Tomcat 中作为 Windows 服务运行,请参阅在 Apache Tomcat 中作为 Windows 服务(64 位)运行

应用程序和目录的缩写

以下这些缩写指代应用程序和安装目录:

可选:准备一个测试环境以便执行升级过程

在升级生产环境前,请先设置测试环境以避免发生问题。有关更多信息,请参阅准备一个测试环境以便执行升级过程

记录服务器名称、概要文件名称、节点名、堆大小值以及先前安装的应用程序的名称

在升级期间,需要了解有关当前环境的一些信息。请确保记录以下信息。

  1. 登录到 WebSphere Application Server 集成解决方案控制台。
  2. 展开服务器 > 服务器类型,然后单击 WebSphere Application Server
  3. 记录服务器名称和节点名。
  4. 单击 server1,展开 Java 和进程管理,然后单击进程定义 > Java 虚拟机
  5. 记录初始堆大小最大堆大小以及通用 JVM 参数下面的值。
  6. 展开应用程序 > 应用程序类型,然后单击“WebSphere 企业应用程序”。
  7. 记录下列已安装的应用程序的名称:
    • Jazz Team Server (jts_war)
    • CLMHelp (clmhelp_war)
    • Admin (admin_war)
    • “变更和配置管理”(ccm_war)

升级 Rational Reporting for Development Intelligence

注:必须先升级 Rational Reporting for Development Intelligence,然后再升级 Rational Solution for CLM。无需将数据仓库与 Rational Reporting for Development Intelligence 一起升级,因为在 Rational Solution for CLM 升级过程中会对它们进行升级。

要升级 Rational Reporting for Development Intelligence,请参阅下列任何链接:

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

安装 Rational Design Management V4.0.6

安装 Rational Design Management V4.0.6 应用程序,但是不运行设置向导。对于分布式配置,请安装对应于先前安装的应用程序的 V4.0.6 应用程序。有关安装服务器的信息,请参阅通过使用 IBM Installation Manager 来进行安装使用命令行命令进行安装

Design Management 的前发行版自动安装了其他必需的应用程序(例如,配置管理,VVC)。这些应用程序现在是在 Design Management 组件(Design Management for Rational Software Architect (RSA-DM) 或 Design Management for Rhapsody (Rhapsody-DM))之外安装的独立可安装组件。可能需要安装的额外组件为:

  • 必需始终安装配置管理组件 (VVC) 并对 Jazz Team Server (JTS) 注册。请勿将此组件与“变更和配置管理 (CCM/RTC)”混淆。
  • 如果您正在安装 RSA-DM,那么还必须安装 IBM Rational Software Architect Extension for Design Management 域扩展。

在将用于升级服务器的节点(例如,节点 1)上安装 CLM 4.0.6 应用程序。不运行设置向导。有关安装服务器的信息,请参阅通过使用 IBM Installation Manager 来进行安装使用命令行命令进行安装

安装 CLM V4.0.6 应用程序,但不运行设置向导。对于分布式配置,请安装对应于先前安装的应用程序的 V4.0.6 应用程序。有关安装服务器的信息,请参阅在 IBM i 上使用许可程序进行安装

备份 WebSphere Application Server 概要文件

可以选择创建 WebSphere Application Server 概要文件的备份,以便在升级失败时可以将其复原。

在分布式拓扑中,必须在托管以下部件的应用程序服务器上完成后续步骤:

  • Jazz Team Server
  • “变更和配置管理”应用程序

  1. 打开命令提示符,并切换到 WebSphere Application Server 安装目录的 bin 文件夹。例如,C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\bin
  2. 运行以下命令。如果启用了 WebSphere Application Server 安全性,那么您还必须提供用户名和密码。
  3. 注:该命令会在启动备份进程之前,先关闭服务器。

    backupConfig.bat Path_to_a_new_compressed_file_to_create_backup_of_profile -username WAS_primary_administrative_user_name -password WAS_administrative_password

    例如:

    backupConfig.bat C:\WAS_backup\CLM_4.0.0.x_profile.zip -username WAS admin -password WAS admin password

    backupConfig.bat C:\WAS_backup\CLM_4.0.1_profile.zip -username WAS admin -password WAS admin password

    backupConfig.bat C:\WAS_backup\CLM_4.0.2_profile.zip -username WAS admin -password WAS admin password

    backupConfig.bat C:\WAS_backup\CLM_4.0.3_profile.zip -username WAS admin -password WAS admin password

    backupConfig.bat C:\WAS_backup\CLM_<previous_version>_profile.zip -username WAS admin -password WAS admin password

    注:运行备份命令前,压缩文件的目录路径必须存在。

    提示:您可以通过运行 restoreConfig.bat 命令来复原已备份的概要文件。例如, restoreConfig.bat C:\WAS_backup\RTC_3.0_profile.zip restoreConfig.bat C:\WAS_backup\CLM_3.0.1.x_profile.zip restoreConfig.bat C:\WAS_backup\CLM_4.0.0.x_profile.zip restoreConfig.bat C:\WAS_backup\CLM_4.0.1_profile.zip restoreConfig.bat C:\WAS_backup\CLM_4.0.2_profile.zip

  1. 打开命令 shell,并切换到 WebSphere Application Server 安装目录的 bin 文件夹。例如,/opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin
  2. 运行以下命令。如果启用了 WebSphere Application Server 安全性,那么您还必须提供用户名和密码。
  3. 注:该命令会在启动备份进程之前,先关闭服务器。

    ./backupConfig.sh Path_to_a_new_compressed_file_to_create_backup_of_profile -username WAS_primary_administrative_user_name -password WAS_administrative_password

    例如:

    ./backupConfig.sh /root/WAS_backup/CLM_4.0.0.x_profile.zip -username admin -password password

    ./backupConfig.sh /root/WAS_backup/CLM_4.0.1_profile.zip -username admin -password password

    ./backupConfig.sh /root/WAS_backup/CLM_4.0.2_profile.zip -username admin -password password

    ./backupConfig.sh /root/WAS_backup/CLM_4.0.3_profile.zip -username admin -password password

    ./backupConfig.sh /root/WAS_backup/CLM_<previous_version>_profile.zip -username admin -password password

    注:运行备份命令前,压缩文件的目录路径必须存在。

    提示:您可以通过运行 ./restoreConfig.sh 命令来复原已备份的概要文件。例如,./restoreConfig.sh /root/WAS_backup/RTC_3.0_profile.zip./restoreConfig.sh /root/WAS_backup/CLM_3.0.1.x_profile.zip./restoreConfig.sh /root/WAS_backup/CLM_4.0.0.x_profile.zip./restoreConfig.sh /root/WAS_backup/CLM_4.0.1_profile.zip./restoreConfig.sh /root/WAS_backup/CLM_4.0.2_profile.zip

  1. 打开命令提示符,并切换到 WebSphere Application Server 安装目录的 bin 文件夹。例如,/usr/IBM/WebSphere/AppServer/profiles/AppSrv01/bin
  2. 运行以下命令。如果启用了 WebSphere Application Server 安全性,那么您还必须提供用户名和密码。
  3. 注:该命令会在启动备份进程之前,先关闭服务器。

    ./backupConfig.sh Path_to_a_new_compressed_file_to_create_backup_of_profile -username WAS_primary_administrative_user_name -password WAS_administrative_password

    例如:

    ./backupConfig.sh /root/WAS_backup/CLM_4.0.0.x_profile.zip -username admin -password password

    ./backupConfig.sh /root/WAS_backup/CLM_4.0.1_profile.zip -username admin -password password

    ./backupConfig.sh /root/WAS_backup/CLM_4.0.2_profile.zip -username admin -password password

    ./backupConfig.sh /root/WAS_backup/CLM_4.0.3_profile.zip -username admin -password password

    ./backupConfig.sh /root/WAS_backup/CLM_<previous_version>_profile.zip -username admin -password password

    注:运行备份命令前,压缩文件的目录路径必须存在。

    提示:您可以通过运行 ./restoreConfig.sh 命令来复原已备份的概要文件。例如,./restoreConfig.sh /root/WAS_backup/RTC_3.0_profile.zip./restoreConfig.sh /root/WAS_backup/CLM_3.0.1.x_profile.zip./restoreConfig.sh /root/WAS_backup/CLM_4.0.0.x_profile.zip./restoreConfig.sh /root/WAS_backup/CLM_4.0.1_profile.zip./restoreConfig.sh /root/WAS_backup/CLM_4.0.2_profile.zip

从 WebSphere Application Server 中卸载先前安装的应用程序

在分布式拓扑中,必须在托管以下部件的应用程序服务器上完成后续步骤:

  • Jazz Team Server
  • Design Management 应用程序
  • “质量管理”应用程序
  • “配置管理”应用程序

  1. 如果已执行上一步来备份 WebSphere Application Server 概要文件,那么该命令会关闭服务器。请启动服务器以继续。
  2. 登录到 WebSphere Application Server 集成解决方案控制台 (https://hostname:9043/ibm/console/logon.jsp)。
  3. 单击应用程序 > 应用程序类型 > WebSphere 企业应用程序
  4. 单击 jts_war,然后单击详细属性下的安全角色到用户/组映射。记录 jts_war 应用程序的安全角色映射。您将使用此信息重新映射该应用程序的 V4.0.4 对应应用程序。
  5. 单击 qm_war,然后单击详细属性下的安全角色到用户/组映射。记录 qm_war 应用程序的安全角色映射。您将使用此信息重新映射该应用程序的 V4.0.4 对应应用程序。
  6. 单击企业应用程序链接,然后停止并卸载已安装的下列应用程序:
    • jts_war
    • clmhelp_war
    • admin_war
    • dm_war
    • rdmhelp_war
    • qm_war
    • vvc_war
    • vvchelp_war
  7. 系统提示您保存对主配置的变更时,请进行保存。

更新 JAZZ_HOME 和 log4j.configuration 定制属性

在分布式拓扑中,必须在托管以下部件的应用程序服务器上更新 JAZZ_HOMElog4j.configuration 定制属性:

  • Jazz Team Server
  • Design Management 应用程序
  • “质量管理”应用程序
  • “配置管理”应用程序

  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.6_install_dir/server/conf。例如,file:///C:/PROGRA~2/IBM/JazzTeamServer_4.0.6/server/conf
  8. 单击 JAZZ_HOME 并将其值更新为 file:////4.0.6_install_dir/server/conf。例如,file:////opt/IBM/JazzTeamServer_4.0.6/server/conf
  9. 单击 JAZZ_HOME 并将其值更新为 file:////4.0.6_install_dir/server/conf。例如,file:////usr/IBM/JazzTeamServer_4.0.4/server/conf
  10. 单击 log4j.configuration 并将其值更新为 file:///4.0.6_install_dir/server/conf/startup_log4j.properties。例如,file:///C:/PROGRA~2/IBM/JazzTeamServer_4.0.6/server/conf/startup_log4j.properties
  11. 单击 log4j.configuration 并将其值更新为 file:////4.0.6_install_dir/server/conf/startup_log4j.properties。例如,file:////opt/IBM/JazzTeamServer_4.0.6/server/conf/startup_log4j.properties
  12. 单击 log4j.configuration 并将其值更新为 file:////4.0.6_install_dir/server/conf/startup_log4j.properties。例如,file:////usr/IBM/JazzTeamServer_4.0.6/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

在分布式拓扑中,必须在托管以下部件的应用程序服务器上完成后续步骤:

  • Jazz Team Server
  • Design Management 应用程序
  • “质量管理”应用程序
  • “配置管理”应用程序
  • 向 Jazz Team Server 注册的任意应用程序

注:升级“需求管理”应用程序时,必须确保已停止 Jazz Team Server(包括向 Jazz Team Server 注册的所有应用程序)和“需求管理”应用程序服务器。

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

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

  1. 在 QShell 中,浏览到旧的配置目录,例如,/QIBM/UserData/JazzTeamServer40/server
  2. 请输入以下命令:
  3. ./serverShutdown.sh profileName wasVersion wasOption adminId adminPwd

更新 WebSphere eXtreme Scale

确保使用最新的临时修订更新 WebSphere eXtreme Scale。要下载最新的临时修订,请参阅安装 WebSphere eXtreme Scale

清除 WebSphere Application Server temp 目录

在分布式拓扑中,必须在托管以下部件的应用程序服务器上完成后续步骤:

  • Jazz Team Server
  • Design Management 应用程序
  • “质量管理”应用程序
  • “配置管理”应用程序

从概要文件中的以下 wscachetemp 目录中除去与此应用程序相关的内容。 这些目录可能位于概要文件中并且可以被除去,具体取决于所安装的应用程序:

  • jts_war
  • dm_war
  • rdmhelp_war
  • qm_war
  • vvc_war
  • vvchelp_war
  • admin_war
  • clmhelp_war

WAS_profile_dir\wscache 位置示例:

C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache

WAS_profile_dir\temp 示例:

C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\temp

WAS_profile_dir/wscache 位置示例:

opt/IBM/WebSphere/AppServer/profiles/AppSrv01/wscache

WAS_profile_dir/temp 示例:

opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp

WAS_profile_dir/wscache 位置示例:

usr/IBM/WebSphere/AppServer/profiles/AppSrv01/wscache

WAS_profile_dir/temp 示例:

usr/IBM/WebSphere/AppServer/profiles/AppSrv01/temp

清除 logs 目录

在分布式拓扑中,必须在托管以下部件的应用程序服务器上完成后续步骤:

  • Jazz Team Server
  • Design Management 应用程序
  • “质量管理”应用程序
  • “配置管理”应用程序

从概要文件中的 logs 目录中除去与此应用程序相关的日志。

WAS_profile_dir\logs 位置示例:

C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\logs

WAS_profile_dir/logs 位置示例:

opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs

WAS_profile_dir/logs 位置示例:

usr/IBM/WebSphere/AppServer/profiles/AppSrv01/logs

停止服务器

在分布式拓扑中,必须在托管以下部件的应用程序服务器上完成后续步骤:

  • Jazz Team Server
  • Design Management 应用程序
  • “质量管理”应用程序
  • “配置管理”应用程序
  • 向 Jazz Team Server 注册的任意应用程序

注:升级“需求管理”应用程序时,必须确保已停止 Jazz Team Server(包括向 Jazz Team Server 注册的所有应用程序)和“需求管理”应用程序服务器。

  1. 打开命令提示符,并切换到 DM_4.0.0.x_install_dir\server 目录。
  2. 打开命令提示符,并切换到 DM_4.0.1_install_dir\server 目录。
  3. 打开命令提示符,并切换到 DM_4.0.2_install_dir\server 目录。
  4. 打开命令提示符,并切换到 DM_4.0.3_install_dir\server 目录。
  5. 打开命令提示符,并切换到 DM_<previous_version>_install_dir\server 目录。例如,DM_4.0.5_install_dir
  6. 请输入以下命令:
  7. server.shutdown.bat

  1. 打开命令 shell,并切换到 DM_4.0.0.x_install_dir/server 目录。
  2. 打开命令 shell,并切换到 DM_4.0.1_install_dir/server 目录。
  3. 打开命令 shell,并切换到 DM_4.0.2_install_dir/server 目录。
  4. 打开命令 shell,并切换到 DM_4.0.3_install_dir/server 目录。
  5. 打开命令 shell,并切换到 DM_<previous_version>_install_dir/server 目录。
  6. 请输入以下命令:
  7. ./server.shutdown

Design Management 3.0 Design Management V3.0.1.x Design Management V4.0.0.x Design Management V4.0.1 Design Management V4.0.2 Design Management V4.0.3 Design Management V4.0.4 或更高版本安装目录中复制 Derby 数据库

  1. 在复制 Derby 数据库之前,转至刚刚在其中安装了 V4.0.6 应用程序的目录,并删除每个应用程序的 Derby repositoryDB 目录。另外,您可以打开命令提示符,并输入以下命令以清除缺省 V4.0.6 Derby repositoryDB 目录:
  2. del /s /f 4.0.6_install_dir\server\conf\jts\derby\repositoryDB
    del /s /f 4.0.6_install_dir\server\conf\dm\derby\repositoryDB
    del /s /f 4.0.6_install_dir\server\conf\vvc\derby\repositoryDB
    rm -rf 4.0.6_install_dir/server/conf/jts/derby/repositoryDB
    rm -rf 4.0.6_install_dir/server/conf/dm/derby/repositoryDB
    rm -rf 4.0.6_install_dir/server/conf/vvc/derby/repositoryDB
  3. 转至先前在其中安装了 Design Management 的目录,复制 Derby 数据库并将其粘贴到 V4.0.6 的对应目录中。您也可以打开命令提示符,并输入以下命令以复制 Derby 数据库。
  4. 注意:如果您正在使用打包的产品随附的 Derby 数据库,那么下列命令有效。如果您已更改 Derby 数据库的位置,请相应地更新路径。

    xcopy /s DM_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dirDM_4.0.3_install_dirDM_<previous_version>_install_dirDM_<previous_version>_install_dir\server\conf\jts\derby\repositoryDB 4.0.6_install_dir\server\conf\jts\derby\repositoryDB
    xcopy /s DM_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dirDM_4.0.3_install_dirDM_<previous_version>_install_dirDM_<previous_version>_install_dir\server\conf\jts\derby\warehouseDB 4.0.6_install_dir\server\conf\jts\derby\warehouseDB
    xcopy /s DM_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dirDM_4.0.3_install_dirDM_<previous_version>_install_dirDM_<previous_version>_install_dir\server\conf\dm\derby\repositoryDB 4.0.6_install_dir\server\conf\dm\derby\repositoryDB
    xcopy /s DM_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dirDM_4.0.3_install_dirDM_<previous_version>_install_dirDM_<previous_version>_install_dir\server\conf\vvc\derby\repositoryDB 4.0.6_install_dir\server\conf\vvc\derby\repositoryDB

    在 WebSphere Application Sever 部署中,缺省数据库位置是在 WebSphere 安装目录下。

    xcopy /s WAS_install_dir\OldAppServerHostIntall\jts\derby\conf\repositoryDB WAS_install_dir\AppServerHost4.xIntall\jts\derby\conf\repositoryDB
    xcopy /s WAS_install_dir\OldAppServerHostIntall\jts\derby\conf\warehouseDB WAS_install_dir\AppServerHost4.xIntall\jts\derby\conf\warehouseDB
    xcopy /s WAS_install_dir\OldAppServerHostIntall\dm\derby\conf\repositoryDB WAS_install_dir\AppServerHost4.xIntall\dm\derby\conf\repositoryDB
    xcopy /s WAS_install_dir\OldAppServerHostIntall\vvc\derby\conf\repositoryDB WAS_install_dir\AppServerHost4.xIntall\vvc\derby\conf\repositoryDB
    cp -R DM_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dirDM_4.0.3_install_dirDM_<previous_version>_install_dirDM_<previous_version>_install_dir/server/conf/jts/derby/repositoryDB 4.0.6_install_dir/server/conf/jts/derby/repositoryDB
    cp -R DM_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dirDM_4.0.3_install_dirDM_<previous_version>_install_dirDM_<previous_version>_install_dir/server/conf/jts/derby/warehouseDB 4.0.6_install_dir/server/conf/jts/derby/warehouseDB
    cp -R DM_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dirDM_4.0.3_install_dirDM_<previous_version>_install_dirDM_<previous_version>_install_dir/server/conf/dm/derby/repositoryDB 4.0.6_install_dir/server/conf/dm/derby/repositoryDB
    cp -R DM_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dirDM_4.0.3_install_dirDM_<previous_version>_install_dirDM_<previous_version>_install_dir/server/conf/vvc/derby/repositoryDB 4.0.6_install_dir/server/conf/vvc/derby/repositoryDB
    cp -R DM_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dirDM_4.0.3_install_dirDM_<previous_version>_install_dirDM_<previous_version>_install_dir/server/conf/jts/derby/warehouseDB 4.0.6_install_dir/server/conf/jts/derby/warehouseDB

    在 WebSphere Application Sever 部署中,缺省数据库位置是在 WebSphere 安装目录下。

    cp -R WAS_install_dir/AppServerHost3.xIntall/jts/derby/conf/repositoryDB WAS_install_dir/AppServerHost4.xIntall/jts/derby/conf/repositoryDB
    cp -R WAS_install_dir/OldAppServerHostIntall/jts/derby/conf/warehouseDB WAS_install_dir/AppServerHost4.xIntall/jts/derby/conf/warehouseDB
    cp -R WAS_install_dir/OldAppServerHostIntall/dm/derby/conf/repositoryDB WAS_install_dir/AppServerHost4.xIntall/dm/derby/conf/repositoryDB
    cp -R WAS_install_dir/OldAppServerHostIntall/vvc/derby/conf/repositoryDB WAS_install_dir/AppServerHost4.xIntall/vvc/derby/conf/repositoryDB

备份数据库

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

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

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

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

要升级 Jazz Team Server 配置文件,请转至 JTS_4.0.6_install_dir/server 并运行下列命令:

如果路径包含空格,请确保将路径括在双引号中。

repotools-jts.bat -migration_jts_updateConfigurationFiles oldJTSHome=RTC_3.0_install_dirJTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dirJTS_4.0.3_install_dirJTS_<previous_version>_install_dirJTS_<previous_version>_install_dir/server/conf

repotools-jts.bat -addTables

repotools-jts.bat -upgradeWarehouse

repotools-jts.bat -migration_jts_updateConfigurationFiles oldJTSHome=RTC_3.0_install_dirJTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dirJTS_4.0.3_install_dirJTS_<previous_version>_install_dirJTS_<previous_version>_install_dir/server/conf updateTomcatFiles=no

repotools-jts.bat -addTables

repotools-jts.bat -upgradeWarehouse

./repotools-jts.sh -migration_jts_updateConfigurationFiles oldJTSHome=RTC_3.0_install_dirJTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dirJTS_4.0.3_install_dirJTS_<previous_version>_install_dirJTS_<previous_version>_install_dir/server/conf

./repotools-jts.sh -addTables

./repotools-jts.sh -upgradeWarehouse

./repotools-jts.sh -migration_jts_updateConfigurationFiles oldJTSHome=RTC_3.0_install_dirJTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dirJTS_4.0.3_install_dirJTS_<previous_version>_install_dirJTS_<previous_version>_install_dir/server/conf updateTomcatFiles=no

./repotools-jts.sh -addTables

./repotools-jts.sh -upgradeWarehouse

要升级 DM 应用程序配置文件,请转至 DM_<previous_version>_install_dir/server 并运行下列命令:

缺省应用程序上下文根为 jazz。如果升级路径源自 V3 或 V4 的发行版,请在命令中使用 applicationContextRoot=dm 开关。

如果路径包含空格,请确保将路径括在双引号中。

repotools-dm.bat -migration_dm_updateConfigurationFiles oldApplicationHome=RTC_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dirDM_4.0.3_install_dirDM_<previous_version>_install_dirDM_<previous_version>_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=dm

repotools-dm.bat -addTables

repotools-dm.bat -migration_dm_updateConfigurationFiles oldApplicationHome=RTC_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dirDM_4.0.3_install_dirDM_<previous_version>_install_dirDM_<previous_version>_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=dm updateTomcatFiles=no

repotools-dm.bat -addTables

./repotools-dm.sh -migration_dm_updateConfigurationFiles oldApplicationHome=RTC_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dirDM_4.0.3_install_dirDM_<previous_version>_install_dirDM_<previous_version>_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=dm

./repotools-dm.sh -addTables

./repotools-dm.sh -migration_dm_updateConfigurationFiles oldApplicationHome=RTC_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dirDM_4.0.3_install_dirDM_<previous_version>_install_dirDM_<previous_version>_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=ccm updateTomcatFiles=no

./repotools-dm.sh -addTables

要升级“配置管理”应用程序配置文件,请转至 VVC_4.0.6_install_dir/server 并运行下列命令:

缺省应用程序上下文根为 jazz。如果升级路径源自 V3 或 V4 的发行版,请在命令中使用 applicationContextRoot=vvc 开关。

如果路径包含空格,请确保将路径括在双引号中。

repotools-vvc.bat -migration_vvc_updateConfigurationFiles oldApplicationHome=VVC_3.0.1.x_install_dirVVC_4.0.0.x_install_dirVVC_4.0.1_install_dirVVC_4.0.2_install_dirVVC_4.0.3_install_dirVVC_<previous_version>_install_dirVVC_<previous_version>_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=vvc

repotools-vvc.bat -addTables

repotools-vvc.bat -migration_vvc_updateConfigurationFiles oldApplicationHome=VVC_3.0.1.x_install_dirVVC_4.0.0.x_install_dirVVC_4.0.1_install_dirVVC_4.0.2_install_dirVVC_4.0.3_install_dirVVC_<previous_version>_install_dirVVC_<previous_version>_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=qm updateTomcatFiles=no

repotools-vvc.bat -addTables

./repotools-vvc.sh -migration_qm_updateConfigurationFiles oldApplicationHome=VVC_3.0.1.x_install_dirVVC_4.0.0.x_install_dirVVC_4.0.1_install_dirVVC_4.0.2_install_dirVVC_4.0.3_install_dirVVC_<previous_version>_install_dirVVC_<previous_version>_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=vvc

./repotools-vvc.sh -addTables

./repotools-vvc.sh -migration_qm_updateConfigurationFiles oldApplicationHome=VVC_3.0.1.x_install_dirVVC_4.0.0.x_install_dirVVC_4.0.1_install_dirVVC_4.0.2_install_dirVVC_4.0.3_install_dirVVC_<previous_version>_install_dirVVC_<previous_version>_install_dir/server/conf ignoreJTSVersionCheck applicationContextRoot=vvc updateTomcatFiles=no

./repotools-vvc.sh -addTables

要升级“需求管理”(RM) 应用程序配置文件,请完成下列步骤:

如果路径包含空格,请确保将路径括在双引号中。

  1. 转至同时安装了旧版本和 V4.0.4 的 RM 应用程序的物理服务器。
  2. RM_4.0.3_install_dir/server 目录和 RM_3.0.1.x_install_dirRM_4.0.0.x_install_dirRM_4.0.1_install_dirRM_4.0.2_install_dir/server 目录的内容复制到便携驱动器上的两个不同目录中。
  3. 转至安装了 Jazz Team Server V4.0.3 的物理服务器,并将便携驱动器的内容复制到临时目录中。 确保每个 RM 应用程序版本都有一个目录。例如:C:\Temp\RM4.0.3C:\Temp\RM3.0.1.xRM4.0.0.xRM4.0.1RM4.0.2
  4. 打开命令提示符,并将目录切换到 C:\Temp\RM4.0.3\server
  5. 输入以下命令:

    upgrade\rm\rm_upgrade.bat -oldApplicationHome C:\Temp\RM3.0.1.xRM4.0.0.xRM4.0.1\server\conf -oldJTSHome JTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dir\server\conf -newJTSHome JTS_4.0.3_install_dir\server\conf applicationContextRoot=rm

    缺省应用程序上下文根为 rdm。如果升级路径源自 V3 或 V4 的发行版,请在命令中使用 applicationContextRoot=rm 开关。

  6. 在 JTS 服务器上完成升级后,请将 C:\Temp\RM4.0.3 目录的内容复制到便携驱动器中。
  7. 转至安装了 RM 应用程序的物理服务器,并通过将便携驱动器的内容粘贴到 RM4.0.3_install_dir/server 目录中来覆盖现有内容。
  1. 转至同时安装了旧版本和 V4.0.4 的 RM 应用程序的物理服务器。
  2. RM4.0.3_install_dir/server 目录和 RM_3.0.1.x_install_dirRM_4.0.0.x_install_dirRM_4.0.1_install_dirRM_4.0.2_install_dir/server 目录的内容复制到便携驱动器上的两个不同目录中。
  3. 转至安装了 Jazz Team Server V4.0.3 的物理机器,并将便携驱动器的内容复制到临时目录中。确保每个 RM 版本都有一个目录。例如:C:\Temp\RM4.0.3C:\Temp\RM3.0.1.xRM4.0.0.xRM4.0.1RM4.0.2
  4. 打开命令提示符,并将目录切换到 C:\Temp\RM4.0.3\server
  5. 输入以下命令:

    upgrade\rm\rm_upgrade.bat -oldApplicationHome C:\Temp\RM3.0.1.xRM4.0.0.xRM4.0.1RM4.0.2\server\conf -oldJTSHome JTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dir\server\conf -newJTSHome JTS_4.0.3_install_dir\server\conf -updateTomcatFiles=no applicationContextRoot=rm

    缺省应用程序上下文根为 rdm。如果升级路径源自 V3 或 V4 的发行版,请在命令中使用 applicationContextRoot=rm 开关。

  6. 在 JTS 服务器上完成升级后,请将 C:\Temp\RM4.0.3 目录的内容复制到便携驱动器中。
  7. 转至安装了 RM 应用程序的物理机器,并通过将便携驱动器的内容粘贴到 RM4.0.3_install_dir/server 目录中来覆盖现有内容。
  1. 转至同时安装了旧版本和 V4.0.3 的 RM 应用程序的物理服务器。
  2. RM4.0.3_install_dir/server 目录和 RM_3.0.1.x_install_dirRM_4.0.0.x_install_dirRM_4.0.1_install_dirRM_4.0.2_install_dir/server 目录的内容复制到便携驱动器上的两个不同目录中。
  3. 转至安装了 Jazz Team Server V4.0.3 的物理服务器,并将便携驱动器的内容复制到临时目录中。 确保每个 RM 应用程序版本都有一个目录。例如:opt/tmp/rm4.0.3opt/tmp/rm3.0.1.xrm4.0.0.xrm4.0.1rm4.0.2
  4. 打开命令 shell,并将目录切换到 opt/tmp/rm4.0.2/server
  5. 输入以下命令:

    upgrade/rm/rm_upgrade.sh -oldApplicationHome opt/tmp/rm3.0.1.xrm4.0.0.xrm4.0.1rm4.0.2/server/conf -oldJTSHome JTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dir/server/conf -newJTSHome JTS_4.0.3_install_dir/server/conf applicationContextRoot rm

    缺省应用程序上下文根为 rdm。如果升级路径源自 V3 或 V4 的发行版,请在命令中使用 applicationContextRoot rm 开关。

  6. 在 JTS 服务器上完成升级之后,请将 opt/tmp/rm4.0.3 目录的内容复制到便携驱动器中。
  7. 转至安装了 RM 应用程序的物理服务器,并通过将便携驱动器的内容粘贴到 4.0.3RM_install_dir/server 目录中来覆盖现有内容。
  1. 转至同时安装了旧版本和 V4.0.3 的 RM 应用程序的物理服务器。
  2. RM_4.0.3_install_dir/server 目录和 RM_3.0.1.x_install_dirRM_4.0.0.x_install_dirRM_4.0.1_install_dirRM_4.0.2_install_dir/server 目录的内容复制到便携驱动器上的两个不同目录中。
  3. 转至安装了 Jazz Team Server V4.0.3 的物理服务器,并将便携驱动器的内容复制到临时目录中。 确保每个 RM 应用程序版本都有一个目录。例如:opt/tmp/rm4.0.3opt/tmp/rm3.0.1.xrm4.0.0.xrm4.0.1rm4.0.2
  4. 打开命令 shell,并将目录切换到 opt/tmp/rm4.0.3/server
  5. 输入以下命令:

    upgrade/rm/rm_upgrade.sh -oldApplicationHome opt/tmp/rm3.0.1.xrm4.0.0.xrm4.0.1rm4.0.2/server/conf -oldJTSHome JTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dir/server/conf -newJTSHome JTS_4.0.3_install_dir/server/conf updateTomcatFiles no applicationContextRoot rm

    缺省应用程序上下文根为 rdm。如果升级路径源自 V3 或 V4 的发行版,请在命令中使用 applicationContextRoot rm 开关。

  6. 在 JTS 服务器上完成升级之后,请将 opt/tmp/rm4.0.3 目录的内容复制到便携驱动器中。
  7. 转至安装了 RM 应用程序的物理服务器,并通过将便携驱动器的内容粘贴到 RM_4.0.3_install_dir/server 目录中来覆盖现有内容。

在先前步骤中运行的命令将执行以下任务:

  • 根据较旧版本中的信息来更新 V4.0.3 teamserver.properties 文件
  • 向数据库中添加表
  • 升级数据仓库模式
  • 复制 tomcat-users.xml 文件的内容。

    仅限 Tomcat 用户数据库:复制 tomcat-users.xml 文件,而不是将其与现有文件合并。如果使用公共 Jazz Team Server 升级多个 CLM 应用程序,那么您必须手动合并 tomcat-users.xml 文件中的用户和组信息。如果用户包含在不同应用程序中的不同组中,那么用户和组信息将有所不同。例如,userA 可能在 CCM 应用程序中具有 JazzAdmins 角色,而在 QM 应用程序中具有 JazzUsers 角色。 另外,如果用户存在于一个应用程序中,但在另一个应用程序中不存在(或者反过来),那么您必须手动将这些用户添加到 tomcat-users.xml 文件中。

  • 将较旧版本的 server.xmlweb.xml 文件的内容与 V4.0.3 合并
  • 将较旧版本的 fronting.properties 文件的内容复制到 V4.0.3 中
  • 将较旧版本的 friendsconfig.rdf 文件的内容复制到 V4.0.3 中

有关这些存储库工具命令的更多信息,请参阅下列帮助主题:

运行升级脚本

此脚本使用存储库工具命令来更新配置文件,并将数据库和数据仓库模式更新为 V4.0.6。有关更多信息,请参阅将脚本文件升级

要在 Rational Design Management 与 Jazz Team Server 分开安装的分布式环境中使用升级脚本,升级脚本必须能够访问安装该应用程序的驱动器或文件系统。例如,在 Windows 上,此安装必须采用以下格式:mounted drive letter:\server\conf。绝对路径(例如 \\computer name\JTS_4.0.6_install_dir\server\conf)将不适用。安装的驱动器必须配置为将“读/写/执行”特权授予管理员帐户。

重要:虽然此脚本文件位于upgrade/application context root 目录中,但是必须从 server 目录中运行该文件。如果路径包含空格,请确保将路径名括在双引号中。

要升级 Jazz Team Server,请使用管理特权打开命令提示符,转至 TS_4.0.6_install_dir\server 目录,并输入以下命令:

upgrade\jts\jts_upgrade.bat -oldJTSHome RTC_3.0_install_dirJTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dirJTS_4.0.3_install_dirJTS_<previous_version>_install_dirJTS_<previous_version>_install_dir\server\conf

upgrade\jts\jts_upgrade.bat -oldJTSHome RTC_3.0_install_dirJTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dirJTS_4.0.3_install_dirJTS_<previous_version>_install_dirJTS_<previous_version>_install_dir\server\conf

升级期间,在配置文件合并之后,将打开一个窗口,您可以在其中检查 Jazz Team Server teamserver.properties 文件。如果 com.ibm.team.fulltext.indexlocation 属性的位置是相对路径,那么不需要变更该路径。如果该位置是绝对路径,请确保此目录是稳定目录,并且不会在应用程序卸载后被删除。

绝对稳定位置应类似于以下示例:com.ibm.team.fulltext.indexLocation=JTS_4.0.6_install_dir/server/conf/jts/indices/workitemindex,其中 JTS_4.0.6_install_dir 是 Jazz Team Server 4.0.6 的安装位置。

重要事项:作为 dm_upgrade.xxx 脚本中步骤 0 的一部分,将对源安装执行命令“repotools-dm -version”。在 Design Management 4.0 中,由于存在未解决的依赖性,因此将不会运行 repotools-dm 命令。在运行 dm_upgrade.xx 脚本前,您必须编辑文件 DM4.0_InstallDir/server/repotools-dm.xx 并注释掉定义属性 "-Dcom.ibm.team.repotools.rcp.allowInvalidBundles=true" 的行。如果 dm_upgrade 脚本的步骤 0 因为无法确定源安装的版本而失败,请修正 4.0 repotools-dm.xxx 文件并再次运行 upgrade/dm/dm_upgrade.xx 脚本,从步骤 0 开始。

要升级 Design Management 应用程序,请使用管理特权打开命令提示符,转至 DM_4.0.4_install_dir\server 目录,并输入以下命令:

upgrade\dm\dm_upgrade.bat -oldApplicationHome RTC_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dirDM_4.0.3_install_dirDM_<previous_version>_install_dir\server\conf

upgrade\dm\dm_upgrade.bat -oldApplicationHome RTC_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dirDM_4.0.3_install_dirDM_<previous_version>_install_dir\server\conf -ignoreJTSVersionCheck

升级期间,在配置文件合并之后,将打开一个窗口,您可以在其中检查 Design Management teamserver.properties 文件。

要升级“质量管理”应用程序,请使用管理特权打开命令提示符,转至 QM_4.0.3_install_dir\server 目录,并输入以下命令:

upgrade\qm\qm_upgrade.bat -oldApplicationHome QM_3.0.1.x_install_dirQM_4.0.0.x_install_dirQM_4.0.1_install_dirQM_4.0.2_install_dir\server\conf

upgrade\qm\qm_upgrade.bat -oldApplicationHome QM_3.0.1.x_install_dirQM_4.0.0.x_install_dirQM_4.0.1_install_dirQM_4.0.2_install_dir\server\conf -newJTSHome JTS_4.0.3_install_dir\server\conf

升级期间,在配置文件合并之后,将打开一个窗口,您可以在其中检查“质量管理”teamserver.properties 文件。如果该位置是绝对路径,请确保此目录是稳定目录,并且不会在应用程序卸载后被删除。绝对稳定位置应类似于以下示例:com.ibm.team.fulltext.indexLocation=QM_4.0.3_install_dir/server/conf/qm/indices/workitemindex,其中 QM_4.0.3_install_dir 是“质量管理”应用程序 4.0.3 的安装位置。

要升级“配置管理”应用程序,请使用管理特权打开命令提示符,转至 VVC_4.0.6_install_dir\server 目录,并输入以下命令:

upgrade\vvc\vvc_upgrade.bat -oldApplicationHome VVC_3.0.1.x_install_dirVVC_4.0.0.x_install_dirVVC_4.0.1_install_dirVVC_4.0.2_install_dirVVC_4.0.3_install_dirVVC_<previous_version>_install_dirVVC_<previous_version>_install_dir\server\conf

upgrade\vvc\vvc_upgrade.bat -oldApplicationHome VVC_3.0.1.x_install_dirVVC_4.0.0.x_install_dirVVC_4.0.1_install_dirVVC_4.0.2_install_dirVVC_4.0.3_install_dirVVC_<previous_version>_install_dirVVC_<previous_version>_install_dir\server\conf -ignoreJTSVersionCheck

要升级 Jazz Team Server,请打开命令 shell,转至 JTS_4.0.6_install_dir/server 目录,并输入以下命令:

upgrade/jts/jts_upgrade.sh -oldJTSHome RTC_3.0_install_dirJTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dirJTS_4.0.3_install_dirJTS_<previous_version>_install_dirJTS_<previous_version>_install_dir/server/conf

upgrade/jts/jts_upgrade.sh -oldJTSHome RTC_3.0_install_dirJTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dirJTS_4.0.3_install_dirJTS_<previous_version>_install_dir/server/conf

升级期间,在配置文件合并之后,将打开一个编辑器,您可以在其中检查 Jazz Team Server teamserver.properties 文件。如果该位置是绝对路径,请确保此目录是稳定目录,并且不会在应用程序卸载后被删除。绝对稳定位置应类似于以下示例:com.ibm.team.fulltext.indexLocation=JTS_4.0.6_install_dir/server/conf/jts/indices/workitemindex,其中 JTS_4.0.6_install_dir 是 Jazz Team Server 4.0.6 的安装位置。

重要事项:作为 dm_upgrade.xxx 脚本中步骤 0 的一部分,将对源安装执行命令“repotools-dm -version”。在 Design Management 4.0 中,由于存在未解决的依赖性,因此将不会运行 repotools-dm 命令。在运行 dm_upgrade.xx 脚本前,您必须编辑文件 DM4.0_InstallDir/server/repotools-dm.xx 并注释掉定义属性 "-Dcom.ibm.team.repotools.rcp.allowInvalidBundles=true" 的行。如果 dm_upgrade 脚本的步骤 0 因为无法确定源安装的版本而失败,请修正 4.0 repotools-dm.xxx 文件并再次运行 upgrade/dm/dm_upgrade.xx 脚本,从步骤 0 开始。

要升级 Design Management 应用程序,请打开命令 shell,转至 DM_4.0.6_install_dir/server 目录,并输入以下命令:

upgrade/dm/dm_upgrade.sh -oldApplicationHome RTC_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dirDM_4.0.3_install_dirDM_<previous_version>_install_dir/server/conf

upgrade/ccm/ccm_upgrade.sh -oldApplicationHome RTC_3.0_install_dirCCM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dirDM_4.0.3_install_dirDM_<previous_version>_install_dir/server/conf -ignoreJTSVersionCheck

升级期间,在配置文件合并之后,将打开一个编辑器,您可以在其中检查 Design Management teamserver.properties 文件。如果该位置是绝对路径,请确保此目录是稳定目录,并且不会在应用程序卸载后被删除。绝对稳定位置应类似于以下示例:com.ibm.team.fulltext.indexLocation=DM_4.0.4_install_dir/server/conf/dm/indices/workitemindex,其中 DM_<previous_version>_install_dir 是 Design Management 4.0.6 应用程序的安装位置。

要升级“配置管理”应用程序,请打开命令 shell,转至 VVC_4.0.6_install_dir/server 目录,并输入以下命令:

upgrade/vvc/vvc_upgrade.sh -oldApplicationHome VVC_3.0.1.x_install_dirVVC_4.0.0.x_install_dirVVC_4.0.1_install_dirVVC_4.0.2_install_dirVVC_4.0.3_install_dirVVC_<previous_version>_install_dirVVC_<previous_version>_install_dir/server/conf

upgrade/vvc/vvc_upgrade.sh -oldApplicationHome VVC_3.0.1.x_install_dirVVC_4.0.0.x_install_dirVVC_4.0.1_install_dirVVC_4.0.2_install_dirVVC_4.0.3_install_dirVVC_<previous_version>_install_dirVVC_<previous_version>_install_dir/server/conf -ignoreJTSVersionCheck

要升级 Jazz Team Server,请使用管理特权打开命令提示符,转至 TS_4.0.6_install_dir\server 目录,并输入以下命令:

upgrade\jts\jts_upgrade.bat -oldJTSHome RTC_3.0_install_dirJTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dirJTS_4.0.3_install_dirJTS_<previous_version>_install_dir\server\conf -updateTomcatFiles no

upgrade\jts\jts_upgrade.bat -oldJTSHome RTC_3.0_install_dirJTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dirJTS_4.0.3_install_dirJTS_<previous_version>_install_dir\server\conf -updateTomcatFiles no

升级期间,在配置文件合并之后,将打开一个窗口,您可以在其中检查 Jazz Team Server teamserver.properties 文件。如果此文件中 com.ibm.team.fulltext.indexlocation 属性的位置是相对路径,那么您必须将其变更为绝对路径,并确保该特定目录是稳定目录,而且不会在应用程序卸载后被删除。old_install_dir 是不稳定目录的一个示例,可能会卸载该目录,因而您将丢失索引文件。绝对稳定位置应类似于以下示例:com.ibm.team.fulltext.indexLocation=JTS_4.0.6_install_dir/server/conf/jts/indices/workitemindex,其中 JTS_4.0.6_install_dir 是 Jazz Team Server 4.0.6 的安装位置。

重要事项:作为 dm_upgrade.xxx 脚本中步骤 0 的一部分,将对源安装执行命令“repotools-dm -version”。在 Design Management 4.0 中,由于存在未解决的依赖性,因此将不会运行 repotools-dm 命令。在运行 dm_upgrade.xx 脚本前,您必须编辑文件 DM4.0_InstallDir/server/repotools-dm.xx 并注释掉定义属性 "-Dcom.ibm.team.repotools.rcp.allowInvalidBundles=true" 的行。如果 dm_upgrade 脚本的步骤 0 因为无法确定源安装的版本而失败,请修正 4.0 repotools-dm.xxx 文件并再次运行 upgrade/dm/dm_upgrade.xx 脚本,从步骤 0 开始。

要升级 Design Management 应用程序,请使用管理特权打开命令提示符,转至 DM_4.0.6_install_dir\server 目录,并输入以下命令:

upgrade\dm\dm_upgrade.bat -oldApplicationHome RTC_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dirDM_4.0.3_install_dirDM_<previous_version>_install_dir\server\conf -updateTomcatFiles no

upgrade\dm\dm_upgrade.bat -oldApplicationHome RTC_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dirDM_4.0.3_install_dirDM_<previous_version>_install_dir\server\conf -ignoreJTSVersionCheck -updateTomcatFiles no

升级期间,在配置文件合并之后,将打开一个窗口,您可以在其中验证 Design Management 应用程序 teamserver.properties 文件。如果此文件中 com.ibm.team.fulltext.indexlocation 属性的位置是相对路径,那么您必须将其变更为绝对路径,并确保该特定目录是稳定目录,而且不会在应用程序卸载后被删除。old_install_dir 是不稳定目录的一个示例,可能会卸载该目录,因而您将丢失索引文件。绝对稳定位置应类似于以下示例:com.ibm.team.fulltext.indexLocation=DM_4.0.6_install_dir/server/conf/dm/indices/workitemindex,其中 DM_4.0.6_install_dir 是 Design Management 4.0.6 应用程序的安装位置。

要升级“配置管理”应用程序,请使用管理特权打开命令提示符,转至 VVC_4.0.6_install_dir\server 目录,并运行以下命令:

upgrade\vvc\vvc_upgrade.bat -oldApplicationHome VVC_3.0.1.x_install_dirVVC_4.0.0.x_install_dirVVC_4.0.1_install_dirVVC_4.0.2_install_dirVVC_4.0.3_install_dirVVC_<previous_version>_install_dir\server\conf -updateTomcatFiles no

upgrade\vvc\vvc_upgrade.bat -oldApplicationHome VVC_3.0.1.x_install_dirVVC_4.0.0.x_install_dirVVC_4.0.1_install_dirVVC_4.0.2_install_dirVVC_4.0.3_install_dirVVC_<previous_version>_install_dir\server\conf -ignoreJTSVersionCheck -updateTomcatFiles no

要升级 Jazz Team Server,请打开命令 shell,转至 JTS_4.0.4_install_dir/server 目录,并输入以下命令:

upgrade/jts/jts_upgrade.sh -oldJTSHome RTC_3.0_install_dirJTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dirJTS_4.0.3_install_dirJTS_<previous_version>_install_dir/server/conf -updateTomcatFiles no

upgrade/jts/jts_upgrade.sh -oldJTSHome RTC_3.0_install_dirJTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dirJTS_4.0.3_install_dirJTS_<previous_version>_install_dir/server/conf -updateTomcatFiles no

升级期间,在配置文件合并之后,将打开一个编辑器,您可以在其中检查 Jazz Team Server teamserver.properties 文件。如果此文件中 com.ibm.team.fulltext.indexlocation 属性的位置是相对路径,那么您必须将其变更为绝对路径,并确保该特定目录是稳定目录,而且不会在应用程序卸载后被删除。old_install_dir 是不稳定目录的一个示例,可能会卸载该目录,因而您将丢失索引文件。绝对稳定位置应类似于以下示例:com.ibm.team.fulltext.indexLocation=JTS_4.0.6_install_dir/server/conf/jts/indices/workitemindex,其中 JTS_4.0.6_install_dir 是 Jazz Team Server 4.0.6 的安装位置。

重要事项:作为 dm_upgrade.xxx 脚本中步骤 0 的一部分,将对源安装执行命令“repotools-dm -version”。在 Design Management 4.0 中,由于存在未解决的依赖性,因此将不会运行 repotools-dm 命令。在运行 dm_upgrade.xx 脚本前,您必须编辑文件 DM4.0_InstallDir/server/repotools-dm.xx 并注释掉定义属性 "-Dcom.ibm.team.repotools.rcp.allowInvalidBundles=true" 的行。如果 dm_upgrade 脚本的步骤 0 因为无法确定源安装的版本而失败,请修正 4.0 repotools-dm.xxx 文件并再次运行 upgrade/dm/dm_upgrade.xx 脚本,从步骤 0 开始。

要升级 Design Management 应用程序,请打开命令 shell,转至 DM_4.0.6_install_dir/server 目录,并输入以下命令:

upgrade/dm/dm_upgrade.sh -oldApplicationHome RTC_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dirDM_4.0.3_install_dirDM_<previous_version>_install_dir/server/conf -updateTomcatFiles no

upgrade/dm/dm_upgrade.sh -oldApplicationHome RTC_3.0_install_dirCCM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dirDM_4.0.3_install_dirDM_<previous_version>_install_dir/server/conf -ignoreJTSVersionCheck -updateTomcatFiles no

要升级“配置管理”应用程序,请打开命令 shell,转至 VVC_4.0.6_install_dir/server 目录,并输入以下命令:

upgrade/vvc/vvc_upgrade.sh -oldApplicationHome VVC_3.0.1.x_install_dirVVC_4.0.0.x_install_dirVVC_4.0.1_install_dirVVC_4.0.2_install_dirVVC_4.0.3_install_dirVVC_<previous_version>_install_dir/server/conf -updateTomcatFiles no

upgrade/vvc/vvc_upgrade.sh -oldApplicationHome VVC_3.0.1.x_install_dirVVC_4.0.0.x_install_dirVVC_4.0.1_install_dirVVC_4.0.2_install_dirVVC_4.0.3_install_dirVVC_<previous_version>_install_dir/server/conf -ignoreJTSVersionCheck -updateTomcatFiles no

在 IBM i 上运行升级脚本

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

    upgrade/jts/jts_upgrade.sh -oldJTSHome /QIBM/UserData/RTC_3.0_install_dirJTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dirJTS_4.0.3_install_dirJTS_<previous_version>_install_dir/server/conf

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

    upgrade/ccm/ccm_upgrade.sh -oldApplicationHome /QIBM/UserData/RTC_3.0_install_dirCCM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dirDM_4.0.3_install_dirDM_<previous_version>_install_dir/server/conf

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

    upgrade/qm/qm_upgrade.sh -oldApplicationHome /QIBM/UserData/QM_3.0.1.x_install_dirQM_4.0.0.x_install_dirQM_4.0.1_install_dirQM_4.0.2_install_dir/server/conf

  6. 输入以下命令以升级“配置管理”应用程序:

    upgrade/vvc/vvc_upgrade.sh -oldApplicationHome /QIBM/UserData/RM_3.0.1.x_install_dirVVC_4.0.0.x_install_dirVVC_4.0.1_install_dirVVC_4.0.2_install_dirVVC_4.0.3_install_dirVVC_<previous_version>_install_dir/server/conf

  7. 运行下一个命令以更新旧版本的 WebSphere Application Server 并部署 CLM V4.0.6 应用程序的 .war 文件。此命令还将执行备份、更新 JVM 设置、更新环境变量设置、删除临时目录以及重新启动服务器。

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

    其中:

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

复制索引文件

注意:仅当 teamserver.properties 文件中的索引文件位于不稳定目录的相对路径或绝对路径中时,才执行这些步骤。不稳定目录的示例为 old_install_dir。如果索引文件位于此目录中,但已卸载此目录,那么您将丢失索引文件。

将 JFS/text 索引从先前的安装目录复制到 4.0.3。对于分布式系统,请转至适当的服务器并复制这些文件。

  1. 打开命令提示符并输入以下命令以清除缺省 V4.0.3 索引目录:
  2. Del /s /f JTS_4.0.3_install_dir\server\conf\jts\indices
    Del /s /f DM_4.0.3_install_dir\server\conf\dm\indices
    Del /s /f VVC_4.0.3_install_dir\server\conf\vvc\indices
    rm -rf JTS_4.0.3_install_dir/server/conf/jts/indices
    rm -rf DM_4.0.3_install_dir/server/conf/dm/indices
    rm -rf VVC_4.0.3_install_dir/server/conf/vvc/indices
  3. 打开命令提示符并输入以下命令来将索引从先前安装复制到 V4.0.3:
  4. copy RTC_3.0_install_dirJTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dir\server\conf\jts\indices JTS_4.0.3_install_dir\server\conf\jts\indices
    copy RTC_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dir\server\conf\dm\indices DM_4.0.3_install_dir\server\conf\dm\indices
    copy QM_3.0.1.x_install_dirVVC_4.0.0.x_install_dirVVC_4.0.1_install_dirVVC_4.0.2_install_dir\server\conf\qm\indices VVC_4.0.3_install_dir\server\conf\vvc\indices
    cp -R RTC_3.0_install_dirJTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dir/server/conf/jts/indices JTS_4.0.3_install_dir/server/conf/jts/indices
    cp -R RTC_3.0_install_dirCCM_3.0.1.x_install_dirCCM_4.0.0.x_install_dirCCM_4.0.1_install_dirCCM_4.0.2_install_dir/server/conf/ccm/indices CCM_4.0.3_install_dir/server/conf/ccm/indices
    cp -R QM_3.0.1.x_install_dirQM_4.0.0.x_install_dirQM_4.0.1_install_dirQM_4.0.2_install_dir/server/conf/qm/indices QM_4.0.3_install_dir/server/conf/qm/indices

要将 JFS/text 索引从先前安装复制到 V4.0.3,请遵循下列步骤。对于分布式系统,请转至适合的服务器并复制这些文件。

  1. 打开命令提示符并输入以下命令以清除缺省 V4.0.3 索引目录:
  2. Del /s /f JTS_4.0.3_install_dir\server\conf\jts\indices
    Del /s /f DM_4.0.3_install_dir\server\conf\dm\indices
    Del /s /f VVC_4.0.3_install_dir\server\conf\vvc\indices
    rm -rf JTS_4.0.3_install_dir/server/conf/jts/indices
    rm -rf DM_4.0.3_install_dir/server/conf/dm/indices
    rm -rf VVC_4.0.3_install_dir/server/conf/vvc/indices
  3. 打开每个应用程序的 teamserver.properties 文件,并搜索 com.ibm.team.fulltext.indexlocation
  4. 如果属性 com.ibm.team.fulltext.indexlocation 指向相对路径(例如,com.ibm.team.fulltext.indexLocation=conf/dm/indices/workitemindex),那么索引将位于相对于托管应用程序的 WebSphere Application Server 概要文件的位置。例如:WAS_install_dir/AppServer/profiles/Appsrv01

    在 Design Management 4.0.3 应用程序的 teamserver.properties 文件中,将此相对路径更改为指向稳定位置的绝对路径。绝对稳定位置的示例类似于以下内容:com.ibm.team.fulltext.indexLocation=4.0.3_install_dir/server/conf/dm/indices/workitemindex,其中 4.0.3_install_dir 是 Design Management 4.0.3 应用程序的安装位置。

    打开命令提示符并输入以下命令来将完整文本索引从先前版本复制到 4.0.3:

  5. copy WAS_profile_dir\conf\jts\indices JTS_4.0.3_install_dir\server\conf\jts\indices
    copy WAS_profile_dir\conf\dm\indices DM_4.0.3_install_dir\server\confdm\indices
    copy WAS_profile_dir\conf\vvc\indices VVC_4.0.3_install_dir\server\conf\vvc\indices
    cp -R WAS_profile_dir/conf/jts/indices JTS_4.0.3_install_dir/server/conf/jts/indices
    cp -R WAS_profile_dir/conf/dm/indices DM_4.0.3_install_dir/server/conf/dm/indices
    cp -R WAS_profile_dir/conf/vvc/indices VVC_4.0.3_install_dir/server/conf/vvc/indices
  6. 如果 com.ibm.team.fulltext.indexlocation 属性指向不稳定的绝对路径(例如,指向可能被卸载和删除的 old_install_dir 目录的路径),请将其变更为指向稳定位置的绝对路径。

    绝对稳定位置的示例类似于以下内容:com.ibm.team.fulltext.indexLocation=4.0.3_install_dir/server/conf/dm/indices/workitemindex,其中 4.0.3_install_dir 是 Design Management V4.0.3 应用程序的安装位置。

    打开命令提示符并输入以下命令来将完整文本索引从先前安装复制到 4.0.3:

  7. copy RTC_3.0_install_dirJTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dir\server\conf\jts\indices JTS_4.0.3_install_dir\server\conf\jts\indices
    copy RTC_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dir\server\conf\dm\indices DM_4.0.3_install_dir\server\conf\dm\indices
    copy QM_3.0.1.x_install_dirVVC_4.0.0.x_install_dirVVC_4.0.1_install_dirVVC_4.0.2_install_dir\server\conf\vvc\indices VVC_4.0.3_install_dir\server\conf\vvc\indices
    cp -R RTC_3.0_install_dirJTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dir/server/conf/jts/indices JTS_4.0.3_install_dir/server/conf/jts/indices
    cp -R RTC_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dir/server/conf/dm/indices DM_4.0.3_install_dir/server/conf/dm/indices
    cp -R QM_3.0.1.x_install_dirVVC_4.0.0.x_install_dirVVC_4.0.1_install_dirVVC_4.0.2_install_dir/server/conf/vvc/indices VVC_4.0.3_install_dir/server/conf/vvc/indices
  8. 打开命令提示符并输入以下命令来将 JFS 索引从先前版本复制到 V4.0.3:
  9. copy RTC_3.0_install_dirJTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dir\server\conf\jts\indices JTS_4.0.3_install_dir\server\conf\jts\indices
    copy RTC_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dir\server\conf\dm\indices DM_4.0.3_install_dir\server\conf\dm\indices
    copy QM_3.0.1.x_install_dirVVC_4.0.0.x_install_dirVVC_4.0.1_install_dirVVC_4.0.2_install_dir\server\conf\vvc\indices VVC_4.0.3_install_dir\server\conf\vvc\indices
    cp -R RTC_3.0_install_dirJTS_3.0.1.x_install_dirJTS_4.0.0.x_install_dirJTS_4.0.1_install_dirJTS_4.0.2_install_dir/server/conf/jts/indices JTS_4.0.3_install_dir/server/conf/jts/indices
    cp -R RTC_3.0_install_dirDM_3.0.1.x_install_dirDM_4.0.0.x_install_dirDM_4.0.1_install_dirDM_4.0.2_install_dir/server/conf/dm/indices DM_4.0.3_install_dir/server/conf/dm/indices
    cp -R VVC_3.0.1.x_install_dirVVC_4.0.0.x_install_dirVVC_4.0.1_install_dirVVC_4.0.2_install_dir/server/conf/vvc/indices VVC_4.0.3_install_dir/server/conf/vvc/indices

启动 WebSphere Application Server

在分布式拓扑中,必须在托管以下部件的应用程序服务器上完成后续步骤:

  • Jazz Team Server
  • Design Management 应用程序
  • “质量管理”应用程序
  • “配置管理”应用程序
  • 向 Jazz Team Server 注册的任意应用程序

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

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

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

将 V4.0.3 WAR 文件部署在 WebSphere Application Server 中

在分布式拓扑中,必须在托管以下部件的应用程序服务器上完成后续步骤:

  • Jazz Team Server
  • Design Management 应用程序
  • “质量管理”应用程序
  • “配置管理”应用程序

WAR 文件位置:如果您使用了 Installation Manager 来安装 Rational Design Management,并且在安装期间已取消选中 Tomcat 7 应用程序服务器的复选框,那么缺省情况下会将 WAR 文件复制到 4.0.3_install_dir/server/webapps 目录中。如果选择了 Tomcat 7 应用程序服务器,那么已将 WAR 文件复制到 4.0.3_install_dir/server/tomcat/webapps 目录中。

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

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

重要事项:如果您在不支持转换器的环境(例如 AIX 或 Solaris)中工作,那么必须在专用转换器上安装 4.0.3 版本的 converter.war。有关详细信息,请参阅 Requirements Management Converter Application Configuration and Troubleshooting Guide

禁用集群

确保仅启动了节点 1(安装了 CLM 4.0.6 应用程序的节点),并且所有其他节点都处于停止状态。有关如何禁用集群的指示信息,请参阅禁用集群

启动应用程序

在“企业应用程序”页面上启动下列应用程序:

在分布式拓扑中,必须在托管以下部件的应用程序服务器上完成后续步骤:

  • Jazz Team Server
  • Design Management 应用程序
  • “质量管理”应用程序
  • “配置管理”应用程序

登录集成解决方案控制台,并启动下列应用程序:

  • jts_war
  • dm_war
  • rdmhelp_war
  • rsadm_war
  • qm_war
  • vvc_war
  • vvchelp_war
  • admin_war
  • clmhelp_war

启动服务器

在分布式拓扑中,必须在托管以下部件的应用程序服务器上完成后续步骤:

  • Jazz Team Server
  • Design Management 应用程序
  • “质量管理”应用程序
  • “配置管理”应用程序
  • 向 Jazz Team Server 注册的任意应用程序

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

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

启动所有 V4.0.6 应用程序服务器:

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

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

迁移“配置管理”应用程序和 Design Management 应用程序

升级“配置管理”应用程序时,必须确保已启动 Jazz Team Server(包括向 Jazz Team Server 注册的所有应用程序)和“配置管理”应用程序服务器。

如果您还要升级 Requirements Management 应用程序,那么在尝试运行以下 repotools-vvc 迁移命令之前,必须执行联机 RM 迁移步骤。

请确保存在具有以下内容的凭证:

  1. adminUserId
  2. adminPassword
  3. repositoryURL
  4. smartCard
  5. certificateFile

以下是一个示例

  1. 打开命令提示符,并切换到 VVC_4.0.6_install_dir\server 目录,具体取决于安装的应用程序。
  2. 输入以下命令:
  3. ./repotools-vvc.sh -migration_vvc_updateResourcesCommand credentialsFile=credentials.txt

  1. 打开命令提示符,并切换到“配置管理”安装目录 VVC_4.0.6_install_dir\server
  2. 输入以下命令:
  3. repotools-vvc.bat -migration_vvc_updateResourcesCommand credentialsFile=credentials.txt

对于 WebSphere,请使用 WAS 管理控制台来验证是否已映射 jts_war 应用程序的安全角色。

VVC repotools 迁移命令向正在运行的 VVC 应用程序发送请求并等待响应。如果此 repotools-vvc 命令立即停止并发生授权错误,请验证服务器是否正在运行,并验证凭证文件中的用户标识和密码是否正确。

VVC repotools 迁移命令完成后,必须为 Design Management 运行另一迁移命令。DM repotools 命令也需要 credentials.txt 文件和运行 VVC repotools 命令所使用类似的属性,仅 repositoryURL 属性将不同。您可以修改上述 credentials.txt 文件或为 DM 新建一个。对于以上两种情况,均需要使用 DM 根上下文将 repository URL 属性定义为以下值: repositoryURL=https://yourserver.com:9443/dm

请确保存在具有以下内容的凭证:

  1. adminUserId
  2. adminPassword
  3. repositoryURL
  4. smartCard
  5. certificateFile

以下是一个示例

  1. 打开命令提示符,并切换到 DM_4.0.6_install_dir\server 目录,具体取决于安装的应用程序。
  2. 输入以下命令:
  3. ./repotools-dm.sh -migration_dm_runUpgradeManager credentialsFile=credentials.txt

  1. 打开命令提示符,并切换到 DM_4.0.6_install_dir\server 目录,具体取决于安装的应用程序。
  2. 输入以下命令:
  3. repotools-dm.bat -migration_dm_runUpgradeManager credentialsFile=credentials.txt

此命令将指示 DM Upgrade Manager 执行每个升级步骤。将会在每一个升级步骤开始和结束时显示最终状态信息:完成、不需要或失败。如果升级步骤失败,那么您必须检查 dm.log 文件以确定导致失败的原因。如果问题可以修复,再次运行 DM repotools 迁移命令即可。此命令可多次运行。当连续运行此命令时,会将上次完成的升级步骤显示为不需要。对于需要很长时间的升级步骤,例如重新建立索引,repotools 命令会每 5 分组显示一条消息以指示升级管理器仍在工作。

升级步骤“Migrate Shadow Index Resources”需要读取、修改和写入每个 DM 模型资源。 此资源迁移会执行批量读取和写入,其缺省设置为每次读/写 200 个资源。在此影子索引资源迁移期间,可能会出现内存不足错误。 如果出现此错误,您必须关闭服务器并通过定义新的 JVM 系统属性 -Dcom.ibm.xtools.rmps.IndexResourceMigrator.bulkSize=10 来减少批处理大小。

对于 Tomcat 应用程序服务器,请修改 server/server.startup 脚本文件中的 JAVA_OPTS 变量。
对于 WebSphere Application Server,请添加另一名为 com.ibm.xtools.rmps.IndexResourceMigrator.bulkSize 的 JVM 定制属性,将其值设置为 10。 与 JAZZ_HOME 一样,此定制属性可使用 WebSphere Administrator 控制台来定义。

在定义此新的 JVM 属性之后,重新启动应用程序服务器并重新运行 DM repotools 迁移命令。 将会跳过先前已完成的步骤,并且影子索引资源的迁移会从其上次中断的地方继续迁移。

在 Design Management for Rational Software Architect 中,如果安装了新的 RSA-DM 域扩展应用程序,那么必须将其注册到 Design Management。其中一个升级步骤会查找在同一应用程序服务器上运行的应用程序,并注册找到的应用程序。 如果域扩展应用程序在另一应用程序服务器上运行,那么将需要手动对 DM 注册该应用程序。 要验证域扩展是否已注册或要注册域扩展,登录到 <serverURL>/dm/admin 并在菜单栏中单击域扩展服务器。 如果域服务器已注册,其会在页面中显示为已启用且已联网。 如果没有显示域服务器,请单击添加新服务器链接。URL 格式为:“https://host:port/rsadm”。 请确保检查对话框中已启用的控件。

V4.0.6 和许可证

V4.0.6 应用程序将可以使用 V4.0.x 许可证。如果指示您正在从 Rational Team Concert 3.0 进行升级,您必须获取 V4.0.3 许可证。在表单中,您已指示您正在从 CLM 3.0.1.x 进行升级。您必须获取 V4.0.3 许可证。 在表单中,您已指示您正在从 Design Management 4.0.0.x 进行升级。您无需获取 V4.0.3 的新许可证。 在表单中您已指示您正在从 Design Management 4.0.1 进行升级。您无需获取 V4.0.3 的新许可证。在表单中您已指示您正在从 Design Management 4.0.2 进行升级。您无需获取 V4.0.3 的新许可证。在表单中您已指示您正在从 Design Management 4.0.3 进行升级。您无需获取 V4.0.4 的新许可证。

如果已使用旧版本的浮动许可证、令牌许可证或授权用户单个安装许可证,请安装 V4.0.6 的对应许可证。安装 V4.0.3 许可证期间,将保留您现有的用户许可证分配。

在开始联机迁移 RM 应用程序之前,请确保为 rm_user 分配了有效的 V4.0 RM Application-Internal 许可证。有关更多信息,请参阅以下步骤:迁移“需求管理”应用程序。

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

重新部署预定义模板

旧版本中名为“基础”的项目模板在 V4.0.3 中已重命名为“测试人员的需求模板”。要在升级后继续使用此模板,您必须更新生命周期项目模板。 有关详细信息,请参阅根据模板创建生命周期项目

启用集群

要启用集群,请关闭节点 1 上的集群成员和应用程序服务器。有关详细的指示信息,请参阅重新启用集群

配置数据仓库

如果您未在先前的安装中配置数据仓库,但要为 V4.0.6 配置数据仓库,请遵循下列步骤:

  1. 创建要用作数据仓库的数据库。有关更多信息,请参阅设置数据库
  2. 运行设置向导,跳至配置数据仓库步骤,并配置数据仓库。有关更多信息,请参阅 在已配置 Jazz Team Server 后配置或变更数据仓库

    注:您不必运行设置向导即可设置 V4.0.3 服务器。只有您未在先前安装中配置数据仓库,但现在要进行配置时,才需要设置向导。

验证核对表

完成升级过程后,请使用此核对表确定是否每个步骤都已成功。

  验证任务 更多信息
请验证是否已将下列应用程序配置文件从先前安装复制到 V4.0.6 中:
  • 对于 Jazz Team Server:JTS_4.0.6_install_dir/server/conf/jts/teamserver.properties
  • 对于“生命周期项目管理”应用程序:JTS_4.0.6_install_dir/server/conf/admin/admin.properties
  • 对于“生命周期项目管理”应用程序:JTS_4.0.6_install_dir/server/conf/admin/friends.rdf
  • 对于 Design Management 应用程序:DM_4.0.6_install_dir/server/conf/dm/teamserver.properties
 
验证是否每个 teamserver.properties 文件都包含以下信息:
  • 从先前版本的 teamserver.properties 中复制的属性
  • com.ibm.team.repository.server.webapp.url 属性包含有效且相异的公用 URL。V4.0.6 应用程序的 URL 必须与旧版本中使用的 URL 相同。
  • 有效的数据库供应商条目。确保 /conf/jts/teamserver.properties 文件中指定的数据库存在。
 
验证应用程序服务器:
  • 验证 4.0.6_install_dir/server/tomcat/conf/tomcat-users.xml 是否包含旧版本中的信息。
  • 如果您使用 LDAP 注册表或者已禁用 HTTPS 或 FORM 认证,请验证以下信息:
    • 4.0.6_install_dir/server/tomcat/conf/server.xml 文件是否包含以下代码片段:

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

    • 4.0.6_install_dir/server/tomcat/conf/server.xml 文件是否不包含以下代码片段:

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

  • 如果在 RTC_3.0_install_dir3.0.1.x_install_dir4.0.0.x_install_dir4.0.1_install_dir4.0.2_install_dir4.0.3_install_dir<previous_version>_install_dir/server/tomcat/conf/server.xml 文件中已具有其他定制设置,请验证是否已将这些设置复制到 4.0.6_install_dir/server/tomcat/conf/server.xml 文件中。
  • 请确认 web.xml 文件具有正确的 <security-role> 标记:
    • 对于 Jazz Team Server:4.0.6_install_dir/server/tomcat/webapps/jts/WEB-INF/web.xml
    • 对于“变更和配置管理”应用程序:4.0.6_install_dir/server/tomcat/webapps/ccm/WEB-INF/web.xml
    • 对于“质量管理”应用程序:4.0.6_install_dir/server/tomcat/webapps/qm/WEB-INF/web.xml
  • 请确保已部署并启动下列应用程序:
    • jts_war
    • dm_war
    • rdmhelp_war
    • rsadm_war
    • vvc_war
    • vvchelp_war
    • admin_war
    • clmhelp_war
部署和启动服务器
检查服务器日志文件:检查下列服务器日志文件以验证它们是否包含升级后信息:
  • 如果您正在使用 Tomcat 服务器,那么日志文件位于 4.0.6_install_dir/server/logs 目录中。
  • 如果您使用 WebSphere Application Server,那么日志文件位于 WAS_install_dir/profiles/AppSrv01/logs 目录中。
 
检查公用 URL:如果您已升级 Jazz Team Server、DM 或 VVC 应用程序,请确保该应用程序的“状态摘要”页面上的公用 URL 与先前版本中使用的 URL 相同。  
检查 Jazz Team Server“管理”页面中的链接:在 Web 浏览器中,转至 Jazz Team Server 的“管理”页面 https://hostname.example.com:9443/jts/admin,并确保未显示任何错误。 Jazz Team Server 管理 Web 界面
检查应用程序的“管理”页面中的链接:在 Web 浏览器中,转至应用程序的“管理”页面 https://hostname.example.com:9443/application context root/admin,并确保未显示任何错误。 应用程序管理 Web 界面
在每台服务器上运行诊断并验证诊断是否已成功地完成:
  • 打开浏览器并登录到管理页面(例如,https://host.example.com:9443/jts/admin)
  • 单击诊断链接。
 
检查用户、许可证和链接工件
  • 检查用户和许可证
  • 检查已链接的工件
  • 检查 Web 客户机
  • 使用搜索检查建立索引
  • 检查 Rational Team Concert Eclipse 客户机或 Visual Studio 客户机
验证用户、许可证和链接工件
检查应用程序工件
  • 检查是否已列示并可浏览所有项目
  • 检查是否所有仪表板都可用以及 viewlet 是否正在工作
  • 找到并查看现有工件,然后验证编辑器是否正确打开
  • 在 Design Management 应用程序中,请验证文件夹、域元素、图形元素和 RSA-domain 元素。
  • 在“配置管理”应用程序中,请验证工作空间、快照和变更集。
 
运行数据收集作业
  • 打开浏览器并登录“管理”页面。此页面的 URL 类似于以下示例:https://host.example.com:9443/jts/admin。
  • 在“报告”页面上,单击数据收集作业
  • 单击对所有应用程序运行所有数据仓库收集作业
  • 等待数据收集作业完成并验证 ETL 是否已完成且没有错误。要监视每个数据收集作业的状态,您必须访问适当的应用程序 URL。有关数据收集作业的更多信息,请参阅“运行数据收集作业”。
运行数据收集作业

与其他产品进行集成

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 Developer for System z 的指示信息,请参阅升级 Rational Developer for System z 集成


Rational ClearQuest

Rational Team Concert 提供了多个工具来帮助您将工作与 Rational ClearQuest 集成。Rational ClearQuest 同步器、Rational ClearQuest 网桥和 Rational ClearQuest 导入器。有关更多信息,请参阅 Rational Team Concert 和 Rational ClearQuest

您可以使用 ClearQuest 同步器(以前称为 Connector)将 Rational Quality Manager 与 Rational ClearQuest 缺陷跟踪系统进行集成。有关更多信息,请参阅 Rational Quality Manager 和 Rational ClearQuest

您可以将 Rational Requirements Composer 与 Rational ClearQuest 进行集成并且配置这两个应用程序,以使需求与缺陷、任务、改进请求和其他记录类型相关联。有关更多信息,请参阅 Rational Requirements Composer 和 Rational ClearQuest

有关升级 ClearQuest 同步器的指示信息,请参阅升级 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

您可以将 IBM Rational Software Architect Design Manager 与 Rational solution for Collaborative Lifecycle Management (CLM) 中的“需求管理”(RM) 应用程序和“变更和配置管理”(CCM) 应用程序进行集成。可以通过进行此集成将设计模型和模型资源与需求、与需求相关的工件、工作项和其他开发工件联系起来。有关更多信息,请参阅 Rational Requirements Composer 和 Rational Software Architect Design Manager