升级与 WebSphere Application Server 一起运行的 Rational Engineering Lifecycle Manager

要升级 Rational® Engineering Lifecycle Manager,请安装新产品版本,更新配置文件,添加或更新现有数据库存储库中的表以及将数据迁移到 V5.0.1

开始之前

过程

  1. 安装 Rational Engineering Lifecycle Manager
    此步骤将安装:
    • Rational Engineering Lifecycle Manager 5.0.1
    • Jazz™ Team Server 5.0.1
    • “配置管理”应用程序 5.0.1
    要点:
    • 选择与原始安装使用不同的包组和目录。
    • 选择与先前安装使用相同的上下文根。

      如果从 Rational Engineering Lifecycle Manager V5.0 进行升级,那么现有 Jazz Reporting Service 或 SPARQL Gateway 上下文根为 SPARQL_Gateway,并且应用程序文件名是 SPARQL_Gateway.war。安装 Rational Engineering Lifecycle Manager 5.0.1 时,选择定制上下文根选项,并在应用程序上下文根值字段中输入 SPARQL_Gateway

  2. 配置应用程序服务器。
    1. 确保旧服务器正在运行。
    2. 备份 WebSphere® Application Server 概要文件。
      1. 打开命令提示符,并切换到 WebSphere Application Server 安装目录的 bin 目录。
      2. 运行此命令。如果开启了 WebSphere Application Server 安全性,请指定用户名和密码。
        提示: 必须存在压缩文件的目录路径,才可开始备份过程。
        • Linux
          backupConfig.sh <Path_to_a_new_compressed_file_to_create_backup_of_profile> -username <WAS_primary_administrative_user_name> -password <WAS_administrative_password>
          例如:
          backupConfig.sh /root/WAS_backup/relm_50_profile.zip -username <WAS_admin> -password <WAS_admin_password>
        • Windows
          backupConfig.bat <Path_to_a_new_compressed_file_to_create_backup_of_profile> -username <WAS_primary_administrative_user_name> -password <WAS_administrative_password>
          例如:
          backupConfig.bat C:\WAS_backup\relm_50_profile.zip -username <WAS_admin> -password <WAS_admin_password>
      开始备份过程之前,此命令会关闭服务器。
    3. 从 WebSphere Application Server 中卸载现有应用程序。
      1. 启动服务器。
      2. 登录到 https://host_name:9043/ibm/console/logon.jsp 处的 WebSphere Application Server Integrated Solutions Console
      3. 单击应用程序 > 应用程序类型 > WebSphere 企业应用程序
      4. 停止下列应用程序并将其卸载:relm.war, relmhelp.war, vvc.war, lqe.war, SPARQL_Gateway.war
      5. 当系统提示您时,将更改保存到主配置。
    4. 更新 JAZZ_HOMElog4j.configuration 定制属性。
      1. 登录到 https://host_name:9043/ibm/console/logon.jsp 处的 WebSphere Application Server Integrated Solutions Console。
      2. 单击服务器 > 服务器类型 > WebSphere Application Server
      3. 单击服务器名称以将其打开。缺省服务器名称为 server1
      4. 服务器基础结构部分下,单击 Java 和流程管理 > 流程定义
      5. 其他属性下,单击 Java 虚拟机
      6. Lifecycle Query EngineJazz Reporting Service 的路径更改为新位置。
      7. 找到通用 JVM 参数文本字段,并对 JVM 启动流程添加以下环境变量:

        -Dlqe.config.location=file://drive:/lqe_installation_dir/server/conf/lqe

      8. 其他属性下,单击定制属性
      9. 单击 JAZZ_HOME 并将其值更新为 file:///<new_version_install_dir>/server/conf

        例如,file:///C:/PROGRA~2/IBM/JazzTeamServer_5.0.1/server/conf

      10. 单击 log4j.configuration 并将其值更新为 file:///<new_version_install_dir>/server/conf/startup_log4j.properties

        例如,file:///C:/PROGRA~2/IBM/JazzTeamServer_5.0.1/server/conf/startup.log4j.properties

      11. 如果您正在连接至 Oracle 数据库,请确保 ORACLE_JDBC_DRIVER_FILE 指向正确的 JDBC 驱动程序文件。
      12. 当系统提示您时,将更改保存到主配置。
    5. 设置 Jazz Reporting Service 共享库。
      1. 在管理控制台中,转至环境 > 共享库
      2. 在列表中,单击 JRS 共享库
      3. 将类路径从现有 Jazz Reporting Service 安装位置更改为新位置。

        例如:5.0.1_install_dir/server/conf/SPARQL_Gateway/SharedLibrary

      4. 类装入下,选中对共享库使用隔离式类装入器。单击应用后,单击保存
    6. 停止 WebSphere Application Server。
      • Linux 运行 stopServer.sh 命令。
      • Windows 运行 stopServer.bat 命令。
    7. 清除 WebSphere Application Server temp 目录。

      从概要文件中的 wscachetemp 目录中移除与 Rational Engineering Lifecycle Manager 相关的内容。根据先前已安装的应用程序不同,概要文件中可能存在下列目录,可以移除这些目录:relm_warlqe_warsparql 和“配置管理”应用程序相关数据。

      • Linux
        WAS_profile_root/wscache(例如:opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp/wscache)
        WAS_profile_root/temp(例如,opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)
      • Windows
        WAS_profile_root\wscache(例如,C:\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
        WAS_profile_root\temp(例如,C:\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)
    8. 清除 WebSphere Application Server 日志目录。
      转至每个应用程序服务器,并从概要文件中的 logs 目录中移除与 Rational Engineering Lifecycle Manager 相关的日志。典型日志目录为:
      • Linux opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs
      • Windows C:\IBM\WebSphere\AppServer\profiles\AppSrv01\logs
    9. 启动 WebSphere Application Server。
      • Linux 运行 startServer.sh 命令。
      • Windows 运行 startServer.bat 命令。
  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
    DB2Oracle 有关完整的指示信息,请参阅数据库供应商提供的文档。
    以下是 DB2® 的数据库备份流程示例,可以作为准则。
    1. 确保旧 Jazz Team Server 已停止。
    2. 在 DB2 中,找到先前安装的 Jazz Team Server 应用程序所使用的数据库。
    3. 备份 Jazz Team Server 应用程序所使用的每一个数据库。
    4. 保存您所做的更改。
    有关备份和复原数据库的更多信息,请参阅 Rational Solution for Collaborative Lifecycle Management 的文档
    SQL Server

    以下是 SQL 服务器的数据库备份流程示例,可以作为准则。

    • 确保您有正确的用户名和密码。
    • 确保启动升级过程之前已备份数据库。
    • 确认安装了 Java 数据库连接 (JDBC) 驱动程序,且正在使用 sqljdbc4.jar。在 V5.0.1 中,不再支持 JRE V5.0。仅支持 JRE V6.0 和 V7.0。
    • 确保 SQL 服务已启动。
    有关完整的指示信息,请参阅数据库供应商提供的文档。
    Oracle 确保 Oracle JDBC 驱动程序 ojdbc.jar$newRELMHome/JazzTeamServer/server/oracle 目录中可用。
  4. 升级“配置管理”应用程序。

    运行 vvc_upgrade 脚本以升级配置和数据库文件,并且重新构建文本索引。

    这是参数示例:
    cd $newRELMHome/server/
    upgrade/vvc/vvc_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
    • 如果您要升级分布式(多台服务器)安装拓扑,请将以下参数与 vvc_upgrade 脚本一起使用:
      -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck
    • 要跳过 Tomcat 升级,请将以下参数添加到 vvc_upgrade 脚本:
      -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck -updateTomcatFiles=no
    提示: 还可将“配置管理”应用程序随 Rhapsody® Design Manager 一起安装。当您安装 Rational Engineering Lifecycle Manager 时,如果希望将组件与 Rhapsody Design Manager 系统安装在不同机器上,请选择“配置管理”应用程序。只将一个“配置管理”应用程序与 Rational Engineering Lifecycle Manager 进行集成。如果您选择将该组件安装在多台服务器上,请确保您选择正确的组件进行安装和升级。
  5. 升级 Rational Engineering Lifecycle Manager
    运行 relm_upgrade.sh 命令以升级配置和数据库文件,并且重新构建文本索引。
    $newRELMHome/server/upgrade/relm/relm_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
  6. Lifecycle Query Engine 和现有 Jazz Reporting Service 或 SPARQL Gateway 配置信息移植到新产品版本。
    将旧安装的 SPARQL_Gateway 目录的内容复制到新 SPARQL_Gateway 目录。
    cp -R $oldRELMHome/server/conf/SPARQL_Gateway/* $newRELMHome/server/conf/SPARQL_Gateway
    如果您是从 V5.0 升级到 V5.0.1,请执行步骤 7。
    如果您是从 V4.x 升级到 V5.0.1,请使用文本编辑器将以下属性添加到 $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties
    • support.query.editing=false
    • support.db.derby=false
    • support.dwse=false
    • query.results.limit=3000
    • query.results.cache.timeout=300
    • user.account.cache.timeout=480
    SPARQL_Gateway 中移除 app.properties
    rm $newRELMHome/server/conf/SPARQL_Gateway/app.properties
    SPARQL_Gateway.properties 重命名为 app.properties
    mv $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties $newRELMHome/server/conf/SPARQL_Gateway/app.properties
    SPARQL_Gateway_runtime.properties 重命名为 app_runtime.properties。 (缺省情况下,不存在 SPARQL_Gateway_runtime.properties,但如果您需要配置链接超时设置,可以创建该文件。)
    mv $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway_runtime.properties $newRELMHome/server/conf/SPARQL_Gateway/app_runtime.properties
  7. 部署 relm.warrelmhelp.warvvc.warlqe.warSPARQL_Gateway.war 文件。
    1. 从 WebSphere Application Server 管理控制台中,选择应用程序 > 应用程序类型 > WebSphere 企业应用程序
    2. 企业应用程序页面上,单击安装
    3. 新应用程序的路径中,选择 $newRELMHome/server/webapps/relm.war,然后单击打开
    4. 选择快速路径,然后选择下一步
    5. 接受缺省值,然后单击设置向导中的下一步。在映射 Web 模块的上下文根页面中,输入上下文根 /relm。然后,单击完成
    6. 将出现一条消息,表明已成功安装 relm.war。单击直接保存到主配置
    7. 安装 Rational Engineering Lifecycle Manager 文档 relmhelp.war。使用以上步骤 a-f。使用 $newRELMHome/server/webapps/relmhelp.war 作为路径而 /relmhelp 作为上下文根。
    8. 安装“配置管理”应用程序 vvc.war。使用以上步骤 a-f。使用 $newRELMHome/server/webapps/vvc.war 作为路径而 /vvc 作为上下文根。
    9. Lifecycle Query Engine 设置 WebSphere Application Server,并部署 lqe.war 文件。
    10. 安装 Jazz Reporting Service 应用程序 SPARQL_Gateway.war。使用以上步骤 a-f。将 $newRELMHome/server/webapps/SPARQL_Gateway.war 用于路径。使用 /SPARQL_Gateway 作为上下文根。
    11. 添加 Jazz Reporting Service 库引用。
      1. 转至应用程序 > 应用程序类型 > WebSphere 企业应用程序,然后单击应用程序列表中的 SPARQL_Gateway_war
      2. 引用部分中,单击共享库引用
      3. 选中 SPARQL_Gateway_war 旁边的复选框,然后单击引用共享库
      4. 选择 JRS 共享库,然后单击向右箭头。
      5. 单击确定。然后再次单击确定,以将您所作的设置保存到主配置。
    12. 确保 Jazz Reporting Service 类装入顺序已正确配置。
      1. 转至应用程序 > 应用程序类型 > WebSphere 企业应用程序,然后单击应用程序列表中的 SPARQL_Gateway_war
      2. 详细信息属性部分中,单击类装入和更新检测
      3. 类装入器顺序部分,选择通过本地类装入器装入的类优先(父代最后)
      4. 单击确定,然后单击保存到主配置
    13. 重新启动 WebSphere Application Server。
  8. 如果从 V4.x 升级,请升级 Lifecycle Query Engine

    打开 Lifecycle Query Engine 管理页面 https://relm_host_name:port/lqe/web/admin。 将出现一条消息,表明 Lifecycle Query Engine 升级正在进行中,并且该应用程序不可用。单击启动升级。当升级过程完成时,数据源将可用。

  9. 升级“配置管理”应用程序。
    1. 确保存在包含以下内容的 credentials.txt 文件:adminUserId, adminPassword, repositoryURL, smartCard, certificateFile

      如果此文件不存在,请进行创建。凭证文件示例如下:

      adminUserId=yourAdminUserId
      adminPassword=yourAdminPassword 
      repositoryURL=https://yourserver.com:9443/vvc 
      smartCard=<none>
      certificateFile=<none>
    2. Configuration_Application_install_dir/server 目录运行 repotools-vvc 命令。
      • Linux./repotools-vvc.sh -vvc_online_migrationCommand credentialsFile=credentials.txt fromVersion=<previous_version> logPort=52000 logLevel=DEBUG
      • Windowsrepotools-vvc.bat -vvc_online_migrationCommand credentialsFile=credentials.txt fromVersion=<previous_version> logPort=52000 logLevel=DEBUG
    3. 重新启动 Jazz Team Server
    “配置管理”应用程序 repotools 命令会对正在运行的“配置管理”应用程序发送请求并等待作出响应。如果 repotools-vvc 命令因权限错误而立即停止,请验证服务器是否正在运行以及凭证文件中的用户标识和密码是否正确。
  10. 重新启动应用程序服务器。
    • Linux 运行 stopServer.shstartServer.sh 命令。
    • Windows 运行 stopServer.batstartServer.bat 命令。
  11. 重新启动 Rational Engineering Lifecycle Manager 服务器,以自动将迁移的数据升级为新应用程序版本中所需的格式。此过程称为联机升级。如果您希望看到升级状态页面,请登录。

结果

当联机升级完成时,Web 浏览器将刷新并打开 Rational Engineering Lifecycle Manager“欢迎使用”页面。如果某个升级步骤失败,请检查 relm.log 文件以确定导致故障的原因。如果您在 Rational Engineering Lifecycle Manager 中定义了大量产品,那么联机升级过程需要很长时间(长达几个小时)才能完成。

下一步做什么


反馈