コンテンツ転送の検証 validating-content-transfers

はじめに getting-started

コンテンツ転送ツールで抽出されたすべてのコンテンツが、ターゲットインスタンスに正常に取り込まれたかどうかをユーザーが確実に判断できます。この検証機能は、抽出中に関与したすべてのノードのパスのダイジェストと、取り込み中に関与したすべてのノードのパスのダイジェストを比較することによって機能します。抽出ダイジェストに含まれているノードパスが取り込みダイジェストにない場合、検証は失敗したと見なされ、追加の手動検証が必要になる可能性があります。

コンテンツ転送の検証はオプション機能です。この機能を有効にすると、抽出にかかる時間と取り込みにかかる時間の両方が長くなります。この機能を使用するには、次の手順に従って、ソース AEM 環境のシステムコンソールで有効にします。

この設定を有効にし、ターゲット 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 の​ 取り込みジョブ ​ユーザーインターフェイスからアクセスすることも可能です。これを行うには、3 つのドット（…）をクリックし、ドロップダウンで「検証レポート」をクリックして検証レポートを表示します。

プリンシパルの移行を検証する方法 how-to-validate-principal-migration

プリンシパルの移行の詳細とその必要性については、ユーザーマッピングとプリンシパルの移行を参照してください。

抽出と取り込みが正常に完了すると、プリンシパルの移行の概要とレポートが使用可能になります。この情報を使用して、どのユーザーとグループが正常に移行されたかを検証し、一部のユーザーとグループが正常に移行されなかった理由を判断することもできます。

この情報を表示するには、Cloud Acceleration Manager に移動します。プロジェクトカードをクリックし、コンテンツ転送カードをクリックします。取り込みジョブ ​に移動し、検証する取り込みを見つけます。その取り込みの 3 つのドット（…）をクリックし、ドロップダウンで「プリンシパルの概要を表示」をクリックします。

概要情報を含むダイアログが表示されます。ヘルプアイコンを使用して、詳細な説明を参照します。「レポートをダウンロード」ボタンをクリックして、完全なコンマ区切り（CSV）レポートをダウンロードします。

トラブルシューティング troubleshooting

検証に失敗した。次は何をすればよいでしょうか。 validation-fail

まず、取り込みが本当に失敗したか、それとも抽出したコンテンツが既にターゲット環境に存在しているのかを確認することです。後者の状況は、「取り込み前にクラウドインスタンス上の既存のコンテンツを消去する」オプションを無効にして取り込みが繰り返される場合に発生する可能性があります。

検証するには、検証レポートからパスを選択し、そのパスがターゲット環境に存在するかどうかを確認します。これがパブリッシュ環境の場合、できることはページやアセットの直接確認に限られる可能性があります。この手順に関してサポートが必要な場合は、カスタマーケアに連絡してチケットをオープンします。

ノード数が予想より少ない。なぜでしょう？ node-count-lower-than-expected

ファイルを扱いやすいサイズにして、取り込みの完了後 2 時間以内に移行の検証結果を計算できるように、一部のパスは抽出ダイジェストと取り込みダイジェストから意図的に除外されています。

現在ダイジェストから除外されているパスには、cqdam.text.txt レンディション、/home 内のノード、/jcr:system 内のノードなどがあります。

クローズドユーザーグループが機能していない validating-cugs

クローズドユーザーグループ（CUG）ポリシーを使用する際のその他の考慮事項について詳しくは、クローズドユーザーグループの移行を参照してください。