Show Menu
ARGOMENTI×

Pianificazione dell'aggiornamento

Panoramica del progetto AEM

AEM viene spesso utilizzato nelle distribuzioni ad alto impatto che potrebbero interessare milioni di utenti. Nella maggior parte dei casi, esistono applicazioni personalizzate che vengono distribuite sulle istanze, e che aumentano la 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. Esso si concentra sull'esecuzione e sugli orientamenti generali del progetto. Fornisce una panoramica dei passaggi effettivi dell'aggiornamento, ma si riferisce alle risorse tecniche disponibili laddove appropriato. Esso dovrebbe essere utilizzato unitamente alle risorse tecniche disponibili di cui al documento.
Il processo di aggiornamento di AEM richiede una gestione accurata delle fasi di pianificazione, analisi ed esecuzione con i risultati finali chiave definiti per ciascuna fase.
È possibile effettuare l’aggiornamento direttamente da AEM versione 6.0 e 6.4. I clienti che eseguono 5.6.x e versioni precedenti devono eseguire l'aggiornamento prima alla versione 6.0 o successiva, con la raccomandazione 6.0(SP3). Inoltre, il nuovo formato OAK Segment Tar è ora utilizzato per il Segment Node Store a partire dalla versione 6.3, e la migrazione del repository a questo nuovo formato è obbligatoria anche per le versioni 6.0, 6.1 e 6.2.
Se si esegue l’aggiornamento da AEM 6.2 a 6.3, è necessario effettuare l’aggiornamento dalle versioni ( 6.2-SP1-CFP1 - -6.2SP1-CFP12.1 ) o 6.2SP1-CFP15 in avanti. In caso contrario, se effettui l’aggiornamento da 6.2SP1-CFP13/6.2SP1CFP14 ad AEM 6.3, devi anche eseguire l’aggiornamento ad almeno la versione 6.3.2.2 . In caso contrario, AEM Sites fallisce dopo l'aggiornamento.

Ambito e requisiti dell'aggiornamento

Di seguito viene riportato un elenco delle aree interessate da un tipico progetto di aggiornamento di AEM:
Componente Impatto Descrizione
Sistema operativo Effetti incerti ma sottili Al momento dell'aggiornamento di AEM, potrebbe essere il momento di aggiornare anche il sistema operativo e questo potrebbe avere un 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 La pulizia online delle revisioni richiede spazio libero su disco pari al 25% delle dimensioni dell'archivio e al 15% dello spazio heap gratuito per il completamento. Potrebbe essere necessario aggiornare l'hardware per garantire risorse sufficienti per l'esecuzione completa della pulizia delle revisioni online. Inoltre, se si effettua l’aggiornamento da una versione precedente a AEM 6, potrebbero essere presenti requisiti di storage aggiuntivi.
Repository dei contenuti (CRX o Oak) Impatto elevato A partire dalla versione 6.1, AEM non supporta CRX2, pertanto, se si esegue l’aggiornamento da una versione precedente, è necessaria una migrazione a Oak (CRX3). AEM 6.3 ha implementato un nuovo archivio dei nodi dei segmenti che richiede anche una migrazione. Lo strumento crx2oak è utilizzato a questo scopo.
Componenti AEM/Contenuto Impatto moderato /libs e /apps sono facilmente gestibili attraverso l'aggiornamento, ma /etc in genere richiede una riapplicazione manuale delle personalizzazioni.
Servizi AEM Basso impatto La maggior parte dei servizi di base di AEM sono sottoposti a test per l'aggiornamento. Questa è un'area di basso impatto.
Servizi applicazione personalizzati Impatto basso-alto A seconda dell'applicazione e della personalizzazione, potrebbero esserci dipendenze da 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 saranno gestiti tramite l'aggiornamento possono essere sottoposti a backup prima che l'aggiornamento abbia luogo e quindi spostati nuovamente nella directory archivio. La maggior parte dei contenuti può essere gestita tramite lo strumento di migrazione.
È importante verificare che sia in esecuzione un sistema operativo supportato, runtime Java, versione httpd e Dispatcher. Per ulteriori informazioni, consultate la pagina Requisiti tecnici di AEM 6.4. L’aggiornamento di questi componenti dovrà essere incluso nel piano di progetto e avvenire prima dell’aggiornamento di AEM.

Fasi del progetto

La pianificazione e l’esecuzione di un aggiornamento di AEM richiedono un gran numero di interventi. 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 produce un risultato finale che viene spesso sfruttato da una fase futura del progetto.

