Planificación de la actualización planning-your-upgrade

Información general del proyecto AEM aem-project-overview

AEM se utiliza a menudo en implementaciones de alto impacto que podrían llegar a millones de usuarios. Normalmente, hay aplicaciones personalizadas que se implementan en las instancias, lo que aumenta la complejidad. Cualquier esfuerzo por actualizar una implementación de este tipo debe gestionarse metódicamente.

Esta guía le ayudará a establecer objetivos, fases y entregables claros al planificar la actualización. Se centra en la ejecución general del proyecto y en las directrices. Aunque proporciona una descripción general de los pasos de actualización reales, hace referencia a los recursos técnicos disponibles cuando corresponde. Debe utilizarse con los recursos técnicos disponibles a los que se hace referencia en el documento.

El proceso de actualización de AEM necesita fases de planificación, análisis y ejecución cuidadosamente gestionadas, con entregables clave definidos para cada fase.

Es posible actualizar directamente desde las versiones 6.0 y 6.5 de AEM. Los clientes que ejecutan 5.6.x o versiones posteriores deben actualizar primero a la versión 6.0 o superior, recomendándose 6.0 (SP3). Además, el nuevo formato de Tar de segmentos de Oak se utiliza ahora para el almacén de nodos de segmentos desde la versión 6.3, y la migración del repositorio a este nuevo formato es obligatoria incluso para la versión 6.0, 6.1 y 6.2.

Ámbito y requisitos de la actualización upgrade-scope-requirements

A continuación, se muestra una lista de áreas que se ven afectadas en un proyecto de actualización de AEM típico:

Es importante asegurarse de que está ejecutando un sistema operativo compatible, un tiempo de ejecución de Java™, un httpd y una versión de Dispatcher. Para obtener más información, consulte la página de requisitos técnicos de AEM 6.5. La actualización de estos componentes debe tenerse en cuenta en el plan del proyecto y debe realizarse antes de actualizar AEM.

Fases del proyecto project-phases

Se está trabajando mucho en la planificación y ejecución de una actualización de AEM. Para aclarar los diferentes esfuerzos que se realizan en este proceso, Adobe ha desglosado los ejercicios de planificación y ejecución en fases independientes. En las secciones que siguen, cada fase da como resultado un entregable que a menudo se utiliza en una fase futura del proyecto.

Planificación de la formación de autores planning-for-author-training

Con cualquier nueva versión, se pueden introducir cambios potenciales en la interfaz de usuario y en los flujos de trabajo de los usuarios. Además, las nuevas versiones introducen nuevas funciones que pueden ser beneficiosas para el uso empresarial. Adobe recomienda revisar los cambios funcionales que se han introducido y organizar un plan para formar a los usuarios en el uso eficaz de ellos.

Las nuevas características de AEM 6.5 se encuentran en la sección AEM de adobe.com. Asegúrese de tener en cuenta cualquier cambio en las IU o las funciones del producto que se utilizan comúnmente en su organización. A medida que revise las nuevas funciones, tome nota también de las que puedan ser de valor para su organización. Después de revisar los cambios realizados en AEM 6.5, desarrolle un plan de formación para sus autores. Esto podría implicar el uso de recursos disponibles libremente como los vídeos de funciones de ayuda o la formación formal ofrecida a través de Adobe Digital Learning Services.

Creación de un Plan de Pruebas creating-a-test-plan

La implementación de AEM por parte de cada cliente es única y se ha personalizado para satisfacer los requisitos empresariales. Como resultado, es importante determinar todas las personalizaciones que se han realizado en el sistema para que se puedan incluir en un plan de prueba. Este plan de prueba potencia el proceso de control de calidad que Adobe realiza en la instancia actualizada.

Es necesario duplicar el entorno de producción exacto y se deben realizar pruebas en él después de la actualización para asegurarse de que todas las aplicaciones y el código personalizado siguen ejecutándose como se desea. Regrese todas las personalizaciones y ejecute pruebas de rendimiento, carga y seguridad. Al organizar el plan de prueba, asegúrese de cubrir todas las personalizaciones que se han realizado en el sistema, además de las IU y los flujos de trabajo predeterminados que se utilizan en sus operaciones diarias. Pueden incluir servicios y servlets OSGI personalizados, integraciones en Adobe Experience Cloud, integraciones con terceros a través de conectores AEM, integraciones de terceros personalizadas, componentes y plantillas personalizados, superposiciones de IU personalizadas en AEM y flujos de trabajo personalizados. Para los clientes que migran de una versión anterior a AEM 6, cualquier consulta personalizada debe analizarse, ya que puede que sea necesario indexarla. Para los clientes que ya tienen una versión de AEM 6.x, se deben probar estas consultas para asegurarse de que sus índices siguen funcionando correctamente después de la actualización.

