這個主題說明在將小型試驗 CLM 部署移至正式作業時,變更伺服器 URL 所需的步驟。
開始之前
在繼續進行重新命名之前,請檢查您的環境是否符合從試驗到正式作業實務的準則。如需詳細資料,請參閱支援的實務。
重要: 如果要執行伺服器重新命名,Jazz™ Team Server 和所有 CLM 應用程式必須是第 4 版或更新版本。
下圖顯示重新命名的一般流程。

關於這項作業
在此程序中,您將資料和配置檔從試驗伺服器複製到正式作業伺服器。
因為您要移動而非複製資料庫,所以必須使試驗環境永久無法運作,以避免污染正式作業環境。
伺服器重新命名特性採用對映檔來決定應該重新命名的 URL。
提供的 repotools 指令可以為您產生起始對映檔。
對映檔包含 JTS 和所有應用程式及應用程式所提供的其他任何 URL 的 source-target 配對。
請參閱瞭解伺服器重新命名使用的對映檔,取得對映檔的其他詳細資料。如需拓蹼圖和對映檔範例,請參閱「試驗至正式作業」實務的拓蹼與對映檔。
程序
- 當您的伺服器仍在線上時,請遵循準備對映檔主題所說明的步驟,在實際重新命名之前先準備和檢閱對映檔。
如果您要將部署移至新電腦,請在新電腦執行安裝。如果您要在相同的電腦上變更 URL,請在與現有的安裝不同的目錄中執行安裝。
如果您也要變更環境定義根目錄,請參閱變更環境定義根目錄。
預備階段的最終結果會是在試驗的 Jazz Team Server 上產生的對映檔。對映檔包含 Jazz Team Server 和所有應用程式及應用程式所提供的其他任何 URL 的 source-target 配對。
- 備份第 4 版試驗環境,並將文字索引和應用程式配置檔複製到新的安裝。
- 停止 Jazz Team Server 和任何已向 Jazz Team Server 登錄的分散式 CLM 應用程式。
此外,請停止受到伺服器重新命名影響的任何其他應用程式,例如 Jazz Build Engine,或任何受影響的已支援整合,例如 Rational
Reporting for Development Intelligence (RRDI)、Rational® ClearCase®
或 Rational ClearQuest®。
註: 在伺服器關閉期間,使用者將無法從與所要重新命名之 CLM 部署整合的任何外部系統中,建立或遍訪鏈結。
- 備份 CLM 4.0 試驗環境中的所有資料庫,包括 Jazz Team Server 資料庫、CCM 和 QM 應用程式的資料庫、資料倉儲資料庫,以及 RRDI 內容儲存資料庫(如果您使用 RRDI 的話)。如果您要變更資料庫伺服器或供應商,請參閱移動 CLM 資料庫,以瞭解其他步驟。
- 將 JFS/text 索引從來源試驗伺服器複製到目標正式作業伺服器。(若為分散式系統,請移至適當的伺服器,以複製檔案。)
下列的 Linux 伺服器範例假設正式作業電腦的磁碟機是由網路裝載。如果您的環境無法這樣做,請使用其他檔案傳送方法,確定已複製檔案。
cp -R SourceJazzInstallDir/server/conf/jts/indices TargetJazzInstallDir/server/conf/jts
cp -R SourceJazzInstallDir/server/conf/ccm/indices TargetJazzInstallDir/server/conf/ccm
cp -R SourceJazzInstallDir/server/conf/qm/indices TargetJazzInstallDir/server/conf/qm
- 將應用程式配置檔從來源試驗伺服器複製到目標正式作業伺服器。(若為分散式系統,請移至適當的伺服器,以複製檔案。)如同上述步驟,以下也是以 Linux 伺服器為例,並且假設正式作業電腦的磁碟機是由網路裝載。
cp SourceJazzInstallDir/server/conf/jts/teamserver*.properties TargetJazzInstallDir/server/conf/jts
cp SourceJazzInstallDir/server/conf/ccm/teamserver*.properties TargetJazzInstallDir/server/conf/ccm
cp SourceJazzInstallDir/server/conf/qm/teamserver*.properties TargetJazzInstallDir/server/conf/qm
cp SourceJazzInstallDir/server/conf/admin/admin.properties* TargetJazzInstallDir/server/conf/admin
cp SourceJazzInstallDir/server/conf/admin/friends.rdf* TargetJazzInstallDir/server/conf/admin
cp SourceJazzInstallDir/server/conf/rm/fronting.properties TargetJazzInstallDir/server/conf/rm
cp SourceJazzInstallDir/server/conf/rm/friendsconfig.rdf TargetJazzInstallDir/server/conf/rm
- 將對映檔複製到正式作業伺服器上的 TargetJazzInstallDir\server 目錄。如需對映檔的詳細資料,請參閱準備對映檔。
- 使用 repotools-jts -importURLMappings 指令,將對映檔匯入目標正式作業 Jazz Team Server,以執行伺服器重新命名的離線部分。
- 如果您有單一伺服器部署,請使用 repotools-jts -importURLMappings 指令匯入對映檔,如下所示:
repotools-jts.bat -importURLMappings
fromFile=".\mappings.txt"
./repotools-jts.sh -importURLMappings
fromFile="./mappings.txt"
在伺服器重新啟動之前,Jazz Team Server 上會開始執行離線重新命名。
- 如果您採取分散式部署,並且容許您對映網路磁碟機,請將網路磁碟機從 Jazz Team Server 主機對映至每一個應用程式主機。然後建立檔案
(例如 serverConfFile.txt),並在其中以下列格式列出您部署中的遠端 server/conf 目錄:
# Remote CCM server
x:/JazzTeamServer/server/conf
# Remote QM server
y:/JazzTeamServer/server/conf
# Remote RM server
z:/JazzTeamServer/server/conf
最後,繼續執行
repotools-jts -importURLMappings 指令,並新增 serverConfFile= 參數,如以下所示。
repotools-jts.bat -importURLMappings
fromFile=".\mappings.txt" serverConfFile=".\serverConf.txt"
./repotools-jts.sh -importURLMappings
fromFile="./mappings.txt" serverConfFile="./serverConf.txt"
- 如果您有分散式 CLM 部署,並且不能夠重新對映網路磁碟機,請繼續執行 repotools-jts
-importURLMappings 指令(無 serverConfFile= 參數)。然後,將 server/conf/jts/.mappingEvent 檔案複製到遠端應用程式配置目錄
(server/conf/application_name),亦即,ccm、qm 和 rm。當您匯入對映時會產生事件檔案。複製 .mappingEvent 檔的時機,必須是在匯入對映檔之後,啟動伺服器之前。
.mappingEvent 檔包含應用程式在其新位置聯絡 Jazz Team Server 所需的資訊。.mappingEvent 檔的內容與給定
Jazz Team Server 和其已登錄的應用程式相同。
註: 對於 z/OS® 上執行的伺服器,應該使用範例 JCL 成員 HLQ.SBLZSAMP(BLZRENAM) 來重新命名。如需詳細的自訂指示,請參閱 BLZRENAM 中的註解標頭。
檢查主控台輸出和 JazzInstallDir/server/repotools-jts_importURLMappings.log 檔案,以驗證重新命名是否成功。
若顯示任何錯誤,或您知道自己在對映檔中犯了錯,請參閱伺服器重新命名的疑難排解,精確找出問題並加以修正。
- 啟動 Jazz Team Server 和任何已安裝的分散式 CLM 應用程式。
此時,CLM 應用程式將與 Jazz Team Server 同步化,來套用 URL 對映,並更新其資料倉儲資料。小資料集大約需要 5 分鐘,超大資料集可能多達 30 分鐘以上。
- 登入 Jazz Team Server:https://hostname:port/jts/serverRenameStatus(例如,https://clmhost.production.example.org:9443/jts/serverRenameStatus),以追蹤重新命名的進度。此頁面會自動重新整理,直到重新命名完成為止。
若有顯示任何錯誤,請參閱伺服器重新命名的疑難排解,精確找出問題並加以修正。
註: 在重新命名完成之前,只要嘗試登入任何 CLM 應用程式的 Web 使用者介面,都會重新導向至這個狀態頁面。
- 執行驗證伺服器重新命名中說明的伺服器重新命名驗證步驟。
- 選用:執行下列步驟,在正式作業環境中配置 Rational Reporting for Development Intelligence (RRDI):
- 備份試驗環境中的下列資料庫,並在正式作業環境中,將它們還原到 RRDI 新安裝架構的新資料庫伺服器上:
- 內容儲存資料庫(例如 RICM,如果尚未備份和還原的話)。
- 資料倉儲(例如 RIDW,如果尚未備份和還原的話)。
- 將 Rational Reporting for Development Intelligence 2.0 版安裝在正式作業環境中。如需詳細資料,請參閱使用 Installation Manager 來安裝 Rational Reporting for Development Intelligence。
- 執行「RRDI 設定」應用程式,來配置報告伺服器。如需詳細資料,請參閱後置安裝作業。請記得執行下列動作:
- 在配置內容儲存資料庫頁面中,指定您在步驟 7.a 所還原之內容儲存資料庫(例如:RICM)的連線內容。
- 在配置資料倉儲頁面中,指定您在步驟 7.a 所還原之資料倉儲資料庫(例如:RIDW)的連線內容。
- 登入 Jazz Team Server,並驗證儲存在 Jazz Team Server 的「進階內容」中以及 CCM 和 QM 的「管理」頁面中的報告伺服器 URL,是指向正式作業 RRDI 報告伺服器。如果它們未指向正式作業系統,請更新它們,以指向正式作業系統。
註: 如果對映檔包含報告伺服器 URL 的對映,則應已自動更新。
- 驗證先前從試驗 RRDI 報告伺服器匯入的所有報告,都能繼續運作。
- 其動作設為檢視最新報告的任何 Cognos 報告或報告視圖,在 CLM 伺服器重新命名之後必須重新執行,才能使快取的 HTML 報告更新。
- 登入 RRDI 報告伺服器。
- 尋找含有快取的輸出版本的報告或報告視圖。
註: 如果報告或報告視圖有快取的輸出版本,您可以對此報告按一下檢視輸出版本,以檢視快取的報告。如果報告或報告視圖是在 CLM 伺服器重新命名之前產生,您必須重新執行報告或報告視圖才能更新它們。否則,執行報告或報告視圖的使用者會看到指向舊 CLM 伺服器的舊鏈結。
- 按一下使用選項執行,以重新執行報告或報告視圖。
- 在報告檢視器中,按一下,以更新與報告或報告視圖相關聯的快取輸出版本。
- 從正式作業 RRDI 報告伺服器匯入新的報告。請驗證匯入成功,且匯入的報告在執行時沒有問題。
- 如果您在 RRDI 中配置了 Rational Quality Manager 即時報告,請遵循步驟,為新的伺服器產生 xdc 檔,並在 32 位元 ODBC 管理程式中配置它。如需詳細資料,請參閱設定即時報告。
- 執行與如下的其他元件和產品整合時,所需的其他任何伺服器重新命名後置步驟:Jazz Build Engines、Rational Reporting、Rational Team Concert 用戶端、Rational ClearQuest 或 Rational ClearCase。如需詳細資料,請參閱 限制和其他資訊。