使用 WebSphere Application Server 和 DB2 for z/OS 将服务器从 V3.0.1.x 进行升级

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

过程

  1. 使用 SMP/E 安装来安装 CLM V4 程序包。V4 配置位置必须与 V3.0.1.x 配置位置不同。 安装 SMP/E 程序包将提供新的用于升级的数据库备份工具。有关详细信息,请参阅SMP/E 安装过程概述。
    注: V4 的 FMID 已更改,因此,不存在用于从 V3.0.1.x 升级到 V4 的 PTF。
  2. 停止服务器,并使用所提供的 DB2 for z/OS UNLOAD 实用程序和 LOAD 实用程序来备份 V3.0.1.x 存储库。 有关详细信息,请参阅使用 DB2 卸载和装入过程进行备份。您可以使用其他已经过测试和验证的工具来生成备份副本。
    要点: 在继续进行升级之前,您必须生成存储库的备份副本,这是因为在升级过程中会对存储库模型进行更改,然而无法回滚这些更改。
    1. 要验证备份与恢复过程,请对新数据库和新模式前缀完成 UNLOAD 和 LOAD 的步骤。
    2. 使用 V3.0.1.x BLZCREDB 样本作业在新数据库中创建表。
    3. 为了充分测试数据库备份和恢复过程,请为每个存储库再创建另外的数据库。新创建的数据库必须与现有数据库具有相同的许可权。
    4. 如果您要恢复数据仓库的副本,那么必须将其恢复到另外的 DB2 z/OS 子系统,这是因为两个数据仓库无法存在于一个子系统中。
    5. 为每个数据库创建单独的 UNIX 系统服务目录 (ussWorkDir)。
    6. 使用字符数相同的存储库模式前缀。
    7. 在继续执行升级步骤之前,请确认已成功创建新的 V3.0.1.x 存储库。
  3. 修改并提交 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 应用程序创建其他目录。
  4. 修改并提交 V4 SBLZSAMP 样本成员 BLZCPCCM,以使用 CCM 定义来设置新的服务器配置和工作目录结构,从而配置“变更和配置管理”(CCM) 服务器。 请遵循此样本成员中的指示信息,或者请参阅为 Jazz Team Server 和 Rational solution for Collaborative Lifecycle Management 应用程序创建其他目录。
  5. 修改并提交 V4 SBLZSAMP 样本成员 BLZCPQM 以使用 QM 定义来设置新的服务器配置和工作目录结构,从而配置“质量管理”(QM) 服务器。 请遵循此样本成员中的指示信息。
  6. 修改并提交 V4 SBLZSAMP 样本成员 BLZCPRM 以使用 RM 定义来设置新的服务器配置和工作目录结构,从而配置“需求管理”(RM) 服务器。 请遵循此样本成员中的指示信息。
  7. 通过完成下列步骤从 WebSphere Application Server 中卸载 V3.0.1.x 应用程序:
    1. 登录到 WebSphere Application Server 集成解决方案控制台 (https://example.com:9043/ibm/console/logon.jsp)
    2. 单击应用程序 > 应用程序类型 > WebSphere 企业应用程序。
    3. 请记录下列 V3.0.1.x 应用程序的安全角色映射,以便您可为 V4 等效件重新创建这些安全角色映射:
      • jts_war
      • ccm_war
      • qm_war
    4. 停止并卸载下列 V3.0.1.x 应用程序:
      • jts_war
      • ccm_war
      • qm_war
      • rm_war
      • clmhelp_war
      • admin_war
    5. 当系统提示您时,将变更保存到主配置。
  8. 通过完成下列步骤来更新 JAZZ_HOME 和 log4j.configuration 定制属性:
    1. 登录到 WebSphere Application Server 集成解决方案控制台 (https://example.com:9043/ibm/console/logon.jsp)
    2. 单击服务器 > 服务器类型 > WebSphere Application Server。
    3. 单击服务器名称以将其打开。缺省服务器名称为“server1”。
    4. 在“服务器基础结构”部分下,选择 Java 和过程管理> 过程定义。
    5. 在“其他属性”下,选择 Java 虚拟机。
    6. 在“其他属性”下面,选择定制属性。
    7. 选择 JAZZ_HOME 并将其值更新为:file:///<4.0_configuration_dir>。例如,file:///etc/jazz40。
    8. 选择 log4j.configuration 并将其值更新为:file:///<4.0_configuration_dir>/startup_log4j.properties。例如,file:///etc/jazz40/startup_log4j.properties。
    9. 当系统提示您时,将变更保存到主配置。
    有关更多信息,请参阅设置 WebSphere Application Server。
  9. 停止 WebSphere Application Server。
  10. 通过完成下列步骤来删除 WebSphere 临时文件和目录以及清除高速缓存:
    1. 转至 WebSphere Application Server 概要文件下的临时目录(通常类似于 <WAS_profile_root>/temp/<node_name>/<server_name>),并删除任何 <application>_war 目录。
    2. 转至 <WAS_profile_root>/temp/wscache 并删除 <application>_war(如果存在)。
  11. 迁移 JTS 服务器配置。使用存储库工具并通过修改 V4 SBLZSAMP 样本成员 BLZJTSU 将 V3.0.1.x 配置文件设置合并到 JTS 的 V4 配置文件中。在您提交 BLZJTSU 作业之前,请完成下列步骤:
    1. 删除包含下列参数的行:
      oldTomcatHome
      newTomcatHome 
    2. 将以下行的内容: 从 updateTomcatFiles=yes 更改为 updateTomcatFiles=no
    3. 替换 @pathPrefix@ 变量以指向 V4 二进制文件的路径前缀。
      注: 在 V3.0.1 中就已添加此样本成员使用的存储库工具命令 migration_jts_updateConfigurationFiles。如果 @pathPrefix@ 指向先前版本,那么此存储库工具命令将不使用 V4 update 命令。
    4. 按照样本 BLZJTSU 作业中的指示信息完成相应的操作。
    提交 BLZJTSU 作业并复查作业输出和更新后的属性文件。
    注: 指向 Derby 数据仓库的数据仓库属性仍然保持为此合并操作的一部分,但是将在后续步骤中解决。
  12. 迁移 CCM 服务器配置。使用存储库工具并通过修改 V4 SBLZSAMP 样本成员 BLZCCMU 将 V3.0.1.x 配置文件设置合并到 CCM 的 V4 配置文件中。在您提交 BLZCCMU 作业之前,请完成下列步骤:
    1. 删除包含下列参数的行:
      oldTomcatHome
      newJTSTomcatHome 
      newApplicationTomcatHome
    2. 将以下行的内容: 从 updateTomcatFiles=yes 更改为 updateTomcatFiles=no
    3. 将以下行的内容: 从 applicationContextRoot=jazz 更改为 applicationContextRoot=ccm。除非 V3.0.1.x 服务器是从 V2.x 迁移而来,否则,应用程序上下文应为 /ccm。
    4. 替换 @pathPrefix@ 变量以指向 V4 二进制文件的路径前缀。
      注: 在 V3.0.1.x 中就已添加此样本成员使用的存储库工具命令 migration_ccm_updateConfigurationFiles。如果 @pathPrefix@ 指向先前版本,那么此存储库工具命令将不使用 V4 update 命令。
    5. 按照样本 BLZCCMU 作业中的指示信息完成相应的操作。
    提交 BLZCCMU 作业并复查作业输出和更新后的属性文件。
    注: 指向 Derby 数据仓库的数据仓库属性仍然保持为此合并操作的一部分,但是将在后续步骤中解决。
  13. 迁移 QM 服务器配置。使用存储库工具并通过修改 V4 SBLZSAMP 样本成员 BLZQMU 将 V3.0.1.x 配置文件设置合并到 QM 的 V4 配置文件中。在您提交 BLZQMU 作业之前,请完成下列步骤:
    1. 删除包含下列参数的行:
      oldTomcatHome
      newJTSTomcatHome 
      newApplicationTomcatHome
    2. 将以下行的内容: 从 updateTomcatFiles=yes 更改为 updateTomcatFiles=no
    3. 替换 @pathPrefix@ 变量以指向 V4 二进制文件的路径前缀。
      注: 在 V3.0.1.x 中就已添加此样本成员使用的存储库工具命令 migration_qm_updateConfigurationFiles。如果 @pathPrefix@ 指向先前版本,那么此存储库工具命令将不使用 V4 update 命令。
    4. 按照样本 BLZQMU 作业中的指示信息完成相应的操作。
    提交 BLZQMU 作业并复查作业输出和更新后的属性文件。
    注: 指向 Derby 数据仓库的数据仓库属性仍然保持为此合并操作的一部分,但是将在后续步骤中解决。
  14. 迁移 RM 服务器配置。使用存储库工具并通过修改 V4 SBLZSAMP 样本成员 BLZRMU 将 V3.0.1.x 配置文件设置合并到 RM 的 V4 配置文件中。在您提交 BLZRMU 作业之前,请完成下列步骤:
    1. 删除包含下列参数的行:
      oldTomcatHome
      newJTSTomcatHome 
      newApplicationTomcatHome
    2. 将以下行的内容: 从 updateTomcatFiles=yes 更改为 updateTomcatFiles=no
    3. 替换 @pathPrefix@ 变量以指向 V4 二进制文件的路径前缀。
      注: 在 V3.0.1.x 中就已添加此样本成员使用的存储库工具命令 migration_rm_updateConfigurationFiles。如果 @pathPrefix@ 指向先前版本,那么此存储库工具命令将不使用 V4 update 命令。
    4. 按照样本 BLZRMU 作业中的指示信息完成相应的操作。
    提交 BLZRMU 作业并复查作业输出和更新后的属性文件。
    注: 指向 Derby 数据仓库的数据仓库属性仍然保持为此合并操作的一部分,但是将在后续步骤中解决。
  15. 通过完成下列步骤来复制索引文件:
    1. 将 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 具有正确的位置信息。
  16. 升级 JTS 数据库。使用存储库工具并通过修改和提交 V4 SBLZSAMP 样本成员 BLZADDTB 的副本将 4.0 数据库表添加至 JTS 存储库。应用程序变量 @appl@ 应设置为 jts。请遵循此样本成员附带包括的指示信息并仔细复查作业输出。
  17. 升级 CCM 数据库。如果您已配置 CCM 应用程序,那么使用存储库工具并通过修改和提交 V4 SBLZSAMP 样本成员 BLZADDTB 的副本将 4.0 数据库表添加至 CCM 存储库。应用程序变量 @appl@ 应设置为 ccm。请遵循此样本成员附带包括的指示信息并仔细复查作业输出。
  18. 升级 QM 数据库。如果您已配置 QM 应用程序,那么使用存储库工具并通过修改和提交 V4 SBLZSAMP 样本成员 BLZADDTB 的副本将 4.0 数据库表添加至 QM 存储库。应用程序变量 @appl@ 应设置为 qm。请遵循此样本成员附带包括的指示信息并仔细复查作业输出。
  19. 可选:配置数据仓库。编辑 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 
  20. 对数据仓库进行升级。如果您已配置数据仓库,那么使用存储库工具并通过修改和提交 V4 SBLZSAMP 样本成员 BLZDWHUP 的副本对数据仓库存储库进行升级。请遵循此样本成员附带包括的指示信息并仔细复查作业输出。
  21. 启动 WebSphere Application Server。
  22. 通过完成下列步骤将 V4 war 文件部署在 WebSphere Application Server 中:
    1. 登录到 WebSphere Application Server 集成解决方案控制台 (https://example.com:9043/ibm/console/logon.jsp)
    2. 通过选择应用程序 > 应用程序类型 > WebSphere 企业应用程序来打开“企业应用程序”页面
    3. 安装下列 V4 .war 文件:
      • jts.war
      • ccm.war
      • qm.war
      • rm.war
      • clmhelp.war
      • admin.war
    4. 根据您在前一步骤中卸载下列 V4 应用程序时记录的内容来映射这些应用程序的安全角色:
      • jts_war
      • ccm_war
      • qm_war
  23. 从 WebSphere Application Server 集成解决方案控制台来启动应用程序:
    • jts_war
    • ccm_war
    • qm_war
    • rm_war
    • clmhelp_war
    • admin_war
  24. 通过打开浏览器并粘贴下列 URL 将服务器复位:
    https://jts_server.mydomain.com:9443/jts/admin#action=com.ibm.team.repository.admin.serverReset
    https://ccm_server.mydomain.com:9443/ccm/admin#action=com.ibm.team.repository.admin.serverReset
    https://qm_server.mydomain.com:9443/qm/admin#action=com.ibm.team.repository.admin.serverReset
    注: 您必须重新启动服务器,才能使服务器复位生效。
  25. 通过完成下列步骤来激活许可证:
    1. 以管理员身份登录到 Jazz Team Server V4.0。
    2. 浏览到服务器管理 > 许可证密钥管理页面并激活许可证。
      注: 您不需要在 4.0 系统上运行设置,因为已设置了所有对象。
    许可证声明:
    • 对于里程碑发行版,您必须激活随里程碑交付的“早期使用许可证”。
    • 对于 V4.0 最终发行版,您必须购买新的许可证。V4 许可证适用于 V3 应用程序,但是,V3 许可证对于 V4 应用程序不起作用。有关更多信息,请参阅管理许可证。
  26. 迁移 Rational Requirements Composer (RRC)。如果您已经配置了 RM 应用程序,那么必须通过完成下列步骤来运行 RM 联机迁移实用程序:
    1. 打开浏览器,清除浏览器高速缓存,然后浏览到 RM Web 客户端。指定以下 URL 中的服务器名称和端口号:https://server_name:port/rdm/web/projects/migration。缺省端口是 9443。此页面将检测正在进行迁移并且迁移向导将启动。
    2. 接受 Rational Requirements Composer - 分析人员客户访问许可证
    3. 单击打开迁移服务面板,然后选择迁移向导以启动 Rational Requirements Composer 迁移。正在进行迁移时,会将有关正在处理哪个存储区域以及何时开始建立索引的状态通过迁移 Web 页面向管理员报告。
      要点: 开始迁移之后,您就无法取消此操作,直到完成迁移为止。
      完成迁移之后,会对 Rational Requirements Composer 数据重新建立索引。
    4. 重新建立索引之后,应用程序会对已迁移的数据执行验证和一致性检查,并向管理员提供反馈。
    5. 当显示一条消息指出已完成迁移时,单击关闭。然后,您将重定向到 RRC 应用程序。
    有关更多详细信息,请参阅联机迁移升级步骤。

反馈