使用升級 Script 從第 2 版升級至 3.0.1 版

您可以使用升級 Script,以便在升級應用程式資料期間,將必須手動執行的指令數目減至最少。

開始之前

在升級伺服器之前,請確定您有 Rational Team Concert 第 2 版儲存資料庫的完全最新有效備份。

請確定已使用「網路時間通訊協定 (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 資料庫,請將 Rational Team Concert 資料庫 (<RTC2_install_dir>\server\repositoryDB) 從第 2 版複製到 3.0.1 版。 如需相關資訊,請參閱備份和還原 Derby 資料庫。

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

程序

  1. 依照需要,檢閱規劃部署與升級相關章節中的各個主題。
  2. 驗證您現有的第 2 版 teamserver.properties 檔中的公用 URL 內容 com.ibm.team.repository.server.webapp.url。

    在 3.0.1 版中,您必須使用相同的公用 URL。 如果未設定公用 URL,在升級之前,請利用第 2 版管理 Web 介面(進階內容)來設定完整主機名稱 URL (https://hostname.example.com:port)。

    teamserver.properties 中的公用 URL 行應該看起來類似於:
    com.ibm.team.repository.server.webapp.url=https\://<hostname.example.com>\:9443/jazz
  3. 關閉第 2 版伺服器。
  4. 如果您還沒有安裝,請將 Jazz Team Server 以及「變更與配置管理 (CCM)」應用程式安裝於一個新的位置。 如果您已安裝 Jazz Team Server,且已升級至 3.0.1 版,您只需要安裝「變更與配置管理」應用程式。
  5. 在安裝期間,選取使用 Rational Team Concert 2.x 環境定義根目錄。
  6. 安裝結束時,對於您想啟動哪一個程式,請選取無。
  7. 使用相同的參數,為 Jazz Team Server 建立個別的資料庫,但所用的資料庫名稱與 2.x 版資料庫不同。如需建立資料庫的相關資訊,請參閱設定資料庫。
    註: 需要與 CCM 資料庫不同的個別 Jazz Team Server 資料庫。 如果您還沒有建立新的 JTS 資料庫,請建立一個。
  8. 導覽至 <CCM3.0.1_install_dir>/server,然後執行下列指令:
    註: 您可以在指令行中指定所有引數來執行 Script。 另一種方法是,如果您會重新執行升級 Script 許多次,您也可以編輯 Script 的參數檔,然後執行縮寫的指令行。 請參閱下一個選用的步驟,以取得參數檔的相關指示。

    如果您需要更多指令行選項的詳細資料,請參閱ccm_upgrade。

    重要: 雖然這個 Script 檔是在 upgrade 目錄之下,但它必須從 server 目錄執行。另外,如果您的路徑包含空格,請務必用雙引號括住它。

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

    Windows
    upgrade\ccm_upgrade.bat -oldApplicationHome <RTC2.x_install_dir>\server\conf -createJTSTables
    UNIX
    upgrade/ccm_upgrade.sh -oldApplicationHome <RTC2.x_install_dir>/server/conf -createJTSTables
    註: -createJTSTables 參數適用於您第一次安裝 Jazz Team Server 3.0.1 的安裝架構。

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

    Windows
    upgrade\ccm_upgrade.bat -oldApplicationHome <RTC2.x_install_dir>\server\conf -newJTSHome <JTS3.0.1InstallDir>\server\conf
    UNIX
    upgrade/ccm_upgrade.sh -oldApplicationHome <RTC2.x_install_dir>/server/conf -newJTSHome <JTS3.0.1InstallDir>/server/conf
    註: 如果您有分散式部署,且還沒有配置 Jazz Team Server,您可以新增 -createJTSTables 參數到上述指令行範例中。
    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。
      重要: 請勿修改連接資料倉儲資料庫的內容,即使它們目前設為 Derby 也一樣。 請只用伺服器設定精靈來修改這些內容。
      如需驗證配置檔的相關資訊,請參閱在升級期間驗證配置檔。
    • 繼續執行 Script,直到您看到一則訊息,指出 CCM 升級成功。
  9. 選用項目:上一步驟還有另一個方式,您可以開啟 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 目錄路徑是必須設定的參數之一。 請確定路徑未包含任何空格。
  10. 如果您使用 Apache Tomcat,請參閱設定 Apache Tomcat。
  11. 如果您使用 WebSphere Application Server,請解除安裝您先前安裝的 Web 應用程式,再重新部署 3.0.1 安裝架構提供的 jts.war、ccm.war 和 clmhelp.war。如需進一步詳細資料,請參閱第 3 版升級期間設定 WebSphere Application Server。
  12. 配置伺服器及您安裝的任何 CLM 應用程式。

    如果您要連同「變更與配置管理」或任何 CLM 應用程式來升級 Jazz Team Server,請執行伺服器設定精靈。 (請參閱執行設定精靈)如果您要新增「變更與配置管理」到已建立的 Jazz Team Server 中,請使用管理 Web 介面。 請參閱將應用程式登錄於 Jazz Team Server。

    註: Jazz.net 程式庫中關於升級 Rational Team Concert 的最新項目
上層主題: 升級 Rational Team Concert

意見