Controlli e risoluzione dei problemi post-aggiornamento

Controlli post aggiornamento

In seguito all' Aggiornamento sul posto per finalizzare l'aggiornamento è necessario eseguire le seguenti attività. Si presume che AEM sia stato avviato con il jar 6.5 e che la base di codice aggiornata sia stata distribuita.

Verificare i registri per il successo dell'aggiornamento

upgrade.log

In passato, l'ispezione dello stato post aggiornamento dell'istanza richiedeva un'attenta ispezione di vari file di log, parti dell'archivio e del launchpad. La generazione di un rapporto di post aggiornamento può aiutare a rilevare gli aggiornamenti difettosi prima di andare in diretta.

Lo scopo principale di questa funzione è ridurre la necessità di interpretare manualmente o di eseguire analisi complesse su più endpoint necessari per qualificare il successo di un aggiornamento. La soluzione intende fornire informazioni non ambigue ai sistemi di automazione esterni per reagire al successo o al guasto identificato di un aggiornamento.

In particolare, garantisce che:

  • Gli errori di aggiornamento rilevati dal framework di aggiornamento possono essere centralizzati in un unico rapporto di aggiornamento;
  • Il rapporto di aggiornamento include indicatori relativi all'intervento manuale necessario.

Per ovviare a questo problema, sono state apportate modifiche nel modo in cui i registri vengono generati nel file upgrade.log.

Ecco un esempio di rapporto che non mostra errori durante l'aggiornamento:

1487887443006

Ecco un esempio di rapporto che mostra un bundle non installato durante il processo di aggiornamento:

1487887532730

error.log

Il file error.log deve essere attentamente rivisto durante e dopo l'avvio di AEM utilizzando il file jar della versione di destinazione. Eventuali avvisi o errori devono essere rivisti. In generale è meglio cercare i problemi all'inizio del log. Gli errori che si verificano successivamente nel registro possono in realtà essere effetti collaterali di una causa principale che viene richiamata in anticipo nel file. Se si verificano errori e avvisi ripetuti, vedi di seguito per Analisi dei problemi relativi all'aggiornamento.

Verificare i bundle OSGi

Passa alla console OSGi /system/console/bundles e cerca di vedere se eventuali bundle non sono avviati. Se uno stato dei bundle è installato, consulta error.log per determinare il problema principale.

Verifica la versione Oak

Dopo l'aggiornamento, noterai che la versione Oak è stata aggiornata a 1.10.2. Per verificare la versione Oak, passa alla console OSGi e osserva la versione associata ai bundle Oak: Oak Core, Oak Commons, Oak Segment Tar.

Cartella Inspect PreUpgradeBackup

Durante l'aggiornamento AEM tentare di eseguire il backup delle personalizzazioni e archiviarle sotto /var/upgrade/PreUpgradeBackup/<time-stamp-of-upgrade>. Per visualizzare questa cartella in CRXDE Lite, potrebbe essere necessario abilitare temporaneamente CRXDE Lite.

La cartella con timestamp deve avere una proprietà denominata mergeStatus con un valore di COMPLETED. La cartella to-process deve essere vuota e il nodo sovrascritto indica quali nodi sono stati sovrascritti durante l'aggiornamento. Il contenuto sotto il nodo leftovers indica il contenuto che non è stato possibile unire in modo sicuro durante l'aggiornamento. Se l’implementazione dipende da uno qualsiasi dei nodi figlio (e non è già installato dal pacchetto di codice aggiornato), dovrà essere unita manualmente.

Disattiva CRXDE Lite dopo questo esercizio se in un ambiente Stage o Production.

Convalida iniziale delle pagine

Esegui una convalida iniziale rispetto a più pagine in AEM. Se si aggiorna un ambiente di authoring, aprire la pagina iniziale e la pagina di benvenuto ( /aem/start.html, /libs/cq/core/content/welcome.html). Negli ambienti Author e Publish aprono alcune pagine dell’applicazione e ne eseguono il rendering corretto. Se si verificano problemi, consulta la sezione error.log per la risoluzione dei problemi.

Applicare AEM Service Pack

Applicare i Service Pack AEM 6.5 pertinenti se sono stati rilasciati.

Funzionalità di migrazione AEM

