升級與 WebSphere Application Server 一起執行的 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. 配置您的應用程式伺服器。
    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. 登入「WebSphere Application Server Integrated Solutions 主控台」,位置如下:https://host_name:9043/ibm/console/logon.jsp
      3. 按一下應用程式 > 應用程式類型 > WebSphere 企業應用程式
      4. 停止及解除安裝下列應用程式:relm.war, relmhelp.war, vvc.war, lqe.war, SPARQL_Gateway.war
      5. 系統提示時,請儲存對主要配置所做的變更。
    4. 更新 JAZZ_HOMElog4j.configuration 自訂內容。
      1. 登入「WebSphere Application Server Integrated Solutions 主控台」,位置如下:https://host_name:9043/ibm/console/logon.jsp
      2. 按一下伺服器 > 伺服器類型 > WebSphere 應用程式伺服器
      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 日誌目錄。
      移至每一部應用程式伺服器,並從設定檔的日誌目錄中移除 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 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
    • 若要跳過 Tomcat 升級,請將下列參數新增至 vvc_upgrade Script:
      -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
    如果要從 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. 部署 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. 如果您從 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. 重新啟動您的應用程式伺服器。
    • Linux 執行 stopServer.shstartServer.sh 指令。
    • Windows 執行 stopServer.batstartServer.bat 指令。
  11. 重新啟動您的 Rational Engineering Lifecycle Manager 伺服器,以自動將移轉的資料升級為新應用程式版本中所需的格式。此程序名為線上升級。如果您要查看升級狀態頁面,請登入。

結果

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

下一步


意見