Pianificazione dell'aggiornamento planning-your-upgrade

Panoramica del progetto AEM aem-project-overview

L’AEM viene spesso utilizzato in implementazioni ad alto impatto che potrebbero servire milioni di utenti. In genere, nelle istanze vengono distribuite applicazioni personalizzate che aumentano la complessità. Qualsiasi sforzo per aggiornare tale implementazione deve essere gestito in modo metodologico.

Questa guida aiuta a stabilire chiari obiettivi, fasi e risultati finali durante la pianificazione dell’aggiornamento. Si concentra sull'esecuzione complessiva del progetto e sulle linee guida. Pur fornendo una panoramica dei passaggi effettivi di aggiornamento, fa riferimento alle risorse tecniche disponibili, ove opportuno. Esso dovrebbe essere utilizzato con le risorse tecniche disponibili di cui al documento.

Il processo di aggiornamento dell’AEM richiede una gestione accurata delle fasi di pianificazione, analisi ed esecuzione, con la definizione dei principali risultati finali per ogni fase.

È possibile effettuare l’aggiornamento direttamente dalle versioni 6.0 e 6.5 dell’AEM. I clienti che eseguono la versione 5.6.x e successive devono prima eseguire l’aggiornamento alla versione 6.0 o successiva, consigliando 6.0 (SP3). Inoltre, il nuovo formato Oak Segment Tar viene ora utilizzato per l’archivio dei nodi di segmento 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.

CAUTION
Se si esegue l’aggiornamento da AEM 6.2 a 6.3, è necessario eseguire l’aggiornamento dalle versioni (6.2-SP1-CFP1 - -6.2SP1-CFP12.1) o 6.2SP1-CFP15 e oltre. In caso contrario, se si esegue l'aggiornamento da 6.2SP1-CFP13/6.2SP1CFP14 a AEM 6.3, devi anche effettuare l’aggiornamento almeno alla versione 6.3.2.2.. In caso contrario, AEM Sites avrebbe esito negativo dopo l’aggiornamento.

Ambito e requisiti dell'aggiornamento upgrade-scope-requirements

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

Componente
Impatto
Descrizione
Sistema operativo
Effetti incerti ma delicati
Al momento dell’aggiornamento dell’AEM, potrebbe essere giunto 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
La funzione di pulizia delle revisioni online richiede la versione gratuita
spazio su disco pari al 25% delle dimensioni dell’archivio e al 15% dello spazio heap disponibile
per completare correttamente. Potrebbe essere necessario aggiornare l'hardware a
garantire risorse sufficienti per la pulizia delle revisioni online per
esegui. Inoltre, se si esegue l’aggiornamento da una versione precedente all’AEM 6,
possono essere requisiti di conservazione aggiuntivi.
Archivio dei contenuti (CRX o Oak)
Impatto elevato
A partire dalla versione 6.1, l’AEM non supporta CRX2, pertanto una migrazione a
Oak (CRX3) è richiesto per l’aggiornamento da una versione precedente. L’AEM 6.3 ha
implementato un nuovo archivio nodi segmento che richiede anche una migrazione. Il
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
Impatto ridotto
La maggior parte dei servizi di base dell’AEM sono testati per l’aggiornamento. Si tratta di un’area di impatto limitato.
Servizi applicativi personalizzati
Impatto da basso a alto
A seconda dell’applicazione e della personalizzazione, possono essere
dipendenze da JVM, versioni del sistema operativo e alcune relative all’indicizzazione
modifiche, poiché gli indici non vengono generati automaticamente in Oak.
Contenuto applicazione personalizzato
Impatto da basso a alto
È possibile eseguire il backup dei contenuti che non verranno gestiti tramite l'aggiornamento
prima dell’aggiornamento, quindi viene spostato di nuovo 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, vedere Pagina Requisiti tecnici di AEM 6.5. L’aggiornamento di questi componenti deve essere considerato nel piano di progetto e deve avvenire prima dell’aggiornamento dell’AEM.