Pianificazione per la 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 funzioni che potrebbero essere utili per l'azienda per sfruttare. Consigliamo di rivedere le modifiche funzionali introdotte e di organizzare un piano per formare i vostri utenti a sfruttarle efficacemente.
Nuove funzioni di AEM 6.4 sono disponibili nella sezione AEM di adobe.com . Assicuratevi di notare eventuali modifiche alle interfacce utente o alle funzionalità dei prodotti comunemente utilizzate nella vostra organizzazione. Osservando le nuove funzioni, prendete nota anche di tutte le funzioni che possono essere di valore per la vostra organizzazione. Dopo aver analizzato le modifiche apportate in AEM 6.4, sviluppate un piano di formazione per gli autori. Ciò potrebbe richiedere l'utilizzo di risorse liberamente disponibili come i video delle funzioni di 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 effettuate al sistema in modo che possano essere incluse in un piano di test. Questo piano di test alimenterà il processo di QA che eseguiamo sull'istanza aggiornata.
L'ambiente di produzione deve essere duplicato e il test deve essere eseguito dopo l'aggiornamento per essere certi che tutte le applicazioni e il codice personalizzato vengano eseguiti come desiderato. Devi ripristinare tutte le tue personalizzazioni ed eseguire test di prestazioni, carico e sicurezza. Quando organizzate il piano di test, accertatevi di coprire tutte le personalizzazioni effettuate al sistema, oltre alle interfacce utente e ai flussi di lavoro out-of-box che vengono utilizzati nelle operazioni quotidiane. Questi possono includere servizi e servlet OSGI personalizzati, integrazioni in Adobe Marketing Cloud, integrazioni con terze parti tramite connettori AEM, integrazioni di terze parti personalizzate, componenti e modelli personalizzati, sovrapposizioni di interfaccia utente personalizzate in AEM e flussi di lavoro personalizzati. Per i clienti che eseguono la migrazione da una versione precedente a AEM 6, eventuali query personalizzate devono essere analizzate in quanto potrebbero dover essere indicizzate. Per i clienti che dispongono già di una versione di AEM 6.x, queste query devono essere ancora 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 delle modifiche nella struttura del repository sia necessario hardware aggiuntivo. In genere questo problema si verifica solo per i clienti che eseguono la migrazione da istanze pre 6.x, ma è importante tenerne conto. Infine, potrebbero essere necessarie modifiche alle procedure operative, inclusi i processi di monitoraggio, manutenzione, backup e disaster recovery.
Verifica i requisiti tecnici per AEM 6.4 e assicurati che l’hardware e il software attuali siano sufficienti. Per potenziali modifiche ai processi operativi, consulta i documenti seguenti:
Monitoraggio e manutenzione:
Backup/ripristino e disaster recovery:

Considerazioni sulla ristrutturazione dei contenuti

