Een op locatie uitgevoerde upgrade uitvoeren

Laatste update: 2023-05-04
  • Onderwerpen:
  • Upgrading
    Meer informatie over dit onderwerp
  • Gemaakt voor:
  • Developer
LET OP

AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.

OPMERKING

Deze pagina schetst de verbeteringsprocedure voor AEM 6.4. Als u een installatie hebt die aan een toepassingsserver wordt opgesteld, zie Upgradestappen voor installatie van toepassingsservers.

Stappen voor upgrade

Voordat u de upgrade uitvoert, moeten verschillende stappen worden uitgevoerd. Zie Code en aanpassingen bijwerken en Onderhoudstaken vóór upgrade voor meer informatie . Zorg er bovendien voor dat uw systeem voldoet aan de vereisten voor de nieuwe versie van AEM. Zie hoe u de complexiteit van uw upgrade kunt inschatten met behulp van Patroondetector en ook de sectie Upgradebereik en -vereisten van Uw upgrade plannen voor meer informatie .

Migratievereisten

  • Minimale vereiste Java-versie: Het migratiehulpprogramma werkt alleen met Java versies 7 en hoger. Voor AEM 6.3 en hoger zijn JRE 8 en IBM JRE 7 en 8 van Oracle de enige ondersteunde versies.

  • Bijgewerkte instantie: Als u een upgrade uitvoert vanaf een versie ouder dan 5,6, zorg ervoor dat u een op zijn plaats verbetering aan AEM 6.0 door de procedure te volgen hebt uitgevoerd die in versie 6.0 van de documentatie van de Verbetering wordt beschreven.

Voorbereiding van het AEM QuickStart-jar-bestand

  1. Stop de instantie als deze wordt uitgevoerd.

  2. Download het nieuwe AEM jar-bestand en gebruik dit om het oude bestand buiten de crx-quickstart map.

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

    java -Xmx4096m -jar aem-quickstart.jar -unpack
    

Migratie van opslagplaats voor inhoud

Deze migratie is niet vereist als u een upgrade uitvoert vanaf AEM 6.3. Voor versies ouder dan 6.3, verstrekt Adobe een hulpmiddel dat kan worden gebruikt om de bewaarplaats aan de nieuwe versie van de Tar van het Segment van het Eak in AEM 6.3 te migreren. Deze wordt geleverd als onderdeel van het pakket quickstart en is verplicht voor alle upgrades die TarMK zullen gebruiken. Voor upgrades voor omgevingen die gebruikmaken van MongoMK is geen migratie naar opslagplaats vereist. Voor meer informatie over wat de voordelen van het nieuwe formaat van de Tar van het Segment zijn, zie Veelgestelde vragen over migreren naar eikensegment.

De werkelijke migratie wordt uitgevoerd met het standaard AEM quickstart jar-bestand, uitgevoerd met een nieuw -x crx2oak die het crx2oak-gereedschap uitvoert om de upgrade te vereenvoudigen en robuuster te maken.

OPMERKING

Als u de migratie van TarMK-inhoud in de repository uitvoert met de CRX2Oak QuickStart-extensie, kunt u mogelijk de samplinginhoud runmode door het volgende aan de lijn van het migratiebevel toe te voegen:

  • --promote-runmode nosamplecontent

Gebruik de volgende opdracht om te bepalen welke opdracht u moet uitvoeren:

java -Xmx4096m -jar aem-quickstart.jar -v -x crx2oak -xargs -- --load-profile <<YOUR_PROFILE>> <<ADDITIONAL_FLAGS>>

Wanneer <<YOUR_PROFILE>> en <<ADDITIONAL_FLAGS>> worden vervangen door het profiel en de markeringen in de volgende tabel:

Bronopslagplaats Doelopslagplaats Profiel Aanvullende markeringen
crx2 of TarMK met FileDataStore TarMK segment-fds Zie de sectie Problemen oplossen hieronder
crx2 MongoMK mongo-from-crx2 -T mongo-uri=mongo://mongo-host:mongo-port -T mongo-db=mongo-database-name
TarMK of crx2 met S3DataStore TarMK segment-douane-ds Zie de sectie Problemen oplossen hieronder
TarMK zonder datastore TarMK segment-geen-ds
MongoMK MongoMK Er is geen migratie nodig

