驗證內容轉移 validating-content-transfers

快速入門 getting-started

使用者可以可靠地判斷「內容轉移工具」擷取的所有內容是否已成功擷取至目標例項。 此驗證功能的運作方式是,比較擷取期間涉及的所有節點的路徑摘要,以及擷取期間涉及的所有節點的路徑摘要。 如果擷取摘要中包含的任何節點路徑遺失擷取摘要,則驗證會被視為失敗,且可能需要額外的手動驗證。

INFO
此功能在內容轉移工具(CTT) 1.8.x版發行後即可使用。 AEM Cloud Service目標環境必須至少執行版本6158或更高版本。 它也需要設定來源環境才能執行 預先複製. 驗證功能會尋找來源上的azcopy.config檔案。 如果找不到此檔案,則不會執行驗證。 要瞭解有關如何設定azcopy.config檔案的詳細資訊,請參閱 此頁面.

驗證內容轉移是一項選擇性功能。 啟用此功能會增加執行擷取和擷取所需的時間。 若要使用此功能,請在來源AEM環境的「系統主控台」中啟用它,步驟如下:

  1. 導覽至來源執行個體上的Adobe Experience Manager Web Console,方法是前往 工具 — 作業 — Web主控台 或直接前往位於的URL https://serveraddress:serverport/system/console/configMgr

  2. 搜尋 內容轉移工具提取服務設定

  3. 使用鉛筆圖示按鈕來編輯其設定值

  4. 啟用 在擷取期間啟用移轉驗證 設定,然後按 儲存

    影像

啟用此設定且目標AEM Cloud Service環境執行相容版本時,將會在後續的所有擷取和內嵌期間進行移轉驗證。

如需如何安裝內容轉移工具的詳細資訊,請參閱 內容轉移工具快速入門.

如何驗證內容轉移 how-to-validate-a-content-transfer

在來源AEM環境中啟用移轉驗證後,即可開始擷取。

如果 在擷取期間覆寫暫存容器 已啟用,與擷取相關的所有節點都會記錄到擷取路徑摘要。 使用此設定時,請務必啟用 在內嵌之前擦除雲端例項上的現有內容 在內嵌期間設定,否則內嵌摘要中可能會遺失節點。 這些是先前擷取中已經存在於目標上的節點。

如需圖形化圖例,請參閱下列範例:

範例 1 example-1

  • 擷取(覆寫)

    影像

  • 內嵌(擦去)

    影像

  • 附註

    此「覆寫」和「擦去」的組合會產生一致的驗證結果,即使是重複擷取亦然。

範例 2 example-2

  • 摘取

    影像

  • 內嵌

    影像

  • 附註

    此「覆寫」和「擦去」的組合將導致初始內嵌的一致驗證結果。

    如果重複內嵌,內嵌摘要會是空的,而驗證似乎已失敗。 擷取摘要是空的,因為此擷取的所有節點都將出現在目標上。

擷取一旦完成,就會開始內嵌。

擷取記錄檔的頂端會包含一個專案,類似於 aem-ethos/tools:1.2.438. 確定此版本編號為 1.2.438 或更高版本,否則您使用的AEMas a Cloud Service版本不支援驗證。

擷取完成並開始驗證後,會在擷取記錄中記錄以下記錄專案:

Gathering artifacts for migration validation...

驗證的詳細資訊會在此專案後面。 尋找以下大型移轉的範例:

Beginning publish migration validation. Migration job id=[3aba1f96-84b6-4bd0-8642-c61c0d528387]
Extraction path digest is being processed...
Extraction path digest processing took 982 seconds
Ingestion path digest is being processed...
Ingestion path digest processing took 999 seconds
Comparing the Extraction and Ingestion path digests...
----------------------------------------------------------
EXTRACTION: Number of nodes extracted: 51674784
INGESTION: Number of nodes ingested: 51674784
----------------------------------------------------------
Validation succeeded! No entries were detected to be missing from the ingestion digest.
----------------------------------------------------------
Comparing the path digests took 29 seconds
Migration validation took 33 minutes

