Pianificazione dell'aggiornamento

Panoramica del progetto AEM

AEM viene spesso utilizzato in implementazioni ad alto impatto che potrebbero servire milioni di utenti. Nella maggior parte dei casi, ci sono applicazioni personalizzate che vengono distribuite sulle istanze, che aggiungono alla complessità. Qualsiasi sforzo per aggiornare tale implementazione deve essere gestito in modo metodico.

Questa guida aiuta a stabilire obiettivi chiari, fasi e risultati finali durante la pianificazione dell'aggiornamento. Si concentra sull'esecuzione complessiva del progetto e sulle linee guida. Offre una panoramica dei passaggi effettivi dell’aggiornamento, ma si riferisce alle risorse tecniche disponibili, se del caso. Esso deve essere utilizzato congiuntamente alle risorse tecniche disponibili di cui al documento.

Il processo di aggiornamento AEM deve essere gestito con cura le fasi di pianificazione, analisi ed esecuzione con i principali risultati finali definiti per ogni fase.

È possibile effettuare l’aggiornamento direttamente dalle versioni 6.0 e 6.5 di AEM. I clienti che eseguono 5.6.x e versioni precedenti devono prima eseguire l’aggiornamento alla versione 6.0 o successiva, con la raccomandazione 6.0(SP3). Inoltre, il nuovo formato OAK Segment Tar viene ora utilizzato per il Segment Node Store a partire dalla versione 6.3 e la migrazione dell'archivio a questo nuovo formato è obbligatoria anche per le versioni 6.0, 6.1 e 6.2.

ATTENZIONE

Se stai effettuando l’aggiornamento da AEM 6.2 a 6.3, devi passare dalle versioni (6.2-SP1-CFP1 - -6.2SP1-CFP12.1) o 6.2SP1-CFP15 in poi. In caso contrario, se stai effettuando l’aggiornamento da 6.2SP1-CFP13/6.2SP1CFP14 a AEM 6.3, devi anche effettuare l’aggiornamento alla versione almeno 6.3.2.2. In caso contrario, dopo l’aggiornamento AEM Sites avrebbe avuto esito negativo.

Ambito e requisiti dell'aggiornamento

Di seguito è riportato un elenco delle aree interessate da un tipico progetto di aggiornamento AEM:

Componente Impatto Descrizione
Sistema operativo Effetti incerti ma sottili Al momento dell'aggiornamento AEM, potrebbe essere il momento di aggiornare anche il sistema operativo e questo potrebbe avere un certo impatto.
Java Runtime Impatto moderato AEM 6.3 richiede JRE 1.7.x (64 bit) o versione successiva. JRE 1.8 è l’unica versione attualmente supportata da Oracle.
Hardware Impatto moderato Il cleanup delle revisioni online richiede spazio su disco gratuito
pari al 25% delle dimensioni dell'archivio e al 15% dello spazio heap gratuito
per essere completato con successo. Potrebbe essere necessario aggiornare l'hardware a
per garantire risorse sufficienti per l'esecuzione del cleanup delle revisioni online fino a completa
. Inoltre, se si esegue l'aggiornamento da una versione precedente a AEM 6,
potrebbe essere necessario ulteriore spazio di archiviazione.
Archivio dei contenuti (CRX o Oak) Impatto elevato A partire dalla versione 6.1, AEM non supporta CRX2, quindi è necessaria una migrazione a
Oak (CRX3) se si esegue l'aggiornamento da una versione precedente. AEM 6.3 ha
implementato un nuovo archivio dei nodi di segmento che richiede anche una migrazione. A questo scopo viene utilizzato lo strumento
crx2oak .
Componenti/contenuti AEM Impatto moderato /libs e /apps sono facilmente gestibili tramite l'aggiornamento, ma /etc in genere richiede una riapplicazione manuale delle personalizzazioni.
Servizi AEM Basso impatto La maggior parte dei servizi di base AEM viene testata per l’aggiornamento. Questa è un'area a basso impatto.
Servizi applicativi personalizzati Impatto basso-alto A seconda dell'applicazione e della personalizzazione, ci possono essere dipendenze
su JVM, versioni del sistema operativo e alcune modifiche relative all'indicizzazione
, in quanto gli indici non vengono generati automaticamente in Oak.
Contenuto applicazione personalizzato Impatto basso-alto I contenuti che non verranno gestiti tramite l'aggiornamento possono essere sottoposti a backup
prima che l'aggiornamento abbia luogo e quindi spostati nuovamente nell'archivio.
La maggior parte dei contenuti può essere gestita tramite lo strumento di migrazione.

