準備對映檔

這個主題說明如何準備對映檔,以便在之後您要實際重新命名 CLM 伺服器時使用。當您的伺服器仍在線上時,您可以在實際重新命名之前,先準備和檢閱對映檔。

開始之前

重要: 能夠重新命名伺服器是 CLM 第 4 版的一項特性。 因此,您必須將 Jazz™ Team Server 和所有 CLM 應用程式升級到第 4 版,才能執行伺服器重新命名。

關於這項作業

實際重新命名伺服器之前,您需要執行一些步驟。在大部分情況下,其中包括準備和檢閱您執行重新命名作業時,要使用的對映檔。對映檔列出您部署中的現有來源 URL 以及重新命名後的目標 URL。這些包括 Jazz Team Server 的 URL、CLM 應用程式、CLM 說明 WAR 檔,以及其他任何受影響的應用程式。如需拓蹼圖和對映檔範例,請參閱設定測試暫置環境時使用的拓蹼和對映檔。

您可以在單一伺服器 CLM 部署中 (亦即,Jazz Team Server 和 CLM 應用程式全安裝在相同電腦上),執行這些步驟,或是在分散式部署中(亦即,CLM 應用程式安裝在不同電腦上),執行這些步驟。這些預備步驟可以與各種不同的實務配合使用,舉例來說,將電腦移至新的實體位置、將測試沙盤推演設定在新電腦上,或是因為資料中心合併,而涉及在新電腦上重新命名環境。

For z/OS operating system 註: z/OS® 支援重新命名伺服器,但是就對映檔建立程序來說,仍有一些差異。如需詳細資料,請參閱在 z/OS 上重新命名伺服器。

程序

  1. 將涉及重新命名的所有伺服器升級至第 4 版之後,啟動 Jazz Team Server (JTS),並驗證已向伺服器正確登錄應用程式。
    1. 登入 Jazz Team Server 的「管理」頁面。將 Web 瀏覽器指向 https://hostname:port/jts/admin。
    2. 按一下伺服器標籤。
    3. 在「配置」區段的左窗格中,按一下已登錄的應用程式。
    4. 驗證您所有的應用程式皆已登錄。

    如需進一步詳細資料,請參閱將應用程式登錄於 Jazz Team Server。

  2. 在安裝 Jazz Team Server 的電腦上,開啟命令提示字元,並切換至 JazzInstallDir\server 目錄。
    註: 請務必對原始 Jazz Team Server 執行這個步驟和後續步驟,即使您將移至新的硬體,也必須這樣做。
  3. 使用 repotools-jts -generateURLMappings 指令,產生起始對映檔來作為範本,以便進一步編輯,如以下所示。如果您已執行這個指令,或檔案已存在,請新增 overwrite=true 參數。
    註: 針對 UNIX 所顯示的任何範例,同樣適用於 Linux。
    • For Windows operating system repotools-jts.bat -generateURLMappings toFile=mappings.txt adminUserId=<adminId> adminPassword=<adminPassword>
    • For Unix operating systems ./repotools-jts.sh -generateURLMappings toFile=mappings.txt adminUserId=<adminId> adminPassword=<adminPassword>

    這個指令的輸出是一個對映檔,其中列出 Jazz Team Server 和已向 Jazz Team Server 登錄的每一個 CLM 應用程式 (CCM、QM 和 RM)的現有來源公用 URL 和預設目標 URL。此外,也會識別 CLM 說明 WAR 檔和任何受影響的已知外部系統的來源和目標 URL。

    驗證位於 JazzInstallDir/server/repotools-jts_generateURLMappings.log 的日誌檔中沒有錯誤。

  4. 仔細檢閱和編輯產生的對映檔。尋找主機名稱、埠或根環境定義中的打字錯誤。重新命名工具無法偵測到某些打字錯誤,而可能導致產品無法運作。

    檢閱 瞭解伺服器重新命名使用的對映檔 主題,以熟悉對映檔的結構。仔細檢閱和編輯產生的對映檔。

    1. 驗證每一個要重新命名的應用程式和 CLM 說明 WAR 檔都有 source-target 配對。
    2. 編輯您要重新命名項目的 target= urls,使其目標正確。
      註: 如果您重新命名 JTS 或任何應用程式的埠號,則在重新命名之後但伺服器重新啟動之前,您需要在應用程式伺服器中更新埠資訊。如需詳細資料,請參閱 變更應用程式伺服器的埠號。如果您重新命名 JTS 或任何應用程式的環境定義根目錄,請參閱變更環境定義根目錄。
    3. 使用 '#',來註銷您不想重新命名之任何 URL 的 source-> target 配對。
    4. 檢閱受影響的 URL 清單。雖然指令會搜尋部署中所有已知的 URL,仍有可能會遺漏一些。只要您對環境有任何的懷疑,請在繼續進行重新命名之前,先告知管理者。
    註: 在您繼續進行實際的重新命名之前,只要 CLM 部署的配置已有所變更,就需要重新產生對映檔。
  5. 如果您的實務涉及新的硬體,請在新電腦上安裝 CLM 第 4 版。請勿執行「Jazz 設定」精靈或啟動 Jazz Team Server。 請參閱安裝 Jazz Team Server 和 Rational Collaborative Lifecycle Management 應用程式解決方案。

下一步

繼續重新命名伺服器。如需詳細資料,請參閱利用伺服器重新命名,將試驗部署移至正式作業或使用正式作業資料來設定測試暫置環境

意見