驗證內容轉移 validating-content-transfers
快速入門 getting-started
使用者可以可靠地判斷「內容轉移工具」擷取的所有內容是否已成功擷取至目標例項。 此驗證功能的運作方式是，比較擷取期間涉及的所有節點的路徑摘要，以及擷取期間涉及的所有節點的路徑摘要。 如果擷取摘要中包含的任何節點路徑遺失擷取摘要，則驗證會被視為失敗，且可能需要額外的手動驗證。
驗證內容轉移是一項選擇性功能。 啟用此功能會增加執行擷取和擷取所需的時間。 若要使用此功能，請在來源AEM環境的「系統主控台」中啟用它，步驟如下：
-
導覽至來源執行個體上的Adobe Experience Manager Web主控台，方法是前往 工具 — 作業 — Web主控台，或直接導覽至 https://serveraddress:serverport/system/console/configMgr 的URL
-
搜尋 內容轉移工具擷取服務組態
-
使用鉛筆圖示按鈕來編輯其設定值
-
啟用 在擷取期間啟用移轉驗證 設定，然後按 儲存：
啟用此設定且目標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-group-migration
請參閱群組移轉以讀取主體移轉詳細資料以及需要的原因。
成功完成擷取和內嵌後，即可使用主要移轉的摘要和報表。 這項資訊可用來驗證哪些群組已成功移轉，也可用來判斷部分群組未成功移轉的原因。
若要檢視此資訊，請前往Cloud Acceleration Manager。 按一下您的專案卡，然後按一下「內容轉移」卡。 導覽至 擷取工作，並找出您要驗證的擷取。 按一下該擷取的三個點(…)，然後在下拉式清單中按一下 檢視主體摘要。
您會看到包含摘要資訊的對話方塊。 使用說明圖示可讀取更完整的說明。 按一下「下載報表」按鈕即可下載完整的逗號分隔報表(CSV)。 也請注意，此報表結尾是使用者報表，可用於移轉後使用者管理。
「主要移轉」報告會報告：
-
每個群組都已移轉，且是第一個觸發該群組移轉的內容路徑；群組也可能位於其他路徑上，但只報告為指定群組找到的第一個路徑。 它也會報告是否在ACL或CUG原則中找到它。
-
每個群組都沒有移轉，以及它沒有移轉的原因。 這通常是因為下列其中一個原因：
- 這是一個內建群組
- 它已經在目標系統上
- 它不在正在移轉的內容上的ACL或CUG原則中
- 它具有重複的唯一欄位（rep：principalName、rep：authorizableId、jcr：uuid或rep：externalId其中之一已在目的地上，但所有這些都必須是唯一的）
疑難排解 troubleshooting
驗證失敗。 現在該怎麼辦？ validation-fail
第一步是判斷擷取是否真的失敗，或擷取的內容是否已存在於目標環境中。 如果重複內嵌，且在內嵌停用之前 擦除雲端執行個體上的現有內容 選項，就可能發生這種情況。
若要驗證，請從驗證報表中選擇路徑，並檢查其是否存在於目標環境中。 如果這是發佈環境，您可能會受限於直接檢查頁面和資產。 如果您需要此步驟的協助，請透過客戶服務開啟票證。
節點計數低於我的預期。 為什麼？ node-count-lower-than-expected
我們會特意排除擷取和擷取摘要的部分路徑，以便管理這些檔案的大小，目標是在擷取完成後的兩小時內計算移轉驗證結果。
我們目前從摘要中排除的路徑包括： cqdam.text.txt轉譯、/home內的節點和/jcr:system內的節點。
封閉使用者群組 validating-cugs
請參閱移轉封閉式使用者群組以瞭解使用封閉式使用者群組(CUG)原則時的額外考量事項。