這是成功驗證的範例,因為擷取摘要中不存在擷取摘要中遺漏的專案。

若要比較,以下為驗證失敗(或執行追加移轉)時驗證報表的外觀:

Beginning publish migration validation. Migration job id=[ac217e5a-a08d-4e81-cbd6-f39f88b174ce]
Extraction path digest is being processed...
Extraction path digest processing took 0 seconds
Ingestion path digest is being processed...
Ingestion path digest processing took 0 seconds
Comparing the Extraction and Ingestion path digests...
----------------------------------------------------------
EXTRACTION: Number of nodes extracted: 4635
INGESTION: Number of nodes ingested: 0
----------------------------------------------------------
Validation failed. However, the following nodes may already be present in the target environment.
See our Migration Validation FAQ (https://www.adobe.com/go/aem_cloud_ctt_validation_en) or open a ticket with Customer Care.
There are 4635 entries present in the extraction digest that are missing from the ingestion digest.
/content/dam/bruce
/content/dam/bruce-assets
... more paths listed (up to 10k) ...
----------------------------------------------------------
Comparing the path digests took 0 seconds
Migration validation took 0 minutes

上述失敗範例是透過執行內嵌,然後在停用擦去的情況下再次執行相同的內嵌來達成,這樣內嵌期間不會涉及任何節點 — 目標上已存在所有內容。

除了包含在擷取記錄檔中,驗證報告也可從 內嵌工作 Cloud Acceleration Manager中的使用者介面。 若要這麼做,請按一下三個點()然後按一下 驗證報告 以檢視驗證報告。

影像

如何驗證主體移轉 how-to-validate-principal-migration

另請參閱 使用者對應和主體移轉 以瞭解主要移轉的詳細資訊以及進行移轉的必要原因。

成功完成擷取和內嵌後,即可使用主要移轉的摘要和報表。 這些資訊可用於驗證哪些使用者和群組已成功移轉,也可用於判斷部分使用者及群組未成功移轉的原因。

若要檢視此資訊,請前往Cloud Acceleration Manager。 按一下您的專案卡,然後按一下「內容轉移」卡。 瀏覽至 內嵌工作 並找出您要驗證的擷取。 按一下三個點()進行擷取,然後按一下 檢視主體摘要 位於下拉式清單中。

影像

您會看到包含摘要資訊的對話方塊。 使用說明圖示可讀取更完整的說明。 按一下 下載報表 按鈕以下載完整的逗號分隔(CSV)報表。

影像

NOTE
如果停用使用者對應,則會顯示此對話方塊的另一個變體。 這會指出已停用使用者對應,且不會顯示提供使用者對應值的3個欄位。

疑難排解 troubleshooting

驗證失敗。 現在該怎麼辦? validation-fail

第一步是判斷擷取是否真的失敗,或擷取的內容是否已存在於目標環境中。 如果內嵌重複出現 在內嵌之前擦除雲端例項上的現有內容 選項已停用。

若要驗證,請從驗證報表中選擇路徑,並檢查其是否存在於目標環境中。 如果這是發佈環境,您可能會受限於直接檢查頁面和資產。 如果您需要此步驟的協助,請透過客戶服務開啟票證。

節點計數低於我的預期。 為什麼? node-count-lower-than-expected

我們會特意排除擷取和擷取摘要的部分路徑,以便管理這些檔案的大小,目標是在擷取完成後的兩小時內計算移轉驗證結果。

我們目前從摘要中排除的路徑包括: cqdam.text.txt 轉譯,內的節點 /home,以及內的節點 /jcr:system.

已關閉的使用者群組無法運作 validating-cugs

另請參閱 移轉封閉式使用者群組 使用封閉式使用者群組(CUG)原則時,需要額外考量事項。

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab