Schritte zum Upgrade von Installationen auf Anwendungs-Servern (WLP) upgrade-steps-for-application-server-installations-wlp
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.
Überprüfen Sie Planung des Upgrades und wie Sie mit dem AEM Analyzer die Komplexität eines Upgrades von AEM abschätzen können.
Migrationsvoraussetzungen migration-prerequisites
- Erforderliche Java-Version: Vergewissern Sie sich, dass Sie IBM® Sumeru JRE 17/21 auf Ihrem WLP-Server installiert haben.
Durchführen des Upgrades performing-the-upgrade
-
Vergewissern Sie sich, dass Sie die vor dem Upgrade Schritte wie das Sichern des AEM 6.5-Servers abgeschlossen haben, bevor Sie eine Aktualisierung durchführen
-
Wählen Sie je nach Ihren Anforderungen einen der folgenden Aktualisierungspfade aus:
- In-Place-Upgrade: Wenn Ihr aktueller WLP-Server Servlet 6 unterstützt, können Sie ein In-Place-Upgrade durchführen und mit Schritt 3 fortfahren.
- Sidegrade: Wenn Sie ein neues Setup bevorzugen oder wenn Ihr WLP-Server Servlet 6 nicht unterstützt, richten Sie eine neue WLP-Instanz mit AEM 6.5 LTS ein und migrieren Sie den Inhalt, indem Sie dem Handbuch zur Migration von AEM 6.5 zu AEM 6.5 LTS-Inhalten mit Oak-Upgrade folgen und zum Abschnitt Bereitstellen der aktualisierten Codebasis wechseln
-
Halten Sie die AEM-Instanz an. Dies kann in der Regel mithilfe dieses Befehls erfolgen:
code language-shell <path-to-wlp-directory>/bin/server stop server_name
-
Entfernen Sie die nicht mehr benötigten Dateien und Ordner. Insbesondere müssen Sie die folgenden Elemente entfernen:
-
Die Datei cq-quickstart-65.war aus dem
dropins
Ordner und demexpanded
Ordner, die sich normalerweise unter<path-to-aem-server>/dropins/cq-quickstart-65.war
bzw.<path-to-aem-server>/apps/expanded/cq-quickstart-65.war
befinden -
Der
launchpad/startup
. Sie können ihn löschen, indem Sie am Terminal den folgenden Befehl ausführen, vorausgesetzt, Sie befinden sich im Ordner „server“:code language-shell rm -rf crx-quickstart/launchpad/startup
-
Die
base.jar
. Sie können dies tun, indem Sie die folgenden Befehle ausführen:code language-shell find crx-quickstart/launchpad -type f -name "org.apache.sling.launchpad.base.jar*" -exec rm -f {} \;
-
Die Datei
BootstrapCommandFile_timestamp.txt
:code language-shell rm -f crx-quickstart/launchpad/felix/bundle0/BootstrapCommandFile_timestamp.txt
-
Entfernen Sie die
sling.options
-Datei, indem Sie Folgendes ausführen:code language-shell find crx-quickstart/launchpad -type f -name "sling.options.file" -exec rm -rf {} \;
-
Entfernen Sie die
sling.bootstrap.txt
:code language-shell rm -rf crx-quickstart/launchpad/sling_bootstrap.txt
-
-
Erstellen Sie eine Sicherung der
sling.properties
-Datei (normalerweise incrx-quickstart/conf/
vorhanden) und löschen Sie sie -
Ändern Sie in der-Datei die Version des Servlets
server.xml
6.0). -
Installieren Sie Java 17/Java 21 und stellen Sie sicher, dass es korrekt installiert ist, indem Sie Folgendes ausführen:
code language-shell java -version
-
Überprüfen Sie die Startparameter für den AEM-Server und stellen Sie sicher, dass Sie die Parameter entsprechend Ihren Anforderungen aktualisieren. Weitere Informationen finden Sie Überlegungen zu Java 17Java 21 .
-
Laden Sie den neuen 6.5 LTS-WAR herunter und kopieren Sie ihn in den Dropins-Ordner unter:
/<path-to-aem-server>/dropins/
-
AEM-Instanz starten: Dies kann normalerweise mithilfe dieses Befehls erfolgen:
code language-shell <path-to-wlp-directory>/bin/server start server_name
-
Wenn Sie benutzerdefinierte Änderungen in
sling.properties
haben, befolgen Sie bitte die folgenden Anweisungen:- Beenden Sie die AEM-Instanz, indem Sie
<path-to-wlp-directory>/bin/server stop server_name
ausführen - Wenden Sie Ihre benutzerdefinierten
sling.properties
auf die neu generiertesling.properties
an (indem Sie auf die in Schritt 5 erstellte Sicherungsdatei verweisen) - AEM-Instanz starten. Dies kann in der Regel durch Ausführen von Folgendem geschehen:
<path-to-wlp-directory>/bin/server start server_name
- Beenden Sie die AEM-Instanz, indem Sie
Bereitstellen einer aktualisierten Code-Basis deploy-upgraded-codebase
Nach Abschluss des Upgrade-Prozesses 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 Fehlerbehebungen nach einem Upgrade perform-post-upgrade-checks-and-troubleshooting
Siehe Prüfungen und Fehlerbehebung nach einer Aktualisierung.