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 Bevorderend Code en Aanpassingenen pre-Verbeterde Taken van het Onderhoudvoor meer informatie. Zorg er bovendien voor dat uw systeem voldoet aan de vereisten voor de nieuwe versie van AEM. Zie hoe de Detector van het Patroon u kan helpen de ingewikkeldheid van uw upgarde schatten en ook de sectie van het Bereik en van de Vereisten van de Verbetering van zien die Uw Verbeteringvoor meer informatie plannen.

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 Oak 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 Tar van het Segment zijn, zie migrerend aan de Veelgestelde vragen van Tar van het Segment van Oak.

De werkelijke migratie wordt uitgevoerd met het standaard AEM QuickStart-jar-bestand, uitgevoerd met een nieuwe -x crx2oak -optie 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>>

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

waar:

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

Voor extra instructies bij het gebruiken van het crx2oak hulpmiddel, zie het Gebruiken van het CRX2Oak Hulpmiddel van de Migratie. 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 locatie in de installatiemap van AEM is: <aem-install>/crx-quickstart/opt/extensions/crx2oak.jar . De nieuwste versie van het CRX2Oak migratiehulpmiddel is beschikbaar voor download van de Bewaarplaats van de Adobe bij: 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 upgrade.log -bestand, dat zich onder crx-quickstart/logs in de installatiemap van AEM bevindt, omdat deze kunnen wijzen op niet-fatale fouten die tijdens de migratie zijn opgetreden.

Controleer de configuratiebestanden onder de map crx-quickstart/install . Als er een migratie nodig was, worden deze bijgewerkt om de doelopslagplaats te weerspiegelen.

Nota van A op datastores:

Hoewel FileDataStore de nieuwe standaardinstelling is voor AEM 6.3-installaties, is het gebruik 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 geen externe datastore is gespecificeerd. Dit zal ertoe leiden dat de volledige opslagplaats opnieuw aan de eerste start wordt onderworpen. Gebruik - overslaan-controlepunten om de migratie te dwingen of https://jackrabbit.apache.org/oak/docs/migration.html#Checkpoints_migration voor meer info 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 gedeelte <<ADDITIONAL_FLAGS>> van uw migratieopdracht om uw datastore-configuratie op te geven:

voor S3 datastores:

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

Waar /path/to/SharedS3DataStore.config het pad naar uw S3 datastore config-bestand vertegenwoordigt en /path/to/datastore het pad naar uw S3 datastore.

voor de datastores van het Dossier:

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

Waar /path/to/datastore het pad naar de datastore van het bestand vertegenwoordigt.

De upgrade uitvoeren performing-the-upgrade

als het gebruiken 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 bevordering aan 6.5, zie andere inhoudsherstructurering en migratieopties in Uitgestelde Migratie van de Inhouddie 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 de Code en de pagina van Aanpassingen van de Verbeteringworden gevonden.

Post-upgradecontroles en probleemoplossing uitvoeren perform-post-upgrade-check-troubleshooting

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