驗證內容轉移 validating-content-transfers

快速入門 getting-started

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

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

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

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

  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 ​或更新版本,否則您使用的AEM as 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