Utilizzo dello strumento di migrazione CRX2Oak using-the-crx-oak-migration-tool

Introduzione introduction

CRX2Oak è uno strumento progettato per migrare i dati tra archivi diversi.

Può essere utilizzato per migrare i dati dalle versioni precedenti di CQ basate su Apache Jackrabbit 2 ad Oak e può anche essere utilizzato per copiare i dati tra archivi Oak.

Puoi scaricare la versione più recente di crx2oak dall’archivio di Adobi pubblico da questa posizione:
https://repo1.maven.org/maven2/com/adobe/granite/crx2oak/

NOTE
Per ulteriori informazioni su Apache Oak e sui concetti chiave della persistenza di Adobe Experience Manager (AEM), vedi Introduzione alla piattaforma AEM.

Casi di utilizzo della migrazione migration-use-cases

Lo strumento può essere utilizzato per:

  • Migrazione dalle versioni precedenti di CQ 5 all’AEM 6
  • Copia dei dati tra più archivi Oak
  • Conversione di dati tra diverse implementazioni Oak MicroKernel.

Il supporto per la migrazione degli archivi tramite archivi BLOB esterni (comunemente noti come archivi dati) è fornito in diverse combinazioni. Un possibile percorso di migrazione è da un archivio CRX2 che utilizza un FileDataStore esterno a un archivio Oak che utilizza un S3DataStore.

Il diagramma seguente illustra tutte le possibili combinazioni di migrazione supportate da CRX2Oak:

chlimage_1-151

Funzioni features

CRX2Oak viene richiamato durante gli aggiornamenti AEM in modo che l’utente possa specificare un profilo di migrazione predefinito che automatizza la riconfigurazione delle modalità di persistenza. Questa modalità è denominata modalità di avvio rapido.

Può anche essere eseguito separatamente nel caso richieda una maggiore personalizzazione. Tuttavia, in questa modalità le modifiche vengono apportate solo all’archivio e ogni ulteriore riconfigurazione dell’AEM deve essere eseguita manualmente. Questa modalità è denominata standalone.

Un altro aspetto da notare è che con le impostazioni predefinite in modalità standalone, viene eseguita la migrazione solo dell’archivio dei nodi e il nuovo archivio riutilizza il vecchio archivio binario.

Modalità QuickStart automatizzata automated-quickstart-mode

Da AEM 6.3, CRX2Oak è in grado di gestire profili di migrazione definiti dall’utente che possono essere configurati con tutte le opzioni di migrazione già disponibili. Ciò consente sia una maggiore flessibilità sia la possibilità di automatizzare la configurazione di AEM, funzioni che non sono disponibili se si utilizza lo strumento in modalità autonoma.

Per passare da CRX2Oak alla modalità quickstart, definire il percorso della cartella crx-quickstart nella directory di installazione dell'AEM tramite questa variabile di ambiente del sistema operativo:

Per sistemi basati su UNIX e macOS:

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

Per Windows:

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

Riprendi supporto resume-support

La migrazione può essere interrotta in qualsiasi momento, con la possibilità di riprenderla in seguito.

Logica di aggiornamento personalizzabile customizable-upgrade-logic

La logica Java™ personalizzata può essere implementata utilizzando CommitHooks. È possibile implementare RepositoryInitializer classi personalizzate per inizializzare l'archivio con valori personalizzati.

Supporto per operazioni con mapping della memoria support-for-memory-mapped-operations

Per impostazione predefinita, CRX2Oak supporta anche operazioni mappate sulla memoria. La mappatura della memoria migliora notevolmente le prestazioni e deve essere utilizzata quando possibile.

CAUTION
Si noti tuttavia che le operazioni mappate alla memoria non sono supportate per le piattaforme Windows. Pertanto, si consiglia di aggiungere il parametro —disable-mmap durante l'esecuzione della migrazione su Windows.

Migrazione selettiva dei contenuti selective-migration-of-content

Per impostazione predefinita, lo strumento esegue la migrazione dell'intero archivio nel percorso "/". Tuttavia, hai il controllo completo sul contenuto da migrare.

Se una parte del contenuto non è necessaria nella nuova istanza, è possibile utilizzare il parametro --exclude-path per escludere il contenuto e ottimizzare la procedura di aggiornamento.

Unione percorsi path-merging

Se i dati devono essere copiati tra due archivi e si dispone di un percorso di contenuto diverso in entrambe le istanze, è possibile definirlo nel parametro --merge-path. In questo caso, CRX2Oak copia solo i nuovi nodi nell'archivio di destinazione e mantiene i vecchi nodi in posizione.

chlimage_1-152

Supporto versione version-support

Per impostazione predefinita, l’AEM crea una versione di ogni nodo o pagina che viene modificata e la memorizza nell’archivio. Le versioni possono quindi essere utilizzate per ripristinare uno stato precedente della pagina.

Tuttavia, queste versioni non vengono mai eliminate anche se la pagina originale viene eliminata. Quando si gestiscono archivi che sono in funzione da molto tempo, la migrazione può rielaborare i dati ridondanti causati da versioni orfane.

