Een op locatie uitgevoerde upgrade uitvoeren performing-an-in-place-upgrade

NOTE
Deze pagina schetst de op zijn plaats verbeteringsprocedure voor AEM 6.5 LTS. Als u een installatie hebt die aan een toepassingsserver wordt opgesteld, zie de Stappen van de Verbetering voor de Installaties van de Server van de Toepassing.

Stappen voor upgrade pre-upgrade-steps

Voordat u de upgrade uitvoert, moeten verschillende stappen worden uitgevoerd. Zie Bevorderend Code en Aanpassingenen pre-Verbeterde Taken van het Onderhoudvoor meer informatie. Bovendien, zorg ervoor dat uw systeem aan de vereisten voor AEM 6.5 LTSvoldoet en verbetering planningsoverwegingenziet en hoe Analysatoru kan helpen de ingewikkeldheid schatten.

Migratievereisten migration-prerequisites

  • Minimaal Vereiste versie van Java: zorg ervoor u Oracle Java™ 17/21 hebt geïnstalleerd op uw systeem.

Voorbereiding van het JAR-bestand van AEM Quickstart prep-quickstart-file

  1. Download het nieuwe AEM 6.5 LTS jar-bestand

  2. Bepaal het correcte verbeteringsbegin bevel

  3. De instantie stoppen als deze wordt uitgevoerd

  4. Nieuwe AEM 6.5 LTS-jar gebruiken om de oude buiten de crx-quickstart -map te vervangen

  5. Maak een back-up van het sling.properties -bestand (meestal aanwezig in de crx-quickstart/conf/ ) en verwijder het vervolgens

  6. Pak de nieuwe QuickStart-jar uit door deze uit te voeren:

    code language-shell
    java -Xmx4096m -jar aem-quickstart.jar -unpack
    
  7. Als aangepaste sling.properties moeten worden toegepast, maakt u een nieuwe lokale AEM-instantie en haalt u het bestand sling.properties op uit de map crx-quickstart/conf. Pas de vereiste aangepaste wijzigingen toe op dit bestand en kopieer het vervolgens naar de map crx-quickstart/conf van de AEM-instantie die wordt bijgewerkt. Als er geen aangepaste eigenschappen zijn, kan deze stap worden overgeslagen.

De upgrade uitvoeren performing-the-upgrade

als het gebruiken van S3:

  1. Verwijder eventuele potten onder crx-quickstart/install die zijn gekoppeld aan een eerdere versie van de S3-connector.

  2. Download de recentste versie van 1.60.2 S3 schakelaar van https://repo1.maven.org/maven2/com/adobe/granite/com.adobe.granite.oak.s3connector/

  3. Pak de S3-connector (versie 1.60.2) uit en kopieer de inhoud van de volgende mappen onder crx-quickstart/install als volgt:

    1. Kopiëren com.adobe.granite.oak.s3connector-1.60.2/jcr_root/libs/system/install/1 onder crx-quickstart/install/1
    2. Kopiëren com.adobe.granite.oak.s3connector-1.60.2/jcr_root/libs/system/install/15 onder crx-quickstart/install/15

Nu, begin de instantie van AEM gebruikend het nieuwe die bevel wordt bepaald gebruikend de informatie onder het correcte bevel van het verbeteringsbeginsectie bepaalt.

Bepaal het correcte bevel van het verbeteringsbegin determining-the-correct-upgrade-start-command

NOTE
De steun voor sommige van Java 8/11 argumenten is verwijderd in Java 17/21, zie Oracle Java™ 17 documenten, Oracle Java™ 21 documentenen Java&trade argumenten overwegingen voor AEM 6.5 LTS.

Als u de upgrade wilt uitvoeren, is het belangrijk dat u AEM start met het jar-bestand om het exemplaar te tonen.

De upgrade wordt niet gestart wanneer u AEM start vanaf het startscript. De meeste klanten beginnen AEM gebruikend het beginmanuscript en hebben dit beginmanuscript aangepast om schakelaars voor omgevingsconfiguraties zoals geheugenmontages, veiligheidscertificaten, etc. te omvatten. Daarom raadt Adobe u aan deze procedure te volgen om de juiste upgradeopdracht te bepalen:

  1. Bij een lopende AEM-instantie voert u het volgende uit via de opdrachtregel:

    code language-shell
    ps -ef | grep java
    
  2. Kijk naar het AEM-proces. Het zal er ongeveer als volgt uitzien:

    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. Wijzig de opdracht door het pad naar de bestaande jar ( crx-quickstart/app/aem-quickstart*.jar in dit geval) te vervangen door de nieuwe AEM 6.5 LTS-jar die op hetzelfde niveau staat als de crx-quickstart -map. Gebruikend ons vorige bevel als voorbeeld, zou ons bevel zijn:

    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
    

    Hierdoor worden alle juiste geheugeninstellingen, aangepaste runmodi en andere omgevingsparameters voor de upgrade toegepast. Nadat de upgrade is voltooid, kan de instantie met het beginscript worden gestart in de toekomst.

Bijgewerkte Codebase implementeren deploy-upgraded-codebase

Zodra het op zijn plaats verbeteringsproces is voltooid, zou de bijgewerkte codebasis moeten worden opgesteld. De stappen voor het bijwerken van de codebasis om in de doelversie van AEM te werken kunnen in de Code en de pagina van Aanpassingen van de Verbeteringworden gevonden.

Controles achteraf en probleemoplossing uitvoeren perform-post-upgrade-check-troubleshooting

Zie Controle van de Verbetering van de Post en het Oplossen van problemen.

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