DokumentationAEM 6.5 LTSAnvändarhandbok

Utföra en uppgradering på plats performing-an-in-place-upgrade

Last update: Wed May 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Gäller:
  • Experience Manager 6.5 LTS
  • Ämnen:

Skapat för:

  • Administratör
NOTE
På den här sidan beskrivs uppgraderingsproceduren för AEM 6.5 LTS. Om du har en installation som distribueras till en programserver läser du Uppgradera steg för programserverinstallationer.

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 och se planeringshänsyn samt hur Analyzer kan hjälpa dig att beräkna komplexiteten.

Krav för migrering migration-prerequisites

  • Minimikrav på Java-version: Kontrollera att Oracle Java™ 17/21 är installerat på datorn.

Förberedelse av filen AEM Quickstart jar prep-quickstart-file

  1. Ladda ned nya AEM 6.5 LTS jar-filen

  2. Kontrollera rätt startkommando för uppgradering

  3. Stoppa instansen om den körs

  4. Använd nya AEM 6.5 LTS jar för att ersätta den gamla utanför mappen crx-quickstart

  5. Gör en säkerhetskopia av filen sling.properties (finns vanligtvis i crx-quickstart/conf/) och ta sedan bort den

  6. Packa upp den nya snabbstartsburken genom att köra:

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

  7. Om du behöver använda anpassade sling.properties skapar du en ny lokal AEM-instans och hämtar filen sling.properties från katalogen crx-quickstart/conf. Använd de anpassade ändringarna i den här filen och kopiera den sedan till katalogen crx-quickstart/conf för den AEM-instans som uppgraderas. Om det inte finns några anpassade egenskaper kan det här steget hoppas över.

Utföra uppgraderingen performing-the-upgrade

Om S3 används:

  1. Ta bort alla tecken under crx-quickstart/install som är associerade med en tidigare version av S3-anslutningen.

  2. Hämta den senaste versionen av 1.60.2 S3-anslutningen från https://repo1.maven.org/maven2/com/adobe/granite/com.adobe.granite.oak.s3connector/

  3. Extrahera S3-kopplingen (version 1.60.2) och kopiera innehållet i följande mappar under crx-quickstart/install enligt följande:

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

Starta nu AEM-instansen med det nya kommandot som bestäms med hjälp av informationen under avsnittet Kontrollera rätt startkommando för uppgradering.

Kontrollera rätt startkommando för uppgradering determining-the-correct-upgrade-start-command

NOTE
Stöd för vissa av Java 8/11-argumenten har tagits bort i Java 17/21, se Oracle Java™ 17-dokument, Oracle Java™ 21-dokument och JavaTrade-argument för AEM 6.5 LTS.

För att kunna genomföra uppgraderingen är det viktigt att du startar AEM med filen jar för att ta fram instansen.

Observera att uppgraderingen inte startar när AEM startas från startskriptet. De flesta kunder börjar använda AEM med startskriptet och har anpassat det här startskriptet för att inkludera växlar för miljökonfigurationer som minnesinställningar, säkerhetscertifikat osv. Därför rekommenderar Adobe att du följer den här proceduren för att fastställa rätt uppgraderingskommando:

  1. Kör följande från kommandoraden på en AEM-instans som körs:

    code language-shell 
    ps -ef | grep java

  2. Leta efter AEM-processen. Det ser ut ungefär så här:

    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. Ändra kommandot genom att ersätta sökvägen till den befintliga burken ( crx-quickstart/app/aem-quickstart*.jar i det här fallet) med den nya AEM 6.5 LTS-burken som är jämställd med mappen crx-quickstart. Om du använder vårt tidigare kommando som exempel blir vårt kommando:

    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

    Detta säkerställer att alla korrekta minnesinställningar, anpassade körningslägen och andra miljöparametrar används för uppgraderingen. När uppgraderingen har slutförts kan instansen startas från startskriptet vid framtida starter.

Distribuera uppgraderad kodbas deploy-upgraded-codebase

När uppgraderingsprocessen på plats har slutförts 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 efteruppgraderingskontroller och felsökning perform-post-upgrade-check-troubleshooting

Se Efterbelys uppgraderingskontroller och felsökning.

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