升級 Rational Engineering Lifecycle Manager

如果要將 Rational® Engineering Lifecycle Manager 的版本升級到最新版本,您會並列安裝新的版本。

開始之前

如果您正在更新與 Rational Engineering Lifecycle Manager 整合的產品,請確保遵循 升級 Rational Engineering Lifecycle Manager 產品堆疊 中的指引

程序

  1. 利用安裝 Rational Engineering Lifecycle Manager 和生命週期查詢引擎中的指示來安裝 Rational Engineering Lifecycle Manager 將安裝下列產品:
    • Rational Engineering Lifecycle Manager 4.0.6 版
    • Jazz™ Team Server 4.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 <用來建立設定檔備份的新壓縮檔路徑> <WAS 主要管理使用者名稱> <WAS 管理密碼>
      例如,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 Integrated Solutions 主控台」, 位置如下: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 Integrated Solutions 主控台」, 位置如下:https://hostname:9043/ibm/console/logon.jsp
      2. 按一下伺服器>伺服器類型>WebSphere 應用程式伺服器
      3. 按一下伺服器名稱來開啟它。預設伺服器名稱是 server1。
      4. 伺服器基礎架構區段之下,按一下 Java 和程序管理 > 程序定義
      5. 其他內容之下,按一下 Java 虛擬機器
      6. 將「生命週期查詢引擎」和 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 (for example: C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
      WAS_profile_root\temp (for example: C:\Program Files\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)
    6. 清除日誌目錄。 移至每一部應用程式伺服器, 並從設定檔的日誌目錄中移除 Rational Engineering Lifecycle Manager 相關日誌。一般日誌目錄可能如下: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 Script 來升級「配置管理」應用程式。 這會將配置檔和資料庫檔案升級,並重建文字索引。如需如何升級「配置管理」應用程式的詳細說明,請參閱下列位置的升級手冊:配置管理的互動式升級手冊。適用 Linux 的參數範例為:
    cd $newRELMHome/server/
    upgrade/vvc/vvc_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
    • 如果您要升級分散式(多部機器)安裝拓蹼,您必須新增下列參數到 vvc_upgrade Script 中:-oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck
    • 如果您使用 WebSphere Application Server, 您必須新增參數到 vvc_upgrade Script 中, 告訴它不要將 Tomcat 升級:-oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck -updateTomcatFiles=no
    註: 「配置管理」應用程式也可以隨 Rhapsody® Design Manager 一起安裝。當您安裝 Rational Engineering Lifecycle 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 Script 中的舊版參數,才能執行升級 Script。在下列的位置可以找到此參數和其他可用參數的說明:relm_upgrade Script 參照
  6. 「生命週期查詢引擎」和 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

下一步

升級所有必要的軟體之後,「生命週期查詢引擎」可能需要重新編製其內容的索引。4.0.3 中已將新詞彙新增到「生命週期查詢引擎」中,如果您想要 Rational Engineering Lifecycle Manager 使用這些詞彙所包含的資料,您需要重新編製應用程式的索引。
表 1. 重新編製索引需求概觀(依產品)
產品 1.x 版至 4.0.6 版 4.0.3 版至 4.0.6 版 4.0.4 版至 4.0.6 版 4.0.5 版至 4.0.6 版
Rational Team Concert™ 需要重新編製索引 不需要重新編製索引 不需要重新編製索引 不需要重新編製索引
Rational Quality Manager 需要重新編製索引 建議重新編製索引。所有 QM 資源新增了 oslc:shortld 內容。如果您要在任何查詢中使用此內容,則必須重新編製索引。 不需要重新編製索引 不需要重新編製索引
Rhapsody Design Management 不需要重新編製索引,但是可移除重複的索引項目,協助改良效能。如果查詢要使用新資料,請重新編製索引。 不需要重新編製索引 不需要重新編製索引 不需要重新編製索引
Rational DOORS® 強烈建議重新檢索正式作業資料。如果您已針對 mailto URI 建立查詢,則建議重新檢索。 建議重新檢索正式作業資料。如果您已針對 mailto URI 建立查詢,則建議重新檢索。 不需要重新編製索引。 不需要重新編製索引。
Rational DOORS Next Generation 不適用 不適用 不需要重新編製索引 不需要重新編製索引
Rational Engineering Lifecycle Manager 需要重新編製索引 需要重新編製索引 需要重新編製索引 需要重新編製索引
Jazz Team Server 使用者 TRS (jts/trsUsers) 需要重新編製索引。 不需要重新編製索引 不需要重新編製索引 不需要重新編製索引

意見