使用升級 Script 從 3.0 升級至 3.0.1

這個主題說明將 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)

  1. 依照需要,檢閱規劃部署與升級相關章節中的各個主題。
  2. 關閉 JTS 3.0 伺服器。
  3. 如果您沒有將安裝 Jazz Team Server 納入 CLM 安裝之中,請將 Jazz Team Server 安裝在磁碟上的新位置。 如果您已安裝 Jazz Team Server、已升級至 3.0.1 版,且想要安裝及升級「變更與配置管理」應用程式,請繼續升級「變更與配置管理 (CCM)」。
  4. 在安裝期間,請選取使用預設 3.x 應用程式環境定義根目錄。
  5. 安裝結束時,對於您想啟動哪一個程式,請選取無。
  6. 導覽至 <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 會利用指示的使用者互動來完成這些作業:
    • 執行 -migration_jts_updateConfigurationFiles 指令及更新配置和 Tomcat 檔。 請輸入 [E] 來執行指令,輸入 [S] 來跳過步驟,或按一下 [Enter] 鍵來取消執行 Script。
    • 順利合併配置檔之後,請輸入 [C],繼續作業。 這時會開啟一個「記事本」視窗(或 UNIX 系統的 vi 編輯器),供您驗證 Jazz Team Server teamserver.properties 檔。 請確認 com.ibm.team.repository.server.webapp.url 內容所表示的「公用 URI 根目錄」正確。 另外,也請確認資料庫內容正確。 完成之後,如果有任何變更,請儲存變更,然後關閉編輯器,繼續執行 Script。
      重要: 請勿修改連接資料倉儲資料庫的內容,即使它們目前設為 Derby 也一樣。 請只用伺服器設定精靈來修改這些內容。
      如需驗證配置檔的相關資訊,請參閱在升級期間驗證配置檔。
    • 繼續執行 Script,直到您看到一則訊息,指出 JTS 升級成功。
  7. 選用項目:上一步驟還有另一個方式,您可以開啟 Script 的參數檔,修改預設值,然後執行縮寫形式的指令行。

    jts_params 檔的英文及翻譯版在 <3.0.1JTS_install_dir>/server/upgrade/params 目錄中。

    1. 如果要取得您的語言確切的參數檔名稱,請從 <3.0.1JTS_install_dir>\server\upgrade 目錄中,執行 locale.bat -ccm -showParamFileName 指令 (Windows) 或 locale.sh -jts -showParamFileName(UNIX 系統)。
    2. 開啟 jts_params 或它的翻譯版來進行編輯,指定每個參數的值。 OLD_JTS_HOME 目錄路徑是必須設定的參數之一。
  8. 如果您使用 Apache Tomcat,請參閱設定 Apache Tomcat。
  9. 如果您使用 WebSphere Application Server,請解除安裝您先前安裝的 Web 應用程式,再重新部署 3.0.1 安裝架構提供的 jts.war 和 clmhelp.war。 如需進一步詳細資料,請參閱第 3 版升級期間設定 WebSphere Application Server。
  10. 啟動 JTS 伺服器。
  11. 繼續執行設定精靈來配置伺服器。

升級「變更與配置管理 (CCM)」

  1. 依照需要,檢閱規劃部署與升級相關章節中的各個主題。
  2. 關閉 CCM 3.0 伺服器。
  3. 將 CCM 應用程式安裝到磁碟上新的位置。
  4. 在安裝期間,請選取使用預設 3.x 應用程式環境定義根目錄。
    重要: 如果您的 Rational Team Concert 3.0 版是從第 2 版升級而來,請選取使用 Rational Team Concert 2.x 環境定義根目錄來保留 /jazz 環境定義根目錄。
  5. 安裝結束時,對於您想啟動哪一個程式,請選取無。
  6. 導覽至 <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 升級成功。
  7. 選用項目:上一步驟還有另一個方式,您可以開啟 Script 的參數檔,修改預設值,然後執行縮寫形式的指令行。

    ccm_params 檔的英文及翻譯版在 <3.0.1CCM_install_dir>/server/upgrade/params 目錄中。

    1. 如果要取得您的語言確切的參數檔名稱,請從 <3.0.1CCM_install_dir>\server\upgrade 目錄中,執行 locale.bat -ccm -showParamFileName 指令 (Windows) 或 locale.sh -ccm -showParamFileName(UNIX 系統)。
    2. 開啟 ccm_params 檔或它的翻譯版來進行編輯,指定每個參數的值。 OLD_AAPLICATION_HOME 目錄路徑是必須設定的參數之一。 請確定路徑未包含任何空格。
  8. 如果您使用 Apache Tomcat,請參閱設定 Apache Tomcat。
  9. 如果您使用 WebSphere Application Server,請解除安裝您先前安裝的 Web 應用程式,再重新部署 3.0.1 安裝架構提供的 ccm.war。 如需進一步詳細資料,請參閱第 3 版升級期間設定 WebSphere Application Server。
  10. 啟動 CCM 伺服器。
  11. 如果您要新增「變更與配置管理」到已建立的 Jazz Team Server 中,請使用管理 Web 介面。 請參閱將應用程式登錄於 Jazz Team Server。
註: Jazz.net 程式庫中關於升級 Rational Team Concert 的最新項目
上層主題: 升級 Rational Team Concert

意見