Controlli post-aggiornamento e risoluzione dei problemi post-upgrade-checks-and-troubleshooting

Controlli post-aggiornamento post-upgrade-checks

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

Verifica registri per aggiornamento completato verify-logs-for-upgrade-success

aggiorna.registro

In passato, il controllo dello stato di post-aggiornamento dell’istanza richiedeva un’attenta ispezione di vari file di registro, parti dell’archivio e il modulo di avvio. La generazione di un rapporto post-aggiornamento può aiutare a rilevare gli aggiornamenti difettosi prima della pubblicazione.

Lo scopo principale di questa funzione è ridurre la necessità di interpretazione manuale o logica di analisi complessa su più endpoint necessari per qualificare il successo di un aggiornamento. La soluzione fornisce informazioni inequivocabili che consentono ai sistemi di automazione esterni di reagire in caso di esito positivo o negativo di un aggiornamento.

In particolare, garantisce che:

Per risolvere questo problema, sono state apportate modifiche alla modalità di generazione dei registri nel file upgrade.log.

error.log

Il file error.log deve essere esaminato attentamente durante e dopo l’avvio di AEM utilizzando la versione target jar. Eventuali avvertenze o errori devono essere esaminati. In generale, è consigliabile cercare i problemi all’inizio del registro. Gli errori che si verificano più avanti nel registro possono in realtà essere effetti collaterali di una causa principale che viene richiamata all’inizio del file. Se si verificano errori e avvisi ripetuti, vedere di seguito per Analisi dei problemi relativi all'aggiornamento.

Verificare i bundle OSGi verify-osgi-bundles

Passa alla console OSGi /system/console/bundles e verifica se alcuni bundle non sono stati avviati. Se uno dei bundle si trova in uno stato di installazione, consultare error.log per determinare il problema radice.

Verifica versione Oak verify-oak-version

In seguito all'aggiornamento, dovresti notare che la versione di Oak è stata aggiornata a 1.68.x. Per verificare la versione di Oak, accedi alla console OSGi e controlla la versione associata ai bundle di Oak: Oak Core, Oak Commons, Oak Segment Tar.

Convalida iniziale delle pagine initial-validation-of-pages

Esegui una convalida iniziale su 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). In entrambi gli ambienti Author e Publish, apri alcune pagine di applicazioni e verifica che vengano riprodotte correttamente. In caso di problemi, consultare error.log per la risoluzione dei problemi.

Verifica configurazioni di manutenzione pianificate verify-scheduled-maintenance-configurations

Abilita raccolta oggetti inattivi dell’archivio dati enable-data-store-garbage-collection

Se utilizzi un archivio dati file, accertati che l’attività Raccolta oggetti inattivi dell’archivio dati sia abilitata e aggiunta all’elenco Manutenzione settimanale. Le istruzioni sono descritte in Pulizia revisioni.

Abilita pulizia revisioni online enable-online-revision-cleanup

Se utilizzi MongoMK o il nuovo formato di segmento TarMK, accertati che l’attività Pulizia revisioni sia abilitata e aggiunta all’elenco Manutenzione giornaliera. Le istruzioni sono descritte in Pulizia revisioni.

Abilita agenti di replica enable-replication-agents

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. Consulta Procedura di aggiornamento per ulteriori dettagli sull'ordine degli eventi.

Abilita processi pianificati personalizzati enable-custom-scheduled-jobs

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

Esegui piano di test execute-test-plan

Eseguire il piano di test dettagliato definito in Aggiornamento del codice e delle personalizzazioni nella sezione Procedura di test.

Analisi Dei Problemi Relativi All’Aggiornamento analyzing-issues-with-the-upgrade

Questa sezione contiene alcuni scenari di problemi che è possibile affrontare durante la procedura di aggiornamento ad AEM 6.5 LTS.

Impossibile aggiornare pacchetti e bundle packages-and-bundles-fail-to-update

Nel caso in cui i pacchetti non vengano installati durante l’aggiornamento, i bundle in essi contenuti non verranno aggiornati. Questa categoria di problemi è causata da una configurazione errata dell’archivio dati. Verranno inoltre visualizzati come ERRORE e AVVERTENZA messaggi nel log degli errori. Poiché nella maggior parte di questi casi l’accesso predefinito potrebbe non funzionare, puoi utilizzare CRXDE direttamente per verificare e individuare i problemi di configurazione.

Aggiornamento Non Eseguito the-upgrade-did-not-run

Prima di avviare i passaggi di preparazione, assicurarsi di eseguire prima l'istanza source eseguendola con il comando java -jar aem-quickstart.jar. Questo è necessario per assicurarsi 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, è necessario eseguirlo con il comando java -jar <aem-quickstart-6.5-LTS.jar>. L’avvio da uno script di avvio non avvierà AEM in modalità di aggiornamento.

Alcuni bundle di AEM non passano allo stato attivo some-aem-bundles-are-not-switching-to-the-active-state

Se sono presenti bundle che non si avviano, verifica la presenza di eventuali dipendenze non soddisfatte.

Nel caso in cui il problema sia presente ma si basi su un’installazione non riuscita del pacchetto che ha portato a un mancato aggiornamento dei bundle, questi verranno considerati incompatibili per la nuova versione. Per ulteriori informazioni su come risolvere il problema, vedere Impossibile aggiornare pacchetti e bundle.

Si consiglia inoltre di confrontare l’elenco dei bundle di una nuova istanza AEM 6.5 LTS con quello aggiornato per rilevare i bundle che non sono stati aggiornati. Questo fornirà un ambito più vicino di ciò che si desidera cercare in error.log.

Bundle personalizzati non passano allo stato attivo custom-bundles-not-switching-to-the-active-state

Se i bundle personalizzati non passano allo stato attivo, è probabile che ci sia codice che non importa l’API modificata. Questo nella maggior parte dei casi porterà a dipendenze non soddisfatte.

È inoltre consigliabile verificare se la modifica che ha causato il problema era necessaria e, in caso contrario, ripristinarla. Controlla anche se l’aumento di versione dell’esportazione del pacchetto è stato aumentato più del necessario, seguendo un rigoroso controllo delle versioni semantiche.

Analisi di error.log e upgrade.log analyzing-the-error.log-and-upgrade.log

Nella maggior parte delle situazioni, i registri devono essere consultati per gli errori per individuare la causa di un problema. Tuttavia, con gli 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 error.log rimuovendo tutti i messaggi che si prevede non siano correlati al problema che stai affrontando. Puoi eseguire questa operazione tramite uno strumento come grep, utilizzando:

grep -v UnrelatedErrorString

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

oppure

In alcuni casi è possibile trovare anche messaggi WARN in quanto possono esserci 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 contacting-adobe-support

Se hai già esaminato i consigli su questa pagina e riscontri ancora problemi, contatta il supporto Adobe. Per fornire quante più informazioni possibili al tecnico del supporto che lavora al tuo caso, assicurati di includere i file error.log e upgrade.log dall'aggiornamento.