Migration von AEM 6.5 zu AEM 6.5 LTS-Inhalten mit Oak-Upgrade aem-65-to-aem-65lts-content-migration-using-oak-upgrade
Dieses Dokument enthält eine umfassende Anleitung zum Aktualisieren von Adobe Experience Manager von Version 6.5 auf 6.5 LTS mit Schwerpunkt auf der Migration von Content-Repositorys mit dem Oak-Upgrade-Tool, einem leistungsstarken Dienstprogramm für die präzise und kontrollierte Übertragung von Inhalten zwischen verschiedenen Repositorys.
Voraussetzungen prerequisites
Stellen Sie vor Beginn der Migration sicher, dass die folgenden Anforderungen erfüllt sind:
- Java-Kompatibilität: AEM 6.5 LTS muss installiert und für die Ausführung mit Java™ 17 konfiguriert sein. Starten Sie nach der Einrichtung die AEM-Instanz und stellen Sie sicher, dass alle Bundles aktiv sind und ohne Probleme ausgeführt werden
- Systemressourcen: Stellen Sie sicher, dass ausreichend Speicherplatz und Arbeitsspeicher für beide Repositorys während des Migrationsprozesses verfügbar sind
- Oak-Upgrade-Tool: Laden Sie die
oak-upgrade-JAR-Datei aus dem offiziellen Maven-Repository herunter. Stellen Sie sicher, dass die Version mit der in AEM 6.5 LTS verwendeten Oak-Core-Version übereinstimmt. Das Oak-Upgrade-Tool läuft auf Oracle® Java™ 11 oder höher
Schrittweiser Migrationsprozess step-by-step-migration-process
Anhalten von AEM 6.5 und AEM 6.5 LTS stopping-aem65-and-aem65lts
Beenden Sie vor Beginn der Migration Ihre LTS-Instanzen von AEM 6.5 und AEM 6.5. Dadurch wird sichergestellt, dass das Repository sich in einem stabilen Zustand befindet und während der Migration keine zusätzlichen Schreibvorgänge stattfinden.
Sichern der AEM 6.5-Instanz backing-up-the-aem65-instance
Erstellen Sie eine vollständige Sicherung Ihrer AEM 6.5-Instanz, falls noch nicht geschehen.
Verwenden des Oak-Upgrade-Tools für die Inhaltsmigration using-the-oak-upgrade-tool-for-content-migration
Das Oak-Upgrade-Tool wird wie im Folgenden gezeigt über die Befehlszeile ausgeführt:
java -jar oak-upgrade-*.jar [options] /path/to/source/repository /path/to/destination/repository
Im Folgenden finden Sie die wichtigsten Befehle und Optionen:
Schlüsseloptionen
-
--include-paths: Geben Sie Teilbäume an, die in die Migration einbezogen werden sollen. In diesem Beispiel wird der Befehl verwendet:code language-none java -jar oak-upgrade-*.jar --include-paths=/content/site /old/repository /new/repository -
--exclude-paths: Schließen Sie bestimmte Pfade von der Migration aus. Seien Sie vorsichtig, wenn Sie diese Option verwenden. Wenn der Pfad auf dem Zielsystem vorhanden ist, wird er entfernt. In diesem Beispiel wird der Befehl verwendet:code language-none java -jar oak-upgrade-*.jar --exclude-paths=/content/old_site /old/repository /new/repository -
--copy-binaries: Standardmäßig migriert oak-upgrade nur Verweise auf Binärdateien, sodass die tatsächlichen Dateien im ursprünglichen Blob/Datenspeicher verbleiben. Daher ist das neue Repository weiterhin auf den Quellspeicher für Binärdateien angewiesen. Um Binärdateien zusammen mit dem Repository-Inhalt zu migrieren, verwenden Sie den Parameter--copy-binaries, um alle Binärdaten in den neuen Speicher zu kopieren, wie unten dargestellt:code language-none java -jar oak-upgrade-*.jar \ --copy-binaries \ --src-datastore=/old/repository/datastore \ --datastore=/new/repository/datastore \ /old/repository \ /new/repository
Checkpoints migrieren migratiing-checkpoints
Beim Migrieren eines alten SegmentMK-Repositorys (vor Oak 1.6) zu einem neuen SegmentMK (Oak-Version größer oder gleich 1.6) werden die Checkpoints ebenfalls migriert. Dadurch kann eine Neuindizierung vermieden werden, wenn die Oak zum ersten Mal im neuen Repository ausgeführt wird. Die Checkpoints werden jedoch in folgenden Fällen nicht migriert:
- Benutzerdefinierte Ein-, Ausschluss- oder Zusammenführungspfade werden angegeben oder
- Die Binärdateien werden durch Verweise kopiert, es wird kein Quelldatenspeicher angegeben und zwei verschiedene Checkpoints enthalten eine andere Binärdatei unter demselben Pfad.
Im zweiten Fall gibt oak-upgrade folgende Warnung und Unterbrechungen aus:
Checkpoints won't be copied, because no external datastore has been specified. This will result in the full repository reindexing on the first start. Use --skip-checkpoints to force the migration or see https://jackrabbit.apache.org/oak/docs/migration.html#Checkpoints_migration for more info.
Die einfachste Möglichkeit, dieses Problem zu beheben, besteht darin, den Quelldatenspeicher in den Befehlszeilenoptionen anzugeben (beispielsweise --src-datastore oder --src-s3datastore).
Die Warnung kann auch ignoriert werden, aber in diesem Fall wird das Repository beim ersten Start vollständig neu indiziert. Es kann ein langer Prozess sein, besonders für den großen Fall. Das Repository ist erst verwendbar, wenn der Neuindizierungsprozess abgeschlossen ist. Verwenden Sie die Option --skip-checkpoints , um die Warnung zu unterdrücken.
Sie können das Repository auch offline neu indizieren, bevor Sie AEM mit Offline-Neuindizierung starten.
Weitere Informationen zum Oak-Upgrade-Tool und zur erweiterten Verwendung finden Sie in der offiziellen Dokumentation.