Het CRX2Oak-migratiehulpprogramma gebruiken

Inleiding

CRX2Oak is een hulpmiddel dat wordt ontworpen om gegevens tussen verschillende bewaarplaatsen te migreren.

Deze kan worden gebruikt om gegevens van oudere CQ-versies op basis van Apache Jackrabbit 2 te migreren naar eikenhout en kan ook worden gebruikt om gegevens te kopiëren tussen Oak-opslagplaatsen.

U kunt de nieuwste versie van crx2oak downloaden van de openbare opslagplaats van Adobe op deze plaats:
https://repo1.maven.org/maven2/com/adobe/granite/crx2oak/

De lijst met wijzigingen en correcties voor de nieuwste versie vindt u in de Opmerkingen bij de release CRX2Oak.

OPMERKING

Voor meer informatie over Apache Oak en de belangrijkste concepten van AEM persistentie raadpleegt u Inleiding tot het AEM Platform.

Gevallen voor migratiegebruik

U kunt het gereedschap gebruiken voor:

  • Migreren van oudere CQ 5-versies naar AEM 6
  • Gegevens kopiëren tussen meerdere eiken-opslagplaatsen
  • Gegevens tussen verschillende Oak MicroKernel-implementaties omzetten.

Ondersteuning voor migrerende opslagplaatsen die gebruikmaken van externe blob-opslagplaatsen (beter bekend als Data Stores) wordt in verschillende combinaties geboden. Een mogelijk migratiepad is afkomstig uit een CRX2-opslagplaats die een externe FileDataStore aan een eiken-opslagplaats met behulp van een S3DataStore.

In het onderstaande diagram worden alle mogelijke migratiecombinaties weergegeven die door CRX2Oak worden ondersteund:

chlimage_1-151

Functies

CRX2Oak wordt geroepen tijdens AEM verbeteringen op een manier waarin de gebruiker een vooraf bepaald migratieprofiel kan specificeren dat de herconfiguratie van persistentiemodi automatiseert. Dit wordt de snelstartmodus genoemd.

Het kan ook afzonderlijk worden uitgevoerd voor het geval het meer aanpassing vereist. Let er echter op dat in deze modus alleen wijzigingen worden aangebracht in de opslagplaats en dat eventuele aanvullende aanpassingen van AEM handmatig moeten worden uitgevoerd. Dit wordt de standalone wijze genoemd.

Een ander ding om op te merken is dat met de standaardmontages op standalone wijze, slechts de Opslag van de Knoop zal worden gemigreerd en de nieuwe bewaarplaats zal de oude binaire opslag hergebruiken.

Automatische QuickStart-modus

Sinds AEM 6.3 kan CRX2Oak door de gebruiker gedefinieerde migratieprofielen verwerken die kunnen worden geconfigureerd met alle migratieopties die al beschikbaar zijn. Hierdoor is meer flexibiliteit mogelijk en kunt u de configuratie van AEM automatiseren. Functies die niet beschikbaar zijn als u het gereedschap in zelfstandige modus gebruikt.

Als u wilt overschakelen van CRX2Oak naar de snelstartmodus, moet u het pad naar de crx-quickstart-map in de AEM installatiemap definiëren via deze omgevingsvariabele van het besturingssysteem:

Voor op UNIX gebaseerde systemen en macOS:

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

Voor Windows:

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

Ondersteuning hervatten

De migratie kan op elk moment worden onderbroken, met de mogelijkheid om deze later te hervatten.

Aanpasbare upgradelogica

Aangepaste Java-logica wordt ook geïmplementeerd met CommitHooks. Aangepast RepositoryInitializer kunnen klassen worden geïmplementeerd om de repository te initialiseren met aangepaste waarden.

Ondersteuning voor bewerkingen met geheugentoewijzing

CRX2Oak ondersteunt standaard ook bewerkingen die zijn toegewezen aan het geheugen. Geheugentoewijzing verbetert de prestaties aanzienlijk en moet waar mogelijk worden gebruikt.

LET OP

Vergeet echter niet dat bewerkingen met geheugentoewijzing niet worden ondersteund voor Windows-platforms. Daarom wordt aanbevolen het —disable-mmap parameter bij het uitvoeren van de migratie in Windows.

Selectieve migratie van inhoud

Standaard migreert het hulpprogramma de gehele opslagplaats onder de "/" pad. U hebt echter volledige controle over de inhoud die u wilt migreren.

Als er een onderdeel van de inhoud is dat niet op het nieuwe exemplaar wordt vereist, kunt u het --exclude-path om de inhoud uit te sluiten en de upgradeprocedure te optimaliseren.

Pad samenvoegen

Als gegevens moeten worden gekopieerd tussen twee opslagplaatsen en u een inhoudspad hebt dat op beide instanties verschillend is, kunt u het in de --merge-path parameter. Zodra u, zal CRX2Oak slechts de nieuwe knopen aan de bestemmingsbewaarplaats kopiëren en zal oude op zijn plaats houden.

chlimage_1-152

Versieondersteuning

AEM maakt standaard een versie van elk knooppunt of elke pagina die wordt gewijzigd en slaat deze op in de opslagplaats. De versies kunnen vervolgens worden gebruikt om de pagina in een eerdere staat te herstellen.