Determinación de los cambios arquitectónicos y de infraestructura necesarios determining-architectural-and-infrastructure-changes-needed

Al realizar la actualización, es posible que también necesite actualizar otros componentes de su pila técnica, como el sistema operativo o JVM. Además, es posible que debido a los cambios en la composición del repositorio se requiera hardware adicional. Esto solo aparece para los clientes que migran de instancias anteriores a la 6.x, pero es importante tenerlo en cuenta. Por último, es posible que se necesiten cambios en las prácticas operativas, incluidos los procesos de supervisión, mantenimiento, backup y recuperación ante desastres.

Revise los requisitos técnicos de AEM 6.5 y asegúrese de que el hardware y el software actuales sean suficientes. Para ver posibles cambios en los procesos operativos, consulte los siguientes documentos:

Supervisión y mantenimiento:

Tablero de operaciones

Prácticas recomendadas de supervisión de Assets

Monitorización de recursos del servidor mediante la consola JMX

Limpieza de revisión

Copia de seguridad/restauración y recuperación ante desastres:

Copia de seguridad y restauración

Rendimiento y escalabilidad

Cómo ejecutar AEM con espera en frío de TarMK

Consideraciones de reestructuración de contenido content-restructuring-considerations

AEM ha introducido cambios en la estructura del repositorio que ayudarán a que las actualizaciones sean más fluidas. Los cambios implican mover contenido fuera de la carpeta /etc a carpetas como /libs, /apps y /content, en función de si Adobe o un cliente son propietarios del contenido, lo que limita las posibilidades de sobrescribir contenido durante las versiones. La reestructuración del repositorio se ha realizado de tal manera que no debería requerir cambios de código en el momento de la actualización a la versión 6.5, aunque se recomienda revisar los detalles en Reestructuración del repositorio en AEM mientras se planea una actualización.

Evaluación de la complejidad de actualización assessing-upgrade-complexity

Debido a la amplia variedad en la cantidad y naturaleza de las personalizaciones que los clientes de Adobe aplican a sus entornos de AEM, es importante pasar algún tiempo por adelantado para determinar el nivel general de esfuerzo que se debe esperar en la actualización.

Existen dos métodos para evaluar la complejidad de la actualización: una fase preliminar puede utilizar Pattern Detector, recién introducido, que está disponible para ejecutarse en las instancias de AEM 6.1, 6.2 y 6.3. El detector de patrones es la forma más sencilla de evaluar la complejidad general de la actualización que cabe esperar utilizando los patrones notificados. El informe detector de patrones incluye patrones para identificar las API no disponibles que utiliza la base de código personalizada (esto se hizo mediante comprobaciones de compatibilidad previas a la actualización en la versión 6.3).

Después de la evaluación inicial, un paso siguiente más completo podría ser realizar una actualización en una instancia de prueba y realizar algunas pruebas básicas de humo. Adobe también proporciona algunos . Además, la lista de funciones obsoletas y eliminadas debe revisarse no solo para la versión a la que está actualizando, sino también para cualquier versión entre las versiones de origen y destino. Por ejemplo, si actualiza de AEM 6.2 a 6.5, es importante revisar las funciones obsoletas y eliminadas de AEM 6.3, además de las de AEM 6.5.

Pattern Detector, introducido recientemente, debería proporcionarle una estimación bastante precisa de lo que puede esperar durante una actualización en la mayoría de los casos. Sin embargo, para personalizaciones e implementaciones más complejas en las que tenga cambios incompatibles, puede actualizar una instancia de desarrollo a AEM 6.5 según las instrucciones de Realización de una actualización in situ. Una vez finalizado, realice algunas pruebas de humo de alto nivel en este entorno. El objetivo de este ejercicio no es completar exhaustivamente el inventario de casos de prueba y producir un inventario formal de defectos, sino darnos una estimación aproximada de la cantidad de trabajo que se requerirá para actualizar el código para la compatibilidad con la versión 6.5. Cuando se combina con la Detección de patrones y los cambios de arquitectura determinados en la sección anterior, se puede proporcionar una estimación aproximada al equipo de administración del proyecto para que planifique la actualización.

Generación de la actualización y reversión de Runbook building-the-upgrade-and-rollback-runbook

