升級與 Apache Tomcat 一起執行的 Rational Engineering Lifecycle Manager

若要升級 Rational® Engineering Lifecycle Manager,請安裝產品新版本,更新配置檔,在現有資料儲存庫中新增或更新表格,然後將現有的資料移轉至 5.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 5.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 Server 資料庫備份過程範例。

    • 請確定您有正確的使用者名稱及密碼。
    • 請確定在開始升級程序之前,您已備份資料庫。
    • 請確認已安裝 Java 資料庫連線功能 (JDBC) 驅動程式,並且您正在使用 sqljdbc4.jar。在 5.0.1 版中,不再支援 JRE 5.0 版。僅支援 JRE 6.0 版和 7.0 版。
    • 請確定已啟動 SQL 服務。
    如需完整指示,請參閱您資料庫供應商所提供的說明文件。
    Oracle 請確定 Oracle JDBC 驅動程式 ojdbc.jar 可從 $newRELMHome/JazzTeamServer/server/oracle 目錄中取得。
  4. 升級「配置管理」應用程式。
    執行 vvc_upgrade Script,以將配置檔和資料庫檔案升級,並重建文字索引。以下是參數範例:
    cd $newRELMHome/server/
    upgrade/vvc/vvc_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
    • 如果升級分散式(多個伺服器)安裝拓蹼,請將下列參數與 vvc_upgrade Script 搭配使用:
      -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
    如果要從 5.0 版升級到 5.0.1 版,請繼續步驟 7。
    如果要從 4.x 版升級到 5.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
    app.propertiesSPARQL_Gateway 移除
    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. 如果您從 4.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 指令立即停止並傳回權限錯誤,請驗證伺服器是否正在執行並且認證檔中的使用者 ID 與密碼是否正確。
  10. 重新啟動 Tomcat 伺服器。
  11. 重新啟動您的 Rational Engineering Lifecycle Manager 伺服器,以自動將移轉的資料升級為新應用程式版本中所需的格式。此程序名為線上升級。如果您要查看升級狀態頁面,請登入。

結果

線上升級成功後,Web 瀏覽器會重新整理並開啟 Rational Engineering Lifecycle Manager 歡迎使用頁面。如果升級步驟失敗,請檢查 relm.log 檔以判斷失敗原因。如果您在 Rational Engineering Lifecycle Manager 中定義了許多產品,則完成線上升級需要很長的時間(長達數小時)。

下一步


意見