這個主題說明將 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 目錄中。
如果您計劃要升級多個產品,請參閱升級順序,以協助您決定要先升級的產品。
程序
- 依照需要,檢閱規劃部署與升級相關章節中的各個主題。
- 驗證您現有的第 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
- 關閉第 2 版伺服器。
- 如果還沒有下載 Jazz™ Team Server,請將伺服器以及「變更與配置管理 (CCM)」應用程式安裝於新位置。
如果您已安裝 Jazz Team Server,請安裝「變更與配置管理」應用程式。
- 在安裝期間,選取使用 Rational Team Concert 2.x 環境定義根目錄,來保留 /jazz 環境定義根目錄。
- 安裝結束時,對於您想啟動哪一個程式,請選取無。
- 利用第 2 版資料庫的相同參數,但不同的資料庫名稱,來建立 Jazz Team Server 的個別資料庫。
如需建立資料庫的相關資訊,請參閱設定資料庫。
註: 需要與 CCM 資料庫不同的個別 Jazz Team Server 資料庫。
如果您還沒有建立新的 Jazz Team Server 資料庫,請建立一個。
重要: 開啟另一個指令行視窗來執行第 2 版和第 3 版的 Repotools 指令。
請使用個別的指令行視窗,以確保第 2 版和第 3 版指令所用的環境變數之間不會起衝突。
- 導覽至 <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 檔案:
重要: 您有可能已修改了 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 位置。
- 確認更新的內容檔包含下列資訊:
- 內容是從第 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 相同)。
- 開啟一個指令視窗,移至 <3.0.1CCM_install_dir>/server 目錄。
- 執行下列指令以新增表格至資料庫:
repotools-jazz -addTables
- 執行下列指令來匯出 Rational Team Concert 資料庫中的使用者資訊:
repotools-jazz -migration_exportJTSData toFile=jtsData.tar
註: 如果您執行這個程序超過一次,第二個 tar 檔要使用不同的檔案名稱。
例如,使用 jtsData2.tar。
- 在安裝了 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 參數,您將會遺失在伺服器中的使用者資料。
- 執行下列指令,將 Jazz Team Server 使用者資訊匯入 Rational Team Concert 資料庫中:
repotools-jazz -migration_importUserMapping fromMappingFile=rtc-mapping.txt
- 執行下列指令來重建文字索引:
repotools-jazz -rebuildTextIndices
- 執行下列指令以重建 Lucene 和 RDF 索引:
repotools-jazz -reindex
- 如果您的第 2 版產品有非預設的索引位置,您想要繼續將自訂的位置用於索引,您必須修改 3.0.1 版 teamserver.properties 檔來新增索引位置。
- 將 com.ibm.team.fulltext.indexLocation=conf/jts/indices/workitemindex 的值變更為全文索引的完整路徑位置。例如,com.ibm.team.fulltext.indexLocation=c:/indices/workitemindex。
- 將 com.ibm.team.fulltext.indexLocation=conf/jts/indices/workitemindex 的值變更為 JFS 索引根目錄的完整路徑位置。例如,com.ibm.team.jfs.index.root.directory=c:/indices。
- 驗證下列:
- 確定 Jazz Team Server 資料庫位置有別於應用程式資料庫位置。
- 確定在應用程式和 Jazz Team Server 之間,沒有共用索引或其他檔案相關內容。
- 確定 friendconfig.rdf 檔已重新命名為 friendconfig.rdf.saved。
- 如果您使用 Apache Tomcat,請參閱設定 Apache Tomcat。
- 如果您使用 WebSphere Application Server,請解除安裝您先前安裝的 Web 應用程式,再重新部署 3.0.1 安裝架構提供的 jts.war、ccm.war 和 clmhelp.war。如需進一步詳細資料,請參閱第 3 版升級期間設定 WebSphere Application Server。
- 配置伺服器及您安裝的任何 CLM 應用程式。
如果您要連同「變更與配置管理」應用程式或任何其他 CLM 應用程式來升級 Jazz Team Server,請執行伺服器設定精靈。
(請參閱執行設定精靈)如果您要新增「變更與配置管理」應用程式到已建立的 Jazz Team Server 中,請使用管理 Web 介面。
請參閱將應用程式登錄於 Jazz Team Server。