這個主題說明將 Jazz Team Server 以及「變更與配置管理」從 3.0 版升級至 3.0.1 版的必要步驟。
開始之前
在升級伺服器之前,請確定您有 Rational Team Concert 和 Jazz Team Server 3.0 版儲存資料庫的完全最新有效備份。
另外,也請確定已利用「網路時間通訊協定 (NTP)」,將所有機器上的時鐘同步化。
時間是重要的元素,可讓某個網路節點上的事件,對映到另一個節點上的對應事件。
為了避免發生問題,可利用 NTP 服務的企業部署來克服這些挑戰。如需 NTP 的相關資訊,請造訪 http://www.ntp.org/。此外,所有伺服器必須使用相同的鑑別方法來鑑別其使用者。
如果您計劃要升級多個產品,請參閱升級順序,以協助您決定要先升級的產品。
重要: 如果要在將「變更與配置管理」應用程式和 Jazz Team Server 分開安裝的分散式環境中使用升級 Script,升級 Script 必須能夠存取安裝了 Jazz Team Server 的磁碟機或檔案系統。
例如,在 Windows 上,對映格式必須如下:<mapped drive letter>:\server\conf。
絕對路徑 (\\<machine name>\<installdir>server\conf) 無法運作。
裝載的磁碟機必須以管理帳戶的讀寫執行專用權來配置。
如果您使用 Derby 資料庫,請將 JTS 和 CCM 資料庫從 3.0 版複製到 3.0.1 版。如需相關資訊,請參閱
備份和還原 Derby 資料庫。
註: 如果您利用相同的資料庫,就不需要移轉資料。
但如果在升級時切換資料庫,您就必須從先前的資料庫匯出資料,將它匯入新的資料庫中。
升級 Jazz Team Server (JTS)
- 依照需要,檢閱規劃部署與升級相關章節中的各個主題。
- 關閉 JTS 3.0 伺服器。
- 如果您沒有將安裝 Jazz Team Server 納入 CLM 安裝之中,請將 Jazz Team Server 安裝在磁碟上的新位置。
如果您已安裝 Jazz Team Server、已升級至 3.0.1 版,且想要安裝及升級「變更與配置管理」應用程式,請繼續升級「變更與配置管理 (CCM)」。
- 在安裝期間,請選取使用預設 3.x 應用程式環境定義根目錄。
- 安裝結束時,對於您想啟動哪一個程式,請選取無。
- 導覽至 <3.0.1JTS_install_dir>/server,然後執行下列指令:
註: 您可以在指令行中指定所有引數來執行 Script。
另一種方法是,如果您會重新執行升級 Script 許多次,您也可以編輯 Script 的參數檔,然後執行縮寫的指令行。
請參閱下一個選用的步驟,以取得參數檔的相關指示。
重要: 雖然這個 Script 檔是在 upgrade 目錄之下,但它必須從 server 目錄執行。另外,如果您的路徑包含空格,請務必用雙引號括住它。
Windows
upgrade\jts_upgrade.bat -oldJTSHome <3.0JTS_install_dir>\server\conf
UNIX
upgrade/jts_upgrade.sh -oldJTSHome <3.0JTS_install_dir>/server/conf
如果您需要更多指令行選項的詳細資料,請參閱jts_upgrade。
Script 會利用指示的使用者互動來完成這些作業:
- 選用項目:上一步驟還有另一個方式,您可以開啟 Script 的參數檔,修改預設值,然後執行縮寫形式的指令行。
jts_params 檔的英文及翻譯版在 <3.0.1JTS_install_dir>/server/upgrade/params 目錄中。
- 如果要取得您的語言確切的參數檔名稱,請從 <3.0.1JTS_install_dir>\server\upgrade 目錄中,執行 locale.bat -ccm -showParamFileName 指令 (Windows) 或 locale.sh -jts -showParamFileName(UNIX 系統)。
- 開啟 jts_params 或它的翻譯版來進行編輯,指定每個參數的值。
OLD_JTS_HOME 目錄路徑是必須設定的參數之一。
- 如果您使用 Apache Tomcat,請參閱設定 Apache Tomcat。
- 如果您使用 WebSphere Application Server,請解除安裝您先前安裝的 Web 應用程式,再重新部署 3.0.1 安裝架構提供的 jts.war 和 clmhelp.war。
如需進一步詳細資料,請參閱第 3 版升級期間設定 WebSphere Application Server。
- 啟動 JTS 伺服器。
- 繼續執行設定精靈來配置伺服器。
升級「變更與配置管理 (CCM)」
- 依照需要,檢閱規劃部署與升級相關章節中的各個主題。
- 關閉 CCM 3.0 伺服器。
- 將 CCM 應用程式安裝到磁碟上新的位置。
- 在安裝期間,請選取使用預設 3.x 應用程式環境定義根目錄。
重要: 如果您的 Rational Team Concert 3.0 版是從第 2 版升級而來,請選取使用 Rational Team Concert 2.x 環境定義根目錄來保留 /jazz 環境定義根目錄。
- 安裝結束時,對於您想啟動哪一個程式,請選取無。
- 導覽至 <3.0.1CCM_install_dir>/server,然後執行下列指令:
註: 您可以在指令行中指定所有引數來執行 Script。
另一種方法是,如果您會重新執行升級 Script 許多次,您也可以編輯 Script 的參數檔,然後執行縮寫的指令行。
請參閱下一個選用的步驟,以取得參數檔的相關指示。
重要: 雖然這個 Script 檔是在 upgrade 目錄之下,但它必須從 server 目錄執行。另外,如果您的路徑包含空格,請務必用雙引號括住它。另外,請務必提供 applicationContextRoot 參數,將它設為 ccm。
依預設,applicationContextRoot 是 jazz。
Windows
upgrade\ccm_upgrade.bat -oldApplicationHome <3.0CCM_install_dir>\server\conf -applicationContextRoot ccm
UNIX
upgrade/ccm_upgrade.sh -oldApplicationHome <3.0CCM_install_dir>/server/conf -applicationContextRoot ccm
如果您需要更多指令行選項的詳細資料,請參閱ccm_upgrade。
Script 會利用指示的使用者互動來完成這些作業:
- 執行 -migration_ccm_updateConfigurationFiles 指令及更新配置和 Tomcat 檔。
請輸入 [E] 來執行指令,輸入 [S] 來跳過步驟,或按一下 [Enter] 鍵來取消執行 Script。
- 順利合併配置檔之後,請輸入 [C],繼續作業。
這時會開啟一個「記事本」視窗(或 UNIX 系統的 vi 編輯器),供您驗證 CCM teamserver.properties 檔。
請確認 com.ibm.team.repository.server.webapp.url 內容所表示的「公用 URI 根目錄」正確。
另外,也請確認資料庫內容正確。
這個資料庫位置必須有別於 JTS 資料庫位置。
完成之後,如果有任何變更,請儲存變更,然後關閉編輯器,繼續執行 Script。如需驗證配置檔的相關資訊,請參閱在升級期間驗證配置檔。
- 繼續執行 Script,直到您看到一則訊息,指出 CCM 升級成功。
- 選用項目:上一步驟還有另一個方式,您可以開啟 Script 的參數檔,修改預設值,然後執行縮寫形式的指令行。
ccm_params 檔的英文及翻譯版在 <3.0.1CCM_install_dir>/server/upgrade/params 目錄中。
- 如果要取得您的語言確切的參數檔名稱,請從 <3.0.1CCM_install_dir>\server\upgrade 目錄中,執行 locale.bat -ccm -showParamFileName 指令 (Windows) 或 locale.sh -ccm -showParamFileName(UNIX 系統)。
- 開啟 ccm_params 檔或它的翻譯版來進行編輯,指定每個參數的值。
OLD_AAPLICATION_HOME 目錄路徑是必須設定的參數之一。
請確定路徑未包含任何空格。
- 如果您使用 Apache Tomcat,請參閱設定 Apache Tomcat。
- 如果您使用 WebSphere Application Server,請解除安裝您先前安裝的 Web 應用程式,再重新部署 3.0.1 安裝架構提供的 ccm.war。
如需進一步詳細資料,請參閱第 3 版升級期間設定 WebSphere Application Server。
- 啟動 CCM 伺服器。
- 如果您要新增「變更與配置管理」到已建立的 Jazz Team Server 中,請使用管理 Web 介面。
請參閱將應用程式登錄於 Jazz Team Server。