升级与 Apache Tomcat 一起运行的 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. 停止旧的 Tomcat 服务器。
  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
    提示: 还可将“配置管理”应用程序随 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. 启动 Apache Tomcat 服务器。
  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. 重新启动 Tomcat 服务器。
  11. 重新启动 Rational Engineering Lifecycle Manager 服务器,以自动将迁移的数据升级为新应用程序版本中所需的格式。此过程称为联机升级。如果您希望看到升级状态页面,请登录。

结果

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

下一步做什么


反馈