使用正式作業資料來設定測試暫置環境

這個主題說明如何使用伺服器重新命名特性,以實際的正式作業資料來準備暫置環境。暫置環境是一個測試沙盤推演,並與正式作業環境隔離。您可以透過它,使用實際資料來嘗試新的特性或功能,並且不會影響正式作業資料庫。

關於這項作業

重要: 這個程序無法用來從舊版本升級您的環境。 只有第 4 版及更新的版本才支援伺服器重新命名。 因此,必須升級到第 4 版,才能使用伺服器重新命名來設定暫置環境。

伺服器重新命名特性採用對映檔來決定應該重新命名的 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 暫置閘道伺服器。

重要: 請勿將 Rational Team Concert 用戶端同時連接到正式作業和暫置儲存庫。請一律使用暫置工作區來連接暫置伺服器。

下圖顯示使用伺服器重新命名來設定暫置環境時所需的主要步驟。它假設已安裝最新版的 CLM(第 4 版)和 RRDI(第 2 版)。

正式作業到暫置實務

程序

  1. 遵循準備對映檔主題中的步驟,做好重新命名的準備。

    務必為對映檔中任何受影響的 URL 建立虛擬對映。這麼做可避免暫置環境與正式作業環境之間交互鏈結。 如需詳細資料,請參閱暫置環境的虛擬對映。

    預備階段的最終結果會是在原始來源 Jazz Team Server 上產生一個對映檔。請仔細檢閱和編輯對映檔,然後將它複製到暫置環境中目標 Jazz Team Server 上的 JazzInstallDir\server 目錄。

  2. 備份第 4 版正式作業環境,並將文字索引和應用程式配置檔複製到目標暫置伺服器。

    在執行這些步驟時,您需要停止正式作業伺服器,因此請務必找時間執行備份,並且最好是在您準備要設定暫置環境之前。在您繼續實際重新命名之前,只要正式作業環境已有所變更,就需要先重新產生對映檔,再將它匯入至暫置伺服器。在伺服器關閉期間,使用者將無法從與所要重新命名之 CLM 部署整合的任何外部系統中,建立或遍訪鏈結。

    1. 在正式作業環境中,停止 Jazz Team Server 和任何已向 Jazz Team Server 登錄的分散式 CLM 應用程式。
    2. 備份 CLM 4.0 正式作業環境中的所有資料庫,包括 Jazz Team Server 資料庫、CCM 和 QM 應用程式的資料庫、資料倉儲資料庫,以及 RRDI 內容儲存資料庫。遵循移動 CLM 資料庫中的步驟,將資料庫從正式作業環境複製到暫置環境。
    3. 將 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
    4. 將應用程式配置檔從來源正式作業伺服器,複製到目標暫置伺服器。(若為分散式系統,請移至適當的伺服器,以複製檔案。)如同上述步驟,以下也是以 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
    5. 將對映檔複製到正式作業伺服器上的 TargetJazzInstallDir\server 目錄。如需對映檔的詳細資料,請參閱準備對映檔。
      註: 在您執行下一步之前,只要 CLM 部署的配置已有所變更,就需要重新產生對映檔。
    6. 重新啟動所有 CLM 伺服器,允許使用者繼續使用正式作業環境。 其餘步驟全部都適用於暫置測試環境。
  3. 在暫置測試環境中執行下列步驟:
    1. 將正式作業環境中的資料庫備份還原至暫置環境。建議您在暫置環境中使用另一部資料庫伺服器,以避免正式作業資料庫伺服器受到壓力。
    2. 在 JazzInstallDir/server/conf/applicationName/teamserver.properties 檔中更換資料庫連線參數,使其指向測試環境中資料庫暫置副本的連線參數。 這些包括 jts 資料庫、ccm 和 qm 應用程式資料庫、資料倉儲資料庫及更新的密碼的項目。
    3. 對於對映檔的虛擬對映還有另一項預防措施(如果您的環境容許的話),即更新 hosts 檔,以防止存取正式作業系統 URL,及防止意外編輯到正式作業伺服器中的構件。

      這裡的目標是將主機名稱解析為虛假的 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
    4. 在 JazzInstallDir\server 目錄中開啟命令提示字元,並且使用 repotools-jts -importURLMappings 指令,將對映檔匯入至目標 Jazz Team Server。
      • 如果您有單一伺服器部署,請使用 repotools-jts -importURLMappings 指令匯入對映檔,如下所示:

        For Windows operating system repotools-jts.bat -importURLMappings fromFile="C:\mappings.txt"

        For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="opt/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= 參數,如以下所示。

        For Windows operating system repotools-jts.bat -importURLMappings fromFile="C:\mappings.txt" serverConfFile="C:\serverConf.txt"

        For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="/opt/mappings.txt" serverConfFile="/opt/serverConf.txt"

      • 如果您有分散式 CLM 部署,並且不能夠重新對映網路磁碟機,請繼續執行 repotools-jts -importURLMappings 指令,如下所示:

        For Windows operating system repotools-jts.bat -importURLMappings fromFile="C:\mappings.txt"

        For Unix operating systems ./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 檔案,以驗證重新命名是否成功。 若顯示任何錯誤,或您知道自己在對映檔中犯了錯,請參閱伺服器重新命名的疑難排解,精確找出問題並加以修正。

      註: 對於 z/OS® 上執行的伺服器,應該使用範例 JCL 成員 HLQ.SBLZSAMP(BLZRENAM) 來重新命名。如需詳細的自訂指示,請參閱 BLZRENAM 中的註解標頭。
  4. 啟動 Jazz Team Server 和任何已向 Jazz Team Server 登錄的分散式 CLM 應用程式。

    此時,CLM 應用程式將與 Jazz Team Server 同步化,來套用 URL 對映,並更新其資料倉儲資料。小資料集大約需要 5 分鐘,超大資料集可能多達 30 分鐘以上。

  5. 登入 Jazz Team Server at https://new host:port/jts/serverRenameStatus,以驗證重新命名的狀態。

    等待所有應用程式重新命名以及「終結伺服器重新命名」步驟的完成。驗證下列訊息出現:伺服器重新命名順利完成。Jazz Team Server 及應用程式完全運作。您可以立即開始使用伺服器,不需要重新啟動。

    若有顯示任何錯誤,請參閱伺服器重新命名的疑難排解,精確找出問題並加以修正。

    註: 在重新命名完成之前,只要嘗試登入任何 CLM 應用程式的 Web 使用者介面,都會重新導向至這個狀態頁面。
  6. 執行驗證伺服器重新命名中說明的伺服器重新命名驗證步驟。
    註: 如果您建立虛擬對映來保護正式作業環境,您應該會在暫置伺服器的「應用程式診斷」頁面的應用程式和夥伴區段中,看到這些 URL 的相關錯誤。
  7. 選用:執行下列步驟,在暫置環境中配置 Rational Reporting for Development Intelligence (RRDI):
    1. 備份正式作業環境中的下列資料庫,並在暫置環境中,將它們還原到 RRDI 新安裝架構的新資料庫伺服器上:
      • 內容儲存資料庫(例如:RICM)
      • 資料倉儲(例如 RIDW,如果尚未備份和還原的話)。
    2. 將 Rational Reporting for Development Intelligence 2.0 版安裝在暫置環境中。如需詳細資料,請參閱使用 Installation Manager 來安裝 Rational Reporting for Development Intelligence。
    3. 執行「RRDI 設定」應用程式,來配置報告伺服器。如需詳細資料,請參閱後置安裝作業。請記得執行下列動作:
      • 在配置內容儲存資料庫頁面中,指定您在步驟 7.a 所還原之內容儲存資料庫(例如:RICM)的連線內容。
      • 在配置資料倉儲頁面中,指定您在步驟 7.a 所還原之資料倉儲資料庫(例如:RIDW)的連線內容。
    4. 登入 Jazz Team Server,並將儲存在 Jazz Team Server 的進階內容以及 CCM 和 QM 的「管理」頁面中的報告伺服器 URL,更新為指向暫置 RRDI 報告伺服器。
      註: 只有在您的對映檔遺漏 RRDI 的 URL 時,才需要執行這個步驟。
    5. 驗證先前從正式作業 RRDI 報告伺服器匯入的所有報告,都能繼續運作。
    6. 其動作設為檢視最新報告的任何 Cognos 報告或報告視圖,在 CLM 伺服器重新命名之後必須重新執行,才能使快取的 HTML 報告更新。
      1. 登入 RRDI 報告伺服器。
      2. 尋找含有快取的輸出版本的報告或報告視圖。
        註: 如果報告或報告視圖有快取的輸出版本,您可以對此報告按一下檢視輸出版本,以檢視快取的報告。如果報告或報告視圖是在 CLM 伺服器重新命名之前產生,您必須重新執行報告或報告視圖才能更新它們。否則,執行報告或報告視圖的使用者會看到指向舊 CLM 伺服器的舊鏈結。
      3. 按一下使用選項執行,以重新執行報告或報告視圖。
      4. 在報告檢視器中,按一下保留這個版本 > 儲存報告,以更新與報告或報告視圖相關聯的快取輸出版本。
    7. 從暫置 RRDI 報告伺服器匯入新的報告。請驗證匯入成功,且匯入的報告在執行時沒有問題。
    8. 如果您在 RRDI 中配置了 Rational Quality Manager 即時報告,請遵循步驟,為新的伺服器產生 xdc 檔,並在 32 位元 ODBC 管理程式中配置它。如需詳細資料,請參閱設定即時報告。
  8. 如果您的暫置環境還包含其他元件,例如 Rational Team Concert 用戶端、Rational ClearQuest 或 Rational ClearCase,請執行其他任何必要的步驟。如需詳細資料,請參閱 限制和其他資訊。

意見