DokumentationAEM 6.5 LTSBenutzerhandbuch

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

Last update: Wed May 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Gilt für:
  • Experience Manager 6.5 LTS
  • Themen:

Erstellt für:

  • Admin
NOTE
Auf dieser Seite wird das Verfahren für das In-Place-Upgrade für AEM 6.5 LTS beschrieben. Wenn Sie eine Installation haben, die auf einem Anwendungs-Server bereitgestellt wird, lesen Sie Upgrade-Schritte für Anwendungs-Server-Installationen.

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 AEM 6.5 LTS erfüllt, und lesen Sie Überlegungen zur Upgrade- und wie Analyzer Ihnen bei der Schätzung der Komplexität helfen kann.

Migrationsvoraussetzungen migration-prerequisites

  • Erforderliche Mindestversion für Java: Vergewissern Sie sich, dass Oracle Java™ 17/21 auf Ihrem System installiert ist.

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

  1. Herunterladen der neuen JAR-Datei für AEM 6.5 LTS

  2. Bestimmen des korrekten Befehls zum Starten des Upgrades

  3. Instanz anhalten, wenn sie gerade ausgeführt wird

  4. Verwenden Sie die neue AEM 6.5 LTS-JAR-Datei, um die alte JAR-Datei außerhalb des crx-quickstart zu ersetzen

  5. Erstellen Sie ein Backup der sling.properties-Datei (normalerweise im crx-quickstart/conf/ vorhanden) und löschen Sie sie dann

  6. Entpacken Sie die Quickstart-JAR-Datei, indem Sie Folgendes ausführen:

    code language-shell 
    java -Xmx4096m -jar aem-quickstart.jar -unpack

  7. Wenn benutzerdefinierte sling.properties angewendet werden müssen, erstellen Sie eine neue lokale AEM-Instanz und rufen Sie die Datei sling.properties aus dem Verzeichnis crx-quickstart/conf ab. Wenden Sie die erforderlichen benutzerdefinierten Änderungen auf diese Datei an und kopieren Sie sie dann in den Ordner „crx-quickstart/conf“ der AEM-Instanz, die aktualisiert wird. Wenn keine benutzerdefinierten Eigenschaften vorhanden sind, kann dieser Schritt übersprungen werden.

Durchführen der Aktualisierung performing-the-upgrade

Bei Verwendung von S3:

  1. Entfernen Sie etwaige JARs unter crx-quickstart/install, die mit einer früheren Version des S3 Connectors verknüpft sind.

  2. Laden Sie die neueste Version des S3 Connectors 1.60.2 von https://repo1.maven.org/maven2/com/adobe/granite/com.adobe.granite.oak.s3connector/ herunter.

  3. Extrahieren Sie den S3-Connector (Version 1.60.2) und kopieren Sie den Inhalt der folgenden Ordner unter crx-quickstart/install wie folgt:

    1. com.adobe.granite.oak.s3connector-1.60.2/jcr_root/libs/system/install/1 unter crx-quickstart/install/1 kopieren
    2. com.adobe.granite.oak.s3connector-1.60.2/jcr_root/libs/system/install/15 unter crx-quickstart/install/15 kopieren

Starten Sie nun die AEM-Instanz mit dem neuen Befehl, der anhand der Informationen im Abschnitt Bestimmen des richtigen Startbefehls für das Upgrade ermittelt wurde.

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

NOTE
Die Unterstützung für einige der Java 8/11-Argumente wurde in Java 17/21 entfernt. Siehe Oracle Java™ 17-Dokumente, Oracle Java™ 21-Dokumente und Überlegungen zu Java&trade-Argumenten für AEM 6.5 LTS.

Um das Upgrade auszuführen, ist es wichtig, AEM mithilfe der JAR-Datei zu starten, um die Instanz aufzurufen.

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:

  1. Führen Sie in einer aktiven AEM-Instanz Folgendes in der Befehlszeile aus:

    code language-shell 
    ps -ef | grep java

  2. Suchen Sie nach dem AEM-Prozess. Er sieht in etwa so aus:

    code language-shell 
    /usr/bin/java -server -Xmx1024m -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar crx-quickstart/app/cq-quickstart-6.5.0-standalone-quickstart.jar start -c crx-quickstart -i launchpad -p 4502 -Dsling.properties=conf/sling.properties

  3. Ändern Sie den Befehl, indem Sie den Pfad zur vorhandenen JAR-Datei (in diesem Fall crx-quickstart/app/aem-quickstart*.jar) durch die neue LTS-JAR-Datei für AEM 6.5 ersetzen, die dem crx-quickstart gleichgeordnet ist. Wenn wir unseren vorherigen Befehl als Beispiel heranziehen, würde unser Befehl folgendermaßen lauten:

    code language-shell 
    /usr/bin/java -server -Xmx4096m -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar <AEM-6.5-LTS.jar> -c crx-quickstart -p 4502 -Dsling.properties=conf/sling.properties

    Dadurch wird sichergestellt, dass alle richtigen Speichereinstellungen, benutzerdefinierten Ausführungsmodi und anderen Umgebungsparametern für das Upgrade angewendet werden. Nach Abschluss des Upgrades kann die Instanz bei zukünftigen Starts vom Startskript gestartet werden.

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.

recommendation-more-help
51c6a92d-a39d-46d7-8e3e-2db9a31c06a2