È importante assicurarsi di eseguire un sistema operativo supportato, Java Runtime, httpd e la versione di Dispatcher. Per ulteriori informazioni, consulta la pagina AEM 6.5 Technical Requirements . L’aggiornamento di questi componenti dovrà essere preso in considerazione nel piano di progetto e avvenire prima dell’aggiornamento AEM.

Fasi del progetto

Un sacco di lavoro va nella pianificazione ed esecuzione di un aggiornamento AEM. Al fine di chiarire i diversi sforzi intrapresi in questo processo, abbiamo suddiviso gli esercizi di pianificazione ed esecuzione in fasi separate. Nelle sezioni seguenti, ogni fase determina un risultato finale che viene spesso sfruttato da una fase futura del progetto.

Pianificazione del corso di formazione sull'autore

Con qualsiasi nuova versione, potrebbero essere introdotte modifiche all’interfaccia utente e ai flussi di lavoro degli utenti. Inoltre, le nuove versioni introducono nuove funzionalità che potrebbero risultare vantaggiose per il business da sfruttare. Consigliamo di rivedere le modifiche funzionali introdotte e di organizzare un piano per addestrare gli utenti a sfruttarle in modo efficace.

unu_cropped

Le nuove funzioni di AEM 6.5 si trovano nella sezione AEM di adobe.com. Assicurati di notare eventuali modifiche alle interfacce utente o alle funzionalità dei prodotti comunemente utilizzate nella tua organizzazione. Osservando le nuove funzioni, prendi anche nota di tutte le funzioni che possono essere di valore per la tua organizzazione. Dopo aver esaminato le modifiche apportate alla AEM 6.5, sviluppa un piano di formazione per i tuoi autori. Questo potrebbe comportare l'utilizzo di risorse liberamente disponibili come i video delle funzioni helpx o la formazione formale offerta tramite Adobe Digital Learning Services.

Creazione di un piano di test

L'implementazione di AEM da parte di ogni cliente è unica ed è stata personalizzata per soddisfare le proprie esigenze aziendali. Di conseguenza, è importante determinare tutte le personalizzazioni apportate al sistema in modo che possano essere incluse in un piano di test. Questo piano di test alimenterà il processo di controllo qualità eseguito sull'istanza aggiornata.

piano di prova

L'ambiente di produzione deve essere duplicato e il test deve essere eseguito dopo l'aggiornamento per assicurarsi che tutte le applicazioni e il codice personalizzato vengano eseguiti come desiderato. È necessario ripristinare tutte le personalizzazioni ed eseguire test di prestazioni, carico e sicurezza. Quando organizzi il tuo piano di test, assicurati di includere tutte le personalizzazioni che sono state apportate al sistema, oltre alle UI e ai flussi di lavoro preconfigurati che vengono utilizzati nelle operazioni quotidiane. Questi possono includere servizi e servlet OSGI personalizzati, integrazioni a Adobe Marketing Cloud, integrazioni con terze parti tramite connettori AEM, integrazioni personalizzate di terze parti, componenti e modelli personalizzati, sovrapposizioni personalizzate dell’interfaccia utente in AEM e flussi di lavoro personalizzati. Per i clienti che eseguono la migrazione da una versione precedente alla AEM 6, eventuali query personalizzate devono essere analizzate in quanto potrebbero dover essere indicizzate. Per i clienti che dispongono già di una versione 6.x di AEM, queste query devono ancora essere testate per garantire che i loro indici continuino a funzionare efficacemente dopo l’aggiornamento.

Determinazione dei cambiamenti di architettura e di infrastruttura necessari

Durante l'aggiornamento, potrebbe essere necessario aggiornare anche altri componenti nello stack tecnico, come il sistema operativo o JVM. Inoltre, è possibile che a causa di modifiche nel trucco del repository possa essere necessario hardware aggiuntivo. Questo di solito si verifica solo per i clienti che eseguono la migrazione da istanze precedenti alla 6.x, ma è importante tenerne conto. Infine, potrebbero essere necessarie modifiche alle procedure operative, inclusi i processi di monitoraggio, manutenzione e backup e disaster recovery.

doi_ritagliato

Esamina i requisiti tecnici per AEM 6.5 e assicurati che l'hardware e il software correnti siano sufficienti. Per potenziali modifiche ai processi operativi, consulta i seguenti documenti:

Monitoraggio e manutenzione:

Dashboard operazioni

Best practice per il monitoraggio in Assets

Risorse del server di monitoraggio tramite la console JMX

Pulizia revisioni

Backup/ripristino e disaster recovery:

Backup e ripristino

Prestazioni e scalabilità

