利用伺服器重新命名,將試驗部署移至正式作業

這個主題說明在將小型試驗 CLM 部署移至正式作業時,變更伺服器 URL 所需的步驟。

開始之前

在繼續進行重新命名之前,請檢查您的環境是否符合從試驗到正式作業實務的準則。如需詳細資料,請參閱支援的實務。

重要: 如果要執行伺服器重新命名,Jazz™ Team Server 和所有 CLM 應用程式必須是第 4 版或更新版本。

下圖顯示重新命名的一般流程。

試驗到正式作業實務

關於這項作業

在此程序中,您將資料和配置檔從試驗伺服器複製到正式作業伺服器。 因為您要移動而非複製資料庫,所以必須使試驗環境永久無法運作,以避免污染正式作業環境。

伺服器重新命名特性採用對映檔來決定應該重新命名的 URL。 提供的 repotools 指令可以為您產生起始對映檔。 對映檔包含 JTS 和所有應用程式及應用程式所提供的其他任何 URL 的 source-target 配對。 請參閱瞭解伺服器重新命名使用的對映檔,取得對映檔的其他詳細資料。如需拓蹼圖和對映檔範例,請參閱「試驗至正式作業」實務的拓蹼與對映檔。

程序

  1. 當您的伺服器仍在線上時,請遵循準備對映檔主題所說明的步驟,在實際重新命名之前先準備和檢閱對映檔。

    如果您要將部署移至新電腦,請在新電腦執行安裝。如果您要在相同的電腦上變更 URL,請在與現有的安裝不同的目錄中執行安裝。 如果您也要變更環境定義根目錄,請參閱變更環境定義根目錄。

    預備階段的最終結果會是在試驗的 Jazz Team Server 上產生的對映檔。對映檔包含 Jazz Team Server 和所有應用程式及應用程式所提供的其他任何 URL 的 source-target 配對。

  2. 備份第 4 版試驗環境,並將文字索引和應用程式配置檔複製到新的安裝。
    1. 停止 Jazz Team Server 和任何已向 Jazz Team Server 登錄的分散式 CLM 應用程式。

      此外,請停止受到伺服器重新命名影響的任何其他應用程式,例如 Jazz Build Engine,或任何受影響的已支援整合,例如 Rational Reporting for Development Intelligence (RRDI)、Rational® ClearCase® 或 Rational ClearQuest®。

      註: 在伺服器關閉期間,使用者將無法從與所要重新命名之 CLM 部署整合的任何外部系統中,建立或遍訪鏈結。
    2. 備份 CLM 4.0 試驗環境中的所有資料庫,包括 Jazz Team Server 資料庫、CCM 和 QM 應用程式的資料庫、資料倉儲資料庫,以及 RRDI 內容儲存資料庫(如果您使用 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 目錄。如需對映檔的詳細資料,請參閱準備對映檔。
  3. 使用 repotools-jts -importURLMappings 指令,將對映檔匯入目標正式作業 Jazz Team Server,以執行伺服器重新命名的離線部分。
    1. 如果您有單一伺服器部署,請使用 repotools-jts -importURLMappings 指令匯入對映檔,如下所示:
      • For Windows operating system repotools-jts.bat -importURLMappings fromFile=".\mappings.txt"
      • For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="./mappings.txt"

      在伺服器重新啟動之前,Jazz Team Server 上會開始執行離線重新命名。

    2. 如果您採取分散式部署,並且容許您對映網路磁碟機,請將網路磁碟機從 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=".\mappings.txt" serverConfFile=".\serverConf.txt"
      • For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="./mappings.txt" serverConfFile="./serverConf.txt"
    3. 如果您有分散式 CLM 部署,並且不能夠重新對映網路磁碟機,請繼續執行 repotools-jts -importURLMappings 指令(無 serverConfFile= 參數)。然後,將 server/conf/jts/.mappingEvent 檔案複製到遠端應用程式配置目錄 (server/conf/application_name),亦即,ccm、qm 和 rm。當您匯入對映時會產生事件檔案。複製 .mappingEvent 檔的時機,必須是在匯入對映檔之後,啟動伺服器之前。

      .mappingEvent 檔包含應用程式在其新位置聯絡 Jazz Team Server 所需的資訊。.mappingEvent 檔的內容與給定 Jazz Team Server 和其已登錄的應用程式相同。

    註: 對於 z/OS® 上執行的伺服器,應該使用範例 JCL 成員 HLQ.SBLZSAMP(BLZRENAM) 來重新命名。如需詳細的自訂指示,請參閱 BLZRENAM 中的註解標頭。

    檢查主控台輸出和 JazzInstallDir/server/repotools-jts_importURLMappings.log 檔案,以驗證重新命名是否成功。 若顯示任何錯誤,或您知道自己在對映檔中犯了錯,請參閱伺服器重新命名的疑難排解,精確找出問題並加以修正。

  4. 啟動 Jazz Team Server 和任何已安裝的分散式 CLM 應用程式。

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

  5. 登入 Jazz Team Server:https://hostname:port/jts/serverRenameStatus(例如,https://clmhost.production.example.org:9443/jts/serverRenameStatus),以追蹤重新命名的進度。此頁面會自動重新整理,直到重新命名完成為止。

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

    註: 在重新命名完成之前,只要嘗試登入任何 CLM 應用程式的 Web 使用者介面,都會重新導向至這個狀態頁面。
  6. 執行驗證伺服器重新命名中說明的伺服器重新命名驗證步驟。
  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 報告伺服器。如果它們未指向正式作業系統,請更新它們,以指向正式作業系統。
      註: 如果對映檔包含報告伺服器 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. 執行與如下的其他元件和產品整合時,所需的其他任何伺服器重新命名後置步驟:Jazz Build Engines、Rational Reporting、Rational Team Concert 用戶端、Rational ClearQuest 或 Rational ClearCase。如需詳細資料,請參閱 限制和其他資訊。

意見