升級至全分散式企業拓蹼

您可以利用這個主題所說明的程序,將 Rational Team Concert™ 安裝架構升級至含有新的分散式 CCM 和 JTS 應用程式的 3.0.1 版。

開始之前

重要: 請確定已使用「網路時間通訊協定 (NTP)」,將所有機器上的時鐘同步化。時間是重要的元素,它可讓某個網路節點上的事件,對映到另一個節點上的對應事件。為了避免發生問題,可利用 NTP 服務的企業部署來克服這些挑戰。如需 NTP 的相關資訊,請造訪 http://www.ntp.org/。
註: 這裡的範例主要說明 Jazz Team Server 以及「變更與配置管理」。您可以將相同的程序用於「品質管理」應用程式。

如需全分散式 Rational Team Concert 3.0.1 企業拓蹼的範例,請檢閱 全分散式 Rational Team Concert 2.0 至 3.0.1 企業拓蹼範例 主題。

將 JTS 應用程式分散到不同的伺服器時,請確定部署 JTS 的第二部伺服器有相同的作業系統和應用程式伺服器配置。相同的作業系統和應用程式伺服器有利於檔案移轉。

請確定這兩部伺服器使用相同的鑑別方法與使用者領域來處理其使用者。

檢閱並考量部署單一登入。如果您使用 WebSphere,這有助於在多伺服器環境中進行鑑別。

3.0.1 版安裝結束時,請在「您想啟動哪一個程式」之下,選取無。只有在檔案與儲存庫移轉完成之後,才能執行 JTS 設定精靈。

上層主題: 升級 Rational Team Concert

準備配置檔

程序

  1. 在 A 機器(要升級的 RTC 2.x 伺服器所在的機器)上,安裝 3.0.1 版「變更與配置管理」應用程式,但是不安裝 Jazz Team Server (JTS) 和 RTC 試用軟體授權。
    註: 請確定在環境定義根目錄畫面中,選取了使用 Rational Team Concert 2.x 環境定義根目錄。
  2. 在 B 機器上,安裝 3.0.1 版 Jazz Team Server (JTS) 應用程式和 RTC 試用軟體授權,但是不將「變更與配置管理」安裝在將成為共用 JTS 的伺服器上。
    註: 請確定在環境定義根目錄畫面中,選取了使用 Rational Team Concert 2.x 環境定義根目錄。
  3. 在 A 機器上開啟新的指令視窗,並導覽至 3.0.1_install_dir/server。
  4. 執行下列指令來合併 Jazz 和 Tomcat 配置檔:
    repotools-jazz -migration_ccm_updateConfigurationFiles oldJazzHome=2.x_install_dir/server/conf
    註: 依預設,-migration_ccm_updateConfigurationFiles 指令會同時更新 Jazz 和 Tomcat 配置檔。如果未安裝 Tomcat,且您只想更新 Jazz 配置檔,您必須指定 updateType=JAZZ 參數。
    repotools-jazz -migration_ccm_updateConfigurationFiles oldJazzHome=2.x_install_dir/server/conf updateType=JAZZ
  5. 在 A 機器上,移至 3.0.1_install_dir/server/conf/jazz,並且檢閱 RTC teamserver.properties 檔的內容。請特別注意資料庫連線和公用 URL 項目,確認其與 A 機器的主機名稱相符。
    注意:
    請務必檢閱合併檔案的內容,具體地說,就是 jazz 和 JTS teamserver.properties 檔兩者的資料庫連線和公用 URL 項目,這一點非常重要。 Jazz (RTC/CCM) teamserver.properties 位於 A 機器的 3.0.1_install_dir/server/conf/jazz 之下,要編輯與移動的 JTS teamserver.properties 則位於 A 機器的 3.0.1_install_dir/server/jts-migration/conf/jts 之下。

    請務必編輯和更新這兩個 teamserver.properties 檔(必要的話),讓它們擁有正確的所在伺服器主機名稱,這一點很重要。

    如需驗證點的相關資訊和範例,請參閱「升級 Rational Team Concert」之下「準備配置檔」中的步驟 3-6。

  6. 編輯 A 機器上的 JTS teamserver.properties 之後,請將它複製到 B 機器的 3.0.1_install_dir/server/conf/jts 之下。在取代現有的 teamserver.properties 檔之前,請建立備份。
  7. 如果部署在 Tomcat 上,您必須將 3.0.1_install_dir/tomcat/conf/tomcat-users.xml 和 3.0.1_install_dir/tomcat/conf/server.xml 檔,從 A 機器複製到 B 機器上的 3.0.1_install_dir/tomcat/conf 資料夾。取代現有的檔案之前,請先建立備份。
  8. 如果部署在 Tomcat 上,且使用 LDAP,您必須完成下列作業,以編輯過的 web.xml 檔來部署 JTS:
    1. 在 B 機器上,利用 server.startup 來啟動 JTS 伺服器,以解壓縮 JTS.war 檔。
    2. 在 B 機器上,利用 server.shutdown 指令來停止 JTS 伺服器。
    3. 在 B 機器上,先建立 3.0.1_install_dir/server/tomcat/webapps/jts/WEB-INF/web.xml 的備份,然後用 A 伺服器中相等 web.xml 檔的副本來取代它。

