本主题描述借助一个使用 Tomcat 应用程序服务器和 DB2® for z/OS® 的设置,将服务器从 Rational® Team Concert (RTC) V3.0 升级到 Rational solution for Collaborative Lifecycle Management (CLM) V4 时需要执行的步骤。
开始之前
生成 BLZSAMP 成员的副本,以便您在必要时可以复查原始文件。提交作业之后,复查样本的作业日志。预期的返回码为 0。
关于此任务
执行下列步骤会将 RTC V3.0 配置迁移到 CLM V4.0 配置。
过程
- 使用 SMP/E 安装来安装 CLM V4 程序包。V4 配置位置必须与 V3.0 配置位置不同。 安装 SMP/E 程序包将提供新的用于升级的数据库备份工具。有关详细信息,请参阅SMP/E 安装过程概述。
注: V4 的 FMID 已更改,因此,不存在用于从 V3.0 升级到 V4 的 PTF。
- 使用所提供的 DB2 for z/OS UNLOAD 实用程序和 LOAD 实用程序来备份 V3.0 存储库。 有关详细信息,请参阅使用 DB2 卸载和装入过程进行备份。您可以使用其他已经过测试和验证的工具来生成备份副本。
要点: 在继续进行升级之前,您必须生成存储库的备份副本,这是因为在升级过程中会对存储库模型进行更改,然而无法回滚这些更改。
- 要验证备份与恢复过程,请对新数据库和新模式前缀完成 UNLOAD 和 LOAD 的步骤。
- 使用 V3.0 BLZCREDB 样本作业在新数据库中创建表。
- 为了充分测试数据库备份和恢复过程,请为每个存储库再创建另外的数据库。新创建的数据库必须与现有数据库具有相同的许可权。
- 为每个数据库创建单独的 UNIX 系统服务目录 (ussWorkDir)。
- 使用字符数相同的存储库模式前缀。
- 在继续执行升级步骤之前,请确认已成功创建新的 V3.0 存储库。
- 修改并提交 V4 SBLZSAMP 样本成员 BLZCPJTS 以设置服务器配置结构和工作目录(其中包括“生命周期项目管理”应用程序),从而配置 Jazz™ Team Server (JTS)。
注: 您为 V4 创建的配置目录 (JAZZ_HOME) 和工作目录必须与 V3.0 目录不同,以便升级实用程序可以合并这两个版本。例如,V3.0 的缺省配置目录为 /etc/jazz,因此,对于 V4 使用 /etc/jazz40。同样,对于工作目录,使用 /u/jazz40。
请遵循此样本成员中的指示信息,或者请参阅为 Jazz Team Server 和 Rational solution for Collaborative Lifecycle Management 应用程序创建其他目录。
- 修改并提交 V4 SBLZSAMP 样本成员 BLZCPCCM,以使用 CCM 定义来设置新的服务器配置和工作目录结构,从而配置“变更和配置管理”(CCM) 服务器。 请遵循此样本成员中的指示信息,或者请参阅为 Jazz Team Server 和 Rational solution for Collaborative Lifecycle Management 应用程序创建其他目录。
- 创建一个称为 RIDW 的 DB2 for z/OS 新数据库,将其用作数据仓库并授予许可权。 有关详细信息,请参阅设置 DB2 for z/OS 以与 Jazz Team Server 搭配使用。
- 通过启动和停止 V4 Tomcat 服务器来部署应用程序(或者部署 ccm.war 和 jts.war 文件)。
注: 如果已经定制了 V3.0 应用程序 web.xml 文件(例如,为了支持 LDAP 注册表而进行定制),那么其余步骤会将这些定制文件迁移到 V4 应用程序并修改每个应用程序中的 web.xml 文件。但是,.war 文件已签名,因此,只能修改已部署的 .war 文件。如果在迁移之后重新部署了应用程序,那么必须再次手动定制 V3.0 文件。
- 迁移 JTS 服务器配置。使用存储库工具并通过修改 V4 SBLZSAMP 样本成员 BLZJTSU 将 V3.0 配置文件设置合并到 JTS 的 V4 配置文件中。在您提交 BLZJTSU 作业之前,请完成下列步骤:
- 替换 @pathPrefix@ 变量以指向 V4 二进制文件的路径前缀。
注: 在 V3.0.1 中就已添加此样本成员使用的存储库工具命令 migration_jts_updateConfigurationFiles。如果 @pathPrefix@ 指向先前版本,那么此存储库工具命令将不使用 V4 update 命令。
- 按照样本 BLZJTSU 作业中的指示信息完成相应的操作。
提交 BLZJTSU 作业并复查作业输出和更新后的属性文件。
注: 指向 Derby 数据仓库的数据仓库属性仍然保持为此合并操作的一部分,但是将在后续步骤中解决。
- 迁移 CCM 服务器配置。使用存储库工具并通过修改 V4 SBLZSAMP 样本成员 BLZCCMU 将 V3.0.1.x 配置文件设置合并到 CCM 的 V4 配置文件中。在您提交 BLZCCMU 作业之前,请完成下列步骤:
- 将以下行的内容: 从 applicationContextRoot=jazz 更改为 applicationContextRoot=ccm。除非 V3 服务器是从 V2.x 迁移而来,否则,应用程序上下文应为 /ccm。
- 替换 @pathPrefix@ 变量以指向 V4 二进制文件的路径前缀。
注: 在 V3 中就已添加此样本成员使用的存储库工具命令 migration_ccm_updateConfigurationFiles。如果 @pathPrefix@ 指向先前版本,那么此存储库工具命令将不使用 V4 update 命令。
- 按照样本 BLZCCMU 作业中的指示信息完成相应的操作。
提交 BLZCCMU 作业并复查作业输出和更新后的属性文件。注: 指向 Derby 数据仓库的数据仓库属性仍然保持为此合并操作的一部分,但是将在后续步骤中解决。
- 停止 RTC V3 Tomcat 服务器。
- 通过完成下列步骤来复制索引文件:
- 将 V3 中的 JFS/text 索引复制到 V4。对于分布式系统,请转至适当的服务器并复制这些文件。
- 打开命令提示符并输入以下命令以清除缺省 4.0 indices 目录:
rm -rf <4.0_configuration_dir>/jts/indices
rm -rf <4.0_configuration_dir>/ccm/indices
打开命令提示符并输入以下命令以将索引从 V3 复制到 V4:cp -R <3.0_configuration_dir>/jts/indices <4.0_configuration_dir>/jts/indices
cp -R <3.0_configuration_dir>/ccm/indices <4.0_configuration_dir>/ccm/indices
编辑 JTS 和 CCM teamserver.properties 文件以确保 com.ibm.team.fulltext.indexLocation 和 com.ibm.team.jfs.index.root.directory 具有正确的位置信息。
- 升级 JTS 数据库。使用存储库工具并通过修改和提交 V4 SBLZSAMP 样本成员 BLZADDTB 的副本将 4.0 数据库表添加至 JTS 存储库。应用程序变量 @appl@ 应设置为 jts。请遵循此样本成员附带包括的指示信息并仔细复查作业输出。
- 升级 CCM 数据库。如果您已配置 CCM 应用程序,那么使用存储库工具并通过修改和提交 V4 SBLZSAMP 样本成员 BLZADDTB 的副本将 4.0 数据库表添加至 CCM 存储库。应用程序变量 @appl@ 应设置为 ccm。请遵循此样本成员附带包括的指示信息并仔细复查作业输出。
- 可选:配置数据仓库。编辑 JTS 和 CCM teamserver.properties 文件,使其包括数据仓库存储库的设置。所有三个文件中将具有相同的设置。
要点: 如果您现在未实现独立的数据仓库,那么可以跳过此步骤。但是,如果您跳过此步骤,那么当您使用 Jazz Team Server 安装向导时必须跳过数据仓库配置步骤。
如果您现在正在配置数据仓库,那么必须更新 JTS 和 CCM teamserver.properties 文件以使其包括 db2z 数据仓库参数,并且必须除去现有的所有 Derby 数据仓库属性。具体来说,使用 # 将其注释掉,如以下示例所示:
#com.ibm.team.datawarehouse.db.net.port
#com.ibm.team.datawarehouse.db.vendor=DERBY(或者 derby_net)
#com.ibm.team.datawarehouse.db.jdbc.location=/directoryInYourWorkdirectory 或者
#com.ibm.team.datawarehouse.db.jdbc.location=//localhost\:1527// ...
添加以下信息:
com.ibm.team.datawarehouse.db.vendor = db2z
com.ibm.team.datawarehouse.db.jdbc.location=//ipAddress:ipPort/location:user=jazzDBuser;password={password};
com.ibm.team.datawarehouse.db.jdbc.password=jazzDBpswd
# The database user for whom proper permissions will be granted
com.ibm.team.datawarehouse.report.user = RPTUSER
com.ibm.team.datawarehouse.db.db2.dsn.dbname=RIDW
- 如果您已更新数据仓库的 teamserver.properties 文件,请修改并提交 V4 SBLZSAMP 样本成员 BLZCREDB 以创建数据仓库表,从而创建数据仓库存储库。将应用程序变量 @appl@ 设置为 jts。存储库工具命令 @repotoolsCommand@ 为 -createWarehouse。
- 通过修改并提交 V4 SBLZSAMP 样本成员 BLZSRVD 来启动 V4 Tomcat 服务器。请确保配置目录 @confPath@ 变量和工作目录 @workPath@ 变量设置为新的 V4 目录值。
- 通过完成下列步骤来激活许可证:
- 以管理员身份登录到 Jazz Team Server V4.0。
- 浏览到服务器管理 > 许可证密钥管理页面并激活许可证。
注: 您不需要在 4.0 系统上运行设置,因为已设置了所有对象。
许可证声明: - 对于里程碑发行版,您必须激活随里程碑交付的“早期使用许可证”。
- 对于 V4.0 最终发行版,您必须购买新的许可证。V4 许可证适用于 V3 应用程序,但是,V3 许可证对于 V4 应用程序不起作用。有关更多信息,请参阅管理许可证。
- 如果您想要添加“质量管理”(QM) 应用程序或“需求管理”(RM) 应用程序,请遵循有关新安装的指示信息。有关详细信息,请参阅在 z/OS 上安装和配置 Jazz Team Server 和 Rational solution for Collaborative Lifecycle Management 应用程序。