Risolvere gli errori SegmentNotFoundException in Adobe Experience Manager
Questo articolo spiega come risolvere gli errori SegmentNotFoundException in Adobe Experience Manager (AEM) ripristinando da un backup, convalidando l’integrità dell’archivio ed eseguendo la manutenzione.
Descrizione description
Gli errori SegmentNotFoundException in Adobe Experience Manager indicano un danneggiamento dell’archivio o segmenti mancanti, che possono rendere l’ambiente di authoring di AEM inaccessibile e interrompere le normali operazioni. Questi errori vengono generalmente considerati come voci di registro ripetute e l’impossibilità di accedere all’istanza Autore di AEM. Il ripristino dall’ultimo backup valido noto e la convalida dello stato dell’archivio sono passaggi fondamentali per ripristinare l’ambiente ed evitare ulteriori problemi.
Ambiente
Adobe Experience Manager (AEM) Managed Services (tutte le versioni)
Sintomi
- Errori SegmentNotFoundException nei registri di AEM
- Impossibilità di accedere o utilizzare l’ambiente di authoring di AEM
- Richieste di ripristino dell’ultimo backup funzionante noto
Causa
Gli errori SegmentNotFoundException sono in genere causati dal danneggiamento dell’archivio o da segmenti mancanti e richiedono spesso il ripristino dal backup e la compattazione dell’archivio per risolvere e impedire la ricorrenza.
Risoluzione resolution
Per risolvere il problema, segui i passaggi seguenti:
-
Identifica il backup valido più recente dell’ambiente AEM, garantendo che includa tutti i file necessari come archivio, datastore e indici.
-
Ripristinare il backup nell’ambiente AEM in base alle procedure di backup e ripristino dell’organizzazione. Assicurati che tutti i componenti (archivio, archivio dati, indici) siano ripristinati nelle posizioni corrette.
-
Dopo il ripristino, esegui i controlli di coerenza dell’archivio, dell’archivio dati e dell’indice per confermare l’integrità dell’ambiente ripristinato. Per la verifica della coerenza dell’indice, utilizza lo strumento Oak con i parametri appropriati per il tuo ambiente. Esempio di comando:
java -jar oak-run.jar index --index-consistency-check <datastore-config-path> <segmentstore-path>Sostituisci
<datastore-config-path>e<segmentstore-path>con i percorsi corretti per il tuo ambiente. -
Esamina l’output dei controlli di coerenza per garantire che tutti gli indici siano segnalati come validi.
-
Eseguire una compattazione offline dell’archivio per ottimizzare lo storage ed evitare ulteriori problemi di segmento. Pianifica la compattazione offline regolare e disabilita la compattazione online per ridurre il rischio di danneggiamento dei segmenti.
-
Monitora l’ambiente per rilevare la ricorrenza di errori SegmentNotFoundException. Se il problema si ripresenta, controlla i registri per i flussi di lavoro o i processi a lunga esecuzione che possono contribuire al danneggiamento dei segmenti.
-
(Facoltativo) Per acquisire immagini heap o thread per ulteriori analisi, utilizza gli strumenti Java standard come
jstackojmapsul processo AEM, seguendo le procedure della tua organizzazione.