在升級 Jazz Team Server 之後移轉 Jazz 儲存庫

儲存庫移轉是一種將資料庫內容從某種格式轉換另一種格式的程序。當您將 Jazz™ Team Server 從 X 版本升級至 Y 版本,而 Y 版本的綱目已有變更,就必須執行儲存庫移轉。
開始之前
只要兩個 Jazz Team Server 版本之間有任何的綱目變更,就必須執行資料移轉。您必須已同時擷取 Jazz Team Server X 和 Y 版本的壓縮檔。
執行這項作業的原因和時機
一般而言,資料移轉程序有兩個步驟:

儲存庫移轉圖

您可以使用 repotools 應用程式來執行匯出與匯入作業。
註: 在您移轉儲存庫時,必須停止 Jazz Team Server。視您機器的配置、作業系統、資料庫等而定, 移轉可能耗費頗長的時間。因此,請適當排程您的停機時間。

移轉全文目錄

Jazz Team Server 可管理位於資料庫外、並儲存處理全文查詢所需之所有資料的目錄。目錄的位置配置在 teamserver.properties 檔的 com.ibm.team.fulltext.indexLocation 內容之下。當移轉資料庫時, 如果您想使用先前用於檢索的目錄, 您必須確定 -rebuildTextIndices 儲存庫工具中使用的位置, 符合伺服器使用的位置。在您啟動伺服器或執行 -rebuildTextIndices 指令時,會將全文目錄位置的絕對路徑列印在日誌檔中。您可以檢查伺服器日誌檔和 repotools_rebuildTextIndicies 日誌檔, 比較這兩個目錄。
提示: 如果 teamserver.properties 檔中所配置的目錄是一個相對路徑,則會將警告列印在日誌檔中。建議您將這個內容配置成絕對目錄路徑。
如需建立全文索引的相關資訊, 請參閱-rebuildTextIndices

Jazz Team Server 移轉作業是一項相當密集的程序,視您要移轉的資料大小而定,可能耗費可觀的時間量。以下提供您該留意以免犯下常見錯誤之事物的核對清單。

作業系統
Jazz Team Server 設定
  • 設定以下內容(位於 teamserver.properties),以確定正在存取您最快的磁碟:
    com.ibm.team.repository.tmpdir
    com.ibm.team.scm.vcs.tmpdir
    com.ibm.team.scm.tmpdir
    com.ibm.team.fulltext.indexLocation
DB2
  • 依預設,DB2 會根據需要盡可能增長緩衝池大小。除非您停用此項,在現成設定下,DB2 應可執行適當。
  • 如果要檢查緩衝池,請執行下列動作:
    1. 在命令提示字元中輸入下列指令,以連接作為您匯入目標的 Jazz 資料庫:
      db2 connect to <databaseName>
    2. 然後,執行下列指令:
      db2 "select bufferpoolid, bpname from syscat.bufferpools"
      這會輸出下列格式的緩衝池 ID:
      BUFFERPOOLID BPNAME
      ------------ ----------------------------------
                 1 IBMDEFAULTBP
      
        已選取 1 筆記錄。
    3. 在上述範例中,緩衝池 ID 是 1。接著,執行下列指令:
      db2mtrk -d
      這會輸出類似如下的資料:
      正在追蹤記憶體,日期:2009/06/04,時間:22:19:17
      
      <databaseName> 資料庫的記憶體
         utilh       pckcacheh   other       catcacheh   bph (1)     bph (S32K)
         64.0K       384.0K      128.0K      128.0K      95.4M       832.0K
      
         bph (S16K)  bph (S8K)   bph (S4K)   shsorth     lockh       dbh
         576.0K      448.0K      384.0K      64.0K       2.5M        20.8M
      
         apph (269)  apph (268)  apph (267)  apph (266)  apph (265)  apph (262)
         64.0K       64.0K       64.0K       64.0K       64.0K       64.0K
      
         appshrh
         128.0K
      粗體輸出表示已配置給您資料庫的緩衝池大小。
Oracle
  • 停用資源回收筒 -「資源回收筒」會追蹤已刪除的所有元素,填滿磁碟,而可能會實際造成問題。請在 sqlplus 中執行下列指令:
    "ALTER SYSTEM SET RECYCLEBIN" = 'OFF' 
    "PURGE RECYCLEBIN"
  • 停用「保留統計資料歷程」-「保留統計資料歷程」會追蹤過去方法的執行時期:
    "exec dbms_stats.ALTER_STATS_HISTORY_RETENTION (0)"
    "exec dbms_stats.PURGE_STATS ( current_timestamp )"
  • 確定 Oracle 表格空間僅跨過單一檔案

如果要開始移轉,請執行下列動作:

  1. 停止 X 版本的 Jazz Team Server 如果要停止 Jazz Team Server,請執行包裝在 [installDir]/jazz/server 中的 server.shutdown.sh(若為 Linux)或 server.shutdown.bat(若為 Windows)。
  2. 備份 Jazz 儲存庫。備份僅是一個預防移轉出錯的手段。
    1. 若為 Derby,請針對整個資料庫目錄,建立一份保存副本。
    2. 若為 DB2,請使用 DB2 備份指令,在指定的目標目錄中,產生一個內含日期和時間資訊的資料庫保存檔。
  3. 備份全文索引。全文索引的位置指定在 teamserver.properties 檔的 com.ibm.team.fulltext.indexLocation 內容中。
  4. 執行 repotools,以匯出儲存庫中的資料。 Script(在 Linux 上是 repotools.sh,在 Windows 上是 repotools.bat) 是包裝在 [installDir]/jazz/server 目錄中。

    範例:repotools -export toFile=./file_name.tar

    註: 日誌資訊與錯誤訊息會顯示在主控台與日誌檔中。日誌檔含有匯出的項目數、項目的匯出時間、錯誤等除錯相關資訊,以及其他有用的資訊。依預設,會將日誌檔建立在和 repotools Script 相同的目錄中。您可以使用 logFile 參數,來變更日誌檔的位置。
    現在,您已將儲存庫的內容匯出至 TAR 檔。
  5. teamserver.properties 檔從 X 版本的 [installDir]/jazz/server 複製至 Y 版本的 [installDir]/jazz/server
  6. 從 Y 版本執行 repotools,以便將 TAR 檔中的資料匯入至儲存庫。
    範例:repotools -import fromFile=./file_name.tar
    重要: 如果您的資料庫不是 Derby,在執行匯入工具之前,必須先建立新的資料庫。
    註: -import 選項會記載已匯入和跳過的項目,以及匯入期間的錯誤等相關資訊。
下一步
現在您可以啟動 Y 版本的 Jazz Team Server

意見

以上說明對您有幫助嗎?您可以在 Jazz.net 網站中提供意見(需要登錄):在討論區中提供意見提交錯誤