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

CAUTION
AEM 6.4 ha llegado al final de la compatibilidad ampliada y esta documentación ya no se actualiza. Para obtener más información, consulte nuestra períodos de asistencia técnica. Buscar las versiones compatibles here.

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

AEM se utiliza a menudo en implementaciones de alto impacto que podrían servir a millones de usuarios. En la mayoría de los casos, 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 manejarse metódicamente.

Esta guía le ayuda a establecer objetivos, fases y resultados 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 reales de la actualización, se refiere a los recursos técnicos disponibles cuando corresponde. Debe utilizarse junto con los recursos técnicos disponibles a 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.

Tenga en cuenta que es posible actualizar directamente desde AEM versiones 6.0 y hasta 6.4. Los clientes que ejecutan 5.6.x y versiones posteriores deben actualizar primero a la versión 6.0 o superior, recomendando 6.0 (SP3). Además, el nuevo formato de Tar de segmentos OAK se utiliza ahora para el Almacenamiento de nodos de segmentos desde la versión 6.3, y la migración del repositorio a este nuevo formato es obligatoria incluso para las versiones 6.0, 6.1 y 6.2.

CAUTION
Si está actualizando de AEM 6.2 a 6.3, O BIEN debe actualizarlo de versiones (6.2-SP1-CFP1 - -6.2SP1-CFP12.1) o 6.2SP1-CFP15 en adelante. De lo contrario, si actualiza desde 6.2SP1-CFP13/6.2SP1CFP14 a AEM 6.3, también debe actualizar a al menos la versión 6.3.2.2. De lo contrario, AEM Sites fallaría después de la actualización.

Alcance y requisitos de la actualización upgrade-scope-requirements

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

Componente
Impacto
Descripción
Sistema operativo
Efectos inciertos pero sutiles
En el momento de la actualización de AEM, puede ser tiempo de actualizar el sistema operativo también y esto podría tener algún impacto.
Java Runtime
Impacto moderado
AEM 6.3 requiere JRE 1.7.x (64 bits) o posterior. JRE 1.8 es la única versión compatible actualmente con Oracle.
Hardware
Impacto moderado
La limpieza de revisión en línea requiere
espacio en disco igual al 25% del tamaño del repositorio y un 15% de espacio libre en pilas
para completarse correctamente. Es posible que deba actualizar su hardware a
garantizar recursos suficientes para la limpieza de revisión en línea para
ejecutar. Además, si actualiza desde una versión anterior a AEM 6,
pueden ser requisitos de almacenamiento adicionales.
Repositorio de contenido (CRX u Oak)
Impacto alto
A partir de la versión 6.1, AEM no es compatible con CRX2, por lo que una migración a
Oak (CRX3) es necesario si se actualiza desde una versión anterior. AEM 6.3 tiene
se ha implementado un nuevo almacén de nodos de segmento que también requiere una migración. La variable
la herramienta crx2oak se utiliza para este fin.
AEM componentes/contenido
Impacto moderado
/libs y /apps se gestionan fácilmente mediante la actualización, pero /etc generalmente requiere una reaplicación manual de las personalizaciones.
Servicios AEM
Impacto bajo
La mayoría de AEM servicios principales se prueban para actualizarse. Se trata de una zona de bajo impacto.
Servicios de aplicaciones personalizados
Impacto bajo a alto
Según la aplicación y la personalización, puede haber
dependencias en JVM, versiones de sistemas operativos y algunas relacionadas con la indexación
cambia, ya que los índices no se generan automáticamente en Oak.
Contenido de aplicación personalizado
Impacto bajo a alto
Se puede realizar una copia de seguridad del contenido que no se gestionará mediante la actualización
antes de que la actualización tenga lugar y luego se mueva de nuevo al repositorio.
La mayoría del contenido se puede administrar mediante la herramienta de migración.

Es importante asegurarse de que está ejecutando un sistema operativo compatible, Java runtime, httpd y Dispatcher version. Para obtener más información, consulte la AEM página de requisitos técnicos 6.4. La actualización de estos componentes debe incluirse en el plan del proyecto y realizarse antes de actualizar el AEM.

Fases del proyecto project-phases