Fasi progetto project-phases

Molto lavoro è dedicato alla pianificazione e all'esecuzione di un aggiornamento AEM. Per chiarire i diversi sforzi che entrano in questa fase, Adobe ha suddiviso gli esercizi di pianificazione ed esecuzione in fasi separate. Nelle sezioni seguenti, ogni fase determina un risultato finale che viene spesso utilizzato in una fase futura del progetto.

Pianificazione per la formazione dell’autore planning-for-author-training

Con qualsiasi nuova versione, possono essere introdotte modifiche potenziali all’interfaccia utente e ai flussi di lavoro degli utenti. Inoltre, le nuove versioni introducono nuove funzioni che possono essere utili per l’azienda. L’Adobe consiglia di rivedere le modifiche funzionali introdotte e di organizzare un piano di formazione per consentire agli utenti di utilizzarle in modo efficace.

unu_cropped

Le nuove funzioni di AEM 6.5 sono disponibili in la sezione AEM di adobe.com. Nota eventuali modifiche all’interfaccia utente o alle funzioni del prodotto comunemente utilizzate nell’organizzazione. Esaminando le nuove funzioni, prendi nota anche di quelle che possono essere di valore per la tua organizzazione. Dopo aver analizzato i cambiamenti di AEM 6.5, sviluppa un piano di formazione per gli autori. Questo potrebbe comportare l’utilizzo di risorse liberamente disponibili, come i video dell’Aiuto o la formazione formale offerta tramite Servizi di apprendimento digitale Adobe.

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

L'implementazione di AEM da parte di ogni cliente è unica ed è stata personalizzata in base ai requisiti 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 alimenta il processo di controllo qualità eseguito da Adobe sull’istanza aggiornata.

piano di test

È necessario duplicare l’ambiente di produzione esatto e sottoporlo a test dopo l’aggiornamento per assicurarsi che tutte le applicazioni e il codice personalizzato vengano ancora eseguiti come desiderato. Ripristina tutte le tue personalizzazioni ed esegui test di prestazioni, carico e sicurezza. Quando organizzi il piano di test, assicurati di coprire tutte le personalizzazioni apportate al sistema, oltre alle interfacce utente e ai flussi di lavoro predefiniti utilizzati nelle operazioni quotidiane. Questi possono includere servizi e servlet OSGI personalizzati, integrazioni a Adobe Experience Cloud, integrazioni con terze parti tramite connettori AEM, integrazioni personalizzate di terze parti, 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, è necessario analizzare tutte le query personalizzate, in quanto potrebbero dover essere indicizzate. Per i clienti che utilizzano già una versione AEM 6.x, queste query devono essere ancora testate per garantire che i loro indici continuino a funzionare in modo efficace dopo l’aggiornamento.

Determinazione delle modifiche di architettura e infrastruttura necessarie determining-architectural-and-infrastructure-changes-needed

Durante l’aggiornamento, è possibile che sia necessario aggiornare anche altri componenti dello stack tecnico, come il sistema operativo o JVM. Inoltre, è possibile che, a causa di modifiche nella composizione dell’archivio, sia necessario hardware aggiuntivo. Questo problema viene fuori solo per i clienti che eseguono la migrazione da istanze precedenti a 6.x, ma è importante da considerare. Infine, potrebbero essere necessarie modifiche alle procedure operative, inclusi i processi di monitoraggio, manutenzione, backup e disaster recovery.

doi_ritagliato

Rivedi i requisiti tecnici per AEM 6.5 e assicurati che l’hardware e il software attuali siano sufficienti. Per le potenziali modifiche ai processi operativi, consulta i seguenti documenti:

Monitoraggio e manutenzione

Dashboard operazioni

Best practice per il monitoraggio in Assets

Monitoraggio delle risorse del server tramite la console JMX

Pulizia revisioni

Backup/ripristino e disaster recovery:

Backup e ripristino

Prestazioni e scalabilità

Come eseguire l’AEM con TarMK Cold Standby

