Pianificazione dell'aggiornamento planning-your-upgrade

Panoramica del progetto AEM aem-project-overview

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.4 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.

Ambito e requisiti dell'aggiornamento upgrade-scope-requirements

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

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

Fasi del progetto project-phases

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 della formazione sull’autore planning-for-author-training

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 l’azienda per l’utilizzo. Consigliamo di rivedere le modifiche funzionali introdotte e di organizzare un piano per addestrare gli utenti a sfruttarle in modo efficace.

Le nuove funzioni di AEM 6.4 si trovano in la 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.4, sviluppa un piano di formazione per i tuoi autori. Ciò potrebbe comportare l'utilizzo di risorse disponibili liberamente, come i video delle funzioni helpx o la formazione formale offerta tramite Adobe Digital Learning Services.

Creazione di un piano di test creating-a-test-plan

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.

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 determining-architectural-and-infrastructure-changes-needed

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.

Esamina i requisiti tecnici per AEM 6.4 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 content-restructuring-considerations

AEM 6.4 ha 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 effettuata in modo tale da non richiedere modifiche al codice al momento dell’aggiornamento 6.4, anche se è consigliabile rivedere i dettagli in Ristrutturazione dell’archivio in AEM 6.4 durante la pianificazione di un aggiornamento.

Valutazione della complessità dell'aggiornamento assessing-upgrade-complexity

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 di Funzioni obsolete e rimosse deve essere rivisto non solo per la versione a cui stai eseguendo l’aggiornamento, ma anche per tutte le versioni tra la versione sorgente e quella di destinazione. Ad esempio, se esegui l’aggiornamento da AEM 6.2 a 6.4, è importante rivedere le funzioni obsolete e rimosse di AEM 6.3 oltre a quelle di AEM 6.4.

Il rilevatore pattern introdotto nella versione 6.4 dovrebbe fornire una stima abbastanza precisa di cosa aspettarsi durante un aggiornamento per la maggior parte dei casi. Tuttavia, per personalizzazioni e implementazioni più complesse in cui si verificano modifiche incompatibili, è possibile aggiornare un’istanza di sviluppo a AEM 6.4 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.4. Se combinato con Rilevamento pattern e le modifiche dell'architettura determinate nella sezione precedente, è possibile fornire una stima approssimativa al team di gestione del progetto per la pianificazione dell'aggiornamento.

Creazione del Runbook di aggiornamento e ripristino building-the-upgrade-and-rollback-runbook

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.

Abbiamo fornito procedure di aggiornamento e ripristino 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 developing-a-project-plan

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.

Un piano globale di progetto dovrebbe comprendere:

Esecuzione di attività di sviluppo e controllo qualità performing-development-and-qa

Abbiamo fornito procedure per Aggiornamento di codice e personalizzazioni per essere compatibile con AEM 6.4. Poiché questo processo iterativo viene eseguito, le modifiche al runbook devono essere apportate secondo necessità. Vedi anche Compatibilità con le versioni precedenti in AEM 6.4 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.

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 funzionalità, è 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 final-testing

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.

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 performing-the-upgrade

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

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.