Mucho trabajo se dedica a la planificación y ejecución de una actualización AEM. A fin de aclarar los diferentes esfuerzos que se realizan en este proceso, hemos desglosado los ejercicios de planificación y ejecución en fases separadas. En las secciones siguientes, cada fase resulta en un envío que a menudo se aprovecha en una fase futura del proyecto.

Planificación de la formación del autor planning-for-author-training

Con cualquier nueva versión, pueden introducirse cambios 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 negocio. Recomendamos revisar los cambios funcionales que se han introducido y organizar un plan para entrenar a los usuarios en cómo aprovecharlos de forma eficaz.

screen_shot_2018-04-04at121206

Las nuevas funciones de AEM 6.4 se encuentran en la sección AEM de adobe.com. Asegúrese de tener en cuenta los cambios realizados en las IU o en las funciones de los productos que se utilizan con frecuencia en su organización. A medida que revise las nuevas funciones, también tome nota de cualquier que pueda ser de valor para su organización. Después de revisar lo que ha cambiado en la AEM 6.4, desarrolle un plan de formación para sus autores. Esto podría implicar aprovechar los recursos libremente disponibles, como los vídeos de funciones de ayuda o la formación formal ofrecida a través de Servicios de aprendizaje digital de Adobe.

Creación de un plan de prueba creating-a-test-plan

La implementación de AEM por parte de cada cliente es única y se ha personalizado para satisfacer sus necesidades comerciales. 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 impulsará el proceso de control de calidad que realizamos en la instancia actualizada.

plan de prueba

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 sigan ejecutándose según lo desee. Debe recuperar toda la personalización y ejecutar 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 listos para usar que se aprovechan en sus operaciones diarias. Pueden incluir servicios y servlets OSGI personalizados, integraciones con Adobe Marketing 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 desde una versión anterior a AEM 6, cualquier consulta personalizada debe analizarse, ya que puede que sea necesario indexarlas. Para los clientes que ya están en una versión AEM 6.x, estas consultas deben probarse para garantizar que sus índices sigan funcionando de forma eficaz después de la actualización.

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

Al actualizar, 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 configuración del repositorio se necesite hardware adicional. Normalmente, esto solo aparece para los clientes que migran desde instancias anteriores a la 6.x, pero es importante tener en cuenta. Por último, es posible que se necesiten cambios en sus prácticas operacionales, incluidos procesos de monitoreo, mantenimiento y backup y recuperación ante desastres.

screen_shot_2018-04-04at120223

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

Monitorización y mantenimiento:

Tablero de operaciones

Prácticas recomendadas de supervisión de Assets

Monitorización de recursos del servidor utilizando la consola JMX

Limpieza de revisión

Backup/Restore y Recuperación ante Desastres:

Copia de seguridad y restauración

Rendimiento y escalabilidad

Ejecución de AEM con el modo de espera pasiva TarMK

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

AEM 6.4 ha introducido cambios en la estructura del repositorio que ayudarán a hacer las actualizaciones más fluidas. Los cambios implican mover contenido de la carpeta /etc a carpetas, incluidas /libs, /apps y /content, en función de si el Adobe o un cliente posee el contenido, lo que limita las posibilidades de sobrescribir contenido durante las versiones. La reestructuración de repositorios 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.4, aunque se recomienda revisar los detalles en Reestructuración de repositorios en AEM 6.4 mientras se planifica una actualización.

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

Debido a la gran variedad en la cantidad y naturaleza de las personalizaciones que nuestros clientes aplican a sus entornos AEM, es importante pasar un tiempo por delante para determinar el nivel general de esfuerzo que debería esperarse en su actualización.