Come eseguire AEM con lo standby a freddo TarMK

Considerazioni sulla ristrutturazione dei contenuti

AEM introdotto modifiche alla struttura dell'archivio che contribuiranno a rendere gli aggiornamenti più diretti. Le modifiche comportano lo spostamento del contenuto dalla cartella /etc a cartelle quali /libs, /apps e /content, in base al fatto che il contenuto sia di proprietà di un Adobe o di un cliente, limitando così le possibilità di sovrascrivere il contenuto durante le versioni. La ristrutturazione dell’archivio è stata eseguita in modo tale da non richiedere modifiche al codice al momento dell’aggiornamento 6.5, anche se è consigliabile rivedere i dettagli in Ristrutturazione dell’archivio in AEM durante la pianificazione di un aggiornamento.

Valutazione della complessità dell'aggiornamento

A causa dell’ampia varietà di personalizzazioni che i nostri clienti applicano ai loro ambienti di AEM, è importante dedicare un po’ di tempo prima di determinare il livello generale di impegno che dovrebbe essere previsto nell’aggiornamento.

Esistono due approcci possibili per valutare la complessità dell’aggiornamento: una fase preliminare può semplicemente utilizzare il rilevatore pattern introdotto di recente, che può essere eseguito sulle istanze 6.1, 6.2 e 6.3 di AEM. Il rilevatore di pattern è il modo più semplice per valutare la complessità complessiva dell’aggiornamento da attendersi utilizzando i pattern riportati. Il rapporto del rilevatore di pattern include pattern per identificare le API non disponibili utilizzate dalla codebase personalizzata (questa operazione è stata eseguita utilizzando i controlli di compatibilità precedenti all’aggiornamento nella versione 6.3).

Dopo la valutazione iniziale, un passo successivo più completo potrebbe essere quello di eseguire un aggiornamento su un'istanza di prova ed eseguire alcune prove di fumo di base. Adobe fornisce anche alcuni . Inoltre, l'elenco delle Funzioni obsolete e rimosse deve essere rivisto non solo per la versione in cui stai effettuando l'aggiornamento, ma anche per tutte le versioni tra la versione di origine e quella di destinazione. Ad esempio, se esegui l’aggiornamento da AEM 6.2 a 6.5, è importante rivedere le funzioni obsolete e rimosse di AEM 6.3 oltre a quelle di AEM 6.5.

trei_cropped

Il rilevatore pattern introdotto di recente dovrebbe fornire una stima abbastanza precisa di cosa aspettarsi durante un aggiornamento per la maggior parte dei casi. Tuttavia, per personalizzazioni e distribuzioni più complesse in cui si verificano modifiche incompatibili, è possibile aggiornare un'istanza di sviluppo a AEM 6.5 in base alle istruzioni in Esecuzione di un aggiornamento sul posto. Una volta completato, eseguire alcuni test di fumo ad alto livello su questo ambiente. L'obiettivo di questo esercizio non è completare in modo esaustivo l'inventario dei casi di test e produrre un inventario formale dei difetti, ma fornirci una stima approssimativa della quantità di lavoro che sarà necessario per aggiornare il codice per la compatibilità 6.5. In combinazione con le Rilevamento pattern e le modifiche architettoniche determinate nella sezione precedente, è possibile fornire al team di gestione del progetto una stima approssimativa per la pianificazione dell’aggiornamento.

Creazione del Runbook di aggiornamento e ripristino

Sebbene Adobe abbia documentato il processo di aggiornamento di un'istanza AEM, il layout di rete, l'architettura di distribuzione e le personalizzazioni di ciascun cliente richiedono una regolazione precisa e un'impostazione personalizzata di questo approccio. Per questo motivo, ti invitiamo a rivedere tutta la documentazione fornita e a utilizzarla per informare un runbook specifico per il progetto che delinea le specifiche procedure di aggiornamento e ripristino che seguirai nel tuo ambiente. Se esegui l’aggiornamento da CRX2, assicurati di valutare quanto tempo impiegherà la migrazione dei contenuti quando passi da CRX2 a Oak. Per i grandi archivi, potrebbe essere sostanziale.

diagramma di runbook

