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

Steg före uppgradering pre-upgrade-steps

Innan du utför uppgraderingen måste du utföra flera steg. Se Uppgradera kod och anpassningar och Underhållsaktiviteter före uppgraderingen för mer information. Kontrollera dessutom att datorn uppfyller kraven för den nya versionen av AEM. Se hur Mönsteravkännare kan hjälpa dig att beräkna uppgraderingens komplexitet och även se avsnittet Upgrade Scope och Requirements i Planera din uppgradering för mer information.

Krav för migrering migration-prerequisites

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

Migrering av innehållsdatabas content-repository-migration

Migreringen krävs inte om du uppgraderar från AEM 6.3. För versioner som är äldre än 6.3 tillhandahåller Adobe ett verktyg som kan användas för att migrera databasen till den nya versionen av den eksegmentstjärna som finns i AEM 6.3. Det ingår som en del av snabbstartspaketet och är obligatoriskt för alla uppgraderingar som ska använda tarMK. Uppgraderingar för miljöer där MongoMK används kräver inte databasmigrering. Mer information om fördelarna med det nya segmenttjärformatet finns i Migrering till Oak Segment tar - frågor och svar.

Den faktiska migreringen utförs med AEM snabbredigeringsfil som körs med en ny -x crx2oak som kör crx2oak-verktyget för att förenkla uppgraderingen och göra den mer robust.

Använd följande kommando för att bestämma vilket kommando du ska köra:

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

Plats <<YOUR_PROFILE>> och <<ADDITIONAL_FLAGS>> ersätts med profilen och flaggorna i följande tabell:

Var:

Du kan också behöva ytterligare växlar för följande scenarier:

Mer information om hur du använder verktyget crx2oak finns i Använda CRX2Oak Migration Tool. JAR-hjälpfilen för crx2oak kan vid behov uppgraderas manuellt genom att manuellt ersätta den med senare versioner efter att snabbstarten har packats upp. Sökvägen i AEM installationsmapp är: <aem-install>/crx-quickstart/opt/extensions/crx2oak.jar. Den senaste versionen av CRX2Oak-migreringsverktyget kan hämtas från Adobe-databasen på: https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/crx2oak/

Om migreringen har slutförts avslutas verktyget med en avslutningskod på noll. Kontrollera dessutom om det finns WARN- och ERROR-meddelanden i upgrade.log fil, som finns under crx-quickstart/logs i AEM installationskatalog, eftersom dessa kan tyda på icke-allvarliga fel som uppstod under migreringen.

Kontrollera konfigurationsfilerna under crx-quickstart/install mapp. Om en migrering var nödvändig kommer dessa att uppdateras för att återspegla måldatabasen.

Felsöka migreringsproblem troubleshooting-migration-issues

Hoppa över det här avsnittet om du uppgraderar från 6.3. De tillhandahållna crx2oak-profilerna bör tillgodose behoven hos de flesta kunder, men det finns tillfällen då ytterligare parametrar behövs. Om ett fel inträffar under migreringen kan det finnas aspekter av miljön som kräver ytterligare konfigurationsalternativ. I så fall kommer du förmodligen att få följande fel:

Kontrollpunkter kopieras inte eftersom inget externt datalager har angetts. Detta resulterar i att hela databasen indexeras om första gången du startar. Använd —skip-checkpoints för att framtvinga migreringen eller läs https://jackrabbit.apache.org/oak/docs/migration.html#Checkpoints_migration för mer information.

Av någon anledning behöver migreringsprocessen åtkomst till binärfiler i datalagret och kan inte hitta den. Om du vill ange din datalagerkonfiguration tar du med följande flaggor i <<ADDITIONAL_FLAGS>> del av migreringskommandot:

För S3-datastorer:

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

Plats /path/to/SharedS3DataStore.config representerar sökvägen till din S3-datastore-konfigurationsfil och /path/to/datastore representerar sökvägen till S3-datalagret.

För fildatalager:

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

Plats /path/to/datastore representerar sökvägen till File DataStore.

Utföra uppgraderingen performing-the-upgrade

Om du använder S3:

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

För att kunna genomföra uppgraderingen är det viktigt att du börjar AEM använda filen jar för att ta fram instansen. För uppgradering till 6.4, se även andra alternativ för innehållsomstrukturering och migrering i Lazy Content Migration som du kan välja med uppgraderingskommandot.

Observera att AEM från startskriptet inte startar uppgraderingen. De flesta kunder börjar 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 vi att du följer den här proceduren för att fastställa rätt uppgraderingskommando:

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 i Sidan Uppgraderingskod och anpassningar.

Genomför efteruppgraderingskontroller och felsökning perform-post-upgrade-check-troubleshooting

Se Kontrollera och felsök efter uppgradering.