本主题描述将 Jazz Team Server 以及“更改和配置管理”从 V3.0 升级到 V3.0.1 所需完成的步骤。
准备工作
在升级服务器之前,请确保您有 Rational Team Concert 和 Jazz Team Server V3.0 存储库数据库的最新有效备份。
并且,请确保所有机器上的时钟都已使用网络时间协议 (NTP) 进行同步。时间是关键元素,它使一个网络节点上的事件能够映射至另一个网络节点上的相应事件。如果要避免问题,可通过 NTP 服务的企业部署来解决这些问题。有关 NTP 的更多信息,请访问 http://www.ntp.org/。另外,所有服务器必须对其用户使用相同的认证方法。
如果您计划升级多款产品,请参阅升级顺序以帮助您确定首先升级的产品。
要点: 要在“更改和配置管理”应用程序与 Jazz Team Server
分开安装的分布式环境中使用升级脚本,升级脚本必须能够访问 Jazz Team Server
所安装在的驱动器或文件系统。例如,在 Windows 上,映射格式必须为
<mapped drive letter>:\server\conf。绝对路径
(\\<machine name>\<installdir>server\conf)
无效。安装的驱动器必须配置为,将“读/写/执行”特权授予管理员帐户。
如果您使用 Derby 数据库,请将 JTS 和 CCM 数据库从 3.0 复制到 3.0.1。有关更多信息,请参阅
备份和恢复 Derby 数据库。
注: 如果要使用同一个数据库,那么不必进行数据迁移。但是,如果要在升级期间切换数据库,那么必须从先前数据库中导出数据并将其导入到新数据库中。
升级 Jazz Team Server (JTS)
- 根据需要,查看有关计划部署和升级的部分中的主题。
- 关闭 JTS 3.0 服务器。
- 如果尚未安装 Jazz Team Server 作为 CLM 安装的组成部分,请先将 Jazz Team Server
安装到磁盘上的新位置。如果已安装 Jazz Team Server 且升级到 V3.0.1,并且想安装并升级“更改和配置管理”应用程序,请转到升级“更改和配置管理”(CCM)。
- 在安装期间,请选择使用缺省 3.x 应用程序上下文根。
- 安装结束时,请为您要启动哪个程序选择无。
- 浏览到 <3.0.1JTS_install_dir>/server 并运行下列命令:
注: 可以通过在命令行中指定所有参数来运行脚本。另外,如果您要反复运行升级脚本,那么还可以编辑此脚本的参数文件并运行缩略的命令行。有关参数文件的指示信息,请参阅下一个可选步骤。
要点: 虽然此脚本文件在 upgrade 目录下,但它必须从 server 目录中运行。并且,如果路径包含空格,请确保将其括在双引号中。
Windows
upgrade\jts_upgrade.bat -oldJTSHome <3.0JTS_install_dir>\server\conf
UNIX
upgrade/jts_upgrade.sh -oldJTSHome <3.0JTS_install_dir>/server/conf
如果您需要更多有关命令行选项的详细信息,请参阅jts_upgrade。
- 可选:作为对上一步骤的替代,您可以打开脚本的参数文件,修改缺省值,然后运行命令行的简略格式。
jts_params 文件的英语版本和翻译版本都在
<3.0.1JTS_install_dir>/server/upgrade/params
目录中。
- 要了解您所采用的语言的参数文件的准确名称,请从
<3.0.1JTS_install_dir>\server\upgrade
目录中运行 locale.bat -jts -showParamFileName 命令(对于
Windows)或 locale.sh -jts -showParamFileName 命令(对于
UNIX 系统)。
- 打开 jts_params 或者它的翻译版本,以便编辑和指定各个参数的值。其中一个必须设置的参数是 OLD_JTS_HOME 目录的路径。
- 如果是使用 Apache Tomcat,请参阅设置 Apache Tomcat。
- 如果是使用 WebSphere Application Server,请卸载先前安装的 Web 应用程序并重新部署
V3.0.1 安装版本随附的 jts.war 和
clmhelp.war。有关进一步的详细信息,请参阅设置 WebSphere Application Server 以进行 V3 升级。
- 启动 JTS 服务器。
- 接着,运行设置向导以配置服务器。
升级“更改和配置管理”(CCM)
- 根据需要,查看有关计划部署和升级的部分中的主题。
- 关闭 CCM 3.0 服务器。
- 将 CCM 应用程序安装到磁盘上的新位置。
- 在安装期间,请选择使用缺省 3.x 应用程序上下文根。
要点: 如果 Rational Team Concert V3.0 是先前从 V2 升级而来,请选中使用 Rational Team Concert 2.x 上下文根以保留 /jazz 上下文根。
- 安装结束时,请为您要启动哪个程序选择无。
- 浏览到 <3.0.1CCM_install_dir>/server 并运行下列命令:
注: 可以通过在命令行中指定所有参数来运行脚本。另外,如果您要反复运行升级脚本,那么还可以编辑此脚本的参数文件并运行缩略的命令行。有关参数文件的指示信息,请参阅下一个可选步骤。
要点: 虽然此脚本文件在 upgrade 目录下,但它必须从 server 目录中运行。并且,如果路径包含空格,请确保将其括在双引号中。另外,请确保提供
applicationContextRoot 参数并将其设置为 ccm。缺省情况下,applicationContextRoot 是 jazz。
Windows
upgrade\ccm_upgrade.bat -oldApplicationHome <3.0CCM_install_dir>\server\conf -applicationContextRoot ccm
UNIX
upgrade/ccm_upgrade.sh -oldApplicationHome <3.0CCM_install_dir>/server/conf -applicationContextRoot ccm
如果您需要更多有关命令行选项的详细信息,请参阅ccm_upgrade。
此脚本将借助指示的用户交互完成下列任务:
- 运行 -migration_ccm_updateConfigurationFiles 命令并更新配置和 Tomcat 文件。请输入 [E] 以执行命令,输入 [S] 跳过步骤,或者按 [Enter] 键取消脚本执行。
- 在成功地合并配置文件之后,请输入 [C] 继续。这将打开一个记事本窗口(在 UNIX
系统上,将打开 vi 编辑器),您可以在此窗口中验证 CCM teamserver.properties
文件。验证 com.ibm.team.repository.server.webapp.url 属性所指定的公用 URI
根是否正确。并且,验证数据库属性是否正确。数据库位置不得与 JTS
数据库位置相同。完成后,请保存更改(如果有)并关闭编辑器以继续执行脚本。有关验证配置文件的信息,请参阅在升级期间验证配置文件。
- 继续运行脚本,直到您看到指示 CCM 升级成功的消息为止。
- 可选:作为对上一步骤的替代,您可以打开脚本的参数文件,修改缺省值,然后运行命令行的简略格式。
ccm_params 文件的英语版本和翻译版本都在
<3.0.1CCM_install_dir>/server/upgrade/params
目录中。
- 要了解您所采用的语言的参数文件的准确名称,请从
<3.0.1CCM_install_dir>\server\upgrade
目录中运行 locale.bat -ccm -showParamFileName 命令(对于
Windows)或 locale.sh -ccm -showParamFileName 命令(对于
UNIX 系统)。
- 打开 ccm_params 文件或者它的翻译版本,以便编辑和指定各个参数的值。其中一个必须设置的参数是 OLD_AAPLICATION_HOME 目录的路径。请确保此路径未包含任何空格。
- 如果是使用 Apache Tomcat,请参阅设置 Apache Tomcat。
- 如果是使用 WebSphere Application Server,请卸载先前安装的
Web 应用程序并重新部署 3.0.1 安装版本随附的
ccm.war。有关进一步的详细信息,请参阅设置 WebSphere Application Server 以进行 V3 升级。
- 启动 CCM 服务器。
- 如果正在将“更改和配置管理”添加到已建立的
Jazz Team Server,请使用管理 Web 界面。请参阅向 Jazz Team Server 注册应用程序。