Waar:

  • mongo-host is de IP van de MongoDB-server (bijvoorbeeld 127.0.0.1)

  • mongo-port is de MongoDB-serverpoort (bijvoorbeeld: (27017)

  • mongo-database-name vertegenwoordigt de naam van de database (bijvoorbeeld: auteur)

U kunt extra schakelaars voor de volgende scenario's ook vereisen:

  • Als u de upgrade uitvoert op een Windows-systeem waar Java-geheugentoewijzing niet correct wordt verwerkt, voegt u de opdracht --disable-mmap aan het bevel.

  • Als u Java 7 gebruikt, voegt u de opdracht -XX:MaxPermSize=2048m parameter net na de -Xmx parameter.

Voor meer instructies over het gebruik van het crx2oak-gereedschap raadpleegt u het dialoogvenster CRX2Oak-migratiehulpmiddel. U kunt indien nodig handmatig een upgrade uitvoeren van de crx2oak-hulplijn door deze handmatig te vervangen door nieuwere versies nadat u de snelstart hebt uitgenomen. De installatiemap van AEM bevindt zich op de volgende locatie: <aem-install>/crx-quickstart/opt/extensions/crx2oak.jar. De nieuwste versie van het CRX2Oak-migratiehulpprogramma kan worden gedownload van de Adobe Repository op: https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/crx2oak/

Als de migratie is voltooid, wordt het gereedschap afgesloten met de afsluitcode nul. Controleer bovendien op WAARSCHUWING- en FOUTberichten in het dialoogvenster upgrade.log bestand, zich onder crx-quickstart/logs in de AEM installatiemap, aangezien deze kunnen wijzen op niet-fatale fouten die zich tijdens de migratie hebben voorgedaan.

Controleer de onderstaande configuratiebestanden crx-quickstart/install map. Als er een migratie nodig was, worden deze aangepast aan de doelopslagplaats.

OPMERKING

while FileDataStore is het nieuwe gebrek voor AEM 6.3 installaties, wordt het gebruiken van een externe datastore niet vereist. Terwijl het gebruiken van een externe datastore als beste praktijken voor productielokaties wordt geadviseerd, is het geen eerste vereiste om te bevorderen. Vanwege de complexiteit die al aanwezig is bij de upgrade van AEM, raden we u aan de upgrade uit te voeren zonder een datastore-migratie uit te voeren. Indien gewenst, kan een datastore migratie achteraf als afzonderlijke inspanning worden uitgevoerd.

Problemen met migratie oplossen

Sla deze sectie over als u een upgrade uitvoert vanaf 6.3. Hoewel de aangeboden crx2oak-profielen aan de behoeften van de meeste klanten moeten voldoen, zijn er momenten waarop extra parameters nodig zullen zijn. Als u tijdens de migratie een fout tegenkomt, is het mogelijk dat er aspecten van uw omgeving zijn waarvoor aanvullende configuratieopties moeten worden opgegeven. Als dat het geval is, treedt waarschijnlijk de volgende fout op:

Controlepunten worden niet gekopieerd omdat er geen externe datastore is opgegeven. Dit zal ertoe leiden dat de volledige opslagplaats opnieuw aan de eerste start wordt onderworpen. Gebruik —skip-checkpoints om de migratie te dwingen of https://jackrabbit.apache.org/oak/docs/migration.html#Checkpoints_migration voor meer informatie te zien.

Om een of andere reden heeft het migratieproces toegang tot binaire bestanden in de datastore nodig en kan het proces niet vinden. Neem de volgende markeringen op in het dialoogvenster <<ADDITIONAL_FLAGS>> gedeelte van uw migratieopdracht:

Voor S3-datastores:

--src-s3config=/path/to/SharedS3DataStore.config --src-s3datastore=/path/to/datastore

Wanneer /path/to/SharedS3DataStore.config vertegenwoordigt de weg aan uw S3 datastore configuratiedossier en /path/to/datastore vertegenwoordigt de weg aan uw S3 datastore.

Voor datastores van bestand:

--src-datastore=/path/to/datastore

Wanneer /path/to/datastore geeft het pad naar uw gegevensopslagruimte voor bestanden aan.

De upgrade uitvoeren

Bij gebruik van S3:

  1. Eventuele onderliggende potten verwijderen crx-quickstart/install gekoppeld aan een eerdere versie van de S3-connector.

  2. Download de recentste versie van de 1.8.x S3 schakelaar van https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/com.adobe.granite.oak.s3connector/

  3. Extraheer het pakket naar een tijdelijke map en kopieer de inhoud van jcr_root/libs/system/install aan de crx-quickstart/install map.

Bepaal het correcte bevel van het verbeteringsbegin

Als u de upgrade wilt uitvoeren, is het belangrijk dat u AEM het jar-bestand gaat gebruiken om de instantie op te roepen. Voor een upgrade naar 6.4 kunt u ook andere opties voor inhoudsherstructurering en migratie bekijken in Lazy Content Migration die u met het verbeteringsbevel kunt kiezen.

Merk op dat het beginnen van AEM van het beginmanuscript niet de verbetering zal beginnen. De meeste klanten beginnen AEM het beginmanuscript te gebruiken en hebben dit beginmanuscript aangepast om schakelaars voor omgevingsconfiguraties zoals geheugenmontages, veiligheidscertificaten, enz. te omvatten. Om deze reden, adviseren wij na deze procedure om het juiste verbeteringsbevel te bepalen:

  1. Voer bij een actieve AEM de volgende handelingen uit vanaf de opdrachtregel:

    ps -ef | grep java
    
  2. Zoek het AEM. Het zal er ongeveer als volgt uitzien:

    /usr/bin/java -server -Xmx1024m -XX:MaxPermSize=256M -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar crx-quickstart/app/cq-quickstart-6.2.0-standalone-quickstart.jar start -c crx-quickstart -i launchpad -p 4502 -Dsling.properties=conf/sling.properties
    
  3. Wijzig het bevel door de weg aan het bestaande kruis te vervangen ( crx-quickstart/app/aem-quickstart*.jar in dit geval ) met de nieuwe jar die een zusterbeweging is van de crx-quickstart map. Gebruikend ons vorige bevel als voorbeeld, zou ons bevel zijn:

    /usr/bin/java -server -Xmx1024m -XX:MaxPermSize=256M -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar cq-quickstart-6.4.0.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

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 Pagina Code en aanpassingen bijwerken.

Controles achteraf en probleemoplossing uitvoeren

Zie Controles en probleemoplossing na upgrade.

Op deze pagina