Diverse funzioni in AEM richiedono passaggi aggiuntivi dopo l’aggiornamento. Un elenco completo di queste funzioni e dei passaggi per migrarle nella AEM 6.5 è disponibile nella pagina Aggiornamento del codice e delle personalizzazioni .

Verificare le configurazioni di manutenzione pianificate

Abilita raccolta oggetti inattivi dell'archivio dati

Se utilizzi un archivio dati file , assicurati che l’attività Archivio dati raccolta oggetti inattivi sia abilitata e aggiunta all’elenco Manutenzione settimanale. Le istruzioni sono descritte qui.

NOTA

Questa opzione non è consigliata per le installazioni dell'archivio dati personalizzato S3 o quando si utilizza un archivio dati condiviso.

Abilita pulizia revisioni online

Se utilizzi MongoMK o il nuovo formato del segmento TarMK, assicurati che l'attività Pulizia revisioni sia abilitata e aggiunta all'elenco Manutenzione giornaliera. Istruzioni descritte qui.

Esegui piano di test

Esegui un piano di test dettagliato rispetto a come definito Aggiornamento del codice e delle personalizzazioni nella sezione Procedura di test .

Abilita agenti di replica

Dopo aver aggiornato e convalidato completamente l’ambiente di pubblicazione, abilita gli agenti di replica nell’ambiente di authoring. Verifica che gli agenti siano in grado di connettersi alle rispettive istanze Publish. Per ulteriori informazioni sull'ordine degli eventi, consulta U pgrade Procedure .

Abilita processi pianificati personalizzati

A questo punto è possibile abilitare tutti i processi pianificati come parte della base di codice.

Analisi dei problemi relativi all'aggiornamento

Questa sezione contiene alcuni scenari di problema che si potrebbero incontrare durante la procedura di aggiornamento a AEM 6.3.

Questi scenari dovrebbero aiutare a individuare la causa principale dei problemi relativi all’aggiornamento e dovrebbero aiutare a identificare problemi specifici relativi a progetti o prodotti.

Migrazione archivio non riuscita

La migrazione dei dati da CRX2 a Oak dovrebbe essere fattibile per qualsiasi scenario a partire da Istanze sorgente basate su CQ 5.4. Assicurati di seguire esattamente le istruzioni di aggiornamento in questo documento, che includono la preparazione del repository.xml, assicurandoti che nessun autenticatore personalizzato venga avviato tramite JAAS e che l'istanza sia stata controllata per individuare eventuali incongruenze prima di avviare la migrazione.

Se la migrazione continua a non riuscire, è possibile individuare la causa principale ispezionando il upgrade.log. Se il problema non è ancora noto, segnalalo all’Assistenza clienti.

L'aggiornamento non è stato eseguito

Prima di avviare i passaggi di preparazione, assicurati di eseguire prima l'istanza source eseguendola con il comando java -jar aem-quickstart.jar . Questo è necessario per assicurarti che il file quickstart.properties sia generato correttamente. Se manca, l'aggiornamento non funzionerà. In alternativa, è possibile verificare se il file è presente cercando in crx-quickstart/conf nella cartella di installazione dell'istanza di origine. Inoltre, quando si avvia AEM per avviare l'aggiornamento, deve essere eseguito con il comando java -jar aem-quickstart.jar . L'avvio da uno script iniziale non verrà avviato AEM in modalità di aggiornamento.

Impossibile aggiornare pacchetti e bundle

Nel caso in cui i pacchetti non vengano installati durante l'aggiornamento, nemmeno i bundle che contengono verranno aggiornati. Questa categoria di problemi è solitamente causata da configurazione errata dell’archivio dati. Verranno inoltre visualizzati come messaggi ERROR e WARN nel registro degli errori. Poiché nella maggior parte di questi casi l'accesso predefinito potrebbe non funzionare, è possibile utilizzare CRXDE direttamente per ispezionare e trovare i problemi di configurazione.

Alcuni bundle AEM non passano allo stato attivo

In caso di bundle che non si avviano, dovresti verificare la presenza di dipendenze non soddisfatte.

Nel caso in cui questo problema sia presente ma si basa su un'installazione non riuscita del pacchetto che ha portato a bundle non essere in fase di aggiornamento, saranno considerati incompatibili per la nuova versione. Per ulteriori informazioni su come risolvere questo problema, consulta Impossibile aggiornare pacchetti e bundle sopra.

