Het CRX2Oak-migratiehulpmiddel 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://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/crx2oak/

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

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. Eén mogelijk migratiepad is afkomstig van een CRX2-opslagplaats die een externe FileDataStore gebruikt naar een Eak-opslagplaats die een S3DataStore gebruikt.

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

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 die ook wordt geïmplementeerd met CommitHooks. Aangepaste RepositoryInitializer-klassen kunnen 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.

Selectieve migratie van inhoud

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

Als er om het even welk deel van de inhoud is die niet op de nieuwe instantie wordt vereist, kunt u de --exclude-path parameter gebruiken om de inhoud uit te sluiten en de verbeteringsprocedure te optimaliseren.

Samenvoegen van pad

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

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 nuttige eigenschap voor deze types van 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 toe te voegen.

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

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 Apache Documentation 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 de LDAP-documentatie voor meer informatie.

• --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 aan CQ 5.x ldap_login.conf of jaas.conf configuratiedossiers te richten. De notatie 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. Wordt standaard ingesteld op true.

• --copy-versions: Kopieert de versieopslag. Parameters: true, false, yyyy-mm-dd. Wordt standaard ingesteld op 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 voor 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:

Andere overwegingen

Wanneer het migreren aan een MongoDB replicaset, zorg ervoor u de WriteConcern parameter aan 2 op alle verbindingen aan de gegevensbestanden van Mongo plaatst.

U kunt dit doen door de w=2 parameter aan het eind van het verbindingskoord toe te voegen, als dit:

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

Business.Adobe.com-bronnen

Auto Form Fill Personalized Communications Responsive Forms Managed Cloud Web Content Management Digital Rights Management