4.6.0 Service Pack 4 da non UUID a 4.6.1 Migrazione dei contenuti UUID
Per migrare il contenuto dalla versione 4.6.0 del Service Pack 4 non UUID alla versione 4.6.1 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 rilasciata prima della versione 4.6.0 Service Pack 4, devi prima eseguire l’aggiornamento alla versione 4.6.0 Service Pack 4. Segui le istruzioni di aggiornamento specifiche per la versione con licenza del tuo prodotto.
-
Se si utilizza un Service Pack specifico rilasciato dopo la versione 4.6.0 del Service Pack 4, è necessario disinstallare tale Service Pack e ripristinare la versione 4.6.0 del Service Pack 4.
Installazione del pacchetto
Scarica i pacchetti richiesti da Adobe Software Distribution Portal, in base alla versione:
- Pre-migrazione: com.adobe.guides.pre-uuid-migration-2.0.zip
- Scarica UUID versione 4.6.1: com.adobe.fmdita.feature-uuid-4.6.1.4850.zip
- Migrazione: com.adobe.guides.uuid-upgrade-2.0.zip
Controlli di premigrazione
Esegui i seguenti controlli sulla versione non UUID 4.6.0 Service Pack 4:
-
Installa il pacchetto di pre-migrazione com.adobe.guides.pre-uuid-migration-2.0.zip sulla versione 4.6.0 Service Pack 4.
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 - queryLimitInMemoryequeryLimitReads 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/damper 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 le attività in blocco. ad esempio, se il CPU e la memoria attualmente allocati 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.6.0 Service Pack 4 non UUID, devi installare UUID versione 4.6.1 com.adobe.fmdita.feature-uuid-4.6.1.4850.zip ed eseguire la migrazione.
-
Installa il pacchetto di aggiornamento della migrazione UUID com.adobe.guides.uuid-upgrade-2.0.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.ConfigManagerAbilita moduli di avvio dei flussi di lavoro di post-elaborazione Disabilita com.adobe.fmdita.config.ConfigManageruuid. regex ^GUID-(?<id>.*)com.adobe.fmdita.postprocess.version.PostProcessVersionObservationAbilita postelaborazione versione Disabilita Day CQ Tagging Service Abilita convalida (validation.enabled) Disabilita -
Aggiungi un logger separato per:
com.adobe.fmdita.uuidcom.adobe.guides.uuid.
-
(Se non eseguito in precedenza) Se nel sistema sono presenti più di 100.000 file DITA, aggiornare
queryLimitReadsinorg.apache.jackrabbit.oak.query.QueryEngineSettingsServicea 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-upgradee 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). Ad 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/damcompleto 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
È inoltre possibile accedere a un elenco di file aggiornati con errori e file non riusciti durante il processo di migrazione nella tabella di riepilogo del report.
Passaggio: Aggiorna linee di base
baselineObj not found onÈ inoltre possibile accedere a un elenco di file aggiornati con errori e file non riusciti durante il processo di migrazione nella tabella di riepilogo del report.
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/damprima 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.ConfigManagerAbilita moduli di avvio flusso di lavoro post-elaborazione Abilita com.adobe.fmdita.postprocess.version.PostProcessVersionObservationAbilita 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.ConfigManagerUsa titolo per i nomi delle pagine del sito AEM False (valore predefinito) Vero note note NOTE Se prima della migrazione la proprietà Utilizza il titolo per i nomi delle pagine del sito AEM in 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=it).