AEM 6.5 tot AEM 6.5 LTS-migratie van inhoud met Oak-upgrade aem-65-to-aem-65lts-content-migration-using-oak-upgrade
Dit document verstrekt een uitvoerige gids voor de bevordering van Adobe Experience Manager van versie 6.5 aan 6.5 LTS, het concentreren op de migratie van de inhoudsbewaarplaats gebruikend het eiken-verbeteringshulpmiddel, een krachtig nut voor het overbrengen van inhoud tussen verschillende bewaarplaatsen met precisie en controle.
Vereisten prerequisites
Voordat u de migratie start, moet u controleren of aan de volgende vereisten is voldaan:
- Java-compatibiliteit: AEM 6.5 LTS moet zijn geïnstalleerd en geconfigureerd voor uitvoering met Java™ 17. Start de AEM-instantie nadat u deze hebt ingesteld en controleer of alle bundels actief en actief zijn zonder problemen
- Systeembronnen: zorg ervoor dat er voldoende schijfruimte en geheugen beschikbaar zijn om beide opslagruimten tijdens het migratieproces te verwerken
- Oak-upgrade Tool: Download de
oak-upgrade
pot van de officiële Gemaakt bewaarplaats. Zorg ervoor dat de versie overeenkomt met de eak-core versie die in AEM 6.5 LTS wordt gebruikt. Oak-upgradeprogramma wordt uitgevoerd op Oracle® Java™ 11 of hoger
Stap voor stap migratieproces step-by-step-migration-process
AEM 6.5 en AEM 6.5 LTS stoppen stopping-aem65-and-aem65lts
Stop voordat u de migratie start uw AEM 6.5- en AEM 6.5 LTS-instanties. Dit zorgt ervoor dat de opslagplaats zich in een stabiele toestand bevindt en er tijdens de migratie geen extra schrijvingen plaatsvinden.
Back-up maken van de AEM 6.5-instantie backing-up-the-aem65-instance
Maak een volledige back-up van uw AEM 6.5-exemplaar als dit nog niet is gebeurd.
Het Oak-upgradehulpprogramma voor Inhoud migreren gebruiken using-the-oak-upgrade-tool-for-content-migration
Het gereedschap Oak-upgrade wordt uitgevoerd via de opdrachtregel, zoals hier wordt getoond:
java -jar oak-upgrade-*.jar [options] /path/to/source/repository /path/to/destination/repository
Hieronder vindt u de belangrijkste opdrachten en opties:
Zeer belangrijke Opties
-
--include-paths
: geef de substructuren op die u wilt opnemen in de migratie. Zie dit voorbeeld voor het opdrachtgebruik:code language-none java -jar oak-upgrade-*.jar --include-paths=/content/site /old/repository /new/repository
-
--exclude-paths
: sluit specifieke paden uit van migratie. Wees voorzichtig met het gebruik van deze optie: als het pad aanwezig is op het doelsysteem, wordt het verwijderd. Zie dit voorbeeld voor het opdrachtgebruik:code language-none java -jar oak-upgrade-*.jar --exclude-paths=/content/old_site /old/repository /new/repository
-
--copy-binaries
: Met een eikenupgrade worden standaard alleen verwijzingen naar binaire bestanden gemigreerd, zodat de bestanden in het oorspronkelijke blob-/gegevensarchief blijven staan. Dientengevolge, vertrouwt de nieuwe bewaarplaats nog op de bronopslag voor binaire getallen. Als u binaire bestanden samen met de inhoud van de opslagplaats wilt migreren, gebruikt u de parameter--copy-binaries
om alle binaire gegevens naar de nieuwe opslagplaats te kopiëren, zoals hieronder wordt getoond:code language-none java -jar oak-upgrade-*.jar \ --copy-binaries \ --src-datastore=/old/repository/datastore \ --datastore=/new/repository/datastore \ /old/repository \ /new/repository
Controlepunten migreren migratiing-checkpoints
Bij het migreren van een oude SegmentMK-opslagplaats (vóór Oak 1.6) naar een nieuwe SegmentMK (Oak-versie groter of gelijk aan 1.6), worden de controlepunten ook gemigreerd. Hierdoor kan herindexering worden vermeden wanneer de Oak voor de eerste keer in de nieuwe opslagplaats wordt uitgevoerd. De controlepunten worden echter niet gemigreerd in de volgende gevallen:
- Aangepaste include-, exclude- of merge- paden zijn opgegeven of
- De binaire getallen worden gekopieerd door verwijzingen, er is geen brondatastore opgegeven en twee verschillende controlepunten bevatten een ander binair element onder hetzelfde pad.
In het tweede geval wordt de volgende waarschuwing en onderbrekingen weergegeven voor een eik-upgrade:
Checkpoints won't be copied, because no external datastore has been specified. This will result 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.
De eenvoudigste manier om dit probleem op te lossen is het opgeven van de brondatastore in de opdrachtregelopties (bijvoorbeeld --src-datastore
of --src-s3datastore
).
De waarschuwing kan ook worden genegeerd, maar in dit geval zal de repository bij het eerste opstarten volledig opnieuw worden ontkoppeld. Het kan een lang proces zijn, vooral voor de grote instantie. Bewaarplaats is pas bruikbaar als het herindexeringsproces is voltooid. Gebruik de optie --skip-checkpoints
om de waarschuwing te onderdrukken.
U kunt de bewaarplaats ook off-line opnieuw indexeren alvorens AEM te beginnen die off-line opnieuw indexerenvermijden volledig opnieuw indexeren bij eerste opstarten.
Voor meer informatie over het eiken-verbetering hulpmiddel en het geavanceerde gebruik, verwijs naar de officiële documentatie.