AEM 6.5 till AEM 6.5 LTS Content Migration Using Oak-upgrade aem-65-to-aem-65lts-content-migration-using-oak-upgrade
I det här dokumentet förklaras hur du uppgraderar Adobe Experience Manager från 6.5 till 6.5 LTS, med fokus på att migrera innehållsdatabasen. Det handlar om att använda Oak uppgraderingsverktyg för att överföra innehåll mellan databaser med precision och kontroll.
Förutsättningar prerequisites
Kontrollera att följande krav är uppfyllda innan du startar migreringen:
- Java-kompatibilitet: AEM 6.5 LTS måste installeras och konfigureras för att köras med Java™ 17. Starta AEM-instansen när du har konfigurerat den och kontrollera att alla paket är aktiva och körs utan problem
- Systemresurser: Se till att det finns tillräckligt med diskutrymme och minne för att hantera båda databaserna under migreringsprocessen
- Oak-uppgraderingsverktyg: Hämta
oak-upgradejar från Maven-databasen. Kontrollera att versionen överensstämmer med Oak Core-versionen som används i AEM 6.5 LTS. Oak-uppgraderingsverktyget kan köras i Oracle® Java™ 11 eller senare
Migreringsprocess step-by-step-migration-process
Stoppa AEM 6.5 och AEM 6.5 LTS stopping-aem65-and-aem65lts
Stoppa AEM 6.5- och AEM 6.5 LTS-instanserna innan du startar migreringen. På så sätt ser du till att databasen är i ett stabilt läge och att inga ytterligare skrivningar görs under migreringen.
Säkerhetskopiera AEM 6.5 Instance backing-up-the-aem65-instance
Gör en fullständig säkerhetskopiering av din AEM 6.5-instans om du inte redan har gjort det.
Använda Oak uppgraderingsverktyg för innehållsmigrering using-the-oak-upgrade-tool-for-content-migration
Oak-uppgraderingsverktyget körs via kommandoraden, vilket visas här:
java -jar oak-upgrade-*.jar [options] /path/to/source/repository /path/to/destination/repository
Nedan finns de viktigaste kommandona och alternativen:
Nyckelalternativ
-
--include-paths: Ange underträd som ska inkluderas i migreringen. I det här exemplet finns information om kommandoanvändning:code language-none java -jar oak-upgrade-*.jar --include-paths=/content/site /old/repository /new/repository -
--exclude-paths: Exkludera specifika sökvägar från migreringen. Var försiktig när du använder det här alternativet - om sökvägen finns i målsystemet tas den bort. I det här exemplet finns information om kommandoanvändning:code language-none java -jar oak-upgrade-*.jar --exclude-paths=/content/old_site /old/repository /new/repository -
--copy-binaries: Som standard migrerar Oak-upgrade endast referenser till binära filer, vilket innebär att de faktiska filerna finns kvar i den ursprungliga blob-/datalagret. Därför är den nya databasen fortfarande beroende av källagringsplatsen för binärfiler. Om du vill migrera binärfiler tillsammans med databasinnehållet använder du parametern--copy-binariesför att kopiera alla binära data till den nya lagringsplatsen, vilket visas nedan:code language-none java -jar oak-upgrade-*.jar \ --copy-binaries \ --src-datastore=/old/repository/datastore \ --datastore=/new/repository/datastore \ /old/repository \ /new/repository
Migrera kontrollpunkter migratiing-checkpoints
När du migrerar en gammal SegmentMK-databas (före Oak 1.6) till en ny SegmentMK (Oak version 1.6 eller senare) migreras även kontrollpunkterna. Med den här processen undviker du omindexering när Oak körs för första gången på den nya databasen. Kontrollpunkterna migreras dock inte i följande fall:
- Anpassade inkluderings-, uteslutnings- eller kopplingssökvägar har angetts eller
- Binärfilerna kopieras med referens. Inget källdatalager har angetts och två olika kontrollpunkter innehåller en annan binär fil under samma sökväg.
I det andra fallet skickar Oak-uppgradering följande varningar och avbrott:
Checkpoints are not copied, because no external datastore has been specified. This results in the full repository reindexing on the first start. Use --skip-checkpoints to force the migration or see https://jackrabbit.apache.org/oak/docs/migration.html#Checkpoints_migration for more info.
Det enklaste sättet att åtgärda problemet är att ange källdatalagret i kommandoradsalternativen (till exempel --src-datastore eller --src-s3datastore).
Varningen kan också ignoreras, men i det här fallet indexeras databasen helt om vid första starten. Det kan vara en lång process, särskilt för den stora instansen. Databasen kan inte användas förrän omindexeringen är klar. Använd alternativet --skip-checkpoints om du vill inaktivera varningen.
Du kan även indexera om databasen offline innan du startar AEM med omindexering offline för att undvika fullständig omindexering vid första starten.
Mer information om uppgraderingsverktyget och avancerad användning finns i den officiella dokumentationen.