Migrazione di contenuti da non-UUID a UUID id226TI0U20XA
Per migrare il contenuto dalla versione 4.3.1 non-UUID alla versione 4.3.2 UUID, effettua le seguenti operazioni.
-
Prima di avviare il processo di migrazione, assicurati di disporre di:
- Chiuse tutte le recensioni attive.
- Ha chiuso tutte le attività di traduzione.
-
Prima di eseguire la migrazione del contenuto al server UUID, accertati di avere installato un server non UUID con una versione compatibile di AEM Guides.
-
Se utilizzi una versione precedente alla 4.3.1, effettua l’aggiornamento alla versione 4.3.1. Segui le istruzioni di aggiornamento specifiche per la versione con licenza del tuo prodotto.
-
Attualmente, le versioni successive alla versione 4.3.1 non sono supportate per la migrazione.
Installazione del pacchetto
Scarica i pacchetti richiesti da Adobe Software Distribution Portal, in base alla versione:
- Pre-migrazione: com.adobe.guides.pre-uuid-migration-1.2.27.zip
- Scarica UUID versione 4.3.2: com.adobe.fmdita-6.5-uuid-4.3.2.1977.zip
- Migrazione: com.adobe.guides.uuid-upgrade-1.2.110.zip
Controlli di premigrazione
Esegui i seguenti controlli sulla versione 4.3.1 non-UUID:
-
Installa il pacchetto di pre-migrazione com.adobe.guides.pre-uuid-migration-1.2.27.zip nella versione 4.3.1.
note note NOTE - Per eseguire la migrazione è necessaria l’autorizzazione di amministratore.
- Si consiglia di correggere i file con errori prima di procedere con la migrazione.
-
Se nel sistema sono presenti più di 100.000 file DITA, aggiornare le configurazioni del limite di query affinché lo script funzioni:
- Passa a
/system/console/configMgr and increase both the configs to more than number of assets - queryLimitInMemory
equeryLimitReads under org.apache.jackrabbit.oak.query.QueryEngineSettingsService
- Passa a
-
Avvia
http://<server-name>/libs/fmdita/clientlibs/xmleditor_uuid_upgrade/page.html
. -
Selezionare Valutazione della compatibilità dal pannello a sinistra e sfogliare il percorso della cartella
/content/dam
per tutte le risorse. -
Controlla la compatibilità per elencare le seguenti informazioni:
- File totali
- Tempo stimato per la migrazione
- Numero di file con errori
- File con nome file GUID
-
Se viene visualizzato l’errore, analizza i registri e correggi tali errori. È possibile rieseguire la matrice di compatibilità dopo aver corretto gli errori.
-
Seleziona Configura convalide dal pannello a sinistra. Quindi Seleziona mappa e Seleziona predefinito della mappa per configurarli. L’elenco di convalida dell’output corrente visualizza i file di output presenti prima della migrazione e può essere convalidato in base ai file di output generati successivamente alla migrazione.
Selezionando più mappe DITA e mappe di grandi dimensioni, puoi verificare che la migrazione di tutto il contenuto sia stata completata senza problemi. La selezione di predefiniti contenenti linee di base garantisce anche la corretta migrazione delle linee di base e delle versioni.
-
(Facoltativo) Esegui la rimozione della versione del contenuto per rimuovere le versioni non necessarie e velocizzare il processo di migrazione. Per eseguire l'eliminazione della versione, selezionare l'opzione Eliminazione versione dalla schermata di migrazione e passare all'interfaccia utente tramite l'URL
http://<server- name>/libs/fmdita/clientlibs/xmleditor_uuid_upgrade/page.html
.note note NOTE Questa utility non rimuove le versioni utilizzate nelle linee di base o nelle revisioni né dispone di etichette.
Per ulteriori dettagli, visualizzare Rimuovi versioni precedenti.
Prerequisiti per la migrazione
-
Esegui migrazione UUID solo su un’istanza Autore.
-
Garantire la conformità dell'infrastruttura seguente:
- L’istanza di authoring viene ridimensionata in termini di CPU e memoria per supportare un’elaborazione più rapida e memoria aggiuntiva necessaria per l’attività in blocco. ad esempio, se la CPU e la memoria attualmente allocate sono 8 vCPU e 24 GB heap, utilizza dimensioni doppie per questa attività.
- Lo spazio su disco complessivo e lo spazio su disco temporaneo
(crx-quickstart directory)
devono avere un buffer pari a 10 volte lo spazio già utilizzato. Una volta completata la migrazione, è possibile recuperare la maggior parte dello spazio su disco eseguendo la compattazione. - Esegui Compressione Tar offline prima di avviare questa attività.
- Assicurati che non sia pianificata alcuna indicizzazione o manutenzione del sistema durante la finestra di questa migrazione.
-
Installa la versione UUID della versione supportata su quella non UUID. Ad esempio, se utilizzi la build 4.3.1 non UUID, devi installare UUID versione 4.3.2 com.adobe.fmdita-6.5-uuid-4.3.2.1977.zip) ed eseguire la migrazione.
-
Installa il pacchetto di aggiornamento della migrazione UUID com.adobe.guides.uuid-upgrade-1.2.110.zip.
-
Disattivare i moduli di avvio per i seguenti flussi di lavoro utilizzando l'URL:
http://<server-name>/libs/cq/workflow/content/console.html
.- Flusso di lavoro Aggiorna risorsa DAM
- Flusso di lavoro Writeback di metadati DAM
note note NOTE Idealmente tutti i moduli di avvio dei flussi di lavoro, che vengono eseguiti su qualsiasi percorso all'interno di content/dam
, dovrebbero essere disabilitati. -
Aggiorna le seguenti configurazioni in base alle modifiche suggerite:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 Configurazione Proprietà Valore com.adobe.fmdita.config.ConfigManager
Abilita moduli di avvio dei flussi di lavoro di post-elaborazione Disabilita com.adobe.fmdita.config.ConfigManager
uuid. regex ^GUID-(?<id>.*)
com.adobe.fmdita.postprocess.version.PostProcessVersionObservation
Abilita postelaborazione versione Disabilita Day CQ Tagging Service Abilita convalida (validation.enabled) Disabilita -
Aggiungi un logger separato per:
com.adobe.fmdita.uuid
com.adobe.guides.uuid
.
-
(Se non eseguito in precedenza) Se nel sistema sono presenti più di 100.000 file DITA, aggiornare
queryLimitReads
inorg.apache.jackrabbit.oak.query.QueryEngineSettingsService
a un valore maggiore (qualsiasi valore maggiore del numero di risorse presenti, ad esempio 200.000).table 0-row-3 1-row-3 PID Chiave proprietà Valore proprietà org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Valore: 200000
Valore predefinito: 100000
Migrazione
-
Avvia
http://<server-name>/libs/fmdita/clientlibs/xmleditor_uuid_upgrade/page.html
.note note NOTE Se si sceglie "Abilita backup risorse DITA", i file di backup temporanei vengono archiviati in /content/uuid-upgrade
e i backup dei file DITA vengono eliminati al termine della migrazione di un file. -
Seleziona Aggiornamento di sistema dal pannello a sinistra per eseguire la migrazione. Si consiglia di eseguire la migrazione di tutti i dati contemporaneamente, in quanto il sistema gestisce in modo ottimale la gestione dei batch internamente. Solo i file che non sono risorse DITA e non sono utilizzati in alcuna risorsa DITA possono essere ignorati per la migrazione.
-
(Facoltativo) Seleziona le cartelle per le quali desideri saltare la migrazione. Utilizza questa opzione per eseguire la migrazione di queste cartelle in un secondo momento o saltare la migrazione. Assicurati che queste cartelle non dispongano di risorse DITA e che nessuna risorsa DITA vi faccia riferimento (e che in futuro non vi farà riferimento). Esempio:
content/dam/projects
. -
Selezionare Abilita backup risorse dita per creare un backup della risorsa prima della migrazione. Questo backup viene utilizzato per il rollback in caso di errore durante la migrazione di un file. Se la migrazione ha esito positivo, il backup viene eliminato. Tuttavia, questo rallenta il processo di migrazione.
-
Avvia la migrazione.
note note NOTE Scarica i registri completi e osserva eventuali errori. Se viene rilevato un errore o un'eccezione Non procedere, ma correggere prima l'errore. Gli errori comuni sono elencati alla fine di questo articolo. -
Una volta completata la migrazione, il rapporto è disponibile per il download e possono essere scaricati anche interi registri.
-
Selezionare Scarica report durante l'esecuzione della migrazione per verificare se tutti i file nella cartella sono aggiornati correttamente e se tutte le funzionalità funzionano solo per tale cartella.
note note NOTE È possibile eseguire la migrazione dei contenuti a livello di cartella, /content/dam
completo o nella stessa cartella (eseguire di nuovo la migrazione).Inoltre, è importante assicurarsi che la migrazione dei contenuti venga eseguita per tutte le risorse multimediali, come immagini e grafici utilizzati nel contenuto DITA.
-
Dopo aver eseguito la migrazione di tutti i file, selezionare Aggiornamento baseline/revisione dal pannello di sinistra per migrare le baseline e rivedere a livello di cartella.
Analisi dei rapporti da ogni passaggio
Passaggio: aggiornamento del sistema
Passaggio: Aggiorna linee di base
baselineObj not found on
Postmigrazione
-
Al termine della migrazione, selezionare Convalida aggiornamento sistema dal pannello di sinistra e convalidare i file di output prima e dopo la migrazione per verificare che la migrazione sia stata eseguita correttamente.
-
Dopo la migrazione del server, abilita correttamente i flussi di lavoro e le configurazioni seguenti (inclusi tutti gli altri flussi di lavoro inizialmente disabilitati durante la migrazione) per continuare a lavorare sul server:
- Flusso di lavoro Aggiorna risorsa DAM
- Flusso di lavoro per metadati DAM
note note NOTE È consigliabile abilitare tutti i moduli di avvio dei flussi di lavoro in esecuzione in qualsiasi percorso all'interno di content/dam
prima della migrazione. -
Abilita le seguenti configurazioni:
table 0-row-3 1-row-3 2-row-3 3-row-3 Configurazione Proprietà Valore com.adobe.fmdita.config.ConfigManager
Abilita moduli di avvio flusso di lavoro post-elaborazione Abilita com.adobe.fmdita.postprocess.version.PostProcessVersionObservation
Abilita Postelaborazione Versione Abilita Day CQ Tagging Service Abilita convalida (validation.enabled) Abilita -
Proprietà di Assets da rivedere dopo la migrazione:
table 0-row-4 1-row-4 Configurazione Proprietà Valore pre-migrazione per non-UUID Valore post-migrazione su UUID com.adobe.fmdita.config.ConfigManager
Usa titolo per i nomi delle pagine del sito AEM False (valore predefinito) Vero note note NOTE Se prima della migrazione, la proprietà Use title for AEM Site page names within com.adobe.fmdita.config.ConfigManager
, è impostata su False, dopo la migrazione sarà necessario aggiornare la proprietà. -
Al termine della convalida, è possibile recuperare la maggior parte dello spazio su disco eseguendo la compattazione (fare riferimento a
https://experienceleague.adobe.com/docs/experience-manager-65/deploying/deploying/revision-cleanup.html?lang=en
).