Durchführen einer ersetzenden Aktualisierung performing-an-in-place-upgrade

Schritte vor der Aktualisierung pre-upgrade-steps

Bevor Sie die Aktualisierung durchführen, müssen Sie einige Schritte ausführen. Weitere Informationen finden Sie unter Aktualisieren von Code und Anpassungen und Wartungsaufgaben vor einer Aktualisierung. Stellen Sie außerdem sicher, dass Ihr System die Anforderungen für die neue AEM-Version erfüllt. Erfahren Sie, wie Sie mithilfe der Mustererkennung die Komplexität Ihres Updates abschätzen können, und lesen Sie auch den Abschnitt „Aktualisierungsumfang und -anforderungen“ unter Planung der Aktualisierung.

Migrationsvoraussetzungen migration-prerequisites

Vorbereitung der „AEM Quickstart“-JAR-Datei prep-quickstart-file

Migration des Content-Repositorys content-repository-migration

Diese Migration ist nicht erforderlich, wenn Sie ein Upgrade von AEM 6.3 durchführen. Für Versionen älter als 6.3 bietet Adobe ein Tool, mit dem Sie das Repository in die neue Version von Oak Segment Tar von AEM 6.3 migrieren können. Es wird als Teil des Schnellstartpakets bereitgestellt und ist für alle Upgrades, die TarMK verwenden, obligatorisch. Upgrades für Umgebungen, die MongoMK verwenden, erfordern keine Repository-Migration. Weitere Informationen zu den Vorteilen des neuen Segment-TAR-Formats finden Sie in den häufig gestellten Fragen zur Migration zu Oak Segment Tar.

Die tatsächliche Migration wird mithilfe der standardmäßigen quickstart-JAR-Datei für AEM durchgeführt, und zwar mit der neuen Option -x crx2oak, mit der das crx2oak-Tool ausgeführt wird, um die Aktualisierung einfacher und zuverlässiger zu machen.

Um den Befehl zu ermitteln, den Sie ausführen sollten, verwenden Sie den folgenden Befehl:

java -Xmx4096m -jar aem-quickstart.jar -v -x crx2oak -xargs -- --load-profile <<YOUR_PROFILE>> <<ADDITIONAL_FLAGS>>

Dabei werden <<YOUR_PROFILE>> und <<ADDITIONAL_FLAGS>> durch das Profil und die Flags in der folgenden Tabelle ersetzt:

Dabei gilt:

Möglicherweise benötigen Sie auch zusätzliche Schalter für folgende Szenarien:

Weitere Informationen über die Verwendung des crx2oak-Tools finden Sie unter „Verwenden des CRX2Oak Migration Tools“. crx2oak helper JAR kann bei Bedarf manuell aktualisiert werden, indem die Datei manuell durch neuere Versionen ersetzt wird, nachdem die Schnellstart-Datei entpackt wurde. Sie finden die Datei im AEM-Installationsordner unter: <aem-install>/crx-quickstart/opt/extensions/crx2oak.jar. Die neueste Version des CRX2Oak-Migrations-Tools kann vom Adobe-Repository hier heruntergeladen werden: https://repo1.maven.org/maven2/com/adobe/granite/crx2oak/

Wenn die Migration erfolgreich abgeschlossen wurde, wird das Tool mit einem Exit Code von null beendet. Beachten Sie zusätzlich etwaige WARN- und ERROR-Meldungen in der Datei upgrade.log im AEM-Installationsverzeichnis unter crx-quickstart/logs. Diese Meldungen führen Fehler auf, die nicht schwerwiegend sind und bei der Migration auftraten.

Prüfen Sie die Konfigurationsdateien unter dem Ordner crx-quickstart/install. Wenn eine Migration erforderlich war, werden diese entsprechend dem Ziel-Repository aktualisiert.

Hinweis zu Datenspeichern:

FileDataStore ist der neue Standard für Installationen von AEM 6.3 und es ist kein externer Datenspeicher erforderlich. Die Verwendung eines externen Datenspeichers wird als Best Practice für Produktionsbereitstellungen empfohlen. Eine Aktualisierung ist jedoch nicht erforderlich. Aufgrund der Komplexität, die bereits bei der Aktualisierung von AEM vorhanden ist, empfiehlt Adobe, die Aktualisierung durchzuführen, ohne eine Datenspeichermigration vorzunehmen. Bei Bedarf kann anschließend eine Datenspeichermigration als separater Vorgang ausgeführt werden.

Fehlerbehebung bei Migrationsproblemen troubleshooting-migration-issues

Überspringen Sie diesen Abschnitt, wenn Sie ein Upgrade von 6.3 durchführen. Während die mitgelieferten crx2oak-Profile die Anforderungen der meisten Kundinnen und Kunden erfüllen sollten, gibt es Fälle, in denen zusätzliche Parameter erforderlich sind. Wenn während der Migration ein Fehler auftritt, sind für manche Aspekte Ihrer Umgebung möglicherweise zusätzliche Konfigurationsoptionen nötig. Wenn dies der Fall ist, werden Sie wahrscheinlich auf den folgenden Fehler stoßen:

Checkpoints werden nicht kopiert, da kein externer Datenspeicher angegeben wurde. Dadurch wird das gesamte Repository beim ersten Start neu indiziert. Verwenden Sie „–skip-checkpoints“, um die Migration zu erzwingen, oder finden Sie weitere Informationen unter https://jackrabbit.apache.org/oak/docs/migration.html#Checkpoints_migration.

Aus irgendeinem Grund benötigt der Migrationsprozess Zugriff auf Binärdateien im Datenspeicher und kann diese nicht finden. Um Ihre Datenspeicher-Konfiguration zu spezifizieren, fügen Sie die folgenden Flags in den Abschnitt <<ADDITIONAL_FLAGS>> Ihres Migrationsbefehls ein:

Für S3-Datenspeicher:

--src-s3config=/path/to/SharedS3DataStore.config --src-s3datastore=/path/to/datastore

Dabei entspricht /path/to/SharedS3DataStore.config dem Pfad zur Konfigurationsdatei Ihres S3-Datenspeichers und /path/to/datastore dem Pfad zu Ihrem S3-Datenspeicher.

Für Datei-Datenspeicher:

--src-datastore=/path/to/datastore

Dabei entspricht /path/to/datastore dem Pfad zu Ihrem Datei-Datenspeicher.

Durchführen der Aktualisierung performing-the-upgrade

Bei Verwendung von S3:

Bestimmen des korrekten Befehls zum Starten des Upgrades determining-the-correct-upgrade-start-command

Um das Upgrade durchzuführen, muss AEM mithilfe der JAR-Datei gestartet werden, um die Instanz zu öffnen. Lesen Sie für die Aktualisierung auf 6.5 auch die Informationen zu den Optionen für die Neustrukturierung und Migration des Inhalts unter Lazy-Content-Migration, die Sie mit dem Upgrade-Befehl auswählen können.

Beachten Sie, dass der Start von AEM über das Startskript das Upgrade nicht startet. Die meisten Kundinnen und Kunden starten AEM per Startskript und haben dieses Startskript so angepasst, dass es Schalter für Umgebungskonfigurationen wie Speichereinstellungen, Sicherheitszertifikate usw. enthält. Aus diesem Grund empfiehlt Adobe die folgende Vorgehensweise, um den richtigen Upgrade-Befehl zu ermitteln:

Bereitstellen einer aktualisierten Code-Basis deploy-upgraded-codebase

Sobald die ersetzende Aktualisierung abgeschlossen ist, sollte die aktualisierte Code-Basis bereitgestellt werden. Informationen zur Aktualisierung der Code-Basis, sodass sie in der Zielversion von AEM funktioniert, finden Sie auf der Seite Aktualisieren von Codes und Anpassungen.

Durchführen von Prüfungen und Fehlerbehebung nach einer Aktualisierung perform-post-upgrade-check-troubleshooting

Siehe Prüfungen und Fehlerbehebung nach einer Aktualisierung.