手動從第 2 版升級至 3.0.1

這個主題說明將 Rational Team Concert™ 第 2 版升級至 3.0.1 版的手動程序。

開始之前

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

請確定已使用「網路時間通訊協定 (NTP)」,將所有伺服器上的時鐘同步化。 時間是重要的元素,可讓某個網路節點上的事件,對映到另一個節點上的對應事件。 為了避免發生問題,可利用 NTP 服務的企業部署來克服這些挑戰。如需 NTP 的相關資訊,請造訪 http://www.ntp.org/。此外,所有伺服器必須使用相同的鑑別方法來鑑別其使用者。

如果 Rational Team Concert 第 2 版伺服器使用 Derby,請確定已將儲存資料庫從 RTC2.X_install_dir/server/repositoryDB 複製到 3.0.1CCM_install_dir/server/conf/jazz/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,請安裝「變更與配置管理」應用程式。
  5. 在安裝期間,選取使用 Rational Team Concert 2.x 環境定義根目錄,來保留 /jazz 環境定義根目錄。
  6. 安裝結束時,對於您想啟動哪一個程式,請選取無。
  7. 利用第 2 版資料庫的相同參數,但不同的資料庫名稱,來建立 Jazz Team Server 的個別資料庫。 如需建立資料庫的相關資訊,請參閱設定資料庫。
    註: 需要與 CCM 資料庫不同的個別 Jazz Team Server 資料庫。 如果您還沒有建立新的 Jazz Team Server 資料庫,請建立一個。
    重要: 開啟另一個指令行視窗來執行第 2 版和第 3 版的 Repotools 指令。 請使用個別的指令行視窗,以確保第 2 版和第 3 版指令所用的環境變數之間不會起衝突。
  8. 導覽至 <3.0.1CCM_install_dir>/server,執行下列指令來合併 Jazz 及 Tomcat 配置檔(包括夥伴)。
    repotools-jazz -migration_ccm_updateConfigurationFiles oldApplicationHome=<2.x_install_dir>/server/conf
    依預設,-migration_ccm_updateConfigurationFiles 指令會同時更新 Jazz 和 Tomcat 配置檔。如果未安裝 Tomcat,且您只想更新 Jazz 配置檔,您必須指定 updateTomcatFiles=false 參數。
    -migration_ccm_updateConfigurationFiles 指令會完成下列作業:
    • Jazz 配置檔:
      • teamserver.properties(將 1 個 Rational Team Concert 檔案,合併到團隊伺服器和應用程式的 2 個檔案中)
      • friendsconfig.rdf(將 1 個 Rational Team Concert 檔複製到 1 個應用程式檔案)
    • Tomcat 檔案:
      • tomcat-users.xml(複製)
        記住: 只適用於 Tomcat 使用者資料庫。 會複製 tomcat-users.xml 檔(不會與現有的檔案合併)。 如果您升級具有共同 JTS 的多個 CLM 應用程式,您必須在 tomcat-users.xml 檔中,手動合併使用者和群組資訊。 如果使用者在不同應用程式中,屬於不同的群組,使用者和群組資訊就會不同。 例如,userA 在 CCM 中有 JazzAdmins 角色,在 QM 中有 JazzUsers 角色。 另外,如果某些使用者只出現在一個應用程式中,未出現在另一個應用程式中(反之亦然),就必須將他們手動新增到 tomcat-users.xml 檔中。
      • server.xml(合併)
      • 包含在應用程式 WAR 檔內的 web.xml 檔(將 1 個 Rational Team Concert 檔案,合併到團隊伺服器和應用程式的 2 個檔案中)
    重要: 您有可能已修改了 Rational Team Concert 第 2 版中的其他檔案,例如,log4j.properties 檔。 您必須手動合併這些檔案。

    如需關於 Repotools 指令的詳細資料,請參閱-migration_ccm_updateConfigurationFiles。

    記住: 在下列範例中,teamserver.properties 檔的位置是以預設安裝為基礎。 如果您已變更部署的檔案佈置,請確定所用的位置正確。 另外,下列步驟也假設部署是在單一伺服器上。 依預設,newJTSHome 參數值是從 newApplicationHome 衍生而來。如果 CCM 和 Jazz Team Server 使用個別的伺服器,請指定 newJTSHome 參數來指向 Jazz Team Server 位置。 如此一來,就會合併 Rational Team Concert 第 2 版 teamserver.properties 檔中的 LDAP、電子郵件和資料庫位置內容。 另外,也會將 Tomcat 配置檔複製到 Jazz Team Server 位置。
  9. 確認更新的內容檔包含下列資訊:
    • 內容是從第 2 版 teamserver.properties 檔複製而來。
    • 有效的資料庫供應商項目(確定 /conf/jts/teamserver.properties 所指定的資料庫存在)。 如需相關資訊,請參閱在升級期間驗證配置檔。
    • 驗證 friendsconfig.rdf 已從 <RTC2.X_install_dir>/server/conf/jazz 複製到 <3.0.1CCM_install_dir>/server/conf/jazz。
    • 驗證已複製改寫 tomcat-users.xml。
    • 開啟第 3 版 server.xml 檔,確認它包含第 2 版的資訊(埠號、LDAP 設定及其他修正)。
    • 開啟第 3 版 web.xml 檔,確認它包含第 2 版的資訊(LDAP 設定及其他修正)。
    • 確認有效的特殊公用 URL com.ibm.team.repository.server.webapp.url 在 teamserver.properties 檔中。 (CCM 應用程式的 URL 必須與 Rational Team Concert 第 2 版所用的 URL 相同)。
  10. 開啟一個指令視窗,移至 <3.0.1CCM_install_dir>/server 目錄。
  11. 執行下列指令以新增表格至資料庫:
    repotools-jazz -addTables
  12. 執行下列指令來匯出 Rational Team Concert 資料庫中的使用者資訊:
    repotools-jazz -migration_exportJTSData toFile=jtsData.tar 
    註: 如果您執行這個程序超過一次,第二個 tar 檔要使用不同的檔案名稱。 例如,使用 jtsData2.tar。
  13. 在安裝了 Jazz Team Server 的機器中,執行下列指令,將使用者資訊匯入 Jazz Team Server 資料庫中:
    註: 如果您沒有使用預設的 Derby 資料庫,請確定 conf/jts/teamserver.properties 檔所參照的 Jazz Team Server 資料庫是全新存在的資料庫。
    repotools-jts -migration_importJTSData fromFile=jtsData.tar createMappingFile=rtc-mapping.txt createTables 
    註: 如果您執行這個程序超過一次,第二個 tar 檔要使用不同的檔案名稱。 例如,使用 jtsData2.tar。
    小心: 當您從 CCM 應用程式的第二個安裝架構來匯入 Jazz Team Server 資料時, 請勿使用 createTables 參數。 如果 CLM 應用程式已經安裝在 Jazz Team Server 上,而且您使用 createTables 參數,您將會遺失在伺服器中的使用者資料。
  14. 執行下列指令,將 Jazz Team Server 使用者資訊匯入 Rational Team Concert 資料庫中:
    repotools-jazz -migration_importUserMapping fromMappingFile=rtc-mapping.txt 
  15. 執行下列指令來重建文字索引:
    repotools-jazz -rebuildTextIndices
  16. 執行下列指令以重建 Lucene 和 RDF 索引:
    repotools-jazz -reindex
  17. 如果您的第 2 版產品有非預設的索引位置,您想要繼續將自訂的位置用於索引,您必須修改 3.0.1 版 teamserver.properties 檔來新增索引位置。
    1. 將 com.ibm.team.fulltext.indexLocation=conf/jts/indices/workitemindex 的值變更為全文索引的完整路徑位置。例如,com.ibm.team.fulltext.indexLocation=c:/indices/workitemindex。
    2. 將 com.ibm.team.fulltext.indexLocation=conf/jts/indices/workitemindex 的值變更為 JFS 索引根目錄的完整路徑位置。例如,com.ibm.team.jfs.index.root.directory=c:/indices。
  18. 驗證下列:
    • 確定 Jazz Team Server 資料庫位置有別於應用程式資料庫位置。
    • 確定在應用程式和 Jazz Team Server 之間,沒有共用索引或其他檔案相關內容。
    • 確定 friendconfig.rdf 檔已重新命名為 friendconfig.rdf.saved。
  19. 如果您使用 Apache Tomcat,請參閱設定 Apache Tomcat。
  20. 如果您使用 WebSphere Application Server,請解除安裝您先前安裝的 Web 應用程式,再重新部署 3.0.1 安裝架構提供的 jts.war、ccm.war 和 clmhelp.war。如需進一步詳細資料,請參閱第 3 版升級期間設定 WebSphere Application Server。
  21. 配置伺服器及您安裝的任何 CLM 應用程式。

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

    註: Jazz.net 程式庫中關於升級 Rational Team Concert 的最新項目
上層主題: 升級 Rational Team Concert
相關概念:
設定資料庫
相關工作:
在升級期間驗證配置檔

意見