Schritte zum Upgrade von Anwendungs-Server-Installationen (Tomcat) upgrade-steps-for-application-server-installations-tomcat

NOTE
Auf dieser Seite wird das Upgrade-Verfahren für AEM 6.5 LTS auf Tomcat beschrieben.

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 Java-Version: Vergewissern Sie sich, dass Oracle® JRE 17/21 auf Ihrem Tomcat-Server installiert ist.
  • Tomcat-Server: Die unterstützten Versionen von Tomcat-Server für AEM 6.5 LTS sind 10.0.x und 10.1.x.

Durchführen des Upgrades performing-the-upgrade

In allen Beispielen in diesem Verfahren wird Tomcat als Anwendungs-Server verwendet. Zudem wird vorausgesetzt, dass Sie bereits eine funktionierende AEM-Version installiert haben. In dieser Anleitung wird die Aktualisierung von AEM Version .6.5 auf6.5 LTS beschrieben.

  1. Wenn AEM 6.5 bereits bereitgestellt ist, überprüfen Sie, ob die Bundles ordnungsgemäß funktionieren, indem Sie Folgendes aufrufen: https://<serveraddress:port>/system/console/bundles

  2. Beenden Sie als Nächstes AEM 6.5. Dies kann über den Tomcat App Manager unter folgender Adresse durchgeführt werden: https://<serveraddress:port>/manager/html

  3. Vergewissern Sie sich, dass Sie die Aktivitäten vor dem Upgrade wie das Backup des AEM 6.5-Servers abgeschlossen haben, bevor Sie irgendwelche Upgrades durchführen

  4. Installieren Sie Java 17/Java 21 und stellen Sie sicher, dass es korrekt installiert ist, indem Sie den Befehl ausführen:

    code language-none
    java –version
    
  5. Einrichten eines mit AEM 6.5 LTS kompatiblen Tomcat-Servers

  6. Überprüfen Sie die Startparameter für den AEM-Server und stellen Sie sicher, dass Sie die Parameter entsprechend den Systemanforderungen aktualisieren. Weitere Informationen finden Sie Überlegungen zu Java 17Java 21 .

  7. Stellen Sie den neu heruntergeladenen 6.5 LTS-WAR mit Java 17/Java 21 auf dem Tomcat-Server bereit und starten Sie den Tomcat-Server mit AEM 6.5 LTS, indem Sie Folgendes ausführen:

    code language-none
    $CATALINA_HOME/bin/catalina.sh start
    
  8. Sobald die AEM ausgeführt wird, stellen Sie sicher, dass alle Bundles den Status „Wird ausgeführt“ aufweisen, indem Sie auf zugreifen: https://<serveraddress:port>/cq/system/console/bundles

  9. Beenden Sie den AEM 6.5 LTS Tomcat-Server. In den meisten Fällen können Sie dazu das Skript "./catalina.sh" ausführen, indem Sie diesen Befehl am Terminal ausführen:

    code language-none
    $CATALINA_HOME/bin/catalina.sh stop
    
  10. Migrieren Sie jetzt Ihren Inhalt von AEM 6.5 zu AEM 6.5 LTS, indem Sie die folgenden Schritte hier ausführen: Migration von AEM 6.5 zu AEM 6.5 LTS-Inhalt mit Oak-Upgrade

  11. Nachdem der Inhalt migriert wurde, wenden Sie alle benutzerdefinierten Änderungen an, die in der sling.properties erforderlich sind

  12. Starten Sie den Tomcat-Server für AEM 6.5 LTS, indem Sie Folgendes ausführen:

    code language-none
    $CATALINA_HOME/bin/catalina.sh start
    
  13. Überwachen Sie die Fehlerprotokolle beim Start von AEM, um sicherzustellen, dass keine Fehler vorhanden sind und AEM reibungslos ausgeführt wird

  14. Nachdem AEM 6.5 LTS gestartet wurde, überprüfen Sie, ob die Bundles ordnungsgemäß funktionieren, indem Sie Folgendes aufrufen: https://<serveraddress:port>/cq/system/console/bundles

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

Weitere Informationen Sie unter „Prüfungen undnach einem Upgrade“.

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