本主题描述借助一个使用 Tomcat Application Server 和 DB2® for z/OS® 的设置,将服务器从 Rational® solution for Collaborative Lifecycle Management (CLM) V3.0.1.x 应用程序升级到 V4 时需要执行的步骤。
开始之前
生成 BLZSAMP 成员的副本,以便您在必要时可以复查原始文件。提交作业之后,复查样本的作业日志。预期的返回码为 0。
关于此任务
执行下列步骤会将 V3.0.1.x 配置迁移到 V4.0 配置。
过程
- 使用 SMP/E 安装来安装 CLM V4 程序包。V4 配置位置必须与 V3.0.1.x 配置位置不同。 安装 SMP/E 程序包将提供新的用于升级的数据库备份工具。有关详细信息,请参阅SMP/E 安装过程概述。
注: V4 的 FMID 已更改,因此,不存在用于从 V3.0.1.x 升级到 V4 的 PTF。
- 停止所有 V3.0.1.x 服务器。
- 使用所提供的 DB2 for z/OS UNLOAD 实用程序和 LOAD 实用程序来备份 V3.0.1.x 存储库。 有关详细信息,请参阅使用 DB2 卸载和装入过程进行备份。您可以使用其他已经过测试和验证的工具来生成备份副本。
要点: 在继续进行升级之前,您必须生成存储库的备份副本,这是因为在升级过程中会对存储库模型进行更改,然而无法回滚这些更改。
- 要验证备份与恢复过程,请对新数据库和新模式前缀完成 UNLOAD 和 LOAD 的步骤。
- 使用 V3.0.1.x BLZCREDB 样本作业在新数据库中创建表。
- 为了充分测试数据库备份和恢复过程,请为每个存储库再创建另外的数据库。新创建的数据库必须与现有数据库具有相同的许可权。
- 如果您要恢复数据仓库的副本,那么必须将其恢复到另外的 DB2 z/OS 子系统,这是因为两个数据仓库无法存在于一个子系统中。
- 为每个数据库创建单独的 UNIX 系统服务目录 (ussWorkDir)。
- 使用字符数相同的存储库模式前缀。
- 在继续执行升级步骤之前,请确认已成功创建新的 V3.0.1.x 存储库。
- 修改并提交 V4 SBLZSAMP 样本成员 BLZPOPT 以设置新的 Tomcat 服务器配置结构和工作目录,从而配置 Tomcat 服务器。请确保配置目录不同于 V3.0.1.x 安装版本中使用的配置目录。请遵循此样本成员中的指示信息,或者请参阅为 Jazz Team Server 和 Rational solution for Collaborative Lifecycle Management 应用程序创建其他目录。
- 修改并提交 V4 SBLZSAMP 样本成员 BLZCPJTS 以设置服务器配置结构和工作目录(其中包括“生命周期项目管理”应用程序),从而配置 Jazz Team Server (JTS)。
注: 您为 V4 创建的配置目录 (JAZZ_HOME) 和工作目录必须与 V3.0.1.x 目录不同,以便升级实用程序可以合并这两个版本。例如,V3.0.1.x 的缺省配置目录为 /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 应用程序创建其他目录。
- 修改并提交 V4 SBLZSAMP 样本成员 BLZCPQM 以使用 QM 定义来设置新的服务器配置和工作目录结构,从而配置“质量管理”(QM) 服务器。 请遵循此样本成员中的指示信息。
- 修改并提交 V4 SBLZSAMP 样本成员 BLZCPRM 以使用 RM 定义来设置新的服务器配置和工作目录结构,从而配置“需求管理”(RM) 服务器。 请遵循此样本成员中的指示信息。
- 通过启动和停止 V4 Tomcat 服务器来部署应用程序(或者部署 ccm.war 和 jts.war 文件)。
注: 如果已经定制了 V3.0.1.x 应用程序 web.xml 文件(例如,为了支持 LDAP 注册表而进行定制),那么其余步骤会将这些定制文件迁移到 V4 应用程序并修改每个应用程序中的 web.xml 文件。但是,.war 文件已签名,因此,只能修改已部署的 .war 文件。如果在迁移之后重新部署了应用程序,那么必须再次手动定制 V4 文件。
- 迁移 JTS 服务器配置。使用存储库工具并通过修改 V4 SBLZSAMP 样本成员 BLZJTSU 将 V3.0.1.x 配置文件设置合并到 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.0.1.x 服务器是从 V2.x 迁移而来,否则,应用程序上下文应为 /ccm。
- 替换 @pathPrefix@ 变量以指向 V4 二进制文件的路径前缀。
注: 在 V3.0.1.x 中就已添加此样本成员使用的存储库工具命令 migration_ccm_updateConfigurationFiles。如果 @pathPrefix@ 指向先前版本,那么此存储库工具命令将不使用 V4 update 命令。
- 按照样本 BLZCCMU 作业中的指示信息完成相应的操作。
提交 BLZCCMU 作业并复查作业输出和更新后的属性文件。注: 指向 Derby 数据仓库的数据仓库属性仍然保持为此合并操作的一部分,但是将在后续步骤中解决。
- 迁移 QM 服务器配置。使用存储库工具并通过修改 V4 SBLZSAMP 样本成员 BLZQMU 将 V3.0.1.x 配置文件设置合并到 QM 的 V4 配置文件中。在您提交 BLZQMU 作业之前,请完成下列步骤:
- 替换 @pathPrefix@ 变量以指向 V4 二进制文件的路径前缀。
注: 在 V3.0.1.x 中就已添加此样本成员使用的存储库工具命令 migration_qm_updateConfigurationFiles。如果 @pathPrefix@ 指向先前版本,那么此存储库工具命令将不使用 V4 update 命令。
- 按照样本 BLZQMU 作业中的指示信息完成相应的操作。
提交 BLZQMU 作业并复查作业输出和更新后的属性文件。注: 指向 Derby 数据仓库的数据仓库属性仍然保持为此合并操作的一部分,但是将在后续步骤中解决。
- 迁移 RM 服务器配置。使用存储库工具并通过修改 V4 SBLZSAMP 样本成员 BLZRMU 将 V3.0.1.x 配置文件设置合并到 RM 的 V4 配置文件中。在您提交 BLZRMU 作业之前,请完成下列步骤:
- 替换 @pathPrefix@ 变量以指向 V4 二进制文件的路径前缀。
注: 在 V3.0.1.x 中就已添加此样本成员使用的存储库工具命令 migration_rm_updateConfigurationFiles。如果 @pathPrefix@ 指向先前版本,那么此存储库工具命令将不使用 V4 update 命令。
- 按照样本 BLZRMU 作业中的指示信息完成相应的操作。
提交 BLZRMU 作业并复查作业输出和更新后的属性文件。注: 指向 Derby 数据仓库的数据仓库属性仍然保持为此合并操作的一部分,但是将在后续步骤中解决。
- 通过完成下列步骤来复制索引文件:
- 将 V3.0.1.x 中的 JFS/text 索引复制到 V4。对于分布式系统,请转至适当的服务器并复制这些文件。
- 打开命令提示符并输入以下命令以清除缺省 4.0 indices 目录:
rm -rf <4.0_configuration_dir>/jts/indices
rm -rf <4.0_configuration_dir>/ccm/indices
rm -rf <4.0_configuration_dir>/qm/indices
- 打开命令提示符并输入以下命令以将索引从 V3.0.1.x 复制到 V4:
cp -R <3.0.1.x_configuration_dir>/jts/indices <4.0_configuration_dir>/jts/indices
cp -R <3.0.1.x_configuration_dir>/ccm/indices <4.0_configuration_dir>/ccm/indices
cp -R <3.0.1.x_configuration_dir>/qm/indices <4.0_configuration_dir>/qm/indices
编辑 JTS、CCM 和 QM 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。请遵循此样本成员附带包括的指示信息并仔细复查作业输出。
- 升级 QM 数据库。如果您已配置 QM 应用程序,那么使用存储库工具并通过修改和提交 V4 SBLZSAMP 样本成员 BLZADDTB 的副本将 4.0 数据库表添加至 QM 存储库。应用程序变量 @appl@ 应设置为 qm。请遵循此样本成员附带包括的指示信息并仔细复查作业输出。
- 可选:配置数据仓库。编辑 JTS、CCM 和 QM teamserver.properties 文件,使其包括数据仓库存储库的设置。所有三个文件中将具有相同的设置。
要点: 如果您现在未实现独立的数据仓库,那么可以跳过此步骤。但是,如果您跳过此步骤,那么当您使用 Jazz Team Server 安装向导时必须跳过数据仓库配置步骤。
如果您现在正在配置数据仓库,那么必须更新 JTS、CCM 和 QM 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
- 对数据仓库进行升级。如果您已配置数据仓库,那么使用存储库工具并通过修改和提交 V4 SBLZSAMP 样本成员 BLZDWHUP 的副本对数据仓库存储库进行升级。请遵循此样本成员附带包括的指示信息并仔细复查作业输出。
- 通过修改并提交 V4 SBLZSAMP 样本成员 BLZSRVD 来启动 V4 Tomcat 服务器。请确保配置目录 @confPath@ 变量和工作目录 @workPath@ 变量设置为新的 V4 目录值。
- 通过完成下列步骤来激活许可证:
- 以管理员身份登录到 Jazz Team Server V4.0。
- 浏览到服务器管理 > 许可证密钥管理页面并激活许可证。
注: 您不需要在 4.0 系统上运行设置,因为已经设置了所有对象。
许可证声明: - 对于里程碑发行版,您必须激活随里程碑交付的“早期使用许可证”。
- 对于 V4.0 最终发行版,您必须购买新的许可证。V4 许可证适用于 V3 应用程序,但是,V3 许可证对于 V4 应用程序不起作用。有关更多信息,请参阅管理许可证。
- 迁移 Rational Requirements Composer (RRC)。如果您已经配置了 RM 应用程序,那么必须通过完成下列步骤来运行 RM 联机迁移实用程序:
- 打开浏览器,清除浏览器高速缓存,然后浏览到 RM Web 客户端。指定以下 URL 中的服务器名称和端口号:https://server_name:port/rdm/web/projects/migration。缺省端口是 9443。此页面将检测正在进行迁移并且迁移向导将启动。
- 接受 Rational Requirements Composer - 分析人员客户访问许可证
- 单击打开迁移服务面板,然后选择迁移向导以启动 Rational Requirements Composer 迁移。正在进行迁移时,会将有关正在处理哪个存储区域以及何时开始建立索引的状态通过迁移 Web 页面向管理员报告。
要点: 开始迁移之后,您就无法取消此操作,直到完成迁移为止。
完成迁移之后,会对 Rational Requirements Composer 数据重新建立索引。
- 重新建立索引之后,应用程序会对已迁移的数据执行验证和一致性检查,并向管理员提供反馈。
- 当显示一条消息指出已完成迁移时,单击关闭。然后,您将重定向到 RRC 应用程序。
有关更多详细信息,请参阅联机迁移升级步骤。