升级 Rational Engineering Lifecycle Manager

要将您所使用的 Rational® Engineering Lifecycle Manager 版本升级到最新版本,您将对新版本进行并排安装。

开始之前

如果要更新与 Rational Engineering Lifecycle Manager 进行集成的产品,请确保遵循升级 Rational Engineering Lifecycle Manager 产品堆栈中的指南

过程

  1. 按照安装 Rational Engineering Lifecycle Manager 和 Lifecycle Query Engine 中的指示信息来安装 Rational Engineering Lifecycle Manager 这将安装以下三项:
    • Rational Engineering Lifecycle Manager V4.0.6
    • Jazz™ Team Server V4.0.6
    • “配置管理”应用程序
    要点:
    • 您务必选择与原始安装使用不同的包组和目录。
    • 您务必选择与先前安装使用相同的上下文根。
  2. 如果您要使用 WebSphere® Application Server,请完成下列步骤。
    1. 备份 WebSphere Application Server 概要文件。打开命令提示符,并切换到 WebSphere Application Server 安装目录的 bin 文件夹。例如,C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\bin。运行以下命令。请注意,如果启用了 WebSphere Application Server 安全性,那么您还必须提供用户名和密码:
      backupConfig.bat <Path to a new compressed file to create backup of profile> <WAS primary administrative user name> <WAS administrative password>
      例如,backupConfig.bat C:\WAS_backup\clm_40_profile.zip -username WAS admin -password WAS admin password
    2. 从 WebSphere Application Server 中卸载现有应用程序。要卸载应用程序 WAR 文件,请转至每个应用程序服务器并执行下列步骤。
      1. 登录到 WebSphere Application Server 集成解决方案控制台 (https://hostname:9043/ibm/console/logon.jsp)。
      2. 单击应用程序 > 应用程序类型 > WebSphere 企业应用程序
      3. 停止下列应用程序并将其卸载:relm.war、vvc.war、lqe.war 和 SPARQL_Gateway.war
      4. 当系统提示您时,将更改保存到主配置。
    3. 更新 JAZZ_HOME 和 log4j.configuration 定制属性。
      1. 登录到 WebSphere Application Server 集成解决方案控制台 (https://hostname:9043/ibm/console/logon.jsp)。
      2. 单击服务器 > 服务器类型 > WebSphere Application Server
      3. 单击服务器名称以将其打开。缺省服务器名称为 server1。
      4. 服务器基础结构部分下,单击 Java 和流程管理 > 流程定义
      5. 其他属性下,单击 Java 虚拟机
      6. 将 Lifecycle Query Engine 和 SPARQL Gateway 的路径更改为新位置。
      7. 找到“通用 JVM 参数”文本字段,并对 JVM 启动流程添加以下环境变量: -Dlqe.config.location=file://drive:\lqe_installation_folder\server\conf\lqe
      8. 其他属性下,单击定制属性
      9. 单击 JAZZ_HOME 并将其值更新到 file:///4.0.6_install_dir/server/conf。 例如,file:///C:/PROGRA~2/IBM/JazzTeamServer_4.0.6/server/conf
      10. 单击 log4j.configuration 并将其值更新到 file:///4.0.6_install_dir/server/conf/startup_log4j.properties。 例如,file:///C:/PROGRA~2/IBM/JazzTeamServer_4.0.6/server/conf/startup.log4j.properties
      11. 如果您正在连接至 Oracle 数据库,请确保 ORACLE_JDBC_DRIVER_FILE 指向正确的 JDBC 驱动程序文件。
      12. 当系统提示您时,将更改保存到主配置。
    4. 停止 WebSphere Application Server。
    5. 清除 WebSphere Application Server temp 目录。转至每个应用程序服务器,并从概要文件中的下列 wscachetemp 目录中除去与 Rational Engineering Lifecycle Manager 相关的内容。根据先前已安装的应用程序不同,概要文件下可能存在下列目录,可以除去这些目录:relm_warlqe_warsparql 和 vvc 相关数据。
      WAS_profile_root\wscache(例如:C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
      WAS_profile_root\temp(例如:C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)
    6. 清除 logs 目录。转至每个应用程序服务器,并从概要文件中的 logs 目录中除去与 Rational Engineering Lifecycle Manager 相关的日志。典型的 logs 目录可能为:C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\logs
  3. 要迁移数据库,请完成下列步骤:
    选项 描述
    Derby 删除通过升级所安装的 Derby 数据库,然后将它们替换为原始安装中的 Derby 文件。
    rm -rf $newRELMHome/server/conf/jts/derby/repositoryDB
    rm -rf $newRELMHome/server/conf/jts/indices
    rm -rf $newRELMHome/server/conf/relm/derby/repositoryDB
    rm -rf $newRELMHome/server/conf/vvc/derby/repositoryDB
    cp -R $oldRELMHome/server/conf/jts/derby/repositoryDB $newRELMHome/server/conf/jts/derby
    cp -R $oldRELMHome/server/conf/jts/indices $newRELMHome/server/conf/jts
    cp -R $oldRELMHome/server/conf/relm/derby/repositoryDB $newRELMHome/server/conf/relm/derby
    cp -R $oldRELMHome/server/conf/relm/indices $newRELMHome/server/conf/relm
    cp -R $oldRELMHome/server/conf/vvc/derby/repositoryDB $newRELMHome/server/conf/vvc/derby
    cp -R $oldRELMHome/server/conf/vvc/indices $newRELMHome/server/conf/vvc
    DB2® 或 Oracle 有关完整的指示信息,请参阅数据库供应商提供的文档。以下是 DB2 的样本流程,可以作为准则。
    1. 停止旧的 Jazz Team Server。
    2. 在 DB2 中,找到先前安装的 JTS 应用程序所使用的数据库。
    3. 备份 JTS 应用程序所使用的每个数据库。
    4. 右键单击每个数据库,然后选择复原 > 复原到新数据库
    5. 输入数据库的名称,并选择包含备份的目录。
    6. 打开 <JazzInstallDir>/server/conf/jts/teamserver.properties 文件。
    7. 将 Jazz 数据库的名称替换为您所提供的名称,如以下示例中所示。
      #
      # DB2 configuration
      #
      
      # Comment out above lines, uncomment the following three lines and customize example location to use DB2
      #com.ibm.team.repository.db.vendor = DB2
      #com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:fullyMaterializeLobData=false;user=db2admin;password={password};
      #com.ibm.team.repository.db.jdbc.password=db2admin
    8. 对您需要复原的每个数据库重复执行步骤 d 到步骤 g。
    9. 保存您所做的更改。
  4. 使用 vvc_upgrade.bat 脚本升级“配置管理”应用程序。 这将升级配置文件和数据库文件,并且重新构建文本索引。有关如何升级“配置管理”应用程序的详细描述,请参阅以下位置提供的升级指南:“配置管理”的交互式升级指南 针对 Linux 的参数示例将是:
    cd $newRELMHome/server/
    upgrade/vvc/vvc_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
    • 如果您要升级分布式(多台机器)安装拓扑,那么将需要对 vvc_upgrade 脚本添加以下参数:-oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck
    • 如果您要使用 WebSphere Application Server,那么需要对 vvc_upgrade 脚本添加一个参数,以让它不要升级 Tomcat:-oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck -updateTomcatFiles=no
    注: 还可将“配置管理”应用程序随 Rhapsody® Design Manager 一起安装。当您安装 Rational Engineering Lifecycle Manager 时,还将允许您选择安装“配置管理”应用程序 - 这在您想要将此应用程序与 Rhapsody Design Manager 安装在不同机器上时很有用。只应将此组件与 Rhapsody Design Manager 的其中一项与 Jazz Team Server 进行集成。如果您选择将此组件安装在多台机器上,那么在安装和升级此组件时应注意选择正确的机器。
  5. 通过运行 relm_upgrade.sh 来升级 Rational Engineering Lifecycle Manager
    $newRELMHome/server/upgrade/relm/relm_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
    这将执行三项升级。首先将升级配置文件。其次将升级数据库文件。最后将重新构建文本索引。
    注: 必须设置 relm_params 脚本中的先前版本参数才能运行升级脚本。此参数和其他可用参数的描述可在以下位置找到:relm_upgrade 脚本引用
  6. 应将 Lifecycle Query Engine 和 SPARQL Gateway 组件的任何配置信息移植到新安装。您必须将旧版本手动复制到新的 Jazz Team Server。
    rm -rf $newRELMHome/server/conf/lqe
    cp -R $oldRELMHome/server/conf/lqe $newRELMHome/server/conf/lqe
    rm -rf $newRELMHome/server/conf/SPARQL_Gateway
    cp -R $oldRELMHome/server/conf/SPARQL_Gateway $newRELMHome/server/conf/SPARQL_Gateway
  7. 编辑 SPARQL Gateway 属性以除去 DBLocation 属性。 在以下文件中,除去 DBLocation 行:$newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties
  8. 如果您要使用 Oracle,请确保以下目录中提供了 Oracle ojdbc.jar(JDBC 驱动程序):$newRELMHome\JazzTeamServer\server\oracle
  9. 如果您要使用 WebSphere Application Server,请部署 relm.warvvc.warlqe.warsparql_gateway.war 文件。重新启动 WebSphere Application Server。
  10. 启动 Jazz Team Server。
  11. 打开 LQE 管理页面 https://server:port/lqe/web/admin 将显示一条消息,该消息指示 LQE 处于升级方式并且不可用。单击启动升级。完成该升级后,数据源将可用。
  12. 确保存在包含以下内容的 credentials.txt 文件:adminUserId, adminPassword, repositoryURL, smartCard, certificateFile 如果此文件已不存在,请创建该文件。例如,凭证文件可能包含类似于如下的内容:
    adminUserId=yourAdminUserId
    adminPassword=yourAdminPassword 
    repositoryURL=https://yourserver.com:9443/vvc 
    smartCard=<none>
    certificateFile=<none>
  13. Configuration_Application_install_dir/server 目录运行以下批处理文件
    • Linux:./repotools-vvc.sh -migration_vvc_updateResourcesCommand credentialsFile=credentials.txt
    • Windows:repotools-vvc.bat -migration_vvc_updateResourcesCommand credentialsFile=credentials.txt

下一步做什么

在您将所有必需的软件升级之后,Lifecycle Query Engine 可能需要对它们的内容重新建立索引。已将新的词汇表添加至 4.0.3 的 Lifecycle Query Engine,如果您希望 Rational Engineering Lifecycle Manager 使用这些词汇表中包括的数据,那么您将需要对该应用程序重新建立索引。
表 1. 重新建立索引的需求的概述(按产品划分)
产品 V1.x 到 V4.0.6 V4.0.3 到 V4.0.6 V4.0.4 到 V4.0.6 V4.0.5 到 V4.0.6
Rational Team Concert™ 需要重新建立索引 不需要重新建立索引 不需要重新建立索引 不需要重新建立索引
Rational Quality Manager 需要重新建立索引 建议重新建立索引。名为 oslc:shortld 的新属性已添加到所有 QM 资源。如果您想要在任何查询中使用此属性,那么必须重新建立索引。 不需要重新建立索引 不需要重新建立索引
Rhapsody Design Management 不需要重新建立索引,但是可能需要除去重复索引条目以帮助提高性能。如果要在查询中使用新数据,请重新建立索引。 不需要重新建立索引 不需要重新建立索引 不需要重新建立索引
Rational DOORS® 强烈建议重新对产品数据建立索引。如果您已针对 mailto URI 创建了查询,那么建议重新建立索引。 建议重新对产品数据建立索引。如果您已针对 mailto URI 创建了查询,那么建议重新建立索引。 不需要重新建立索引。 不需要重新建立索引。
Rational DOORS Next Generation 不适用 不适用 不需要重新建立索引 不需要重新建立索引
Rational Engineering Lifecycle Manager 需要重新建立索引 需要重新建立索引 需要重新建立索引 需要重新建立索引
Jazz Team Server Users TRS (jts/trsUsers) 需要重新建立索引。 不需要重新建立索引 不需要重新建立索引 不需要重新建立索引

反馈