Existen dos métodos que puede utilizar para evaluar la complejidad de la actualización: una fase preliminar solo puede utilizar el detector de patrones recién introducido, que está disponible para ejecutarse en las instancias 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 se espera utilizando los patrones notificados. El informe detector de patrones incluye patrones para identificar API no disponibles que están en uso en el código de base personalizado (esto se hizo usando comprobaciones de compatibilidad previas a la actualización en 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 de humo básicas. 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.4, es importante revisar las funciones obsoletas y eliminadas de AEM 6.3 además de las de AEM 6.4.

screen_shot_2018-04-04at120912

El detector de patrones introducido en la versión 6.4 debería ofrecerle una estimación bastante precisa de lo que cabe 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.4 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 elaborar 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.4. Cuando se combina con la variable Detección de patrones y los cambios de arquitectura que se determinaron en la sección anterior, se puede proporcionar una estimación aproximada al equipo de gestión del proyecto para planificar la actualización.

Creación del Runbook de actualización y reversión building-the-upgrade-and-rollback-runbook

Aunque Adobe ha documentado el proceso para actualizar una instancia de AEM, el diseño de red, la arquitectura de implementación y las personalizaciones de cada cliente requerirán un ajuste y una personalización precisos de este enfoque. Por este motivo, le recomendamos que revise toda la documentación que hemos proporcionado y la utilice para informar a un runbook específico del proyecto que describe 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.

diagrama de runbook

Hemos proporcionado procedimientos de actualización y reversión en Procedimiento de actualización así como instrucciones paso a paso para aplicar la actualización en Realización de una Actualización in situ. Estas instrucciones deben revisarse y tenerse en cuenta con la arquitectura del sistema, las personalizaciones y la tolerancia al tiempo de inactividad para determinar los procedimientos de conmutación y reversión adecuados que se van a ejecutar durante la actualización. Cualquier cambio en la arquitectura o en el tamaño del servidor debe incluirse al redactar el runbook personalizado. Es importante señalar que esto debería tratarse como un primer proyecto. A medida que su equipo complete sus ciclos de control de calidad y desarrollo e implemente la actualización al entorno de ensayo, es probable que se necesite realizar algunos pasos adicionales. Idealmente, este documento debería contener suficiente información para que, si se entregara a un miembro de su personal de operaciones, pudiera completar la actualización completamente a partir de la información contenida en él.

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

Podemos usar los resultados de ejercicios anteriores para construir un plan de proyecto que abarque los plazos esperados para nuestros esfuerzos de prueba o desarrollo, capacitación y ejecución real de la actualización.

plan del proyecto de desarrollo

Un plan general de proyectos debería incluir:

  • Finalización de los planes de desarrollo y ensayo

  • Actualización de entornos de desarrollo y control de calidad

  • Actualización de la base de código personalizado para AEM 6.4

  • Prueba de control de calidad y ciclo de corrección

  • Actualización del entorno de ensayo

  • Integración, rendimiento y pruebas de carga

  • Certificación de entorno

  • Go live

Realización de actividades de desarrollo y control de calidad performing-development-and-qa

Hemos proporcionado procedimientos para Actualización de código y personalizaciones para ser compatible con AEM 6.4. 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.4 información sobre cómo sus personalizaciones pueden permanecer compatibles con versiones anteriores en la mayoría de los casos sin requerir desarrollo inmediatamente después de la actualización.

screen_shot_2018-04-04at154829

El proceso de desarrollo y prueba suele ser iterativo. Debido a las personalizaciones, los cambios realizados durante la actualización podrían hacer que una sección entera del producto quede inutilizable. Una vez que los desarrolladores han abordado la causa principal del problema y el equipo de prueba tiene acceso para probar estas funciones, existe la posibilidad de que descubra problemas adicionales. A medida que se descubren problemas que requieren ajustes en el proceso de actualización, asegúrese de agregarlos 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

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

screen_shot_2018-04-04at120435

Este paso es vital, ya que es la única vez que puede validar los pasos del runbook con un entorno similar a una producción. Una vez actualizado el entorno, es importante permitir que los usuarios finales tengan tiempo de iniciar sesión y pasar por las actividades que realizan al utilizar el sistema en sus actividades diarias. No es inusual que los usuarios aprovechen una parte del sistema que no se había considerado anteriormente. Encontrar y corregir problemas en estas áreas antes de la entrada en funcionamiento puede ayudar a evitar costosas interrupciones 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 estuviéramos iniciando por primera vez.

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

Una vez que se ha recibido la aprobación final de todas las partes interesadas, es hora de ejecutar los procedimientos del runbook que se han definido. Hemos proporcionado los pasos para la actualización y la reversión en Procedimiento de actualización y los pasos de instalación en Realización de una Actualización in situ como punto de referencia.

perform-upgrade

Hemos proporcionado 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 también recomendamos validar con sus propios casos de prueba en función de sus procesos empresariales. También recomendamos comprobar el programa de limpieza de revisión en línea de AEM y las rutinas relacionadas para garantizar que se produzcan durante un tiempo silencioso para su empresa. Estas rutinas son esenciales para el desempeño a largo plazo de AEM.

recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56