AEM 6.4 ha introdotto modifiche alla struttura del repository per rendere più semplici gli aggiornamenti. Le modifiche comportano lo spostamento del contenuto dalla cartella /etc a cartelle quali /libs, /apps e /content, a seconda che Adobe o un cliente sia proprietario del contenuto, limitando così le possibilità di sovrascrivere il contenuto durante le release. La ristrutturazione dell’archivio è stata realizzata in modo tale da non richiedere modifiche al codice al momento dell’aggiornamento 6.4, anche se si consiglia di esaminare i dettagli in Ristrutturazione repository in AEM 6.4 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 AEM, è importante dedicare un po’ di tempo prima di determinare il livello generale di impegno che ci si dovrebbe aspettare nell’aggiornamento.
Per valutare la complessità dell’aggiornamento è possibile seguire due approcci: una fase preliminare può semplicemente utilizzare il nuovo Rilevatore di pattern, disponibile per l’esecuzione sulle istanze AEM 6.1, 6.2 e 6.3. 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 base di codice personalizzata (ciò è stato fatto utilizzando i controlli di compatibilità pre-aggiornamento in 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 Funzioni obsolete e rimosse obsolete e rimosse deve essere rivisto non solo per la versione in cui si sta effettuando l'aggiornamento, ma anche per qualsiasi versione tra le versioni di origine e di destinazione. Ad esempio, se effettui l’aggiornamento da AEM 6.2 a 6.4, è importante consultare le funzioni obsolete e rimosse di AEM 6.3 oltre a quelle di AEM 6.4.
Il rilevamento dei pattern introdotto in 6.4 dovrebbe fornire una stima abbastanza precisa di cosa aspettarsi durante un aggiornamento per la maggior parte dei casi. Tuttavia, per le personalizzazioni e le distribuzioni più complesse con modifiche incompatibili, puoi aggiornare un’istanza di sviluppo ad AEM 6.4 in base alle istruzioni in Esecuzione di un aggiornamento locale. Una volta completato, eseguire alcuni test di fumo ad alto livello su questo ambiente. L'obiettivo di questo esercizio non è di completare esaustivamente l'inventario dei casi di test e produrre un inventario formale dei difetti, ma di darci una stima approssimativa della quantità di lavoro che sarà richiesto per aggiornare il codice per la compatibilità 6.4. In combinazione con il 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 rollback

Sebbene Adobe abbia documentato il processo di aggiornamento di un'istanza di AEM, il layout di rete, l'architettura di distribuzione e le personalizzazioni di ogni cliente richiederanno una messa a punto e una personalizzazione di questo approccio. Per questo motivo, ti invitiamo a consultare tutta la documentazione fornita e a utilizzarla per informare un runbook specifico per il progetto che delinea le procedure di aggiornamento e ripristino specifiche che seguirai nel tuo ambiente. Se si esegue l'aggiornamento da CRX2, assicurarsi di valutare quanto tempo impiegherà la migrazione dei contenuti per passare da CRX2 a Oak. Per i grandi repository, potrebbe essere sostanziale.
Abbiamo fornito procedure di aggiornamento e ripristino nella procedura di aggiornamento e istruzioni dettagliate per l'applicazione dell'aggiornamento in Esecuzione di un aggiornamento Esecuzione di un aggiornamento locale locale. Queste istruzioni devono essere riviste e prese in considerazione con l'architettura del sistema, le personalizzazioni e la tolleranza di inattività per determinare le procedure di switch-over e rollback appropriate che verranno eseguite durante l'aggiornamento. Eventuali modifiche all'architettura o alle dimensioni del server devono essere incluse nella progettazione del runbook personalizzato. E' importante notare che questo dovrebbe essere trattato come un primo progetto. Quando il team completa i cicli di QA e di sviluppo e implementa l'aggiornamento nell'ambiente di pre-produzione, è probabile che sia necessaria la necessità di alcuni passaggi aggiuntivi. Idealmente, il presente 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 le tempistiche previste per i nostri sforzi di test o sviluppo, formazione e l'esecuzione effettiva dell'aggiornamento.
Un piano di progetto globale dovrebbe includere:
  • Completamento dei piani di sviluppo e di collaudo
  • Aggiornamento di ambienti di sviluppo e di controllo della qualità
  • Aggiornamento della base di codice personalizzata per AEM 6.4
  • Un ciclo di verifica e correzione della qualità
  • Aggiornamento dell'ambiente di gestione temporanea
  • Integrazione, prestazioni e test del carico
  • Certificazione ambientale
  • Vai live

Sviluppo e QA

Abbiamo fornito procedure per aggiornare il codice e le personalizzazioni in modo da essere compatibili con AEM 6.4. Poiché questo processo iterativo viene eseguito, è necessario apportare modifiche al runbook in base alle esigenze. Consulta anche Compatibilità con le versioni precedenti di AEM 6.4 per informazioni su come le personalizzazioni possono rimanere compatibili con le versioni precedenti nella maggior parte dei casi senza che sia necessario sviluppare subito dopo l’aggiornamento.
Il processo di sviluppo e test è in genere iterativo. A causa delle personalizzazioni, le modifiche apportate durante l'aggiornamento potrebbero rendere inutilizzabile un'intera sezione del prodotto. Una volta che gli sviluppatori hanno affrontato la causa principale del problema e che il team di test ha accesso per testare queste funzionalità, è possibile che vengano individuati ulteriori problemi. Poiché vengono rilevati problemi che richiedono modifiche al processo di aggiornamento, accertati di aggiungerli al runbook di aggiornamento personalizzato. Dopo diverse fasi di test e correzione, la base di codice deve essere completamente convalidata e pronta per la distribuzione nell'ambiente di gestione temporanea.

Test finale

Consigliamo di eseguire un ciclo finale di test dopo che la base di codice è stata certificata dal team di controllo qualità dell'organizzazione. Questo ciclo di test comporterà la convalida del runbook in un ambiente di verifica, seguita da cicli di accettazione, prestazioni e test di protezione da parte dell'utente.
Questo passaggio è fondamentale, in quanto è l'unico momento in cui è possibile convalidare i passaggi del runbook rispetto a un ambiente di produzione. Una volta aggiornato l'ambiente, è importante concedere agli utenti finali un certo tempo di tempo per accedere e svolgere le 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 live può aiutare a prevenire costose interruzioni di produzione. Poiché una nuova versione di AEM contiene modifiche significative alla piattaforma sottostante, è importante eseguire test di prestazioni, carico e sicurezza sul sistema come se lo stessimo avviando per la prima volta.

Esecuzione dell'aggiornamento

Una volta ricevuta la firma finale da parte di tutte le parti interessate, è il momento di eseguire le procedure del runbook che sono state definite. Abbiamo fornito i passaggi per l'aggiornamento e il rollback nella procedura di aggiornamento e i passaggi di installazione in Esecuzione di un aggiornamento Esecuzione di un aggiornamento locale locale come punto di riferimento.
Nelle istruzioni per la convalida dell'ambiente sono stati forniti alcuni passaggi. 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 consigliamo anche la convalida con i vostri casi di test basati sui vostri processi aziendali. Consigliamo inoltre di verificare la pianificazione della pulizia delle revisioni online di AEM e delle relative routine per assicurarvi che si verifichino in un periodo di inattività prolungato per la vostra azienda. Queste routine sono essenziali per le prestazioni a lungo termine di AEM.