Schritte zum Upgrade von Installationen auf Anwendungs-Servern (WLP) upgrade-steps-for-application-server-installations-wlp

NOTE
Auf dieser Seite wird das Upgrade-Verfahren für AEM 6.5 LTS auf WLP (WebSphere® Liberty) 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.

Ü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

  1. 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

  2. Wählen Sie je nach Ihren Anforderungen einen der folgenden Aktualisierungspfade aus:

    1. 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.
    2. 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
  3. 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
    
  4. 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 dem expanded 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
      
  5. Erstellen Sie eine Sicherung der sling.properties-Datei (normalerweise in crx-quickstart/conf/ vorhanden) und löschen Sie sie

  6. Ändern Sie in der-Datei die Version des Servlets server.xml6.0).

  7. 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
    
  8. Ü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 .

  9. Laden Sie den neuen 6.5 LTS-WAR herunter und kopieren Sie ihn in den Dropins-Ordner unter: /<path-to-aem-server>/dropins/

  10. AEM-Instanz starten: Dies kann normalerweise mithilfe dieses Befehls erfolgen:

    code language-shell
    <path-to-wlp-directory>/bin/server start server_name
    
  11. Wenn Sie benutzerdefinierte Änderungen in sling.properties haben, befolgen Sie bitte die folgenden Anweisungen:

    1. Beenden Sie die AEM-Instanz, indem Sie <path-to-wlp-directory>/bin/server stop server_name ausführen
    2. Wenden Sie Ihre benutzerdefinierten sling.properties auf die neu generierte sling.properties an (indem Sie auf die in Schritt 5 erstellte Sicherungsdatei verweisen)
    3. AEM-Instanz starten. Dies kann in der Regel durch Ausführen von Folgendem geschehen: <path-to-wlp-directory>/bin/server start server_name

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.

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