使用內容轉移工具

使用內容轉移工具的重要考量

請跟隨以下章節,了解執行「內容轉移工具」時的重要考量:

  • 「內容轉移工具」的最低系統需求為 AEM 6.3 + 和 JAVA 8。如果您使用較舊版本的 AEM,您必須將內容存放庫升級至 AEM 6.5 才能使用「內容轉移工具」。

  • Java必須在AEM環境上設定,如此java命令就可由啟動AEM的使用者執行。

  • 內容傳輸工具可與下列類型的資料儲存區搭配使用:檔案資料儲存、S3資料儲存、共用S3資料儲存和Azure Blob儲存資料儲存。

  • 如果您使用​沙盒環境,請確定您的環境是最新的,並升級至最新的版本。 如果您使用​生產環境,則會自動更新。

  • 若要使用「內容傳輸工具」,您必須是來源例項的管理員使用者,且屬於您要傳輸內容至之Cloud服務例項中的本機AEM管理員群組。 無權限的使用者將無法擷取能使用「內容轉移工具」的存取 Token。

  • 存取Token可在特定時段後或雲端服務環境升級後定期到期。 如果存取Token已過期,您將無法連線至Cloud Service實例,而您必須擷取新的存取Token。 與現有移轉集相關聯的狀態圖示將變更為紅色雲端,並會在您將滑鼠暫留在紅色雲端時顯示訊息。

  • 內容傳輸工具所傳輸的使用者和群組僅是內容滿足權限所需的使用者和群組。 Extraction​進程將整個/home複製到遷移集中,而​Ingestion​進程複製遷移內容ACL中引用的所有用戶和組。 若要自動將現有使用者和群組對應至其IMS ID,請參閱使用使用者對應工具

  • 在提取階段中,「內容轉移工具」會在作用中的 AEM 來源例項上執行。

  • 在完成內容傳輸程式的​Extraction​階段後,以及開始​Ingestion Phase​將內容以雲端服務​Stage​或​Production​執行個體形式收錄至AEM之前,您將需要記錄支援票證以通知Adobe執行​Ingestion,讓Adobe可以確保在​Ingestion​程式期間不會發生中斷。 您需要在計畫的​Ingestion​日期前1週記錄支援票證。 一旦您提交了支援票證,支援團隊將提供後續步驟的指導。

    • 使用下列詳細資訊記錄支援票證:
      • 當您計劃開始​Ingestion​階段時,請精確確定日期和估計時間(與時區相同)。
      • 您打算將資料收錄到的環境類型(「舞台」或「生產」)。
      • 程式ID。
  • 製作的​擷取階段​將縮小整個製作部署。這表示在整段擷取程序中,將無法使用製作 AEM。此外,請確保在運行​Ingestion​階段時不執行Cloud Manager管道。

可用性

內容傳輸工具可從軟體散發入口網站下載為zip檔案。 您可以透過「封裝管理程式」,在來源 Adobe Experience Manager AEM) 例項上安裝封裝。請確定下載最新版本。 有關最新版本的詳細資訊,請參閱發行說明

注意

軟體發佈入口網站下載內容轉移工具。

執行「內容轉移工具」

請依照以下章節了解如何使用「內容轉移工具」,將內容移轉至 AEM as a Cloud Service (製作/發佈):

  1. 選擇 Adobe Experience Manager 並導覽至工具 -> 操作 -> 內容轉移

    影像

  2. 當您建立第一個移轉集時,會顯示下列主控台。 按一下​建立移轉集​以建立新的移轉集。

    影像

    注意

    如果您有現有的移轉集,主控台將顯示現有移轉集的清單,其目前狀態為。

  3. 請依照下方敘述,填入​內容移轉集詳細資訊​畫面中的欄位。

    影像

    1. 名稱:輸入移轉集名稱。

      注意

      移轉集名稱不允許使用特殊字元。

    2. Cloud Service 設定:輸入目標 AEM as a Cloud Service 製作 URL。

      注意

      在內容轉移活動期間,您一次最多可以建立並維護四個移轉集。
      此外,您還須針對每個特定環境 (預備開發​或​生產) 分別建立移轉。

    3. 存取 Token:輸入存取 Token。

      注意

      您可以使用​開啟存取Token​按鈕來擷取存取Token。 您必須確定您屬於目標Cloud服務例項中的AEM管理員群組。

    4. 參數:選取以下參數以建立移轉集:

      1. 包含版本:視需要選取。

      2. 欲包含的路徑:使用路徑瀏覽器來選取需要移轉的路徑。路徑選擇器可通過輸入或選擇接受輸入。

        重要

        建立移轉集時會限制下列路徑:

        • /apps
        • /libs
        • /home
        • /etc
  4. 在填入​內容移轉集詳細資訊​畫面中的所有欄位後,請按一下​儲存

  5. 您的移轉集會顯示在​綜覽​頁面中。

    影像

    「綜覽」​頁面中將顯示此畫面中上的所有現有移轉集,以及它們的目前狀態與狀態資訊。您可能會看到以下說明的部分圖示。

    • 紅色雲朵​表示您無法完成提取程序。
    • 綠色雲朵​表示您可以完成提取程序。
    • 黃色圖示​表示您並未建立現有移轉集,且該特定移轉集是由相同例項中的其他使用者所建立。
  6. 從「綜覽」頁面選取移轉集,然後按一下​屬性​以檢視或編輯移轉集屬性。編輯屬性時,無法變更容器名稱或服務URL。

內容轉移中的提取程序