Si consiglia inoltre di confrontare l'elenco dei bundle di una nuova istanza AEM 6.5 con quella aggiornata per rilevare i bundle che non sono stati aggiornati. Questo fornirà un ambito più dettagliato di cosa cercare in error.log.

I bundle personalizzati non passano allo stato attivo

Nel caso in cui i bundle personalizzati non passino allo stato attivo, è molto probabile che ci sia codice che non importa l'API di modifica. Ciò spesso porterà a dipendenze non soddisfatte.

L’API rimossa deve essere contrassegnata come obsoleta in una delle versioni precedenti. Puoi trovare istruzioni su una migrazione diretta del tuo codice in questo avviso di rimozione. Adobe punta al controllo delle versioni semantiche, ove possibile, in modo che le versioni possano indicare eventuali modifiche di interruzione.

È anche meglio verificare se la modifica che ha causato il problema è assolutamente necessaria e ripristinarla se non lo è. Controlla anche se l'aumento di versione dell'esportazione del pacchetto è stato aumentato più del necessario, dopo un rigoroso controllo delle versioni semantiche.

Interfaccia utente della piattaforma non funzionante

Nel caso di alcune funzionalità dell’interfaccia utente che non funzionano correttamente dopo l’aggiornamento, controlla prima le sovrapposizioni personalizzate dell’interfaccia. Alcune strutture potrebbero essere cambiate e la sovrapposizione potrebbe aver bisogno di un aggiornamento o essere obsoleta.

Quindi, controlla eventuali errori Javascript che possono essere tracciati verso le estensioni aggiunte personalizzate collegate alle librerie client. Lo stesso può essere applicato per i CSS personalizzati che potrebbero causare problemi al layout di AEM.

Infine, verifica la presenza di errori di configurazione che Javascript potrebbe non essere in grado di gestire. Questo accade solitamente con le estensioni disattivate in modo errato.

Funzionamento errato dei componenti personalizzati, dei modelli o delle estensioni dell'interfaccia utente

Nella maggior parte dei casi, le cause principali di questi problemi sono le stesse dei bundle che non vengono avviati o dei pacchetti che non vengono installati con l'unica differenza che i problemi iniziano quando si utilizzano i componenti.

Il modo per trattare con codice personalizzato errato è quello di eseguire prima prove di fumo al fine di identificare la causa. Una volta trovato, cerca i consigli in questa sezione [link] dell'articolo per trovare i modi per risolverli.

Personalizzazioni mancanti in /etc

/apps e /libs sono gestite correttamente dall'aggiornamento, ma le modifiche in /etc potrebbero dover essere ripristinate manualmente da /var/upgrade/PreUpgradeBackup dopo l'aggiornamento. Assicurati di controllare questa posizione per eventuali contenuti da unire manualmente.

Analisi di error.log e upgrade.log

Nella maggior parte delle situazioni i registri devono essere consultati per gli errori al fine di trovare la causa di un problema. Tuttavia, in caso di aggiornamenti è anche necessario monitorare i problemi di dipendenza, in quanto i vecchi bundle potrebbero non essere aggiornati correttamente.

Il modo migliore per farlo è quello di eliminare il file error.log rimuovendo tutti i messaggi che ci si aspetta che non siano correlati al problema che stai affrontando. Puoi farlo tramite strumenti come grep, utilizzando:

grep -v UnrelatedErrorString

Alcuni messaggi di errore potrebbero non essere immediatamente esplicativi. In questo caso, esaminare il contesto in cui si verificano può anche aiutare a capire dove è stato creato l’errore. Puoi separare l’errore utilizzando:

  • grep -B per aggiungere righe prima dell’errore;

o

  • grep -A per aggiungere righe dopo.

In alcuni casi si possono trovare errori anche nei messaggi WARN in quanto ci possono essere casi validi che portano a questo stato e l'applicazione non è sempre in grado di decidere se si tratta di un errore effettivo. Assicurati di consultare anche questi messaggi.

Contattare il supporto Adobe

Se hai seguito i consigli su questa pagina e stai ancora riscontrando dei problemi, contatta il supporto Adobe. Per fornire il maggior numero possibile di informazioni al tecnico del supporto che lavora sul tuo caso, assicurati di includere il file upgrade.log dal tuo aggiornamento.

In questa pagina