Aufnehmen von Inhalten in Cloud Service ingesting-content
Aufnahmevorgang in Cloud Acceleration Manager ingestion-process
Gehen Sie wie folgt vor, um den Migrationssatz mit Cloud Acceleration Manager aufzunehmen:
-
Gehen Sie zu Cloud Acceleration Manager. Klicken Sie auf Ihre Projektkarte und dann auf die Karte für den Inhaltstransfer. Navigieren Sie zu Aufnahmevorgänge und klicken Sie auf Neue Aufnahme.
-
Überprüfen Sie die Checkliste für die Aufnahme und stellen Sie sicher, dass alle Schritte ausgeführt wurden. Diese Schritte sind erforderlich, um eine erfolgreiche Aufnahme sicherzustellen. Fahren Sie mit dem nächsten Schritt nur fort, wenn die Checkliste abgeschlossen ist.
-
Geben Sie die erforderlichen Informationen ein, um eine Aufnahme zu erstellen.
- Migrationssatz: Wählen Sie als Quelle den Migrationssatz aus, der die extrahierten Daten enthält.
- Migrationssätze laufen nach längerer Inaktivität ab. Daher wird erwartet, dass die Aufnahme relativ bald nach der Extraktion erfolgt. Lesen Sie Ablauf von Migrationssätzen, um mehr darüber zu erfahren.
note tip TIP Wenn die Extraktion ausgeführt wird, wird sie im Dialogfeld angezeigt. Nach erfolgreichem Abschluss der Extraktion startet die Aufnahme automatisch. Wenn die Extraktion fehlschlägt oder angehalten wird, wird der Aufnahmevorgang zurückgesetzt. -
Ziel: Wählen Sie die Zielumgebung aus. In dieser Umgebung werden die Inhalte des Migrationssatzes aufgenommen.
- Aufnahmen unterstützen keine Ziele des Typs „Schnelle Entwicklungsumgebung“ (RDE) oder Vorschau und erscheinen nicht als mögliche Zielwahl, selbst wenn die Benutzenden Zugriff darauf haben.
- Während ein Migrationssatz gleichzeitig in mehrere Ziele aufgenommen werden kann, kann ein Ziel zu jedem Zeitpunkt nur das Ziel einer ausgeführten oder einer wartenden Aufnahme sein.
-
Ebene: Wählen Sie die Ebene aus. (Author/Publish).
- Wenn die Quelle
Author
war, wird empfohlen, sie in dieAuthor
-Ebene auf dem Ziel aufzunehmen. Wenn die QuellePublish
war, sollte das Ziel ebenfallsPublish
sein.
- Wenn die Quelle
note note NOTE Wenn es sich bei Author
um die Zielebene handelt, wird die Authoring-Instanz während der Aufnahmedauer heruntergefahren, sodass sie Benutzenden (wie beispielsweise Autorinnen und Autoren oder anderen, die Wartungsarbeiten durchführen) nicht zur Verfügung steht. Dadurch soll das System geschützt werden, und es sollen Änderungen verhindert werden, die verloren gehen oder einen Aufnahmekonflikt verursachen könnten. Stellen Sie sicher, dass Ihr Team sich dieser Tatsache bewusst ist. Beachten Sie außerdem, dass sich die Umgebung während der Author-Aufnahme im Ruhezustand befindet.-
Bereinigen: Wählen Sie den
Wipe
-Wert aus- Die Option Bereinigen legt den Startpunkt des Ziels für die Aufnahme fest. Wenn Bereinigen aktiviert ist, wird das Ziel einschließlich des gesamten Inhalts auf die in Cloud Manager angegebene AEM-Version zurückgesetzt. Wenn diese Option nicht aktiviert ist, behält das Ziel seinen aktuellen Inhalt als Ausgangspunkt bei.
- Diese Option wirkt sich NICHT darauf aus, wie die Aufnahme von Inhalten durchgeführt wird. Die Aufnahme verwendet immer eine Inhaltsersetzungsstrategie und keine Inhaltszusammenführungsstrategie, sodass in beiden Fällen, Bereinigen und Nicht bereinigen, bei der Aufnahme eines Migrationssatzes die Inhalte im selben Pfad zu dem Ziel überschrieben werden. Wenn der Migrationssatz beispielsweise
/content/page1
enthält und im Ziel bereits/content/page1/product1
enthalten ist, entfernt die Aufnahme den gesamtenpage1
-Pfad und zugehörige Unterseiten, einschließlichproduct1
, und ersetzt sie durch den Inhalt im Migrationssatz. Dies bedeutet, dass bei der Durchführung einer Aufnahme mit der Einstellung Nicht bereinigen in ein Ziel, das beizubehaltende Inhalte enthält, eine sorgfältige Planung erfolgen muss. - Nicht-Wischen-Aufnahmen sind speziell für den Anwendungsfall der Auffüllaufnahme entwickelt. Diese Aufnahmen sollen eine inkrementelle Menge neuer Inhalte aufweisen, die sich seit der letzten Aufnahme in einem vorhandenen Migrationssatz geändert hat. Die Durchführung von Nicht-Wischen-Aufnahmen außerhalb dieses Anwendungsfalls könnte zu sehr langen Erfassungszeiten führen.
note important IMPORTANT Wenn die Einstellung Bereinigen für die Aufnahme aktiviert ist, wird das gesamte bestehende Repository zurückgesetzt, einschließlich der Benutzerberechtigungen für die Ziel-Cloud-Service-Instanz. Diese Rücksetzung gilt auch für Admin-Benutzende, die zur Gruppe Admins hinzugefügt wurden, und eine solche Person muss der Admin-Gruppe erneut hinzugefügt werden, um eine Aufnahme zu starten. -
Vorabkopie: Wählen Sie den
Pre-copy
-Wert aus.- Sie können den optionalen Schritt der Vorabkopie ausführen, um die Aufnahme erheblich zu beschleunigen. Weitere Informationen finden Sie unter Aufnehmen mit AzCopy.
- Wenn die Aufnahme mit einer Voabrkopie verwendet wird (für den S3- oder Azure Data Store), wird empfohlen, die
Author
-Aufnahme zuerst allein auszuführen. Dadurch wird diePublish
-Aufnahme beschleunigt, wenn sie später ausgeführt wird.
note important IMPORTANT Sie können eine Aufnahme in der Zielumgebung nur initiieren, wenn Sie der lokalen Gruppe der AEM-Admins im Ziel-Author-Service von Cloud Service angehören. Wenn Sie eine Aufnahme nicht starten können, finden Sie unter Aufnahme kann nicht gestartet werden weitere Informationen dazu. - Migrationssatz: Wählen Sie als Quelle den Migrationssatz aus, der die extrahierten Daten enthält.
-
Nach Auswahl der Aufnahmeoptionen wird eine geschätzte Dauer angezeigt. Es handelt sich um eine bestmögliche Schätzung auf der Grundlage historischer Daten ähnlicher Aufnahmen.
- Diese Schätzung wird nur berechnet und angezeigt, wenn die Werte „Größe überprüfen“ der Extraktion erfasst wurden und verfügbar sind.
- Dieser Wert ist eine Schätzung und sollte, obwohl er sorgfältig berechnet wurde, nicht als exakt angesehen werden. Verschiedene Faktoren können die tatsächliche Dauer ändern.
- Während die Aufnahme läuft, ist dieser Wert auch im Dauer-Dialog verfügbar, der über die Aktion „Dauer anzeigen“ der Aufnahme aufgerufen werden kann.
-
Klicken Sie auf Aufnehmen.
-
Anschließend können Sie die Aufnahme in der Listenansicht der Aufnahmeaufträge überwachen und im Aktionsmenü der Aufnahme die Dauer anzeigen und protokollieren, während die Aufnahme fortschreitet.
-
Klicken Sie in der Zeile auf die Schaltfläche (i), um weitere Informationen zum Aufnahmevorgang zu erhalten. Sie können die Dauer jedes Aufnahmeschritts anzeigen, wenn dieser ausgeführt oder abgeschlossen wird, indem Sie erst auf … und dann auf Dauer anzeigen klicken. Die Informationen aus der Extraktion werden ebenfalls angezeigt, damit klar ist, was aufgenommen wird.
Auffüllaufnahme top-up-ingestion-process
Das Content Transfer Tool verfügt über eine Funktion, die die Extraktion von differenziellen Inhalten ermöglicht, indem eine Auffüllung des Migrationssatzes ausgeführt wird. Dadurch kann der Migrationssatz so geändert werden, dass nur die Inhalte einbezogen werden, die seit der vorherigen Extraktion geändert wurden, ohne dass der gesamte Inhalt erneut extrahiert werden muss.
Für die Aufnahme differenzieller Inhalte nach Abschluss einiger Aufnahmen müssen Sie eine Auffüllextraktion ausführen und anschließend die Erfassungsmethode mit deaktivierter Bereinigen-Option verwenden. Lesen Sie unbedingt die Erläuterung zum Bereinigen oben, um zu vermeiden, dass Inhalte, die bereits im Ziel sind, verloren gehen.
Erstellen Sie zunächst einen Aufnahmeauftrag und stellen Sie sicher, dass Bereinigen während der Aufnahme deaktiviert ist, wie unten gezeigt:
Fehlerbehebung troubleshooting
CAM kann das Migrations-Token nicht abrufen cam-unable-to-retrieve-the-migration-token
Der automatische Abruf des Migrations-Tokens kann aus verschiedenen Gründen fehlschlagen, wie z. B. wenn Sie in der Cloud Service-Zielumgebung eine IP-Zulassungsliste über Cloud Manager einrichten. In solchen Fällen wird das folgende Dialogfeld angezeigt, wenn Sie versuchen, eine Aufnahme zu starten:
Rufen Sie das Migrations-Token manuell ab, indem Sie im Dialogfeld auf den Link „Token abrufen“ klicken. Es wird eine weitere Registerkarte geöffnet, auf der das Token angezeigt wird. Sie können dann das Token kopieren und in das Feld Migrations-Token-Eingabefeld einfügen. Jetzt sollten Sie in der Lage sein, die Aufnahme zu starten.
Aufnahme kann nicht gestartet werden unable-to-start-ingestion
Sie können eine Aufnahme in der Zielumgebung nur initiieren, wenn Sie der lokalen Gruppe der AEM-Admins im Ziel-Authoring-Service von Cloud Service angehören. Wenn Sie nicht zur Gruppe der AEM-Admins gehören, wird beim Versuch, eine Aufnahme zu starten, ein Fehler wie unten dargestellt angezeigt. Sie können Ihren Administrator bitten, Sie entweder zu den lokalen AEM Administratoren hinzuzufügen oder ihn nach dem Token selbst fragen, das Sie dann in das Feld Eingabefeld für das Migrations-Token einfügen können.
Migrationsdienst kann nicht erreicht werden unable-to-reach-migration-service
Nachdem eine Aufnahme angefordert wurde, wird den Benutzenden möglicherweise eine Meldung wie die folgende angezeigt: „Der Migrations-Service in der Zielumgebung ist derzeit nicht erreichbar. Versuchen Sie es später erneut oder kontaktieren Sie den Adobe-Support.“
Diese Meldung weist darauf hin, dass Cloud Acceleration Manager nicht in der Lage war, den Migrations-Service der Zielumgebung zu erreichen, um die Aufnahme zu starten. Hierfür kann es verschiedene Gründe geben.
- AEM as a Cloud Service verwaltet den Umgebungsstatus und muss den Migrations-Service gelegentlich aus einer Reihe normaler Gründe neu starten. Wenn der Service gerade neu gestartet wird, ist er nicht erreichbar, wird aber bald wieder verfügbar sein.
- Möglicherweise wird ein anderer Prozess in der Instanz ausgeführt. Wenn z. B. durch AEM-Versionsaktualisierungen eine Aktualisierung durchgeführt wird, ist das System möglicherweise ausgelastet und der Migrations-Service ist nicht regelmäßig verfügbar. Sobald dieser Vorgang abgeschlossen ist, kann erneut versucht werden, die Aufnahme zu starten.
- Wenn eine IP-Zulassungsliste über Cloud Manager angewendet wurde, hindert sie Cloud Acceleration Manager daran, den Migrations-Service zu erreichen. Eine IP-Adresse kann nicht für Aufnahmen hinzugefügt werden, da diese Adresse dynamisch ist. Derzeit besteht die einzige Lösung darin, die IP-Zulassungsliste während des Aufnahme- und Indizierungsprozesses zu deaktivieren.
- Es kann andere Gründe geben, die untersucht werden müssen. Wenn die Aufnahme oder Indizierung weiterhin fehlschlägt, wenden Sie sich an die Kundenunterstützung von Adobe.
AEM-Versionsaktualisierungen und Aufnahmen aem-version-updates-and-ingestions
AEM-Versionsaktualisierungen werden automatisch auf Umgebungen angewendet, um sie mit der neuesten AEM as a Cloud Service-Version auf dem neuesten Stand zu halten. Wenn während eines Aufnahmevorgangs eine Aktualisierung ausgelöst wird, kann dies zu unvorhersehbaren Ergebnissen führen, einschließlich der Beschädigung der Umgebung.
Wenn die „AEM-Versionsaktualisierungen“ im Zielprogramm integriert sind, versucht der Aufnahmevorgang, die Warteschlange zu deaktivieren, bevor er gestartet wird. Wenn die Aufnahme abgeschlossen ist, wird der Status des Versionsaktualisierers so zurückgegeben, wie er vor dem Start der Aufnahmen war.
Wenn „AEM-Versionsaktualisierungen“ aktiv ist (d. h. Aktualisierungen werden ausgeführt oder in die Warteschlange gestellt), beginnt die Aufnahme nicht und die Benutzeroberfläche zeigt die folgende Meldung an. Sobald die Aktualisierungen abgeschlossen sind, kann die Aufnahme gestartet werden. Cloud Manager kann zur Anzeige des aktuellen Status der Pipelines des Programms verwendet werden.
Fehler bei Auffüllaufnahme aufgrund einer Verletzung der Eindeutigkeitsbeschränkung top-up-ingestion-failure-due-to-uniqueness-constraint-violation
Eine häufige Ursache für einen Auffüllaufnahme-Fehler ist ein Konflikt bei Knoten-IDs. Um den Fehler zu identifizieren, laden Sie das Aufnahmeprotokoll über die Benutzeroberfläche von Cloud Acceleration Manager herunter und suchen Sie nach einem Eintrag wie dem Folgenden:
java.lang.RuntimeException: org.apache.jackrabbit.oak.api.CommitFailedException: OakConstraint0030: Uniqueness constraint violated property [jcr:uuid] having value a1a1a1a1-b2b2-c3c3-d4d4-e5e5e5e5e5e5: /some/path/jcr:content, /some/other/path/jcr:content
Jeder Knoten in AEM muss über eine eindeutige UUID verfügen. Dieser Fehler weist darauf hin, dass ein Knoten, der gerade aufgenommen wird, dieselbe UUID hat wie ein Knoten, der in einem anderen Pfad in der Zielinstanz vorhanden ist. Hierfür kann es zwei Gründe geben:
- Ein Knoten wird zwischen einer Extraktion und einer nachfolgenden Auffüllextraktion an der Quelle verschoben.
- ERINNERUNG: Bei Auffüllextraktionen bleibt der Knoten im Migrationssatz erhalten, auch wenn er in der Quelle nicht mehr existiert.
- Ein Knoten am Zielort wird zwischen einer Aufnahme und einer nachfolgenden Auffüllaufnahme verschoben.
Dieser Konflikt muss manuell behoben werden. Dabei muss eine Person, die mit dem Inhalt vertraut ist, entscheiden, welche der beiden Knoten gelöscht werden muss, wobei andere Inhalte, die darauf verweisen, zu berücksichtigen sind. Zur Lösung des Problems kann es erforderlich sein, dass die Auffüllextraktion ohne den fehlerhaften Knoten wiederholt wird.
Fehler bei der Auffüllaufnahme, da der Knoten, auf den verwiesen wird, nicht gelöscht werden kann top-up-ingestion-failure-due-to-unable-to-delete-referenced-node
Eine weitere häufige Ursache für einen Fehler bei der Auffüllaufnahme ist ein Versionskonflikt für einen bestimmten Knoten in der Zielinstanz. Um den Fehler zu identifizieren, laden Sie das Aufnahmeprotokoll über die Benutzeroberfläche von Cloud Acceleration Manager herunter und suchen Sie nach einem Eintrag wie dem Folgenden:
java.lang.RuntimeException: org.apache.jackrabbit.oak.api.CommitFailedException: OakIntegrity0001: Löschen des Verweisknotens nicht möglich: 8a2289f4-b904-4bd0-8410-15e41e0976a8
Dies kann vorkommen, wenn ein Knoten im Ziel zwischen einer Aufnahme und einer nachfolgenden Aufnahme mit der Einstellung Nicht bereinigen geändert wird, sodass eine neue Version erstellt wurde. Wenn der Migrationssatz mit aktivierter Option „Versionen einschließen“ extrahiert wurde, kann es zu einem Konflikt kommen, da das Ziel jetzt über eine neuere Version verfügt, auf die der Versionsverlauf und andere Inhalte verweisen. Der Aufnahmevorgang kann den fehlerhaften Versionsknoten nicht löschen, da auf diesen verwiesen wird.
Zur Lösung des Problems kann es erforderlich sein, dass die Auffüllextraktion ohne den fehlerhaften Knoten wiederholt wird. Oder erstellen Sie einen kleinen Migrationssatz des fehlerhaften Knotens, wobei die Option „Versionen einschließen“ deaktiviert ist.
Wenn eine Aufnahme mit der Einstellung Nicht bereinigen mit einem Migrationssatz durchgeführt werden muss, der Versionen enthält, ist es entsprechend den Best Practices wichtig, dass der Inhalt am Zielort so wenig wie möglich geändert wird, bis der Migrationsprozess abgeschlossen ist. Andernfalls können diese Konflikte auftreten.
Aufnahmefehler aufgrund von Eigenschaftswerten für große Knoten ingestion-failure-due-to-large-node-property-values
Die in MongoDB gespeicherten Knoteneigenschaftswerte dürfen 16 MB nicht überschreiten. Wenn ein Knotenwert die unterstützte Größe überschreitet, schlägt die Aufnahme fehl und das Protokoll enthält entweder:
- einen
BSONObjectTooLarge
-Fehler und gibt an, welcher Knoten das Maximum überschritten hat, oder - einen
BsonMaximumSizeExceededException
-Fehler, der angibt, dass ein Knoten vorhanden ist, der wahrscheinlich Unicode-Zeichen enthält, die die maximale Größe überschreiten **
Dies ist eine MongoDB-Beschränkung.
In der Notiz Node property value in MongoDB
in Voraussetzungen für das Content Transfer Tool finden Sie weitere Informationen und einen Link zu einem Oak-Tool, mit dem Sie alle großen Knoten finden können. Sobald alle Knoten mit großen Größen beseitigt sind, führen Sie die Extraktion und Aufnahme erneut durch.
Um diese Einschränkung möglicherweise zu vermeiden, führen Sie den Best Practices Analyzer auf der AEM-Quellinstanz aus und überprüfen Sie die Ergebnisse, insbesondere das Muster „Nicht unterstützte Repository-Struktur“ (Unsupported Repository Structure, URS).
Aufnahmefehler aufgrund unerwarteter zeitweise auftretender Fehler ingestion-failure-due-to-unexpected-intermittent-errors
Manchmal kann es unerwartet zeitweise auftretende Probleme aufgrund fehlgeschlagener Aufnahmen geben. In diesem Fall besteht die einzige Abhilfe leider darin, die Aufnahme erneut zu versuchen. Prüfen Sie das Aufnahmeprotokoll, um die Ursache des Fehlers zu ermitteln und festzustellen, ob es sich um einen der unten aufgeführten Fehler handelt, bei denen ein erneuter Versuch durchgeführt werden sollte.
Probleme mit MongoDB mongo-db-issues
Atlas prescale timeout error
– In der Aufnahmephase wird versucht, die Ziel-Cloud-Datenbank vorab auf eine geeignete Größe zu skalieren, die der Größe des aufzunehmenden Migrationssatzinhalts entspricht. In seltenen Fällen wird dieser Vorgang nicht innerhalb des erwarteten Zeitraums abgeschlossen.Exhausted mongo restore retries
– Die Versuche, eine lokale Sicherungskopie des aufgenommenen Migrationssatzinhalts in die Cloud-Datenbank wiederherzustellen, sind ausgeschöpft. Dies weist auf ein allgemeines Konsistenz-/Netzwerkproblem mit MongoDB hin, das sich häufig nach einigen Minuten selbst behebt.
Aufnahme aufgehoben ingestion-rescinded
Bei einer Aufnahme, die mit einer laufenden Extraktion als Migrationssatz für die Quelle erstellt wurde, wird geduldig gewartet, bis diese Extraktion erfolgreich ist, und zu diesem Zeitpunkt normal gestartet. Wenn die Extraktion fehlschlägt oder gestoppt wird, werden die Aufnahme und der dazugehörige Indizierungsvorgang nicht gestartet, sondern zurückgesetzt. Überprüfen Sie in diesem Fall die Extraktion, um festzustellen, warum sie fehlgeschlagen ist, beheben Sie das Problem und beginnen Sie erneut mit dem Extrahieren. Sobald die feste Extraktion ausgeführt wird, kann eine neue Aufnahme geplant werden.
Gelöschtes Asset nach erneuter Aufnahme nicht vorhanden
Im Allgemeinen wird eine Änderung der Cloud-Umgebungsdaten zwischen den einzelnen Aufnahmen nicht empfohlen.
Wenn ein Asset mithilfe der Touch-optimierten Assets-Benutzeroberfläche aus dem Cloud Service-Ziel gelöscht wird, werden die Knotendaten gelöscht, aber der Asset-Blob mit dem Image wird nicht sofort gelöscht. Es ist zum Löschen markiert, sodass es nicht mehr in der Benutzeroberfläche angezeigt wird. Es verbleibt allerdings im Datenspeicher, bis die Speicherbereinigung erfolgt und der Blob entfernt wird.
Wenn ein zuvor migriertes Asset gelöscht und die nächste Aufnahme ausgeführt wird, bevor die Speicherbereinigung den Löschvorgang für das Asset abgeschlossen hat, wird beim Aufnehmen desselben Migrationssatzes das gelöschte Asset nicht wiederhergestellt. Wenn die Aufnahme die Cloud-Umgebung für das Asset überprüft, liegen keine Knotendaten vor. Daher werden im Zuge der Aufnahme die Knotendaten in die Cloud-Umgebung kopiert. Bei Überprüfung des Blob-Speichers wird jedoch festgestellt, dass der Blob vorhanden ist, und das Kopieren des Blobs übersprungen. Daher sind die Metadaten nach der Aufnahme vorhanden, wenn Sie das Asset über die Touch-optimierte Benutzeroberfläche betrachten, das Image aber nicht. Beachten Sie, dass Migrationssätze und die Inhaltsaufnahme nicht für diesen Fall entwickelt wurden. Sie zielen darauf ab, der Cloud-Umgebung neue Inhalte hinzuzufügen und nicht zuvor migrierte Inhalte wiederherzustellen.
Wie geht es weiter whats-next
Wenn die Aufnahme erfolgreich war, startet AEM die Indizierung automatisch. Siehe Indizierung nach der Migration von Inhalten für weitere Informationen.
Nachdem Sie die Aufnahme von Inhalten in Cloud Service abgeschlossen haben, können Sie die Protokolle jedes Schritts (Extraktion und Aufnahme) anzeigen und nach Fehlern suchen. Weitere Informationen finden Sie unter Anzeigen von Protokollen für einen Migrationssatz.