這個主題說明重新命名小型試驗或完整正式作業部署的步驟。
開始之前
因為無法自動移轉 LQE,必須先從 Jazz™ Team Server 已登錄應用程式清單中移除,並且重新啟動 Jazz Team Server 之後再開始伺服器重新命名程序。
- 登入 Jazz Team Server 的「管理」頁面。
將 Web 瀏覽器指向 https://hostname:port/jts/admin。
- 按一下伺服器標籤。
- 在「配置」區段的左窗格中,按一下已登錄的應用程式。
- 將移除作為已登錄應用程式的 Lifecycle
Query Engine。
- 停止 Lifecycle
Query Engine 伺服器。
- 重新啟動 Jazz Team Server。
註: 重新命名之後,來源伺服器必須永久停止運作,以避免污染正式作業環境。
關於這項作業
伺服器重新命名特性採用對映檔來決定應該重新命名的 URL。提供的 repotools 指令可以為您產生起始對映檔。對映檔包含 Jazz Team Server 和所有應用程式及應用程式所提供的其他任何 URL 的 source-target 配對。請參閱伺服器重新命名的對映檔,取得對映檔的其他詳細資料。
程序
- 當您的伺服器仍在線上時,請遵循準備對映檔主題所說明的步驟,在實際重新命名之前先準備和檢閱對映檔。
預備階段的最終結果會是在來源 Jazz Team Server 上產生的對映檔。對映檔包含 Jazz Team Server 和所有應用程式及應用程式所提供的其他任何 URL 的 source-target 配對。
- 備份現有的來源環境,並將文字索引和應用程式配置檔複製到新的目標安裝架構中。若為分散式系統,請移至適當的伺服器來複製檔案。
註: 如果您執行就地重新命名,而沒有移至新硬體,您是從某個安裝架構將環境複製到相同系統上的第二個安裝架構中。
- 停止 Jazz Team Server 和任何已向 Jazz Team Server 登錄的分散式應用程式。
此外,請停止受到伺服器重新命名影響的任何其他應用程式,或任何受影響的已支援整合。
註: 在伺服器關閉期間,使用者將無法從與所要重新命名之 Rational® Engineering Lifecycle
Manager 部署整合的任何外部系統中,建立或遍訪鏈結。
- 備份來源環境的資料庫,包括 Jazz Team Server 資料庫、應用程式的資料庫、資料倉儲資料庫。如果您要變更資料庫伺服器或供應商,請參閱移動資料庫,以瞭解其他步驟。
- 將 JFS/text 索引從來源安裝架構複製到目標安裝架構。
下列的 Linux 伺服器範例假設目標正式作業電腦的磁碟機是由網路裝載。如果您的環境無法這樣做,請使用其他檔案傳送方法,確定已複製檔案。
cp -R SourceJazzInstallDir/server/conf/jts/indices TargetJazzInstallDir/server/conf/jts
cp -R SourceJazzInstallDir/server/conf/relm/indices TargetJazzInstallDir/server/conf/relm
- 將應用程式配置檔從來源安裝架構,複製到目標正式作業安裝架構。如同上述步驟,以下也是以 Linux 伺服器為例,並且假設目標正式作業電腦的磁碟機是由網路裝載。
cp SourceJazzInstallDir/server/conf/jts/teamserver*.properties TargetJazzInstallDir/server/conf/jts
cp SourceJazzInstallDir/server/conf/relm/teamserver*.properties TargetJazzInstallDir/server/conf/relm
cp SourceJazzInstallDir/server/conf/admin/admin.properties* TargetJazzInstallDir/server/conf/admin
cp SourceJazzInstallDir/server/conf/admin/friends.rdf* TargetJazzInstallDir/server/conf/admin
- 將對映檔複製到目標正式作業伺服器上的 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"
- 如果您有分散式部署,並且不能夠重新對映網路磁碟機,請繼續執行 repotools-jts
-importURLMappings 指令(無 serverConfFile= 參數)。然後,將 server/conf/jts/.mappingEvent 檔案複製到遠端應用程式配置目錄
(server/conf/application_name),亦即,ccm、qm 和 rm。當您匯入對映時會產生事件檔案。複製 .mappingEvent 檔的時機,必須是在匯入對映檔之後,啟動伺服器之前。
.mappingEvent 檔包含應用程式在其新位置聯絡 Jazz Team Server 所需的資訊。.mappingEvent 檔的內容與給定
Jazz Team Server 和其已登錄的應用程式相同。
檢查主控台輸出和 JazzInstallDir/server/repotools-jts_importURLMappings.log 檔案,以驗證重新命名是否成功。
若顯示任何錯誤,或您知道自己在對映檔中犯了錯,請參閱伺服器重新命名的疑難排解,精確找出問題並加以修正。
- 啟動 Jazz Team Server 和任何已安裝的分散式應用程式。
此時,應用程式將與 Jazz Team Server 同步化,來套用 URL 對映,並更新其資料倉儲資料。小資料集大約需要 5 分鐘,超大資料集可能多達 30 分鐘以上。
- 登入 Jazz Team Server,網址是 https://new
host:port/jts/serverRenameStatus。這會啟動實際的重新命名程序。當重新命名完成時,您就可以驗證重新命名,並在必要時,採取任何更正動作。在驗證程序期間,Jazz Team Server 和所有應用程式都處於唯讀模式,但是您還是能夠瀏覽資料,並找出中斷的鏈結和未對映的 URL。如需詳細資料,請參閱在伺服器重新命名之後驗證 URL 和鏈結。
- 完成驗證程序之前,請確定您已執行完成伺服器重新命名驗證程序所說明之其他任何產品特定驗證。當您確信重新命名後的資料正確,請按一下我已驗證伺服器重新命名 ... 勾選框,並且按一下完成。
此時,Jazz Team Server 和所有已登錄的應用程式都會結束唯讀模式,並回復正常的產品使用情況。
- 僅適用於完整的正式作業:如果您有第二部 Jazz Team Server 或其他應用程式會鏈結至已重新命名的 Jazz Team Server,您必須在第二部 Jazz Team Server 上執行 repotools-jts -importURLMappings。
必須執行這個步驟,以便更新從第二部伺服器指向已重新命名之伺服器的鏈結。
重要: 請勿產生新的對映檔。您必須使用用於第一部已重新命名的伺服器的相同對映檔。
- 將編輯後的對映檔從第一部伺服器複製到第二部伺服器。
請確定已包含您從驗證程序所套用的任何更正的對映。
- 檢閱對映檔,必要的話,請移除您不想套用至第二部伺服器的任何來源/目標配對。
- 對第二部 Jazz Team Server 重複步驟 3 到 6,以便對第二部伺服器執行重新命名。
下一步
完成本項作業中的步驟之後,請完成
完成 Lifecycle Query Engine 的伺服器重新命名 中的步驟以重新加入 LQE 並重新產生索引。