将服务器从具有 Tomcat 和 DB2 for z/OS 的 V3.0 进行升级

本主题描述借助一个使用 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 配置。

过程

  1. 使用 SMP/E 安装来安装 CLM V4 程序包。V4 配置位置必须与 V3.0 配置位置不同。 安装 SMP/E 程序包将提供新的用于升级的数据库备份工具。有关详细信息,请参阅SMP/E 安装过程概述。
    注: V4 的 FMID 已更改,因此,不存在用于从 V3.0 升级到 V4 的 PTF。
  2. 使用所提供的 DB2 for z/OS UNLOAD 实用程序和 LOAD 实用程序来备份 V3.0 存储库。 有关详细信息,请参阅使用 DB2 卸载和装入过程进行备份。您可以使用其他已经过测试和验证的工具来生成备份副本。
    要点: 在继续进行升级之前,您必须生成存储库的备份副本,这是因为在升级过程中会对存储库模型进行更改,然而无法回滚这些更改。
    1. 要验证备份与恢复过程,请对新数据库和新模式前缀完成 UNLOAD 和 LOAD 的步骤。
    2. 使用 V3.0 BLZCREDB 样本作业在新数据库中创建表。
    3. 为了充分测试数据库备份和恢复过程,请为每个存储库再创建另外的数据库。新创建的数据库必须与现有数据库具有相同的许可权。
    4. 为每个数据库创建单独的 UNIX 系统服务目录 (ussWorkDir)。
    5. 使用字符数相同的存储库模式前缀。
    6. 在继续执行升级步骤之前,请确认已成功创建新的 V3.0 存储库。
  3. 修改并提交 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 应用程序创建其他目录。
  4. 修改并提交 V4 SBLZSAMP 样本成员 BLZCPCCM,以使用 CCM 定义来设置新的服务器配置和工作目录结构,从而配置“变更和配置管理”(CCM) 服务器。 请遵循此样本成员中的指示信息,或者请参阅为 Jazz Team Server 和 Rational solution for Collaborative Lifecycle Management 应用程序创建其他目录。
  5. 创建一个称为 RIDW 的 DB2 for z/OS 新数据库,将其用作数据仓库并授予许可权。 有关详细信息,请参阅设置 DB2 for z/OS 以与 Jazz Team Server 搭配使用。
  6. 通过启动和停止 V4 Tomcat 服务器来部署应用程序(或者部署 ccm.war 和 jts.war 文件)。
    注: 如果已经定制了 V3.0 应用程序 web.xml 文件(例如,为了支持 LDAP 注册表而进行定制),那么其余步骤会将这些定制文件迁移到 V4 应用程序并修改每个应用程序中的 web.xml 文件。但是,.war 文件已签名,因此,只能修改已部署的 .war 文件。如果在迁移之后重新部署了应用程序,那么必须再次手动定制 V3.0 文件。
  7. 迁移 JTS 服务器配置。使用存储库工具并通过修改 V4 SBLZSAMP 样本成员 BLZJTSU 将 V3.0 配置文件设置合并到 JTS 的 V4 配置文件中。在您提交 BLZJTSU 作业之前,请完成下列步骤:
    1. 替换 @pathPrefix@ 变量以指向 V4 二进制文件的路径前缀。
      注: 在 V3.0.1 中就已添加此样本成员使用的存储库工具命令 migration_jts_updateConfigurationFiles。如果 @pathPrefix@ 指向先前版本,那么此存储库工具命令将不使用 V4 update 命令。
    2. 按照样本 BLZJTSU 作业中的指示信息完成相应的操作。
    提交 BLZJTSU 作业并复查作业输出和更新后的属性文件。
    注: 指向 Derby 数据仓库的数据仓库属性仍然保持为此合并操作的一部分,但是将在后续步骤中解决。
  8. 迁移 CCM 服务器配置。使用存储库工具并通过修改 V4 SBLZSAMP 样本成员 BLZCCMU 将 V3.0.1.x 配置文件设置合并到 CCM 的 V4 配置文件中。在您提交 BLZCCMU 作业之前,请完成下列步骤:
    1. 将以下行的内容: 从 applicationContextRoot=jazz 更改为 applicationContextRoot=ccm。除非 V3 服务器是从 V2.x 迁移而来,否则,应用程序上下文应为 /ccm。
    2. 替换 @pathPrefix@ 变量以指向 V4 二进制文件的路径前缀。
      注: 在 V3 中就已添加此样本成员使用的存储库工具命令 migration_ccm_updateConfigurationFiles。如果 @pathPrefix@ 指向先前版本,那么此存储库工具命令将不使用 V4 update 命令。
    3. 按照样本 BLZCCMU 作业中的指示信息完成相应的操作。
    提交 BLZCCMU 作业并复查作业输出和更新后的属性文件。
    注: 指向 Derby 数据仓库的数据仓库属性仍然保持为此合并操作的一部分,但是将在后续步骤中解决。
  9. 停止 RTC V3 Tomcat 服务器。
  10. 通过完成下列步骤来复制索引文件:
    1. 将 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 具有正确的位置信息。
  11. 升级 JTS 数据库。使用存储库工具并通过修改和提交 V4 SBLZSAMP 样本成员 BLZADDTB 的副本将 4.0 数据库表添加至 JTS 存储库。应用程序变量 @appl@ 应设置为 jts。请遵循此样本成员附带包括的指示信息并仔细复查作业输出。
  12. 升级 CCM 数据库。如果您已配置 CCM 应用程序,那么使用存储库工具并通过修改和提交 V4 SBLZSAMP 样本成员 BLZADDTB 的副本将 4.0 数据库表添加至 CCM 存储库。应用程序变量 @appl@ 应设置为 ccm。请遵循此样本成员附带包括的指示信息并仔细复查作业输出。
  13. 可选:配置数据仓库。编辑 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 
  14. 如果您已更新数据仓库的 teamserver.properties 文件,请修改并提交 V4 SBLZSAMP 样本成员 BLZCREDB 以创建数据仓库表,从而创建数据仓库存储库。将应用程序变量 @appl@ 设置为 jts。存储库工具命令 @repotoolsCommand@ 为 -createWarehouse。
  15. 通过修改并提交 V4 SBLZSAMP 样本成员 BLZSRVD 来启动 V4 Tomcat 服务器。请确保配置目录 @confPath@ 变量和工作目录 @workPath@ 变量设置为新的 V4 目录值。
  16. 通过完成下列步骤来激活许可证:
    1. 以管理员身份登录到 Jazz Team Server V4.0。
    2. 浏览到服务器管理 > 许可证密钥管理页面并激活许可证。
      注: 您不需要在 4.0 系统上运行设置,因为已设置了所有对象。
    许可证声明:
    • 对于里程碑发行版,您必须激活随里程碑交付的“早期使用许可证”。
    • 对于 V4.0 最终发行版,您必须购买新的许可证。V4 许可证适用于 V3 应用程序,但是,V3 许可证对于 V4 应用程序不起作用。有关更多信息,请参阅管理许可证。
  17. 如果您想要添加“质量管理”(QM) 应用程序或“需求管理”(RM) 应用程序,请遵循有关新安装的指示信息。有关详细信息,请参阅在 z/OS 上安装和配置 Jazz Team Server 和 Rational solution for Collaborative Lifecycle Management 应用程序。

反馈