手動離線升級至 3.0.1

這個主題說明如何手動執行伺服器的離線移轉升級步驟,從 IBM® Rational® Requirements Composer 第 2 版升級至 3.0.1 版。

開始之前

開始升級之前,請確定已利用「網路時間通訊協定 (NTP)」,將所有機器上的時鐘同步化。 時間是重要的元素,可讓某個網路節點上的事件,對映到另一個節點上的對應事件。 您可以利用 NTP 服務的企業部署來克服這些挑戰。如需 NTP 的相關資訊,請造訪 http://www.ntp.org/。此外,所有伺服器必須使用相同的鑑別方法來鑑別其使用者。

如果您計劃要升級多個產品,請參閱升級順序,以協助您決定要先升級的產品。

在 IBM WebSphere® Application Server 環境中,將安裝路徑變更為一個沒有包含空格的路徑,例如 C:\IBM\JazzTeamServer。 不過,如果有任何檔名或檔案路徑參數包含空格,您必須用雙引號括住參數。 例如,"C:\Program Files\IBM"。

程序

  1. 檢閱瞭解部署及升級程序主題。 另外,也請依照需要檢閱下列各節中的主題:規劃部署與升級。
    重要:
    • 原始 RM 第 2 版環境定義根目錄 (/rdm) 和所有 RM 構件的 URI 都會保留下來。 Jazz™ Team Server 的環境定義根目錄將從 /jazz 變更為 /jts。
    • 如果您在第 2 版安裝架構中設定公用 URI,在 3.0.1 版中,您必須使用相同的公用 URI。
  2. 確認您的軟硬體符合或超出您的應用程式需求下限。 請參閱系統需求。在現有第 2 版的 teamserver.properties 檔中,擷取下列資訊:
    • 公用 URI 內容 - com.ibm.team.repository.server.webapp.url
    • 用來連接資料庫伺服器的資訊,通常是 com.ibm.team.repository.db.vendor、com.ibm.team.repository.db.jdbc.location 和 com.ibm.team.repository.db.jdbc.password。

    在 3.0.1 版中,您必須使用相同的公用 URI。 如果沒有設定公用 URI,在升級之前,請利用第 2 版管理 Web 介面(進階內容)來設定完整主機名稱 URI (https://hostname.example.com:port)。

    teamserver.properties 檔中的公用 URI 行應該看起來類似於這個範例:
    com.ibm.team.repository.server.webapp.url=https\://<hostname.example.com>\:9443/jazz
  3. 在 Jazz.net 中,下載 IBM Rational Requirements Composer 軟體及 Rational Collaborative Lifecycle Management (CLM) 解決方案中其他要安裝的應用程式。 如需指示,請參閱下載產品安裝媒體。
  4. 停止 IBM Rational Requirements Composer 第 2 版伺服器。
  5. 將 IBM Rational Requirements Composer 第 2 版資料庫和 teamserver.properties 檔備份到某個暫時位置。 teamserver.properties 檔包含資料庫位置,每個應用程式連接資料庫時,都需要資料庫位置。 依預設,這個檔案是在第 2 版的 InstallDir\server\conf\jazz\teamserver.properties 檔中。如需備份指示,請參閱下列主題:
    • 備份和還原 Derby 資料庫
    • 備份及還原其他受支援的資料庫
    • 備份及還原 Jazz Team Server(如果要新增「需求管理」應用程式到現有的 Jazz Team Server 中。)
  6. 從現有的 IBM Rational Requirements Composer 第 2 版資料庫匯出資料。
    1. 切換至 IBM Rational Requirements Composer 第 2 版 RRC2InstallDir\server 目錄。
    2. 執行 repotools -export Windows 指令或 ./repotools.sh - export AIX® 或 Linux 系統指令,將檔案儲存在 IBM Rational Requirements Composer 目錄結構之外,如下列 2.0.1 版範例所示:

    Windows:repotools -export toFile=c:\tmp\rrcdata.tar

    AIX 或 Linux:repotools -export toFile=/tmp/rrcdata.tar

    其中 toFile 變數指定匯出資料庫時,目標 .tar 檔的名稱。

    註:
    • 在儲存庫移轉入門和 Repotools 指令行參照中,有 repotools 指令的詳細使用指示。 請務必使用您現有第 2 版產品隨附的 repotools 版本。
    • Jazz.net 的內容遵循 Jazz.net 使用條款,依現狀提供,沒有任何保證。
  7. 如果您已安裝 Jazz Team Server 3.0.1 版,請停止所有 3.0.1 版伺服器,其中包括 Jazz Team Server 及其他 CLM 應用程式,然後備份您的 Jazz Team Server 3.0.1 版資料庫和環境。 跳到步驟 10。
  8. 如果您還沒有安裝 Jazz Team Server 3.0.1 版,請安裝 Jazz Team Server。請勿執行設定精靈。
  9. 如果您還沒有安裝 Jazz Team Server 3.0.1 版,且您使用的資料庫不是預設的 Derby 資料庫,您必須建立 Jazz Team Server 資料庫。

    Jazz Team Server 和資料倉儲都需要資料庫。 您不需要建立「需求管理」應用程式的資料庫,因為這個應用程式利用 Jazz Team Server 資料庫來儲存資料。 如需每一個資料庫的詳細資料,請參閱設定資料庫中的主題。

    註: 如果您使用 Oracle 或 SQL Server 資料庫,請務必將資料庫驅動程式複製到正確位置。如需詳細資料,請參閱設定 Oracle 資料庫和設定 SQL Server 資料庫。
  10. 將「需求管理」應用程式安裝於另一部機器。如需指示,請參閱利用 IBM Installation Manager 安裝。

    在安裝期間,請選取使用 Rational Requirements Composer 2.x 環境定義根目錄。 這會設定必要的選項來安裝 RM 應用程式,以保留 RM /rdm 第 2 版環境定義根目錄,從而保留通往 RM 構件的鏈結。 如果您沒有選取這個選項,升級會失敗。 如需詳細資料,請參閱瞭解部署及升級程序。

  11. 安裝結束時,對於您想啟動哪一個程式,請選取無,按一下完成,然後按一下結束。
  12. 如果您是部署於 WebSphere Application Server,請停止及解除安裝下列第 2 版 .war 檔:converter.war、jazz.war、rrc-help.war 和 rdm.war。 如需相關資訊,請參閱第 3 版升級期間設定 WebSphere Application Server。
  13. 從您安裝 Jazz Team Server 3.0.1 版的位置開啟一個新的指令視窗,導覽至 JTS301InstallDir\server,然後利用下列指令,將第 2 版與 3.0.1 版的配置檔合併起來:repotools-jts -migration_rm_updateConfigurationFiles oldApplicationHome=RRCS20InstallDir/server/conf。

    如果您將 Jazz Team Server 3.0.1 版與 RM 應用程式分開安裝,例如在分散式部署中,您必須指定 RM 應用程式的位置,然後從 Jazz Team Server 3.0.1 版安裝目錄執行 Script。 在這個情況下,請併入 newApplicationHome 引數。

    repotools-jts -migration_rm_updateConfigurationFiles
    oldApplicationHome=RRC2InstallDir/server/conf newApplicationHome=<JTS301_install_dir>/server/conf -jtsURL https://<fully qualified domain name>:<port>/jts
    註: -jtsURL 參數是 Jazz Team Server 的公用 URI。 依預設,Jazz Team Server 公用 URI 是從應用程式的公用 URI 衍生而來。 這個參數必須指定在 Jazz Team Server 與 RM 應用程式分別執行於不同伺服器實例的分散式部署中。

    這個指令會完成下列作業:

    • 根據第 2 版 Jazz JazzInstallDir/server/conf/jazz/teamserver.properties 檔的資訊來更新第 3 版的 JazzInstallDir/server/conf/app/teamserver.properties 檔。 您將有機會編輯 Jazz Team Server 資料庫位置內容之類的各個值,它們是 Script 無法從第 2 版取得的資訊。
      註: 如果您還沒有安裝和配置 Jazz Team Server 3.0.1 版,這時您必須輸入先前在步驟 9 所建立之新 Jazz Team Server 資料庫的資料庫位置內容。
    • 複製第 2 版 Tomcat 使用者 .xml 檔。
    • 將第 2 版 friendsconfig.rdf 檔與 3.0.1 版合併,這個檔案含有設定要跨儲存庫進行整合的伺服器清單。
    • 將第 2 版 server.xml 和 web.xml(LDAP 設定)的內容,與第 3.0.1 版合併。

    如需其他詳細資料,請參閱合併配置檔與 -migration_updateConfigurationFiles。

  14. 利用 repotools-jts -importapplicationdata 指令,從匯出的第 2 版儲存庫,將 Rational Requirements Composer 資料匯入到新的第 3 版「需求管理 (RM)」儲存庫中,如下列範例所示:
    repotools-jts migration_importapplicationdata fromFile=c:\export.tar

    其中 fromFile 變數指定匯入儲存庫時的來源 .tar 檔名稱。

    註:
    • 如果這是 Jazz Team Server 和任何 Collaborative Lifecycle Management 產品的新安裝,若是第一次將使用者資料匯入到 Jazz Team Server,您可以在指令鏈結中包含 createTables 參數。createTables 參數會建立 Jazz Team Server 資料庫,匯入 .tar 檔的內容。如果已有現有的 Jazz Team Server 資料庫,請不要在指令行中包含 createTables 參數,因為這會改寫現有的資料庫。
    • 如果您在 IBM Rational Requirements Composer 第 2 版中使用浮動授權,會有一個已知的問題,從 IBM Rational Requirements Composer 第 2 版資料庫匯入資料之前,您可能需要停止升級 Script,啟動 Jazz Team Server,以及安裝 3.0.1 版浮動授權。 如需如何執行這個動作的相關資訊,請參閱https://jazz.net/library/article/659。
    • 匯入「需求管理」3.0.1 版的大型儲存庫,可能造成 OutOfMemoryException 錯誤。 如果您有大量專案和構件,請將 repotools-jts.bat 或 repotools-jts.sh Script 中的 -Xmx 參數,從預設值 1500M 增加為較高的值。 為取得最佳結果,如果機器有足夠的記憶體,請採用 4096M。
    • 如果要檢視詳細的 Rational Requirements Composer 配置檔變更清單,請參閱 Rational Requirements Composer 變更。
  15. 驗證您的儲存庫資料和配置檔。 如需詳細資料,請參閱在升級期間驗證配置檔。
  16. 離線移轉完成之後,請先將 Jazz Team Server 3.0.1 版資料庫和環境備份到第 2 版資料庫備份位置以外的位置。 請先備份,再繼續進行線上移轉。 請勿改寫您的第 2 版資料庫備份。
  17. 如果您已建立安全憑證來搭配舊版使用,請複製憑證,或者新建一個。 如需詳細資料,請參閱配置安全憑證。
  18. 如果您以 Windows 服務形式來執行 Tomcat 應用程式伺服器,則必須將服務移除再重新安裝。如需指令語法,請參閱以 Windows 服務形式(32 位元)在 Apache Tomcat 中執行。
  19. 如果您是部署在 IBM WebSphere Application Server,請部署 3.0 WAR 檔,並將安全角色對映至使用者或群組。如需詳細資料,請參閱第 3 版升級期間設定 WebSphere Application Server和將 CLM 應用程式部署在 WebSphere Application Server 上。
  20. 備份完成之後,請繼續線上移轉的步驟。請參閱線上移轉的升級步驟。
    註: Jazz.net 程式庫中關於升級 Rational Requirements Composer 的最新項目
上層主題: 升級 Rational Requirements Composer
相關概念:
移轉升級限制
Rational Requirements Composer 2.0 至 3.0.1 升級程序範例
全分散式 Rational Requirements Composer 第 2 版至 3.0.1 版企業拓蹼範例
授權管理概觀

意見