從 UCM 串流匯入 ClearCase 歷程

使用「 ClearCase® 匯入器」,將 Rational® ClearCase 資料連同完整或局部基準線歷程,從 UCM 串流匯入至 Rational Team Concert™ Source Control。匯入之後,您就可以在 Rational Team Concert Source Control 中修改檔案,但是您無法匯出至 ClearCase。
開始之前

您必須先配置一個同步化主機,然後建立與新增同步化程序帳戶,才能匯入 ClearCase 資料與基準線歷程。如果您只想從 UCM 串流匯入一部分的基準線歷程,而非所有的基準線歷程,則必須同時準備 ClearCase 資料。

執行這項作業的原因和時機
當您完成或驗證所有的必備需求之後,請完成下列作業來匯入 UCM 串流,並選取要與歷程從 UCM 串流一起匯入的檔案與資料夾。

匯入 ClearCase UCM 串流

請完成下列步驟,以建立同步化串流來匯入 UCM 基準線歷程。
  1. 按一下檔案 > 匯入
  2. 匯入視窗中,展開 Jazz Source Control,選取 ClearCase 串流或分支,然後按下一步
  3. ClearCase 串流資訊頁面中,選取從 ClearCase 與歷程一起匯入 因為「ClearCase 匯入器」不會將 Rational Team Concert Source Control 中的變更匯出至 ClearCase,也就不會使用分支資訊,所以分支類型欄位會停用。按一下確定,關閉與歷程一起匯入資訊視窗。
  4. 指定配置給精靈為了支援匯入程序而建立的 Rational ClearCase 動態視圖:
    1. 如果要從 UCM 串流來配置視圖,請選取從現有的 UCM 串流匯入
    2. stream-name@PVOB-tag 格式,輸入現有串流的名稱。 比方說,如果要在含有 \projects 標籤的 PVOB 中,指定名稱為 my_stream 的串流,請輸入 my_stream@\projects。 請利用 cleartool lsstream 指令或「Rational ClearCase 專案瀏覽器」來搜尋串流名稱。
    註: 您無法從唯讀串流匯入 ClearCase 歷程。 如果母項串流不是唯讀的,則您可以從母項串流匯入歷程,不然,您也可以建立與唯讀子項串流完全相同、可寫入的新子項串流,然後從新的串流匯入歷程。
    精靈會驗證串流名稱的語法(而不是存在與否),然後啟用下一步按鈕。
  5. 下一步
  6. ClearCase 儲存體資訊頁面中,指定一個目錄的網路路徑,讓精靈可以在這個目錄中為 Rational ClearCase 動態視圖建立視圖儲存體,以啟用從 Rational ClearCase 匯入至 Jazz™。 「匯入器」會在這個項目中,植入本端主機名稱和 \VIEWSTORAGE 字串所組成的網路路徑。 如果這個目錄存在在本端主機上,且是視圖儲存體的有效位置(在 Windows® 上,它必須共用;或者,在 UNIX® 系統或 Linux® 上,必須將它匯出),您可以使用它。 否則,請指定另一個能夠建立視圖儲存體之本端或遠端目錄的網路路徑。 精靈會建立含有這個目錄中之儲存體的動態視圖,以及特殊視圖標籤(DO_NOT_USE 字首及 UUID 字尾)。 這個視圖應該被視為 Rational ClearCase 使用者禁區。

    適用的話,請勾選請輸入建立 ClearCase 視圖時的其他選項集資訊,然後為 ClearCase 伺服器儲存體位置的「主機」、「主機路徑」及「廣域路徑」輸入適當的值: 分別代表主機名稱、主機本端路徑及廣域儲存體路徑。

  7. 下一步。 精靈會驗證視圖儲存體路徑,而如果有提供廣域儲存體路徑,同樣會驗證。
  8. 選取專案區域或團隊區域頁面上,展開儲存庫項目,並選取您在其中新增同步化程序帳戶的專案區域或團隊區域(請參閱新增同步化程序帳戶至團隊區域中)。 如果儲存庫下沒有任何項目,請驗證您已連接專案區域,然後再試一次。按下一步
  9. Jazz Source Control 資訊頁面會顯示精靈將建立的合併工作區名稱。 如果想要的話,您可以選擇另一個名稱。 如果儲存庫包含所選名稱的工作區,精靈會在其後加上字串,使它成為唯一名稱。 (合併工作區是一個儲存庫工作區,供您解決在 Rational ClearCaseRational Team Concert Source Control 中平行修改檔案或資料夾時所發生的衝突)。
  10. 這個欄位中會顯示預設的同步化使用者 ID(預設 ID 是 ccsync)。 如果您使用的同步化使用者 ID 不是預設值,請將 ID 改為正確的值。 輸入同步化使用者 ID 的密碼。 如需相關資訊,請參閱建立同步化程序帳戶
  11. 連接器安裝位置欄位中,輸入 ClearCase Connector 在這部主機中的安裝路徑名稱,或按一下瀏覽,以瀏覽並找出它。 ClearCase Connector 通常安裝在 Rational Team Concert 安裝目錄中。
  12. 選取在精靈完成之後,啟動「Jazz 同步化引擎」程序,然後選取在這個精靈完成之後,啟動「選取檔案」精靈
  13. 按一下完成 「ClearCase 匯入器」會在 Rational Team Concert 中建立同步化串流,在背景啟動同步化引擎程序,然後開啟選取檔案精靈。

