這個主題說明如何手動執行伺服器的離線移轉升級步驟,從 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"。
程序
- 檢閱瞭解部署及升級程序主題。
另外,也請依照需要檢閱下列各節中的主題:規劃部署與升級。
重要: - 原始 RM 第 2 版環境定義根目錄 (/rdm) 和所有 RM 構件的 URI 都會保留下來。
Jazz™ Team Server 的環境定義根目錄將從 /jazz 變更為 /jts。
- 如果您在第 2 版安裝架構中設定公用 URI,在 3.0.1 版中,您必須使用相同的公用 URI。
- 確認您的軟硬體符合或超出您的應用程式需求下限。
請參閱系統需求。在現有第 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
- 在 Jazz.net 中,下載 IBM Rational Requirements Composer 軟體及 Rational Collaborative Lifecycle Management (CLM) 解決方案中其他要安裝的應用程式。
如需指示,請參閱下載產品安裝媒體。
- 停止 IBM Rational Requirements Composer 第 2 版伺服器。
- 將 IBM Rational Requirements Composer 第 2 版資料庫和 teamserver.properties 檔備份到某個暫時位置。
teamserver.properties 檔包含資料庫位置,每個應用程式連接資料庫時,都需要資料庫位置。
依預設,這個檔案是在第 2 版的 InstallDir\server\conf\jazz\teamserver.properties 檔中。如需備份指示,請參閱下列主題:
- 從現有的 IBM Rational Requirements Composer 第 2 版資料庫匯出資料。
- 切換至 IBM Rational Requirements Composer 第 2 版 RRC2InstallDir\server 目錄。
- 執行 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 檔的名稱。
- 如果您已安裝 Jazz Team
Server 3.0.1 版,請停止所有 3.0.1 版伺服器,其中包括 Jazz Team
Server 及其他 CLM 應用程式,然後備份您的 Jazz Team
Server 3.0.1 版資料庫和環境。
跳到步驟 10。
- 如果您還沒有安裝 Jazz Team
Server 3.0.1 版,請安裝 Jazz Team
Server。請勿執行設定精靈。
- 如果您還沒有安裝 Jazz Team
Server 3.0.1 版,且您使用的資料庫不是預設的 Derby 資料庫,您必須建立 Jazz Team
Server 資料庫。
Jazz Team
Server 和資料倉儲都需要資料庫。
您不需要建立「需求管理」應用程式的資料庫,因為這個應用程式利用 Jazz Team
Server 資料庫來儲存資料。
如需每一個資料庫的詳細資料,請參閱設定資料庫中的主題。
- 將「需求管理」應用程式安裝於另一部機器。如需指示,請參閱利用 IBM Installation Manager 安裝。
在安裝期間,請選取使用 Rational Requirements Composer 2.x 環境定義根目錄。
這會設定必要的選項來安裝 RM 應用程式,以保留 RM /rdm 第 2 版環境定義根目錄,從而保留通往 RM 構件的鏈結。
如果您沒有選取這個選項,升級會失敗。
如需詳細資料,請參閱瞭解部署及升級程序。
- 安裝結束時,對於您想啟動哪一個程式,請選取無,按一下完成,然後按一下結束。
- 如果您是部署於 WebSphere Application Server,請停止及解除安裝下列第 2 版 .war 檔:converter.war、jazz.war、rrc-help.war 和 rdm.war。
如需相關資訊,請參閱第 3 版升級期間設定 WebSphere Application Server。
- 從您安裝 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。
- 利用 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 變更。
- 驗證您的儲存庫資料和配置檔。
如需詳細資料,請參閱在升級期間驗證配置檔。
- 離線移轉完成之後,請先將 Jazz Team
Server 3.0.1 版資料庫和環境備份到第 2 版資料庫備份位置以外的位置。
請先備份,再繼續進行線上移轉。
請勿改寫您的第 2 版資料庫備份。
- 如果您已建立安全憑證來搭配舊版使用,請複製憑證,或者新建一個。
如需詳細資料,請參閱配置安全憑證。
- 如果您以 Windows 服務形式來執行 Tomcat 應用程式伺服器,則必須將服務移除再重新安裝。如需指令語法,請參閱以 Windows 服務形式(32 位元)在 Apache Tomcat 中執行。
- 如果您是部署在 IBM WebSphere Application Server,請部署 3.0 WAR 檔,並將安全角色對映至使用者或群組。如需詳細資料,請參閱第 3 版升級期間設定 WebSphere Application Server和將 CLM 應用程式部署在 WebSphere Application Server 上。
- 備份完成之後,請繼續線上移轉的步驟。請參閱線上移轉的升級步驟。