Validieren von Inhaltsübertragungen validating-content-transfers
Erste Schritte getting-started
Benutzende können zuverlässig ermitteln, ob der gesamte vom Content Transfer Tool extrahierte Inhalt erfolgreich in die Zielinstanz aufgenommen wurde. Diese Validierungsfunktion vergleicht einen Auszug aus den Pfaden aller Knoten, die an der Extraktion beteiligt waren, mit einem Auszug aus den Pfaden aller an der Aufnahme beteiligten Knoten. Wenn im Extraktions-Auszug Knotenpfade enthalten sind, die im Aufnahme-Auszug fehlen, gilt die Validierung als fehlgeschlagen, und es kann eine zusätzliche manuelle Validierung erforderlich sein.
Die Validierung eines Inhaltstransfers ist eine optionale Funktion. Durch die Aktivierung dieser Funktion verlängert sich der zeitliche Aufwand bei der Durchführung sowohl einer Extraktion als auch einer Aufnahme. Um die Funktion zu verwenden, aktivieren Sie sie in der Systemkonsole der AEM-Quellumgebung, indem Sie die folgenden Schritte ausführen:
-
Sie gelangen zur Adobe Experience Manager Web-Konsole in Ihrer Quellinstanz, indem Sie zu Tools – Vorgänge – Web-Konsole gehen oder direkt zur URL unter https://serveraddress:serverport/system/console/configMgr
-
Suchen Sie nach Konfiguration des Content Transfer Tool-Extrahierungs-Service
-
Über die Schaltfläche mit dem Stiftsymbol können Sie die Konfigurationswerte bearbeiten
-
Aktivieren Sie die Einstallung Aktivieren der Migrationsvalidierung während der Extraktion, und klicken Sie dann auf Speichern:
Wenn diese Einstellung aktiviert ist und die AEM as a Cloud Service-Zielumgebung eine kompatible Version ausführt, wird die Migrationsvalidierung bei allen folgenden Extraktionen und Aufnahmen durchgeführt.
Weitere Informationen zum Installieren des Content Transfer Tools finden Sie unter Erste Schritte mit dem Content Transfer Tool.
Validieren eines Inhaltstransfers how-to-validate-a-content-transfer
Wenn die Migrationsvalidierung in der Quell-AEM-Umgebung aktiviert ist, starten Sie eine Extraktion.
Wenn Staging-Container während der Extraktion überschreiben aktiviert ist, werden alle Knoten, die an der Extraktion beteiligt sind, im Auszug des Extraktionspfads protokolliert. Wenn diese Einstellung verwendet wird, muss die Einstellung Vorhandene Inhalte in der Cloud-Instanz vor der Aufnahme löschen während der Aufnahme aktiviert sein, da andernfalls Knoten im Aufnahme-Auszug fehlen können. Hierbei handelt es sich um die Knoten, die bereits aus früheren Aufnahmen im Ziel vorhanden sind.
Eine grafische Darstellung dieses Problems finden Sie in den folgenden Beispielen:
Beispiel 1 example-1
-
Extraktion (Überschreiben)
-
Aufnahme (Löschen)
-
Anmerkungen
Diese Kombination aus „Überschreiben“ und „Löschen“ führt zu konsistenten Validierungsergebnissen, auch für wiederholte Aufnahmen.
Beispiel 2 example-2
-
Extraktion
-
Aufnahme
-
Anmerkungen
Diese Kombination aus „Überschreiben“ und „Löschen“ führt zu konsistenten Validierungsergebnissen für die erste Aufnahme.
Wenn die Aufnahme wiederholt wird, ist der Aufnahmeauszug leer und die Validierung scheint fehlgeschlagen zu sein. Der Aufnahmeauszug ist leer, da alle Knoten dieser Extraktion bereits im Ziel vorhanden sind.
Sobald die Extraktion abgeschlossen ist, beginnen Sie mit der Aufnahme.
Am Anfang des Aufnahmeprotokolls befindet sich ein Eintrag, ähnlich aem-ethos/tools:1.2.438. Stellen Sie sicher, dass diese Versionsnummer 1.2.438 oder höher ist, andernfalls wird die Validierung von der AEM as a Cloud Service-Version, die Sie verwenden, nicht unterstützt.
Sobald die Aufnahme abgeschlossen ist und die Validierung beginnt, wird der folgende Protokolleintrag im Aufnahmeprotokoll vermerkt:
Gathering artifacts for migration validation...
Die Details der Validierung folgen diesem Eintrag. Nachstehend finden Sie ein Beispiel für eine große Migration:
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
Dies ist ein Beispiel für eine erfolgreich durchgeführte Validierung, da im Aufnahmeauszug keine Einträge fehlten, die im Extraktionsauszug vorhanden waren.
Hier sehen Sie, wie ein Validierungsbericht aussehen würde, wenn die Validierung fehlgeschlagen ist (oder wenn eine Auffüllmigration durchgeführt wurde):
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
Das obige Fehlerbeispiel wurde durch Ausführen einer Aufnahme und anschließendes erneutes Ausführen derselben Aufnahme mit deaktiviertem Löschen erreicht, sodass während der Aufnahme keine Knoten beteiligt waren – alles war bereits auf dem Ziel vorhanden.
Der Validierungsbericht wird nicht nur in das Aufnahmeprotokoll aufgenommen, sondern kann auch über die Benutzeroberfläche der Aufnahmeaufträge in Cloud Acceleration Manager aufgerufen werden. Klicken Sie dazu auf die drei Punkte (…) und dann in der Dropdown-Liste auf Validierungsbericht, um den Validierungsbericht anzuzeigen.
Validieren der Prinzipalmigration how-to-validate-group-migration
Weitere Informationen zur Prinzipalmigration und dazu, warum diese erforderlich ist, finden Sie unter Gruppenmigration.
Nach erfolgreichem Abschluss der Extraktion und Aufnahme ist eine Zusammenfassung und ein Bericht zur Prinzipalmigration verfügbar. Anhand dieser Informationen lässt sich überprüfen, welche Gruppen erfolgreich migriert wurden, und ggf. feststellen, warum einige Gruppen nicht migriert wurden.
Navigieren Sie zu Cloud Acceleration Manager, um diese Informationen anzuzeigen. Klicken Sie auf Ihre Projektkarte und dann auf die Karte für den Inhaltstransfer. Navigieren Sie zu Aufnahmevorgänge und suchen Sie nach der zu überprüfenden Aufnahme. Klicken Sie auf die drei Punkte (…) für diese Aufnahme und dann in der Dropdown-Liste auf Prinzipalzusammenfassung anzeigen.
Es wird ein Dialogfeld mit den Zusammenfassungsinformationen angezeigt. Verwenden Sie die Hilfesymbole, um eine umfassendere Beschreibung zu lesen. Klicken Sie auf die Schaltfläche Bericht herunterladen, um den vollständigen Bericht im durch Kommas getrennten Format (CSV) herunterzuladen. Beachten Sie außerdem, dass sich am Ende dieses Berichts der Benutzerbericht befindet, der für die Benutzerverwaltung nach der Migration verwendet werden kann.
Im Bericht „Prinzipalmigration“ wird Folgendes angegeben:
-
Jede migrierte Gruppe und der erste Inhaltspfad, der die Migration dieser Gruppe ausgelöst hat. Die Gruppe kann sich auch auf anderen Pfaden befinden, es wird jedoch nur der erste gemeldet, der für eine bestimmte Gruppe gefunden wird. Es wird auch gemeldet, ob der Pfad in einer ACL- oder einer CUG-Richtlinie gefunden wurde.
-
Jede nicht migrierte Gruppe und der Grund, aus dem sie nicht migriert wurde. In der Regel liegt einer der folgenden Gründe vor:
- Es handelt sich um eine integrierte Gruppe
- Sie befindet sich bereits im Zielsystem
- Sie befindet sich nicht in einer ACL- oder CUG-Richtlinie für den migrierten Inhalt
- Sie verfügt über ein doppeltes eindeutiges Feld (eines der Felder „rep:principalName“, „rep:authorizableId“, „jcr:uuid“ oder „rep:externalId“ befindet sich bereits im Ziel, diese müssen jedoch alle eindeutig sein).
Fehlerbehebung troubleshooting
Validierung fehlgeschlagen. Was jetzt? validation-fail
Der erste Schritt besteht darin festzustellen, ob die Aufnahme wirklich fehlschlug oder ob die extrahierten Inhalte bereits in der Zielumgebung vorhanden sind. Dies kann vorkommen, wenn eine Aufnahme wiederholt wird, während die Option Vorhandene Inhalte in der Cloud-Instanz vor der Aufnahme löschen deaktiviert ist.
Wählen Sie zur Überprüfung einen Pfad aus dem Validierungsbericht aus und überprüfen Sie, ob er in der Zielumgebung vorhanden ist. Wenn es sich um eine Veröffentlichungsumgebung handelt, können Sie Seiten und Assets nur direkt überprüfen. Wenn Sie Hilfe zu diesem Schritt benötigen, öffnen Sie ein Ticket bei der Kundenunterstützung.
Die Knotenanzahl ist geringer als erwartet. Warum ist das so? node-count-lower-than-expected
Einige Pfade von den Extraktions- und Aufnahmeauszügen werden vorsätzlich ausgeschlossen, damit die Größe dieser Dateien überschaubar bleibt, sodass das Ergebnis der Migrationsvalidierung innerhalb von zwei Stunden nach Abschluss der Aufnahme berechnet werden kann.
Zu den Pfaden, die wir derzeit aus den Auszügen ausschließen, gehören: cqdam.text.txt-Ausgabedarstellungen, Knoten in /home und Knoten in /jcr:system.
Geschlossene Benutzergruppen validating-cugs
Siehe Migrieren geschlossener Benutzergruppen für zusätzliche Überlegungen bei der Verwendung einer CUG-Richtlinie (geschlossene Benutzergruppe).