rm_upgrade

請利用這個 Script 來升級 Rational Requirements Composer。

用途

rm_upgrade Script 會將「需求管理」應用程式 3.0.1.x 升級至 4.0。雖然 Script 檔位於 upgrade/rm 目錄之下,您必須從 RM_4.0_InstallDir/server 目錄來執行它。另外,如果您的路徑包含空格,請務必用雙引號括住路徑名稱。

除了執行 Script 和其所有指令行引數,另一種替代作法是開啟 Script 的參數檔,修改預設值,然後執行縮寫形式的指令行。

rm_params 檔的英文及翻譯版在 RM_4.0_InstallDir/server/upgrade/rm/params 目錄中。開啟 rm_params 或它的翻譯版來進行編輯,指定每個參數的值。 OLD_APPLICATION_HOME 目錄路徑是必須設定的參數之一。這必須是現有目錄,且結尾是 server/conf。

Script 會執行下列作業:
  • 執行 -migration_rm_updateConfigurationFiles 指令來更新配置和 Tomcat 檔案。
  • 根據舊版的資訊更新 teamserver.properties 檔。
  • 複製 friendsconfig.rdf 檔案。
  • 在 Tomcat 環境中,合併 server.xml 和 web.xml 檔案的內容與新版本。
  • 將表格新增至 RM 儲存資料庫。

參數

屬性 說明 必要 預設值
oldApplicationHome RM 3.0.1.x 版伺服器配置目錄的完整路徑。路徑不能包含任何空格。 是 RM_3.0.1.x_InstallDir/server/conf
applicationContextRoot RM 環境定義根目錄。 否 rdm
oldJTSHome 3.0.1.x 或 3.0.1 安裝架構的 JTS 伺服器配置目錄的完整路徑。 依預設,oldJTSHome 參數是從 oldApplicationHome 參數值衍生而來。 否 none
oldJTSContextRoot 3.0.1.x 版伺服器的 JTS 環境定義根目錄。 否 jazz
updateTomcatFiles 是否更新 Tomcat 配置檔。如果您使用 WebSphere Application Server,請將這個值設為 "no"。 否 yes
oldApplicationTomcatHome 3.0.1.x 版安裝架構 RM Tomcat 起始目錄的完整路徑。依預設,oldApplicationTomcatHome 參數是從 oldApplicationHome 參數值衍生而來。 否 none
oldJTSTomcatHome 3.0.1.x 版安裝架構 JTS Tomcat 起始目錄的完整路徑。依預設,oldJTSTomcatHome 參數是從 oldJTSHome 參數值衍生而來。 否 none
newApplicationHome 4.0 安裝架構的 RM 伺服器配置目錄路徑。 否 RM_4.0_InstallDir/server/conf
newJTSHome 4.0 安裝架構的 JTS 伺服器配置目錄的完整路徑。 依預設,newJTSHome 參數值是從 newApplicationHome 參數值衍生而來。 否 none
newJTSContextRoot 4.0 JTS 伺服器的環境定義根目錄。 否 jts
jtsURL JTS 的公用 URL。 依預設,JTS 公用 URL 是從應用程式的公用 URL 衍生而來。 這個參數必須指定在 JTS 與 RM 應用程式分別執行於不同伺服器實例的分散式部署中。 否 none
newApplicationTomcatHome 4.0 安裝架構的 RM Tomcat 起始目錄路徑。依預設,newApplicationTomcatHome 參數值是從 newApplicationHome 參數值衍生而來。 否 none
newJTSTomcatHome 4.0 安裝架構的 JTS Tomcat 起始目錄路徑。依預設,newJTSTomcatHome 參數值衍生自 newJTSHome 參數值。 否 none
createJTSTables 匯入 RM 資料時,是否建立 JTS 表格。 否 N/A
ignoreJTSVersionCheck 請勿嘗試驗證應用程式版本是否相容於在 newJTSHome 的 JTS 版本。 這個引數只應該用在分散式部署中,JTS 是在應用程式系統無法存取的系統上。 否 N/A
noPrompt 在建立或修改表格之前,不先提示。 否 N/A
noVerify 不執行 teamserver.properties 檔驗證。 否 N/A
overwrite 是否改寫任何現有的檔案。 否 no
noStepPrompt 執行步驟之前不先提示。 否 N/A

範例

For Windows operating system
upgrade\rm\rm_upgrade.bat -oldApplicationHome "C:\Program Files\IBM\RM_3.0.1.x\server\conf"
For Unix operating systems
./upgrade/rm/rm_upgrade.sh -oldApplicationHome opt/IBM/RM_3.0.1.x/server/conf

意見