請依照下列步驟,從「內容轉移工具」中提取您的移轉集:

  1. 從​「綜覽」​頁面選取一個移轉集,然後按一下​提取​即可開始提取。將顯示​遷移集抽取​對話框,然後按一下​抽取​以啟動抽取階段。

    影像

    注意

    您可以選擇在提取階段中覆寫預備容器。

  2. EXTRACTION​欄位現在顯示​RUNNING​狀態,以指示正在進行抽取。

    影像

    提取一旦完成,移轉集的狀態會更新為​已完成,而​資訊​欄位下會顯示一個​實心綠色​的雲朵圖示。

    影像

    注意

    UI有自動重新載入功能,每30秒重新載入一次概述頁面。
    提取階段開始時將建立寫入鎖定,並在 60 秒​後釋放。因此,如果提取停止,則需等待一分鐘才能釋放鎖定並重新開始提取。

追加提取

「內容轉移工具」具備支援追加差異內容的功能,可以只轉移在上一次內容轉移活動後所進行的變更。

注意

初始轉移內容後,建議您先頻繁地執行追加差異內容,以縮短最終差異化內容轉移的內容凍結時間,然後再於雲端服務上線。

提取程序一旦完成,您即可使用追加提取方法來轉移差異內容。請遵循下列步驟:

  1. 導覽至​綜覽​頁面,並選取您要執行追加提取的移轉集。按一下​提取​即可開始追加提取。移轉集提取​對話框隨即顯示。

    重要

    您必須停用​在提取期間覆寫預備容器​選項。

    影像

內容轉移中的擷取程序

請依照下列步驟,從「內容轉移工具」中擷取您的移轉集:

  1. 從​綜覽​頁面選取一個移轉集,然後按一下​擷取​即可開始擷取。移轉集擷取​對話框隨即顯示。按一下​Ingest​以開始接收階段。 為了示範,已停用​將內容擷取至製作例項。您可以同時將內容擷取至「製作」和「發佈」。

    重要

    啟用​在擷取​選項前擦除雲端例項上的現有內容時,它會刪除整個現有儲存庫並建立新儲存庫,以將內容擷取至。 這表示它會重設目標Cloud服務例項的所有設定,包括權限。

    影像

  2. 擷取完成後,PUBLISH INGESTION​欄位中的狀態會更新為​FINISHED

    影像

追加擷取

「內容轉移工具」具備支援​追加​差異內容的功能,可以只轉移在上一次內容轉移活動後所進行的變更。

注意

初始轉移內容後,建議您先頻繁地執行追加差異內容,以縮短最終差異化內容轉移的內容凍結時間,然後再於雲端服務上線。

擷取程序一旦完成,您即可使用追加擷取方法來轉移差異內容。請遵循下列步驟:

  1. 導覽至​綜覽​頁面,並選取您要執行追加擷取的移轉集。按一下​擷取​即可開始追加提取。移轉集擷取​對話框隨即顯示。

    重要

    您應停用「擷取​之前先擦除雲端例項上的現有內容」選項,以防止從先前的擷取活動中刪除現有內容。

    影像

檢視移轉集記錄

您可以在​綜覽頁面中檢視現有移轉集記錄。
請遵循下列步驟:

  1. 導覽至​綜覽​頁面,並選取您要刪除的移轉集,然後按一下動作列中的​檢視記錄

    影像

  2. 記錄​對話框隨即顯示。按一下​提取記錄,即可在新索引標籤中檢視記錄。

    影像
    或者,

    您也可以在​綜覽​畫面中檢視移轉集記錄。請選取移轉集,然後按一下​提取​欄位下的狀態。在這個情況下,按一下​已完成​即可在新索引標籤中檢視記錄。

    影像

  3. 若要追蹤記錄而不使用使用者介面,您可以透過 SSH 連線至來源 AEM 環境,並追蹤 crx-quickstart/cloud-migration/extraction-XXXXX/output.log file

刪除移轉集

您可以在​綜覽頁面中刪除移轉集。
請遵循下列步驟:

  1. 導覽至​綜覽​頁面,並選取您要刪除的移轉集,然後按一下動作列中的​刪除

    影像

  2. 在​刪除移轉集​對話框中按一下​刪除​以確認刪除。

    影像

疑難排解

遺失 Blob ID

如有回報指出遺失 Blob ID (如下所述),則需要在現有存放庫中執行一致性檢查,並還原遺失的 Blob。
ERROR o.a.j.o.p.b.AbstractSharedCachingDataStore - Error retrieving record [ba45c53f8b687e7056c85dceebf8156a0e6abc7e]

以下命令將會執行

注意

如果要回報引用 Blob 的節點路徑,則須使用 --verbose 旗標。

存放庫 AEM 6.5 (Oak 1.8 及以下的版本)

java -jar oak-run.jar datastorecheck --consistency --store [<SEGMENT_STORE_PATH>|<MONGO_URI>] --[s3ds|fds] <DATASTORE_CFG> --verbose <OUT_DIR> --dump

具有 Oak > 1.10 的存放庫

java -jar oak-run.jar datastore --check-consistency [<SEGMENT_STORE_PATH>|<MONGO_URI>] --[s3ds|fds|azureds] <DATASTORE_CFG> --out-dir <OUT_DIR> --work-dir <TEMP_DIR> --verbose

如需詳細資訊,請參考 Oak Runnable Jar

接著,即可針對上述在 OUT_DIR 中建立、有一致性問題的檔案,檢查是否有路徑遺失二進位檔案,以及是否有採取適當操作如透過備份還原、刪除路徑、重新索引等等。

UI 行為

身為使用者,您可能會在「內容轉移工具」的使用者介面 (UI) 中看到下列行為變更:

  • 「內容轉移工具」UI 中的圖示可能與本指南中顯示的螢幕擷圖不同,也可能完全不顯示 (取決於來源 AEM 例項的版本)。

本頁內容