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

Stappen voor upgrade pre-upgrade-steps

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 migration-prerequisites

Voorbereiding van het AEM QuickStart-jar-bestand prep-quickstart-file

Migratie van opslagplaats voor inhoud content-repository-migration

Deze migratie is niet vereist als u een upgrade uitvoert vanaf AEM 6.3. Voor versies ouder dan 6.3, verstrekt de 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. Zie voor meer informatie over de voordelen van de nieuwe indeling Segment Tar de 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.

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:

Waarbij:

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

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 opslagplaats voor Adoben op: https://repo1.maven.org/maven2/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 bijgewerkt om de doelopslagplaats te weerspiegelen.

Een opmerking over datastores:

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, raadt Adobe 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 troubleshooting-migration-issues

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 performing-the-upgrade

Bij gebruik van S3:

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

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.5 raadpleegt u de overige opties voor het herstructureren van inhoud en migratie 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, etc. te omvatten. Om deze reden, adviseert de Adobe na deze procedure om het juiste verbeteringsbevel te bepalen:

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

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

Zie Controles en probleemoplossing na upgrade.