Aunque Adobe ha documentado el proceso de actualización de una instancia de AEM, el diseño de red, la arquitectura de implementación y las personalizaciones de cada cliente requieren un ajuste y una adaptación precisos de este enfoque. Por este motivo, Adobe le recomienda revisar toda la documentación proporcionada y utilizarla para informar a un Runbook específico del proyecto que describa los procedimientos específicos de actualización y reversión que seguirá en su entorno. Si actualiza desde CRX2, asegúrese de evaluar cuánto tiempo tardará la migración de contenido al pasar de CRX2 a Oak. Para repositorios grandes, podría ser sustancial.

Adobe ha proporcionado procedimientos de actualización y reversión en Procedimiento de actualización e instrucciones paso a paso para aplicar la actualización al realizar una actualización in situ. Estas instrucciones deben revisarse y tenerse en cuenta junto con la arquitectura del sistema, las personalizaciones y la tolerancia ante tiempos de inactividad para determinar los procedimientos de cambio y reversión adecuados que se van a ejecutar durante la actualización. Cualquier cambio en la arquitectura o el tamaño del servidor debe incluirse al redactar el runbook personalizado. Es importante señalar que esto debería tratarse como un primer borrador. A medida que su equipo completa sus ciclos de control de calidad y desarrollo e implementa la actualización en el entorno de ensayo, es probable que sea necesario realizar algunos pasos adicionales. Lo ideal es que este documento contenga información suficiente como para que, si se entregara a un miembro de su personal de operaciones, pueda completar la actualización completamente a partir de la información contenida en él.

Desarrollo de un plan de proyecto developing-a-project-plan

Los resultados de los ejercicios anteriores se pueden utilizar para crear un plan de proyecto que abarque los plazos previstos para los esfuerzos de prueba o desarrollo, la formación y la ejecución real de la actualización.

Un plan de proyecto integral debe incluir:

Desarrollo y control de calidad performing-development-and-qa

Adobe ha proporcionado procedimientos para actualizar código y personalizaciones para que sean compatibles con AEM 6.5. A medida que se ejecuta este proceso iterativo, se deben realizar cambios en el Runbook según sea necesario. Consulte también Compatibilidad con versiones anteriores en AEM 6.5 para obtener información sobre cómo las personalizaciones pueden seguir siendo compatibles con versiones anteriores, por lo general sin que sea necesario desarrollarlas inmediatamente después de la actualización.

El proceso de desarrollo y prueba suele ser iterativo. Debido a las personalizaciones, los cambios realizados durante la actualización podrían inutilizar una sección entera del producto. Una vez que los desarrolladores han abordado la causa raíz del problema y el equipo de prueba tiene acceso para probar estas funciones, existe la posibilidad de descubrir problemas adicionales. A medida que se detecten problemas que requieran ajustes en el proceso de actualización, asegúrese de añadirlos a su runbook de actualización personalizado. Después de varias iteraciones de pruebas y correcciones, la base de código debe validarse completamente y estar lista para su implementación en el entorno de ensayo.

Prueba final final-testing

Adobe recomienda una ronda final de pruebas después de que el equipo de control de calidad de su organización haya certificado la base de código. Esta ronda de pruebas incluirá la validación del runbook en un entorno de ensayo, seguido de rondas de aceptación del usuario, rendimiento y pruebas de seguridad.

Este paso es vital, ya que es la única vez que puede validar los pasos del Runbook con un entorno de producción. Una vez actualizado el entorno, es importante dar a los usuarios finales un poco de tiempo para iniciar sesión y realizar las actividades que realizan al utilizar el sistema en sus actividades diarias. No es inusual que los usuarios usen una parte del sistema que no se había considerado anteriormente. Encontrar y corregir problemas en estas áreas antes del lanzamiento puede ayudar a evitar costosos cortes en la producción. Como una nueva versión de AEM contiene cambios significativos en la plataforma subyacente, también es importante realizar pruebas de rendimiento, carga y seguridad en el sistema como si lo iniciara por primera vez.

Realización de la actualización performing-the-upgrade

Una vez recibida la firma final de todas las partes interesadas, es hora de ejecutar los procedimientos definidos del Runbook. Adobe ha proporcionado pasos para la actualización y la reversión en Procedimiento de actualización y pasos de instalación en Realización de una actualización in situ como punto de referencia.

Adobe proporciona algunos pasos en las instrucciones de actualización para la validación del entorno. Estas incluyen comprobaciones básicas como el análisis de los registros de actualización y la verificación de que todos los paquetes OSGi se han iniciado correctamente, pero Adobe recomienda también validar con sus propios casos de prueba en función de los procesos empresariales. Adobe también recomienda consultar la programación de Limpieza de revisiones en línea de AEM y las rutinas relacionadas para asegurarse de que se produzcan durante un tiempo tranquilo para su empresa. Estas rutinas son esenciales para el rendimiento a largo plazo de AEM.