Una caratteristica utile per questi tipi di situazioni è l'aggiunta del parametro --copy-versions. Può essere utilizzato per saltare i nodi di versione durante la migrazione o la copia di un archivio.

È inoltre possibile scegliere se copiare le versioni orfane aggiungendo --copy-orphaned-versions=true.

Entrambi i parametri supportano anche un formato data YYYY-MM-DD, nel caso in cui si desideri copiare le versioni non oltre una data specifica.

chlimage_1-153

Apri versione Source open-source-version

È disponibile una versione open-source di CRX2Oak sotto forma di oak-upgrade. Supporta tutte le funzioni ad eccezione di:

  • Supporto di CRX2
  • Supporto del profilo di migrazione
  • Supporto per la riconfigurazione automatica dell’AEM

Per ulteriori informazioni, consulta la documentazione di Apache.

Parametri parameters

Opzioni archivio nodi node-store-options

  • --cache: dimensione cache in MB (valore predefinito: 256)

  • --mmap: abilita l'accesso ai file mappati in memoria per l'archivio segmenti

  • Password --src-password: per il database RDB di origine

  • Utente --src-user: per il database radice di origine

  • --user: utente per RDB di destinazione

  • --password: password per RDB di destinazione.

Opzioni di migrazione migration-options

  • --early-shutdown: chiude l'archivio JCR2 di origine dopo la copia dei nodi e prima dell'applicazione degli hook di commit

  • --fail-on-error: forza un errore della migrazione se i nodi non possono essere letti dall'archivio di origine.

  • --ldap: esegue la migrazione degli utenti LDAP da un'istanza CQ 5.x a una basata su Oak. Affinché ciò funzioni, il provider di identità nella configurazione di Oak deve essere denominato ldap. Per ulteriori informazioni, vedere la documentazione LDAP.

  • --ldap-config: Utilizzalo con il parametro --ldap per gli archivi CQ 5.x che hanno utilizzato più server LDAP per l'autenticazione. È possibile utilizzarlo per puntare ai file di configurazione CQ 5.x ldap_login.conf o jaas.conf. Il formato è --ldapconfig=path/to/ldap_login.conf.

Opzioni archivio versioni version-store-options

  • --copy-orphaned-versions: la copia delle versioni orfane viene ignorata. I parametri supportati sono: true, false e yyyy-mm-dd. Impostazione predefinita: true.

  • --copy-versions: Copia l'archivio delle versioni. Parametri: true, false, yyyy-mm-dd. Impostazione predefinita: true.

Opzioni percorso path-options

  • --include-paths: elenco di percorsi separati da virgole da includere durante la copia
  • --merge-paths: elenco di percorsi separati da virgole da unire durante la copia
  • --exclude-paths: elenco di percorsi separati da virgole da escludere durante la copia.

Opzioni archivio BLOB di Source source-blob-store-options

  • --src-datastore: Directory dell'archivio dati da utilizzare come origine FileDataStore

  • --src-fileblobstore: la directory dell'archivio dati da utilizzare come origine FileBlobStore

  • --src-s3datastore: la directory dell'archivio dati da utilizzare per l'origine S3DataStore

  • --src-s3config: file di configurazione per l'origine S3DataStore.

Opzioni BlobStore di destinazione destination-blobstore-options

  • --datastore: Directory dell'archivio dati da utilizzare come destinazione FileDataStore

  • --fileblobstore: Directory dell'archivio dati da utilizzare come destinazione FileBlobStore

  • --s3datastore: directory dell'archivio dati da utilizzare per la destinazione S3DataStore

  • --s3config: file di configurazione per la destinazione S3DataStore.

Opzioni della Guida help-options

  • -?, -h, --help: Visualizza informazioni della Guida.

Debugging debugging

È inoltre possibile abilitare le informazioni di debug per il processo di migrazione per la risoluzione dei problemi che potrebbero verificarsi durante il processo. È possibile eseguire questa operazione in modo diverso a seconda della modalità in cui si desidera eseguire lo strumento:

Modalità CRX2Oak
Azione
Modalità Quickstart
È possibile aggiungere le opzioni —log-level TRACE o —log-level DEBUG alla riga di comando durante l'esecuzione di CRX2Oak. In questa modalità, i registri vengono reindirizzati automaticamente al file upgrade.log.
Modalità autonoma
Aggiungere le opzioni —trace alla riga di comando di CRX2Oak per visualizzare gli eventi TRACE nell'output standard. È necessario reindirizzare i registri utilizzando il carattere di reindirizzamento: '>' o il comando 'tee' per un'ispezione successiva.

Altre considerazioni other-considerations

Durante la migrazione a un set di repliche MongoDB, assicurarsi di impostare il parametro WriteConcern su 2 su tutte le connessioni ai database Mongo.

Per eseguire questa operazione, aggiungere il parametro w=2 alla fine della stringa di connessione, come segue:

java -Xmx4092m -jar crx2oak.jar crx-quickstart/repository/ mongodb://localhost:27017/aem-author?replicaset=replica1&w=2
NOTE
Per ulteriori informazioni, consulta la documentazione sulla stringa di connessione MongoDB in Write Concerns.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2