Uppgradera steg för programserverinstallationer (WLP) upgrade-steps-for-application-server-installations-wlp

NOTE
På den här sidan beskrivs uppgraderingsproceduren för AEM 6.5 LTS on WLP (WebSphere® Liberty).

Steg före uppgradering pre-upgrade-steps

Innan du utför uppgraderingen måste du utföra flera steg. Mer information finns i Uppgradera kod och anpassningar och Underhållsaktiviteter före uppgradering. Kontrollera dessutom att datorn uppfyller kraven för AEM 6.5 LTS.

Kontrollera Planera uppgraderingen och hur AEM Analyzer kan hjälpa dig att beräkna komplexiteten i uppgraderingen av AEM.

Krav för migrering migration-prerequisites

  • Minimikrav för Java-version: Kontrollera att du har installerat IBM® Sumeru JRE 17/21 på WLP-servern.

Utföra uppgraderingen performing-the-upgrade

  1. Se till att du har slutfört föruppgraderingen som att säkerhetskopiera AEM 6.5-servern innan du utför någon uppgraderingsaktivitet

  2. Välj något av följande alternativ beroende på dina behov:

    1. Lokal uppgradering: Om din nuvarande WLP-server stöder Servlet 6 kan du utföra en uppgradering på plats och fortsätta med steg 3.
    2. Sidegrade: Om du föredrar en ny installation eller om din WLP-server inte stöder Servlet 6, skapar du en ny WLP-instans med AEM 6.5 LTS och migrerar innehållet genom att följa guiden AEM 6.5 till AEM 6.5 LTS Content Migration Using Oak-upgrade och hoppa till avsnittet Distribuera uppgraderad kodbas
  3. Stoppa AEM-instansen. Det kan du vanligtvis göra med det här kommandot:

    code language-shell
    <path-to-wlp-directory>/bin/server stop server_name
    
  4. Ta bort filer och mappar som inte längre behövs. Objekten som du behöver ta bort specifikt är:

    • cq-quickstart-65.war från mappen dropins och mappen expanded som vanligtvis finns på <path-to-aem-server>/dropins/cq-quickstart-65.war respektive <path-to-aem-server>/apps/expanded/cq-quickstart-65.war

    • Mappen launchpad/startup. Du kan ta bort den genom att köra följande kommando i terminalen, förutsatt att du är i servermappen:

      code language-shell
      rm -rf crx-quickstart/launchpad/startup
      
    • Filen base.jar. Du kan göra detta genom att köra följande kommandon:

      code language-shell
      find crx-quickstart/launchpad -type f -name "org.apache.sling.launchpad.base.jar*" -exec rm -f {} \;
      
    • Filen BootstrapCommandFile_timestamp.txt:

      code language-shell
      rm -f crx-quickstart/launchpad/felix/bundle0/BootstrapCommandFile_timestamp.txt
      
    • Ta bort filen sling.options genom att köra:

      code language-shell
      find crx-quickstart/launchpad -type f -name "sling.options.file" -exec rm -rf {} \;
      
    • Ta bort filen sling.bootstrap.txt:

      code language-shell
      rm -rf crx-quickstart/launchpad/sling_bootstrap.txt
      
  5. Gör en säkerhetskopia av filen sling.properties (finns vanligtvis i crx-quickstart/conf/) och ta bort den

  6. Ändra serverletsversionen till 6.0 i filen server.xml

  7. Installera Java 17/Java 21 och kontrollera att det är korrekt installerat genom att köra:

    code language-shell
    java -version
    
  8. Granska startparametrarna för AEM-servern och se till att du uppdaterar parametrarna enligt dina krav. Mer information finns i Java 17/Java 21 Considerations.

  9. Hämta det nya 6.5 LTS-kriget och kopiera det till dropins-mappen på: /<path-to-aem-server>/dropins/

  10. Starta AEM-instansen: Det går oftast att göra med det här kommandot:

    code language-shell
    <path-to-wlp-directory>/bin/server start server_name
    
  11. Om du har egna ändringar i sling.properties, följ instruktionerna nedan:

    1. Stoppa AEM-instansen genom att köra <path-to-wlp-directory>/bin/server stop server_name
    2. Använd dina anpassade sling.properties-ändringar på den nyligen genererade sling.properties-filen (genom att referera till den säkerhetskopiefil som skapades i steg 5)
    3. Starta AEM-instansen. Det kan vanligtvis göras genom att köra: <path-to-wlp-directory>/bin/server start server_name

Distribuera uppgraderad kodbas deploy-upgraded-codebase

När uppgraderingen är klar ska den uppdaterade kodbasen distribueras. Steg för att uppdatera kodbasen så att den fungerar i målversionen av AEM finns på sidan Uppgraderingskod och anpassningar.

Genomför kontroller och felsökning efter uppgraderingen perform-post-upgrade-checks-and-troubleshooting

Se Efterbelys uppgraderingskontroller och felsökning.

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