Show Menu
主題×

使用內容轉移工具

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

請跟隨以下章節,了解執行「內容轉移工具」時的重要考量:
  • 「內容轉移工具」的最低系統需求為 AEM 6.3 + 和 JAVA 8。如果您使用較舊版本的 AEM,您必須將內容存放庫升級至 AEM 6.5 才能使用「內容轉移工具」。
  • 內容傳輸工具可與下列類型的資料儲存區搭配使用:檔案資料儲存、S3資料儲存和共用S3資料儲存。 它目前不支援Azure Blob Store資料儲存區。
  • 如果您使用​ 沙箱環境 ,請確定您的環境已升級至 2020 年 6 月 10 日或之後發行的版本。如果您使用​ 生產環境 ,則會自動更新。
  • 如果要使用「內容轉移工具」,您必須是來源例項的管理員使用者,且屬於內容要轉移到的雲端服務例項的 AEM 管理員群組。無權限的使用者將無法擷取能使用「內容轉移工具」的存取 Token。
  • 在提取階段中,「內容轉移工具」會在作用中的 AEM 來源例項上執行。
  • 製作的​ 擷取階段 ​將縮小整個製作部署。這表示在整段擷取程序中,將無法使用製作 AEM。
  • 我們建議,「內容轉移工具」一次可支援的存放庫大小上限應為 20GB。

可用性

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

執行「內容轉移工具」


請依照以下章節了解如何使用「內容轉移工具」,將內容移轉至 AEM 雲端服務 (製作/發佈):
  1. 選擇 Adobe Experience Manager 並導覽至工具 -> 操作 -> 內容轉移
  2. 按一下​ 建立移轉集 ​以建立新的移轉集。 內容移轉集詳細資訊 ​隨即顯示。
    您將在以下畫面中看見現有移轉集及其目前狀態。
  3. 請依照下方敘述,填入​ 內容移轉集詳細資訊 ​畫面中的欄位。
    1. 名稱 :輸入移轉集名稱。
      移轉集名稱不允許使用特殊字元。
    2. 雲端服務設定 :輸入目標 AEM 雲端服務製作 URL。
      在內容轉移活動期間,您一次最多可以建立並維護四個移轉集。 此外,您還須針對每個特定環境 ( 預備 開發 ​或​ 生產 ) 分別建立移轉。
    3. 存取 Token :輸入存取 Token。
      您可以導覽至 /libs/granite/migration/token.json ,從製作例項中擷取存取 Token。存取 Token 可從雲端服務製作例項擷取。
    4. 參數 :選取以下參數以建立移轉集:
      1. 包含版本 :視需要選取。
      2. 欲包含的路徑 :使用路徑瀏覽器來選取需要移轉的路徑。
        建立移轉集時會限制下列路徑:
        • /apps
        • /libs
        • /home
        • /etc
  4. 在填入​ 內容移轉集詳細資訊 ​畫面中的所有欄位後,請按一下​ 儲存
  5. 您的移轉集會顯示在​ 綜覽 ​頁面中。
    「綜覽」 ​頁面中將顯示此畫面中上的所有現有移轉集,以及它們的目前狀態與狀態資訊。
    • 紅色雲朵 ​表示您無法完成提取程序。
    • 綠色雲朵 ​表示您可以完成提取程序。
    • 黃色圖示 ​表示您並未建立現有移轉集,且該特定移轉集是由相同例項中的其他使用者所建立。
  6. 從「綜覽」頁面選取移轉集,然後按一下​ 屬性 ​以檢視或編輯移轉集屬性。

內容轉移中的提取程序

請依照下列步驟,從「內容轉移工具」中提取您的移轉集:
  1. 從​ 「綜覽」 ​頁面選取一個移轉集,然後按一下​ 提取 ​即可開始提取。
  2. 移轉集擷取 ​對話框隨即顯示,請按一下​ 提取 ​以完成提取階段。
    您可以選擇在提取階段中覆寫預備容器。
  3. 現在, 提取 ​欄位將針對正在進行的提取程序顯示​ 執行中 ​狀態。
    提取一旦完成,移轉集的狀態會更新為​ 已完成 ,而​ 資訊 ​欄位下會顯示一個​ 實心綠色 ​的雲朵圖示。
    您必須重新整理頁面才能檢視更新後的狀態。 提取階段開始時將建立寫入鎖定,並在 60 秒 ​後釋放。因此,如果提取停止,則需等待一分鐘才能釋放鎖定並重新開始提取。

追加提取

「內容轉移工具」具備支援追加差異內容的功能,可以只轉移在上一次內容轉移活動後所進行的變更。
初始轉移內容後,建議您先頻繁地執行追加差異內容,以縮短最終差異化內容轉移的內容凍結時間,然後再於雲端服務上線。
提取程序一旦完成,您即可使用追加提取方法來轉移差異內容。請遵循下列步驟:
  1. 導覽至​ 綜覽 ​頁面,並選取您要執行追加提取的移轉集。
  2. 按一下​ 提取 ​即可開始追加提取。
  3. 移轉集提取 ​對話框隨即顯示。
    您必須停用​ 在提取期間覆寫預備容器 ​選項。

內容轉移中的擷取程序

請依照下列步驟,從「內容轉移工具」中擷取您的移轉集:
  1. 從​ 綜覽 ​頁面選取一個移轉集,然後按一下​ 擷取 ​即可開始擷取。
  2. 移轉集擷取 ​對話框隨即顯示。
    為了示範,已停用​ 將內容擷取至製作例項 。您可以同時將內容擷取至「製作」和「發佈」。
    按一下​ 擷取 ​以完成擷取階段。
  3. 擷取一旦完成, 製作擷取 ​欄位中的狀態會更新為​ 已完成 ,而​ 資訊 ​欄位下會顯示一個實心綠色的雲朵圖示。
    您必須重新整理頁面才能檢視更新後的狀態。

追加擷取

「內容轉移工具」具備支援​ 追加 ​差異內容的功能,可以只轉移在上一次內容轉移活動後所進行的變更。
初始轉移內容後,建議您先頻繁地執行追加差異內容,以縮短最終差異化內容轉移的內容凍結時間,然後再於雲端服務上線。
擷取程序一旦完成,您即可使用追加擷取方法來轉移差異內容。請遵循下列步驟:
  1. 導覽至​ 綜覽 ​頁面,並選取您要執行追加擷取的移轉集。
  2. 按一下​ 擷取 ​即可開始追加提取。
  3. 移轉集擷取 ​對話框隨即顯示。
    您應停用​*「擦去」*選項,以防止從先前的擷取活動中刪除現有內容。

檢視移轉集記錄

您可以在​ 綜覽 頁面中檢視現有移轉集記錄。 請遵循下列步驟:
  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) 中看到下列行為變更:
  • 使用者為製作 URL (開發/預備/生產) 建立移轉集,並成功執行提取和擷取。
  • 然後,使用者會為相同的製作 URL 建立新的移轉集,並對新移轉集執行提取和擷取。UI 會顯示第一個移轉集的擷取狀態已變更為​ 「失敗」 ,並且沒有可用記錄。
  • 這並不表示第一個移轉集擷取失敗。之所以會出現此行為,是因為開始新的擷取工作時,將刪除上一個擷取工作。因此,請忽略第一個移轉集的變更狀態。
  • 「內容轉移工具」UI 中的圖示可能與本指南中顯示的螢幕擷圖不同,也可能完全不顯示 (取決於來源 AEM 例項的版本)。