Använda CRX2Oak Migration Tool using-the-crx-oak-migration-tool

Introduktion introduction

CRX2Oak är ett verktyg som är utformat för att migrera data mellan olika databaser.

Den kan användas för att migrera data från äldre CQ-versioner baserade på Apache Jackrabbit 2 till Oak, och den kan också användas för att kopiera data mellan Oak-databaser.

Du kan hämta den senaste versionen av crx2oak från den offentliga Adobe-databasen på den här platsen:
https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/crx2oak/

Listan över ändringar och korrigeringar för den senaste versionen finns i Versionsinformation för CRX2Oak.

Användningsexempel vid migrering migration-use-cases

Verktyget kan användas för:

Stöd för att migrera databaser med externa blobbarkiv (kallas ofta datalager) finns i olika kombinationer. En möjlig migreringsväg är från en CRX2-databas som använder en extern FileDataStore till en Oak-databas med S3DataStore.

Bilden nedan visar alla möjliga migreringskombinationer som stöds av CRX2Oak:

Funktioner features

CRX2Oak anropas under AEM uppgraderingar på ett sätt där användaren kan ange en fördefinierad migreringsprofil som automatiserar omkonfigureringen av beständiga lägen. Detta kallas snabbstartsläge.

Den kan också köras separat om den kräver mer anpassning. Observera dock att i det här läget görs ändringar endast i databasen och att ytterligare omkonfigurationer av AEM måste utföras manuellt. Detta kallas fristående läge.

En annan sak att tänka på är att med standardinställningarna i fristående läge migreras endast nodarkivet och den nya databasen återanvänder den gamla binära lagringen.

Automatiserat snabbläge automated-quickstart-mode

Sedan AEM 6.3 kan CRX2Oak hantera användardefinierade migreringsprofiler som kan konfigureras med alla migreringsalternativ som redan är tillgängliga. Detta ger både större flexibilitet och möjlighet att automatisera konfigurationen av AEM, funktioner som inte är tillgängliga om du använder verktyget i fristående läge.

Om du vill växla från CRX2Oak till snabbstartläge måste du definiera sökvägen till snabbstartmappen i AEM installationskatalog via den här systemmiljövariabeln i operativsystemet:

För UNIX-baserade system och macOS:

export SLING_HOME="/path/to/crx-quickstart"

För Windows:

SET "SLING_HOME=/path/to/crx-quickstart"

Återuppta support resume-support

Migreringen kan avbrytas när som helst, med möjlighet att återuppta den efteråt.

Anpassningsbar uppgraderingslogik customizable-upgrade-logic

Anpassad Java-logik och implementeras även med CommitHooks. Egen RepositoryInitializer kan implementeras för att initiera databasen med anpassade värden.

Stöd för minnesmappningsåtgärder support-for-memory-mapped-operations

CRX2Oak stöder även minnesmappade åtgärder som standard. Minnesmappning förbättrar prestanda avsevärt och bör användas när det är möjligt.

Selektiv migrering av innehåll selective-migration-of-content

Som standard migrerar verktyget hela databasen under "/" bana. Du har dock fullständig kontroll över vilket innehåll som ska migreras.

Om det finns någon del av innehållet som inte krävs för den nya instansen kan du använda --exclude-path -parameter för att exkludera innehållet och optimera uppgraderingsproceduren.

Bansammanslagning path-merging

Om data måste kopieras mellan två databaser och du har en innehållssökväg som är annorlunda på båda instanserna, kan du definiera den i --merge-path parameter. När du gör det kopierar CRX2Oak bara de nya noderna till måldatabasen och behåller de gamla.

Versionsstöd version-support

Som standard skapar AEM en version av varje nod eller sida som ändras och lagrar den i databasen. Versionerna kan sedan användas för att återställa sidan till ett tidigare läge.

Dessa versioner rensas dock aldrig även om originalsidan tas bort. När du hanterar databaser som har varit i drift under en längre tid kan migreringen behöva bearbeta en massa redundanta data som orsakas av överblivna versioner.

En användbar funktion för den här typen av situationer är tillägget --copy-versions parameter. Den kan användas för att hoppa över versionsnoderna under migrering eller kopiering av en databas.

Du kan också välja om du vill kopiera överblivna versioner genom att lägga till --copy-orphaned-versions=true.

Båda parametrarna har även stöd för YYYY-MM-DD datumformat, om du vill kopiera versioner senast ett visst datum.

Open Source Version open-source-version

En öppen källkodsversion av CRX2Oak finns i form av ekuppgradering. Det har stöd för alla funktioner förutom:

Se Apache-dokumentation för mer information.

Parametrar parameters

Alternativ för nodlagring node-store-options

Migreringsalternativ migration-options

Alternativ för Versionsarkiv version-store-options

Banalternativ path-options

Alternativ för källblobbutik source-blob-store-options

Alternativ för målblobStore destination-blobstore-options

Hjälpalternativ help-options

Felsökning debugging

Du kan även aktivera felsökningsinformation för migreringsprocessen för att felsöka eventuella problem som kan uppstå under processen. Du kan göra detta på olika sätt beroende på vilket läge du vill köra verktyget i:

Andra överväganden other-considerations

När du migrerar till en MongoDB-replikuppsättning måste du ange WriteConcern parameter till 2 på alla anslutningar till Mongo-databaserna.

Du kan göra detta genom att lägga till w=2 -parametern i slutet av anslutningssträngen så här:

java -Xmx4092m -XX:MaxPermSize=1024m -jar crx2oak.jar crx-quickstart/repository/ mongodb://localhost:27017/aem-author?replicaset=replica1&w=2