Migrazione dei contenuti da AEM 6.5 ad AEM 6.5 LTS tramite l’aggiornamento ad Oak aem-65-to-aem-65lts-content-migration-using-oak-upgrade
In questo documento viene illustrato come aggiornare Adobe Experience Manager da 6.5 a 6.5 LTS, con particolare attenzione alla migrazione dell'archivio dei contenuti. Include l’utilizzo dello strumento di aggiornamento di Oak per trasferire i contenuti tra archivi con precisione e controllo.
Prerequisiti prerequisites
Prima di avviare la migrazione, verifica che siano soddisfatti i seguenti requisiti:
- Compatibilità Java: AEM 6.5 LTS deve essere installato e configurato per l’esecuzione con Java™ 17. Una volta configurata, avvia l’istanza di AEM e verifica che tutti i bundle siano attivi e funzionanti senza problemi
- Risorse di sistema: garantire spazio su disco e memoria sufficienti per gestire entrambi gli archivi durante il processo di migrazione
- Strumento di aggiornamento Oak: scarica il file jar
oak-upgradedall'archivio Maven ufficiale. Assicurati che la versione corrisponda a quella core di Oak utilizzata in AEM 6.5 LTS. Lo strumento di aggiornamento di Oak viene eseguito su Oracle® Java™ 11 o versione successiva
Processo di migrazione step-by-step-migration-process
Interruzione di AEM 6.5 e AEM 6.5 LTS stopping-aem65-and-aem65lts
Prima di avviare la migrazione, arresta le istanze AEM 6.5 e AEM 6.5 LTS. In questo modo si garantisce che l’archivio sia in uno stato stabile e che non si verifichino scritture aggiuntive durante la migrazione.
Backup dell’istanza di AEM 6.5 backing-up-the-aem65-instance
Esegui un backup completo dell’istanza di AEM 6.5 se non lo hai già fatto.
Utilizzo dello strumento di aggiornamento di Oak per la migrazione dei contenuti using-the-oak-upgrade-tool-for-content-migration
Lo strumento Oak-Upgrade viene eseguito tramite la riga di comando, come illustrato di seguito:
java -jar oak-upgrade-*.jar [options] /path/to/source/repository /path/to/destination/repository
Di seguito sono riportati i comandi e le opzioni essenziali:
Opzioni chiave
-
--include-paths: specificare le sottostrutture da includere nella migrazione. Per informazioni sull'utilizzo del comando, vedere questo esempio:code language-none java -jar oak-upgrade-*.jar --include-paths=/content/site /old/repository /new/repository -
--exclude-paths: escludi percorsi specifici dalla migrazione. Presta attenzione quando utilizzi questa opzione: se il percorso esiste sul sistema di destinazione, viene rimosso. Per informazioni sull'utilizzo del comando, vedere questo esempio:code language-none java -jar oak-upgrade-*.jar --exclude-paths=/content/old_site /old/repository /new/repository -
--copy-binaries: per impostazione predefinita, Oak-upgrade migra solo i riferimenti ai file binari, lasciando i file effettivi nell'archivio BLOB/dati originale. Di conseguenza, il nuovo archivio si basa ancora sull’archivio di origine per i file binari. Per eseguire la migrazione dei dati binari insieme al contenuto dell'archivio, utilizzare il parametro--copy-binariesper copiare tutti i dati binari nel nuovo archivio, come illustrato di seguito:code language-none java -jar oak-upgrade-*.jar \ --copy-binaries \ --src-datastore=/old/repository/datastore \ --datastore=/new/repository/datastore \ /old/repository \ /new/repository
Migrazione dei punti di controllo migratiing-checkpoints
Durante la migrazione di un vecchio archivio SegmentMK (precedente ad Oak 1.6) a un nuovo SegmentMK (versione Oak successiva o uguale a 1.6), viene eseguita anche la migrazione dei punti di controllo. Questo processo evita la reindicizzazione quando Oak viene eseguito per la prima volta sul nuovo archivio. Tuttavia, la migrazione dei punti di controllo non viene eseguita nei casi seguenti:
- Sono specificati percorsi di inclusione, esclusione o unione personalizzati oppure
- Il sistema copia i file binari per riferimento. Non è specificato alcun archivio dati di origine e due punti di controllo diversi contengono un binario diverso nello stesso percorso.
Nel secondo caso, Oak-upgrade emette il seguente avviso e interrompe:
Checkpoints are not copied, because no external datastore has been specified. This results 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.
Il modo più semplice per risolvere il problema è specificare l'archivio dati di origine nelle opzioni della riga di comando (ad esempio --src-datastore o --src-s3datastore).
Anche l’avviso può essere ignorato, ma in questo caso l’archivio viene completamente reindicizzato al primo avvio. Può essere un processo lungo, soprattutto per la grande istanza. L’archivio non è utilizzabile fino al completamento del processo di reindicizzazione. Utilizzare l'opzione --skip-checkpoints per eliminare l'avviso.
È inoltre possibile reindicizzare offline l'archivio prima di avviare AEM utilizzando reindicizzazione offline per evitare la reindicizzazione completa al primo avvio.
Per ulteriori informazioni sullo strumento di aggiornamento di Oak e sull'utilizzo avanzato, consulta la documentazione ufficiale.