Abbiamo fornito procedure di aggiornamento e rollback in Procedura di aggiornamento, nonché istruzioni dettagliate per l'applicazione dell'aggiornamento in Esecuzione di un Aggiornamento sul posto. Queste istruzioni devono essere riviste e prese in considerazione con l'architettura del sistema, le personalizzazioni e la tolleranza al downtime per determinare le procedure appropriate di switch-over e rollback che verranno eseguite durante l'aggiornamento. Eventuali modifiche all'architettura o alle dimensioni del server devono essere incluse nella redazione del proprio runbook personalizzato. E' importante notare che questo dovrebbe essere trattato come una prima bozza. Quando il team completa i propri cicli di QA e di sviluppo e distribuisce l’aggiornamento all’ambiente di staging, potrebbe essere necessaria una serie di passaggi aggiuntivi. Idealmente, questo documento dovrebbe contenere informazioni sufficienti affinché, se consegnato a un membro del personale operativo, possa completare l'aggiornamento completamente dalle informazioni contenute all'interno.

Sviluppo di un piano di progetto

Possiamo utilizzare l'output degli esercizi precedenti per creare un piano di progetto che copra i tempi previsti per i test o le attività di sviluppo, la formazione e l'esecuzione effettiva dell'aggiornamento.

piano di sviluppo

Un piano globale di progetto dovrebbe comprendere:

  • Completamento dei piani di sviluppo e di collaudo
  • Aggiornamento di ambienti di sviluppo e controllo qualità
  • Aggiornamento della base di codice personalizzata per AEM 6.5
  • Un test di controllo qualità e un ciclo di correzione
  • Aggiornamento dell’ambiente di staging
  • Integrazione, prestazioni e test del carico
  • Certificazione ambientale
  • Viva

Esecuzione di attività di sviluppo e controllo qualità

Sono state fornite procedure per Aggiornare il codice e le personalizzazioni per essere compatibili con AEM 6.5. Poiché questo processo iterativo viene eseguito, è necessario apportare le modifiche necessarie al runbook. Consulta anche Compatibilità con le versioni precedenti in AEM 6.5 per informazioni su come le personalizzazioni possono rimanere compatibili con le versioni precedenti nella maggior parte dei casi senza richiedere lo sviluppo subito dopo l’aggiornamento.

patru_cropped

Il processo di sviluppo e test di solito è iterativo. A causa delle personalizzazioni, le modifiche apportate durante l’aggiornamento potrebbero rendere potenzialmente inutilizzabile un’intera sezione del prodotto. Una volta che gli sviluppatori hanno affrontato la causa principale del problema e il team di test ha accesso per testare queste funzioni, è possibile individuare ulteriori problemi. Poiché vengono rilevati problemi che richiedono adeguamenti del processo di aggiornamento, assicurati di aggiungerli al runbook di aggiornamento personalizzato. Dopo diverse iterazioni di test e correzione, la base di codice deve essere completamente convalidata e pronta per la distribuzione nell'ambiente di staging.

Test finale

Consigliamo un ciclo finale di test dopo che la base di codice è stata certificata dal team QA della tua organizzazione. Questo ciclo di test richiederà la convalida del runbook in un ambiente di staging seguito da turni di accettazione, prestazioni e test di sicurezza degli utenti.

cinci_ritagliato

Questo passaggio è fondamentale in quanto è l'unico momento in cui si è in grado di convalidare i passaggi nel runbook rispetto a un ambiente simile alla produzione. Una volta aggiornato l’ambiente, è importante concedere agli utenti finali un certo tempo di accesso ed esecuzione delle attività che svolgono quando utilizzano il sistema nelle loro attività quotidiane. Non è raro che gli utenti utilizzino una parte del sistema che non era stata considerata in precedenza. Trovare e correggere i problemi in queste aree prima del go-live può aiutare a prevenire costose interruzioni di produzione. Poiché una nuova versione di AEM contiene modifiche significative alla piattaforma sottostante, è importante anche eseguire test di prestazioni, carico e sicurezza sul sistema come se lo stessimo avviando per la prima volta.

Esecuzione dell'aggiornamento

Una volta che tutte le parti interessate avranno ricevuto il discarico finale, è il momento di eseguire le procedure del runbook definite. Abbiamo fornito i passaggi per l'aggiornamento e il rollback in Procedura di aggiornamento e i passaggi di installazione in Esecuzione di un Aggiornamento sul posto come punto di riferimento.

upgrade

Abbiamo fornito alcuni passaggi nelle istruzioni di aggiornamento per la convalida dell’ambiente. Questi includono controlli di base come la scansione dei registri di aggiornamento e la verifica che tutti i bundle OSGi siano stati avviati correttamente, ma si consiglia anche la convalida con i tuoi casi di test basati sui tuoi processi aziendali. Si consiglia inoltre di controllare la pianificazione di AEM Pulizia revisioni online e le relative routine per garantire che si verifichino durante un periodo di inattività per la tua azienda. Queste routine sono essenziali per le prestazioni a lungo termine di AEM.

In questa pagina