這個主題說明如何使用伺服器重新命名特性,以實際的正式作業資料來準備暫置環境。暫置環境是一個測試沙盤推演,並與正式作業環境隔離。您可以透過它,使用實際資料來嘗試新的特性或功能,並且不會影響正式作業資料庫。
伺服器重新命名特性採用對映檔來決定應該重新命名的 URL。 提供的 repotools 指令可以為您產生起始對映檔。 對映檔包含 Jazz™ Team Server 和所有應用程式及應用程式所提供的其他任何 URL 的 source-target 配對。請參閱瞭解伺服器重新命名使用的對映檔,取得對映檔的其他詳細資料。如需拓蹼圖和對映檔範例,請參閱設定測試暫置環境時使用的拓蹼和對映檔。
規劃暫置環境時,您需要特別小心不要污染正式作業資料,反之亦然。 您有兩種方式可達成此目的:一種是在 hosts 檔案中新增項目(如果您的環境容許的話),一種是建立對映,以遮罩未出現在暫置環境中的伺服器。 在對映中,請務必包含可能連接正式作業伺服器的其他任何 CLM 伺服器或非 CLM 產品。如需詳細資料,請參閱步驟 3.c 和暫置環境的虛擬對映。
舉例來說,某個正式作業伺服器中有一個「變更與配置管理 (CCM)」應用程式,它會鏈結至另一個正式作業伺服器中的 CCM,以及鏈結至再另外一個正式作業伺服器中的「品質管理 (QM)」。再者,您可能還整合了非 CLM 產品,例如 Rational® ClearQuest®。在此情況下,您應該先遮蔽其他 CCM 和 QM 伺服器的 URL,並確定 Rational ClearQuest 也已遮蔽或是對映至 Rational ClearQuest 暫置閘道伺服器。
下圖顯示使用伺服器重新命名來設定暫置環境時所需的主要步驟。它假設已安裝最新版的 CLM(第 4 版)和 RRDI(第 2 版)。

務必為對映檔中任何受影響的 URL 建立虛擬對映。這麼做可避免暫置環境與正式作業環境之間交互鏈結。 如需詳細資料,請參閱暫置環境的虛擬對映。
預備階段的最終結果會是在原始來源 Jazz Team Server 上產生一個對映檔。請仔細檢閱和編輯對映檔,然後將它複製到暫置環境中目標 Jazz Team Server 上的 JazzInstallDir\server 目錄。
在執行這些步驟時,您需要停止正式作業伺服器,因此請務必找時間執行備份,並且最好是在您準備要設定暫置環境之前。在您繼續實際重新命名之前,只要正式作業環境已有所變更,就需要先重新產生對映檔,再將它匯入至暫置伺服器。在伺服器關閉期間,使用者將無法從與所要重新命名之 CLM 部署整合的任何外部系統中,建立或遍訪鏈結。
下列的 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
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
這裡的目標是將主機名稱解析為虛假的 IP 位址,正式作業環境中的任何 CLM 伺服器都不會使用該 IP 位址。如此一來,如果暫置環境中的伺服器嘗試建立正式作業伺服器連線,該連線將會失敗。
建立一份清單,且其中含有出現在您對映檔中的所有特定主機名稱。這些可以是來源 URL 或受影響的 URL。在 hosts 檔中,針對每一個主機名稱,分別建立一個將主機名稱對映至虛假 IP 位址的項目。您需要編輯暫置環境中所有伺服器的 hosts 檔,包括協力廠商伺服器和用戶端工作站都要。下列主機檔顯示您暫置伺服器的項目範例:
# 10.10.10.10 refers to an IP address that does not host a clm application.
10.10.10.10 ProductionServerP1
10.10.10.10 ProductionServerP2
10.10.10.10 ProductionServerP3
repotools-jts.bat -importURLMappings fromFile="C:\mappings.txt"
./repotools-jts.sh -importURLMappings
fromFile="opt/mappings.txt"
在伺服器重新啟動之前,Jazz Team Server 上會開始執行離線重新命名。
# 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="C:\mappings.txt" serverConfFile="C:\serverConf.txt"
./repotools-jts.sh -importURLMappings
fromFile="/opt/mappings.txt" serverConfFile="/opt/serverConf.txt"
repotools-jts.bat -importURLMappings fromFile="C:\mappings.txt"
./repotools-jts.sh -importURLMappings
fromFile="opt/mappings.txt"
然後,將 server/conf/jts/.mappingEvent 檔案複製到遠端應用程式配置目錄 (server/conf/application_name),亦即,ccm、qm 和 rm。複製 .mappingEvent 檔的時機,必須是在匯入對映檔之後,啟動伺服器之前。
.mappingEvent 檔包含應用程式在其新位置聯絡 Jazz Team Server 所需的資訊。.mappingEvent 檔的內容與給定 Jazz Team Server 和其已登錄的應用程式相同。
檢查主控台輸出和 server/repotools-jts_importURLMappings.log 檔案,以驗證重新命名是否成功。 若顯示任何錯誤,或您知道自己在對映檔中犯了錯,請參閱伺服器重新命名的疑難排解,精確找出問題並加以修正。
此時,CLM 應用程式將與 Jazz Team Server 同步化,來套用 URL 對映,並更新其資料倉儲資料。小資料集大約需要 5 分鐘,超大資料集可能多達 30 分鐘以上。
等待所有應用程式重新命名以及「終結伺服器重新命名」步驟的完成。驗證下列訊息出現:伺服器重新命名順利完成。Jazz Team Server 及應用程式完全運作。您可以立即開始使用伺服器,不需要重新啟動。
若有顯示任何錯誤,請參閱伺服器重新命名的疑難排解,精確找出問題並加以修正。