結果

這時配置檔已移轉完成。

移轉儲存資料庫

這一節說明執行分散式 JTS 應用程式的儲存資料庫移轉所需要的步驟。

開始之前

繼續進行儲存資料庫移轉之前,請驗證是否已完成下列作業:
  • 已建立現有 RTC 2.x 資料庫的完整離線備份。
  • 配置檔(teamserver.properties、friendsconfig.rdf、tomcat-users.xml、server.xml、web.xml)已移轉並準備就緒。 如需相關資訊,請參閱準備配置檔。
  • 已建立 JTS 儲存資料庫。如需相關資訊,請參閱設定資料庫。
  • 已關閉 Rational Team Concert 2.x 版伺服器。
  • 如果 Rational Team Concert 2.x 版伺服器使用 Derby,請確定儲存資料庫已從 2.x_install_dir/server/repositoryDB 複製到 3.0.1_install_dir/server 目錄。
  • 如果是 WebSphere Application Server 移轉:
    • 確定已關閉 RTC 2.x 伺服器。
    • 停止及解除安裝 jazz.war 應用程式。
    • 修改 JAZZ_HOME 內容,使它符合新的安裝路徑 (3.0.1_install_dir/server/conf)。
    • 必要的話,修改 Oracle 或 SQL Server JDBC 驅動程式內容。 請參閱設定 WebSphere Application Server。
    • (選用)必要的話,調整記憶體設定。請參閱設定 WebSphere Application Server。
    • 停止並重新啟動 WebSphere Application Server。

程序

  1. 在 A 機器上開啟指令視窗,並切換至 3.0.1_install_dir/server 目錄。
  2. 執行下列指令以新增表格至資料庫:
    repotools-jazz -addTables
  3. 執行下列指令來匯出 RTC 資料庫的使用者資訊:
    repotools-jazz -migration_exportJTSData toFile=jtsData.tar 
  4. 在 A 機器上,複製剛剛建立的 jtsData.jar 檔,並且將它放在 B 機器的 3.0.1_install_dir/server 目錄中。
  5. 在 B 機器上執行下列指令,將使用者資訊匯入 JTS 資料庫中:
    重要: 如果您沒有使用預設的 Derby 資料庫,請確定 conf/jts/teamserver.properties 參照的 JTS 資料庫已建立並且存在。
    repotools-jts -migration_importJTSData fromFile=jtsData.tar createMappingFile=rtc-mapping.txt createTables 
  6. 在 B 機器上,複製剛剛建立的 rtc-mapping.txt 檔,並且將它放在 A 機器的 RTC3.0.1_install_dir/server 目錄中。
  7. 在 A 機器上,執行下列指令,將 JTS 使用者資訊匯入 RTC 資料庫:
    repotools-jazz -migration_importUserMapping fromMappingFile=rtc-mapping.txt

移轉後儲存庫工具指令

程序

在 A 機器上,執行下列指令來重建索引:

repotools-jazz -rebuildTextIndices

repotools-jazz -reindex

結果

這時儲存資料庫已移轉完成。

移轉後設定

關於這項作業

移轉 RTC 伺服器及分散 JTS 應用程式的移轉後步驟,與在單一伺服器環境中移轉的文件說明相同,不過,您也必須完成下列作業:

程序

在啟動 Jazz Team Server 設定精靈期間,由於是分散式環境,不會自動辨識及預先填入 CCM 應用程式。 如果在設定 Jazz Team Server 期間,未自動辨識 CCM 應用程式,請參閱執行設定精靈中的步驟 9c。

意見