匯入檔案、資料夾與歷程

執行這項作業的原因和時機
選取檔案精靈中,選取 ClearCase 檔案與資料夾作為同步化根目錄,並針對每一個資料夾所屬的元件,選擇要匯入其所有或僅部分的基準線。
  1. 選取要匯入的檔案頁面中,完成下列其中一個動作,以便在您要匯入其基準線的 UCM 元件中,選取檔案與資料夾。
    限制: 您選取的資料夾或檔案,在所有您要匯入的基準線中,必須是可見的。在匯入每一個連續的基準線時,在該基準線中,凡是非可見的同步化根目錄都會被移除。一旦資料夾被當成同步化根目錄而移除之後,就不會進一步匯入該資料夾的基準線資訊,即使它仍存在於後續的基準線中。
    • 如果檔案與資料夾已與歷程一起匯入,請選取在表格中顯示目前匯入的物件,以便在匯入表格中顯示同步化根目錄。
    • 如果要瀏覽已裝載的 VOB 來選取檔案和資料夾,請按一下瀏覽來顯示同步化主機所裝載的 VOB 清單。 (如果要加快瀏覽速度,請卸載任何不想存取的 VOB 。) 如果視窗中沒有可見的 VOB,請驗證同步化主機已裝載您要從中匯入的 VOB。 選好檔案和資料夾之後,請按一下「確定」關閉瀏覽器,並將所選的路徑顯示在匯入表格清單中。
    • 如果要手動選取檔案和資料夾,請輸入您在匯入精靈中指定之 Rational ClearCase 串流中的可見路徑名稱,然後按一下新增。 路徑名稱必須相對於起始視圖。 如果您使用 UCM 串流,路徑名稱結尾必須是 UCM 元件的根。 您指定用於匯入的所有路徑名稱都必須開始於 VOB 標籤(前面沒有 / 或 \ 字元),且包括從 VOB 根到專案根資料夾的完整路徑。 例如:

      sources\eclipse_projects\my_project

      會選取 VOB 標籤為 \sources 之 VOB 的 eclipse_projects 資料夾中所儲存名稱為 my_project 的資料夾。
  2. 選擇要匯入的基準線區域中,針對同步化根目錄所屬的每一個元件,選取您要匯入的基準線歷程:
    • 選取匯入所有基準線,以便從 Rational ClearCase 串流中的所有基準線匯入歷程。
    • 如果您想要匯入具有相關特定屬性類型的部分基準線,請選取匯入具有下列屬性類型的所有基準線。 您可以使用 Rational ClearCase,讓屬性類型與特定的基準線產生關聯。 (請參閱上述開始之前中的詳細資料。)
  3. 按一下完成,以關閉選取檔案精靈,並開始匯入指定的 ClearCase 檔案和資料夾以及基準線歷程。 視元件的大小、元件在串流中的基準線數目,以及基準線中的可用歷程資料量而定,匯入時間可能從數分鐘到數小時或數天不等。
結果
在起始匯入之後,您可以對同步化串流執行同步化,以匯入指定檔案與資料夾的後續基準線歷程。在起始匯入之後,如果您選取其他的檔案及/或資料夾作為同步化根目錄,它們就不會從起始基準線與歷程一起匯入。它們只能與歷程從前次匯入之後才出現的基準線匯入。
提示: 如果要匯入其他檔案和資料夾,以及與原來匯入的檔案和資料夾一樣的歷程,請建立新的同步化串流,然後選取一個同步化根目錄,其中包含您要與歷程一起匯入的所有檔案與資料夾。

意見

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