準備對映檔

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

開始之前

重要: 如果要啟用伺服器重新命名,您必須向「IBM® 軟體支援中心」取得特性金鑰檔。聯絡 IBM 支援中心時,請表明您要索取「伺服器重新命名特性金鑰檔」。

關於這項作業

實際重新命名伺服器之前,您需要執行一些步驟。在大部分情況下,其中包括準備和檢閱您執行重新命名作業時,要使用的對映檔。對映檔列出您部署中的現有來源 URL 以及重新命名後的目標 URL。這些包括 Jazz Team Server、Jazz 應用程式,以及其他任何受影響應用程式的 URL。

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

程序

  1. 升級 Jazz Team Server (JTS) 和所有 Jazz 應用程式之後,啟動 Jazz Team Server 並驗證已向伺服器正確登錄應用程式。
    1. 登入 Jazz Team Server 的「管理」頁面。將 Web 瀏覽器指向 https://hostname:port/jts/admin
    2. 按一下伺服器標籤。
    3. 在「配置」區段的左窗格中,按一下已登錄的應用程式
    4. 驗證您所有的應用程式皆已登錄。如果尚未登錄,請登錄。
    5. 如果已在前一個步驟中登錄所有應用程式,請重新啟動 Jazz Team Server
  2. 在安裝 Jazz Team Server 的電腦上,開啟命令提示字元,並切換至 JazzInstallDir\server 目錄。
    註: 請務必對原始 Jazz Team Server 執行這個步驟和後續步驟,即使您將移至新的硬體,也必須這樣做。
  3. 使用 repotools-jts -generateURLMappings 指令,產生起始對映檔來作為範本,以便進一步編輯,如以下所示。如果您已執行這個指令,或檔案已存在,請新增 overwrite=true 參數。
    • Windows:repotools-jts.bat -generateURLMappings toFile=mappings.txt adminUserId=<adminId> adminPassword=<adminPassword> additionalURLFile=additionalurl.txt
    • Linux:./repotools-jts.sh -generateURLMappings toFile=mappings.txt adminUserId=<adminId> adminPassword=<adminPassword> additionalURLFile=additionalurl.txt

    此指令的輸出是一個對映檔,其中列出 Jazz Team Server 和已登錄於 Jazz Team Server 的每一個 Jazz 應用程式(Rational® Engineering Lifecycle ManagerLifecycle Query EngineJazz Reporting Service)的現有來源公用 URL 和預設目標 URL。 此外,也會識別說明 WAR 檔和任何受影響的已知外部系統的來源和目標 URL。

    此外,會建立第二個檔案,其中含有可能需要對映,或者參照可能需要加以考量之協力廠商整合的所有 URL 清單。您可以將這些 URL 新增到對映檔。對於簡單的部署,這個檔案不包含其他的 URL 並不少見。如果您包含 additionalURLFile=additionalurl.txt 參數,您可以為這個檔案指定不同的名稱。如需這個參數的進一步詳細資料,請參閱用來產生伺服器重新命名對映檔的儲存庫工具指令

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

  4. 仔細檢閱和編輯產生的對映檔。尋找主機名稱、埠或根環境定義中的打字錯誤。重新命名工具無法偵測到某些打字錯誤,而可能導致產品無法運作。若希望熟悉對映檔的結構,請參閱伺服器重新命名的對映檔
    1. 驗證每一個要重新命名的應用程式與說明 WAR 檔都有 source-target 配對。
    2. 編輯您要重新命名項目的 target= urls,使其目標正確。
      註: 如果您重新命名 JTS 或任何應用程式的埠號,則在重新命名之後但伺服器重新啟動之前,您需要在應用程式伺服器中更新埠資訊。如果您重新命名 JTS 或任何應用程式的環境定義根目錄,請參閱變更環境定義根目錄
    3. 使用 '#',來註銷您不想重新命名之任何 URL 的 source-> target 配對。
    4. 檢閱受影響的 URL 清單。雖然指令會搜尋部署中所有已知的 URL,仍有可能會遺漏一些。如果需要對映任何這些受影響的 URL,請解除註解受影響 URL 的來源/目標配對,並且提供新的目標 URL。只要您對環境有任何的懷疑,請在繼續進行重新命名之前,先告知管理者。
    5. 檢閱 additionalurls 檔。如需詳細資料,請參閱 用來產生伺服器重新命名對映檔的儲存庫工具指令
    註: 在您繼續進行實際的重新命名之前,只要 CLM 部署的配置已有所變更(包括登錄其他的應用程式),就需要重新產生對映檔。
  5. 使用 repotools-jts -verifyURLMappings 指令,來驗證對映檔。
    • repotools-jts.bat -verifyURLMappings mappingFile=mappings.txt repositoryURL=<serverURL> adminUserId=<adminId> adminPassword=<adminPassword>
    • ./repotools-jts.sh -verifyURLMappings mappingFile=mappings.txt repositoryURL=<serverURL> adminUserId=<adminId> adminPassword=<adminPassword>

    如需這個指令所執行的驗證類型的進一步詳細資料,請參閱用來驗證對映檔的儲存庫工具指令

  6. 如果您的實務涉及新的硬體,請在新電腦上安裝 Rational Engineering Lifecycle Manager請勿執行「Jazz 設定」精靈或啟動 Jazz Team Server

下一步

繼續重新命名伺服器。如需詳細資料,請參閱 利用伺服器重新命名,來移動試驗或完整的正式作業部署

意見