Considerazioni sulla ristrutturazione dei contenuti content-restructuring-considerations

L’AEM ha introdotto modifiche alla struttura dell’archivio che contribuiranno a rendere gli aggiornamenti più fluidi. Le modifiche comportano lo spostamento di contenuto dalla cartella /etc alle cartelle, tra cui /libs, /apps e /content, a seconda che il contenuto sia di proprietà di un Adobe o di un cliente, limitando così le possibilità di sovrascrittura del 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 si consiglia di rivedere i dettagli in Ristrutturazione dell’archivio dell’AEM durante la pianificazione di un aggiornamento.

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

A causa dell’ampia varietà di tipi e tipi di personalizzazioni che i clienti Adobe applicano ai loro ambienti AEM, è importante trascorrere del tempo prima di determinare il livello complessivo di impegno che dovrebbe essere previsto nell’aggiornamento.

Esistono due approcci per valutare la complessità dell’aggiornamento: una fase preliminare può utilizzare il rilevatore pattern appena introdotto, disponibile per l’esecuzione sulle istanze AEM 6.1, 6.2 e 6.3. Il rilevatore pattern è il modo più semplice per valutare la complessità complessiva dell’aggiornamento che ci si aspetta utilizzando i pattern riportati. Il rapporto del rilevatore pattern include pattern per l’identificazione delle API non disponibili utilizzate dalla base di codice personalizzata (questa operazione è stata eseguita utilizzando i controlli di compatibilità pre-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. L’Adobe fornisce anche alcuni . Inoltre, l'elenco di Funzioni obsolete e rimosse deve essere rivisto non solo per la versione a cui stai effettuando l’aggiornamento, ma anche per tutte le versioni tra le versioni di origine e di destinazione. Ad esempio, per l’aggiornamento da AEM 6.2 a 6.5, è importante rivedere le funzioni obsolete e rimosse dell’AEM 6.3 oltre a quelle per AEM 6.5.

trei_ritagliato

Il rilevatore pattern introdotto di recente dovrebbe fornire una stima abbastanza accurata di ciò che ci si aspetta da un aggiornamento nella maggior parte dei casi. Tuttavia, per personalizzazioni e implementazioni più complesse in cui sono presenti modifiche incompatibili, puoi aggiornare un’istanza di sviluppo a AEM 6.5 seguendo le istruzioni riportate in Esecuzione di un aggiornamento sul posto. Una volta completato, eseguire alcune prove di fumo di alto livello in questo ambiente. L'obiettivo di questo esercizio non è quello di completare in modo esaustivo l'inventario dei test case e produrre un inventario formale dei difetti, ma di fornire una stima approssimativa della quantità di lavoro necessaria per aggiornare il codice per la compatibilità 6.5. In combinazione con Rilevamento pattern e con le modifiche dell'architettura individuate nella sezione precedente, è possibile fornire una stima approssimativa al team di project management per pianificare l'aggiornamento.

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

Sebbene Adobe abbia documentato la procedura di aggiornamento di un’istanza AEM, il layout di rete, l’architettura di distribuzione e le personalizzazioni di ogni cliente richiedono l’ottimizzazione e la personalizzazione di questo approccio. Per questo motivo, Adobe ti incoraggia a rivedere tutta la documentazione fornita e a utilizzarla per informare un runbook specifico per il progetto che illustra le procedure specifiche di aggiornamento e rollback che seguirai nel tuo ambiente. In caso di aggiornamento da CRX2, assicurati di valutare il tempo necessario per la migrazione dei contenuti durante il passaggio da CRX2 a Oak. Per gli archivi di grandi dimensioni, potrebbe essere sostanziale.

diagramma runbook

L’Adobe fornisce procedure di aggiornamento e rollback in Procedura di aggiornamento e istruzioni dettagliate per l'applicazione dell'aggiornamento in Esecuzione di un Aggiornamento sul posto. Queste istruzioni devono essere esaminate e prese in considerazione insieme all'architettura del sistema, alle personalizzazioni e alla tolleranza ai tempi 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 dei server devono essere incluse durante la creazione del runbook personalizzato. E' importante notare che questa proposta dovrebbe essere trattata come una prima bozza. Quando il team completa i cicli di QA e sviluppo e distribuisce l’aggiornamento all’ambiente di staging, è probabile che siano necessari alcuni passaggi aggiuntivi. Idealmente, questo documento dovrebbe contenere informazioni sufficienti in modo tale che, se fosse consegnato a un membro del personale operativo, sarebbe in grado di completare l'aggiornamento completamente dalle informazioni contenute in.

Sviluppo di un piano di progetto developing-a-project-plan

L’output degli esercizi precedenti può essere utilizzato per creare un piano di progetto che copre le tempistiche previste per le attività di test o sviluppo, la formazione e l’esecuzione effettiva dell’aggiornamento.

development-project-plan

Un piano di progetto completo dovrebbe includere:

  • Completamento dei piani di sviluppo e di prova
  • Aggiornamento degli ambienti di sviluppo e controllo qualità
  • Aggiornamento della base di codice personalizzato per AEM 6.5
  • Un test di controllo qualità e un ciclo di correzione
  • Aggiornamento dell’ambiente di staging
  • Integrazione, prestazioni e test di carico
  • Certificazione dell’ambiente
  • Pubblicazione

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

L'Adobe ha previsto procedure per Aggiornamento del codice e delle personalizzazioni essere compatibile con l'AEM 6.5. Durante l’esecuzione di questo processo iterativo, è necessario apportare le modifiche necessarie al runbook. Vedi anche Compatibilità con le versioni precedenti in AEM 6.5 informazioni su come le personalizzazioni possono rimanere compatibili con le versioni precedenti, in genere senza richiedere lo sviluppo immediatamente dopo l’aggiornamento.

patru_cropped

Il processo di sviluppo e test è solitamente iterativo. A causa delle personalizzazioni, le modifiche apportate durante l’aggiornamento potrebbero potenzialmente rendere 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 a testare queste funzioni, esiste la possibilità di individuare ulteriori problemi. Quando vengono rilevati problemi che richiedono modifiche al 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

L’Adobe consiglia un ciclo finale di test dopo che il codebase è stato certificato dal team di controllo qualità della tua organizzazione. Questo ciclo di test prevede la convalida del runbook in un ambiente di staging, seguita da cicli di test di accettazione, prestazioni e sicurezza da parte dell’utente.

cinci_cropped

Questo passaggio è fondamentale in quanto è l’unico momento in cui puoi convalidare i passaggi nel runbook rispetto a un ambiente di produzione. Dopo l’aggiornamento dell’ambiente, è importante concedere agli utenti finali un po’ di tempo per accedere e svolgere le attività che svolgono quando utilizzano il sistema nelle attività quotidiane. Non è raro che gli utenti utilizzino una parte del sistema che non era stata considerata in precedenza. L’individuazione e la correzione dei problemi in queste aree prima della pubblicazione possono contribuire a evitare costose interruzioni della produzione. Poiché una nuova versione dell’AEM contiene modifiche significative alla piattaforma sottostante, è importante anche eseguire test di prestazioni, carico e sicurezza sul sistema come se fosse stato avviato per la prima volta.

Esecuzione dell'aggiornamento performing-the-upgrade

Una volta ricevuto l’approvazione finale da tutte le parti interessate, è ora di eseguire le procedure del runbook definite. L’Adobe fornisce 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.

esegui-aggiornamento

L’Adobe fornisce 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 Adobe consiglia anche di eseguire la convalida con casi di test personalizzati in base ai processi aziendali. Adobe consiglia inoltre di controllare la pianificazione di Pulizia revisioni online AEM e le relative routine per garantire che si verifichino durante un periodo di silenzio per la tua azienda. Queste routine sono essenziali per le prestazioni a lungo termine dell’AEM.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2