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. Mer information finns i Uppgradera kod och anpassningar och Underhållsaktiviteter före uppgradering. 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 se även avsnittet Uppgraderingsomfång och Krav 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 har Adobe ett verktyg som kan användas för att migrera databasen till den nya versionen av Oak Segment tar 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 Vanliga frågor om att migrera till Oak segmenttjära.

Den faktiska migreringen utförs med AEM snabburkfil, som körs med ett nytt -x crx2oak-alternativ 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>>

Där <<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 crx2oak-verktyget finns i Använda CRX2Oak-migreringsverktyget. 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 migreringsverktyget för CRX2Oak finns att hämta från Adobe-databasen på: https://repo1.maven.org/maven2/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 filen upgrade.log, som finns under crx-quickstart/logs i AEM installationskatalog, eftersom dessa kan tyda på icke-allvarliga fel som uppstod under migreringen.

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

En anteckning om datalager:

Även om FileDataStore är det nya standardvärdet för AEM 6.3-installationer krävs inte att ett externt datalager används. Även om du bör använda ett externt datalager som bästa praxis för produktionsdistributioner är det inte en förutsättning för uppgradering. På grund av den komplexitet som redan finns när du uppgraderar AEM rekommenderar Adobe att du utför uppgraderingen utan att utföra en datastorteringsmigrering. Om du vill kan du utföra en datalagermigrering efteråt som en separat åtgärd.

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 inkluderar du följande flaggor i delen <<ADDITIONAL_FLAGS>> av ditt migreringskommando:

För S3-datalager:

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

Där /path/to/SharedS3DataStore.config representerar sökvägen till S3-datalagrets konfigurationsfil och /path/to/datastore representerar sökvägen till S3-datalagret.

För fildatalager:

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

Där /path/to/datastore representerar sökvägen till din File DataStore.

Utföra uppgraderingen performing-the-upgrade

Om S3 används:

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. Om du vill uppgradera till 6.5 kan du läsa 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. Adobe rekommenderar därför 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 på sidan Uppgraderingskod och anpassningar.

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

Se Post Upgrade Checks and Troubleshooting.