使用升級 Script 來離線升級至 3.0.1

這個主題說明如何利用 rm_upgrade Script,將 IBM® Rational® Requirements Composer 第 2 版升級至 3.0.1 版。

開始之前

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

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

重要: 如果要在將「需求管理 (RM)」應用程式和 Jazz™ Team Server 分開安裝的分散式環境中使用升級 Script,升級 Script 必須能夠存取安裝了 RM 的磁碟機或檔案系統。 例如,在 Windows 上,裝載格式必須如下:mounted drive letter:\server\conf。 絕對路徑(如 \\<machine name>\JTS301InstallDir\server\conf)無法運作。 裝載的磁碟機必須以管理者帳戶的讀寫執行專用權來配置。

如果您使用單一伺服器部署,或使用分散式部署,且能夠從 Jazz Team Server 和「需求管理」裝載磁碟機,您可以遵循這些使用升級 Script 的升級指示。

如果您使用分散式網路部署且不得裝載磁碟機,或您是進階管理者且打算手動完成各個步驟,您可以遵循手動離線升級至 3.0.1指示。 手動步驟會詳述這些 Script 在執行什麼。

在 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. 執行離線升級 Script。從 Jazz Team Server 3.0.1 版的安裝位置中,開啟一個新的指令視窗,導覽至 JTS301InstallDir\server,然後執行 upgrade\rm_upgrade.bat 升級 Script (Windows) 或 upgrade/rm_upgrade.sh 升級 Script(AIX 或 Linux 系統)。 當 Script 執行時,它會使用電腦語言環境的語言設定。
    註: 您可以在指令行中指定所有引數來執行 Script。 另一種方法是,如果您會重新執行升級 Script 許多次,您也可以編輯 Script 參數檔,然後執行縮寫的指令行。 請參閱步驟 14,以取得參數檔的指示。
    重要:
    • 雖然這個 Script 檔是在 upgrade 目錄之下,但它必須從 server 目錄執行。另外,如果您的路徑包含空格,請務必用雙引號括住路徑名稱。
    • 如果您在 Rational Requirements Composer 第 2 版中使用浮動授權,會有一個已知的問題,從 IBM Rational Requirements Composer 第 2 版資料庫匯入資料之前,您可能需要停止升級 Script,啟動 Jazz Team Server,以及安裝 3.0.1 版浮動授權。 如需如何執行這個動作的相關資訊,請參閱https://jazz.net/library/article/659。

    如果您已將 Jazz Team Server 3.0.1 版與 RM 應用程式安裝在一起,且這項升級是針對您要升級的第一個或唯一應用程式,指令語法如下:

    Windows:

    upgrade\rm_upgrade.bat -oldApplicationHome RRC2InstallDir\server\conf -importFromFile c:\tmp\export.tar -createJTSTables 

    AIX 或 Linux:

    ./upgrade/rm_upgrade.sh -oldApplicationHome RRC2InstallDir/server/conf -importFromFile /tmp/export.tar -createJTSTables 
    註: -createJTSTables 參數適用於您第一次安裝 Jazz Team Server 3.0.1 版和任何 Collaborative Lifecycle Management 產品的安裝架構。如果您單獨安裝 RM 應用程式,就不需要在指令中併入這個參數,因為 Jazz Team Server 3.0.1 版位於其他位置。 createTables 參數會建立 Jazz Team Server 資料庫,匯入 .tar 檔的內容。如果已有現有的 Jazz Team Server 資料庫,請不要在指令行中包含 createTables 參數,因為這會改寫現有的資料庫。

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

    Windows:

    JTS301InstallDir\server upgrade\rm_upgrade.bat -oldApplicationHome RRCS2InstallDir\server\conf -importFromFile c:\tmp\export.tar -newApplicationHome RRC301InstallDir\server\conf -jtsURL https://fully qualified domain name:port/jts

    AIX 或 Linux:

    JTS301InstallDir/server ./upgrade/rm_upgrade.sh -oldApplicationHome RRCS2InstallDir/server/conf -importFromFile /tmp/export.tar -newApplicationHome RRC301InstallDir/server/conf -jtsURL https://fully qualified domain name:port/jts
    註:
    • 如果您有分散式部署,且還沒有配置 Jazz Team Server 3.0.1 版,您可以新增 -createJTSTables 參數到上述指令行範例中。
    • -jtsURL 參數是 Jazz Team Server 的公用 URI。 依預設,Jazz Team Server 公用 URI 是從應用程式的公用 URI 衍生而來。 這個參數必須指定在 Jazz Team Server 與 RM 應用程式分別執行於不同伺服器實例的分散式部署中。

    如需指令行選項的詳細資料,請輸入下列指令之一:

    Windows:upgrade\rm_upgrade.bat -help

    AIX 或 Linux:./upgrade/rm_upgrade.sh -help

    由於要移轉的資訊量,離線移轉可能需要較長的時間來完成。
    小心: 離線移轉期間,您必須檢閱顯示合併檔案內容的提示,具體地說,就是 teamserver.properties 檔中指定的資料庫連線,必要的話,請編輯合併的檔案。

    這個 Script 會完成下列作業:

    1. 依照下列方式,更新 3.0.1 版配置檔:
      • 執行 -migration_rm_updateConfigurationFiles 指令及更新配置和 Tomcat 檔。 請輸入 [E] 來執行指令,輸入 [S] 來跳過步驟,或按一下 [Enter] 鍵來取消執行 Script。
        重要: 請勿修改連接資料倉儲資料庫的內容,即使它們目前設為 Derby 也一樣。 請只用伺服器設定精靈來修改這些內容。
        註: 如果您還沒有安裝 Jazz Team Server 3.0.1 版,這時您必須輸入先前在步驟 9 所建立的新的 Jazz Team Server 資料庫之資料庫位置內容。
      • 順利合併配置檔之後,請輸入 [C],繼續作業。 這時會開啟一個「記事本」視窗(或 AIX 或 Linux 系統的 vi 編輯器),供您驗證 Jazz Team Server teamserver.properties 檔。 請確認 com.ibm.team.repository.server.webapp.url 內容所表示的「公用 URI 根目錄」正確。 另外,也請確認資料庫內容正確。 完成之後,如果有任何變更,請儲存變更,然後關閉編輯器,繼續執行 Script。
      • 複製第 2 版 Tomcat 使用者 .xml 檔。
      • 將第 2 版 friendsconfig.rdf 檔與 3.0.1 版合併,這個檔案含有設定要跨儲存庫進行整合的伺服器清單。
      • 將第 2 版 server.xml 和 web.xml(LDAP 設定)的內容,與第 3.0.1 版合併。
    2. 利用 repotools-jts -import Windows 指令或 ./repotools-jas.sh -import AIX 或 Linux 指令,將匯出的 RM 第 2 版資料從 .tar 檔匯入到 Jazz Team Server 3.0.1 版資料庫中。
      註:
      • 匯入「需求管理」應用程式 3.0.1 版的大型儲存庫,可能造成 OutOfMemoryException 錯誤。 如果您有大量專案和構件,請將 repotools-jts.bat 或 repotools-jts.sh Script 中的 -Xmx 參數,從預設值 1500M 增加為較高的值。 為取得最佳結果,如果機器有足夠的記憶體,請採用 4096M。
      • 如果要檢視詳細的 Rational Requirements Composer 配置檔變更清單,請參閱 Rational Requirements Composer 變更。
  14. 選用項目:上一步驟還有另一個方式,您可以開啟 Script 參數檔,修改預設值,然後執行縮寫形式的指令行。如需這些值的詳細資料,請參閱rm_upgrade。

    參數檔的英文和翻譯版是在 JazzInstallDir\server\upgrade\params\rm_params.bat 目錄 (Windows) 或 ./params/rm_params.sh 目錄(AIX 或 Linux 系統)中。

    1. 如果要取得您的語言的參數檔確切名稱,請從 JazzInstallDir\server\upgrade 目錄中,執行 locale.bat -rm -showParamFileName 指令 (Windows) 和 ./locale.sh -rm -showParamFileName 指令(AIX 或 Linux 系統)。
    2. 開啟 rm_params 檔或它的翻譯版來進行編輯,指定每個參數的值。 OLD_APPLICATION_HOME 目錄路徑是必須設定的參數。 請確定路徑未包含任何空格。 不過,如果有任何檔名或檔案路徑參數包含空格,您必須用雙引號括住參數。 例如,設定 OLD_APPLICATION_HOME="C:\Program Files\IBM\RRCS2002\server\conf"。 請參閱 JazzInstallDir\server\upgrade\doc\rm_help.txt 檔,以取得每個參數的相關資訊。
  15. 確認已更新您的儲存庫資料和配置檔。 如需詳細資料,請參閱在升級期間驗證配置檔和-migration_rm_updateConfigurationFiles。
  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。
  20. 備份完成之後,請繼續線上移轉的步驟。請參閱線上移轉的升級步驟。
    註: Jazz.net 程式庫中關於升級 Rational Requirements Composer 的最新項目
上層主題: 升級 Rational Requirements Composer
相關概念:
移轉升級限制
Rational Requirements Composer 2.0 至 3.0.1 升級程序範例
全分散式 Rational Requirements Composer 第 2 版至 3.0.1 版企業拓蹼範例
授權管理概觀

意見