Deze versies worden echter nooit leeggemaakt, zelfs niet als de originele pagina wordt verwijderd. Wanneer het behandelen van bewaarplaatsen die lange tijd in werking zijn geweest, zou de migratie veel overtollige gegevens kunnen moeten verwerken die door weesversies worden veroorzaakt.

Een nuttig kenmerk voor dit soort situaties is de toevoeging van de --copy-versions parameter. Het kan worden gebruikt om de versieknooppunten tijdens migratie of exemplaar van een bewaarplaats over te slaan.

U kunt ook kiezen of u zwevende versies wilt kopiëren door --copy-orphaned-versions=true.

Beide parameters ondersteunen ook een YYYY-MM-DD datumnotatie als u versies niet later dan een bepaalde datum wilt kopiëren.

chlimage_1-153

Bronversie openen

Een open-bronversie van CRX2Oak is beschikbaar in de vorm van eik-verbetering. Alle functies worden ondersteund, met uitzondering van:

  • CRX2-ondersteuning
  • Ondersteuning voor migratieprofiel
  • Ondersteuning voor automatische AEM herconfiguratie

Zie de Apache-documentatie voor meer informatie .

Parameters

Opslagopties knooppunt

  • --cache: Cachegrootte in MB (standaard is 256)

  • --mmap: Toegang tot in geheugen toegewezen bestanden voor Segmentarchief inschakelen

  • --src-password: Wachtwoord voor de RDB-brondatabase

  • --src-user: Gebruiker voor de bron-RDB

  • --user: Gebruiker voor de beoogde RDB

  • --password: Wachtwoord voor de doel-RDB.

Migratieopties

  • --early-shutdown: Sluit de bron-JCR2-opslagplaats af nadat knooppunten zijn gekopieerd en voordat de haken voor vastleggen zijn toegepast

  • --fail-on-error: Dwingt een fout van de migratie als de knopen niet van de bronbewaarplaats kunnen worden gelezen.

  • --ldap: Hiermee migreert u LDAP-gebruikers van een CQ 5.x-instantie naar een op eik gebaseerde instantie. Dit werkt alleen als de Identiteitsprovider in de configuratie Eak een naam heeft. Zie voor meer informatie de LDAP-documentatie.

  • --ldap-config: Gebruik dit in combinatie met de --ldap parameter voor CQ 5.x-opslagruimten die meerdere LDAP-servers voor verificatie hebben gebruikt. U kunt het gebruiken om naar CQ 5.x te richten ldap_login.conf of jaas.conf configuratiebestanden. De indeling is --ldapconfig=path/to/ldap_login.conf.

Opties voor versieopslag

  • --copy-orphaned-versions: Kopiëren van zwevende versies wordt overgeslagen. Ondersteunde parameters zijn: true, false en yyyy-mm-dd. Standaardwaarden: true.

  • --copy-versions: Kopieert de versieopslag. Parameters: true, false, yyyy-mm-dd. Standaardwaarden: true.

Padopties

  • --include-paths: Lijst met door komma's gescheiden paden die tijdens het kopiëren moeten worden opgenomen
  • --merge-paths: Lijst met door komma's gescheiden paden die tijdens het kopiëren moeten worden samengevoegd
  • --exclude-paths: Lijst met door komma's gescheiden paden die tijdens het kopiëren moeten worden uitgesloten.

Opslagopties bronblob

  • --src-datastore: De datastore-map die als bron moet worden gebruikt FileDataStore

  • --src-fileblobstore: De datastore-map die als bron moet worden gebruikt FileBlobStore

  • --src-s3datastore: De datastore-map die moet worden gebruikt voor de bron S3DataStore

  • --src-s3config: Het configuratiebestand voor de bron S3DataStore.

Opties doelblobStore

  • --datastore: De datastore-map die als doel moet worden gebruikt FileDataStore

  • --fileblobstore: De datastore-map die als doel moet worden gebruikt FileBlobStore

  • --s3datastore: De datastore-map die voor het doel moet worden gebruikt S3DataStore

  • --s3config: Het configuratiebestand voor het doel S3DataStore.

Help-opties

  • -?, -h, --help: Help-informatie weergeven.

Foutopsporing

U kunt ook foutopsporingsinformatie inschakelen voor het migratieproces om problemen op te lossen die tijdens het proces kunnen optreden. U kunt dit anders doen afhankelijk van de wijze u het hulpmiddel binnen wenst in werking te stellen:

CRX2Oak-modus Actie
Snelstartmodus U kunt de —TRACE op logniveau of —DEBUG OP Logniveau opties voor de opdrachtregel bij het uitvoeren van CRX2Oak. In deze modus worden logbestanden automatisch doorgestuurd naar de upgrade.log, bestand.
Standalone modus

Voeg de —trace opties aan de CRX2Oak bevellijn om de gebeurtenissen van TRACE op standaardoutput te tonen (u moet logboeken opnieuw richten gebruikend redirection karakter: '>' of 'tee' (opdracht voor latere inspectie).

Andere overwegingen

Wanneer u naar een MongoDB-replicaset migreert, moet u de optie WriteConcern parameter to 2 op alle verbindingen met de Mongo-databases.

U kunt dit doen door het toevoegen van w=2 parameter aan het einde van de verbindingstekenreeks, als volgt:

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

Zie de documentatie van de reeks MongoDB-verbindingen over Vragen schrijven.

Op deze pagina