Realización de una actualización in situ

NOTA

Esta página describe el procedimiento de actualización para AEM 6.4. Si tiene una instalación implementada en un servidor de aplicaciones, consulte Pasos de actualización para instalaciones del servidor de aplicaciones.

Pasos previos a la actualización

Antes de ejecutar la actualización, hay que completar varios pasos. Consulte Actualización de código y personalizaciones y Tareas de mantenimiento previas a la actualización para obtener más información. Además, asegúrese de que su sistema cumpla los requisitos de la nueva versión de AEM. Consulte cómo Pattern Detector puede ayudarle a calcular la complejidad de la actualización y también consulte la sección Alcance de la actualización y Requisitos de Planificación de la actualización para obtener más información.

Requisitos previos de migración

  • Versión mínima requerida de Java: la herramienta de migración solo funciona con las versiones 7 y posteriores de Java. Tenga en cuenta que para AEM 6.3 y posteriores, JRE 8 de Oracle y JRE 7 y 8 de IBM son las únicas versiones compatibles.

  • Instancia actualizada: si está actualizando desde una versión anterior a la 5.6, asegúrese de haber realizado una actualización in situ a AEM 6.0 siguiendo el procedimiento descrito en la versión 6.0 de la documentación de actualización.

Preparación del archivo jar de inicio rápido AEM

  1. Detenga la instancia si se está ejecutando.

  2. Descargue el nuevo archivo jar de AEM y utilícelo para reemplazar el antiguo que está fuera de la carpeta crx-quickstart.

  3. Desempaquete el nuevo jar de inicio rápido ejecutando:

    java -Xmx4096m -jar aem-quickstart.jar -unpack
    

Migración del repositorio de contenido

Esta migración no es necesaria si actualiza desde AEM 6.3. Para versiones anteriores a la 6.3, Adobe proporciona una herramienta que se puede utilizar para migrar el repositorio a la nueva versión de Oak Segment Tar presente en la AEM 6.3. Se proporciona como parte del paquete de inicio rápido y es obligatoria para cualquier actualización que vaya a utilizar TarMK. Las actualizaciones para entornos que utilizan MongoMK no requieren la migración del repositorio. Para obtener más información sobre las ventajas del nuevo formato Tar de segmento, consulte las Preguntas frecuentes sobre la migración a Oak Segment Tar.

La migración real se realiza utilizando el archivo jar AEM inicio rápido estándar, ejecutado con una nueva opción -x crx2oak que ejecuta la herramienta crx2oak para simplificar la actualización y hacerla más robusta.

NOTA

Si está realizando la migración de contenido del repositorio TarMK mediante la extensión CRX2Oak Quickstart, puede quitar el modo de ejecución samplecontent añadiendo lo siguiente a la línea de comandos de migración:

  • --promote-runmode nosamplecontent

Para determinar el comando que debe ejecutar, utilice el siguiente comando:

java -Xmx4096m -jar aem-quickstart.jar -v -x crx2oak -xargs -- --load-profile <<YOUR_PROFILE>> <<ADDITIONAL_FLAGS>>

Donde <<YOUR_PROFILE>> y <<ADDITIONAL_FLAGS>> se sustituyen por el perfil y los indicadores enumerados en la siguiente tabla:

Repositorio de origen Repositorio de Target Perfil Indicadores adicionales
crx2 o TarMK con FileDataStore TarMK segment-fds Consulte la sección Resolución de problemas a continuación
crx2 MongoMK mongo-from-crx2 -T mongo-uri=mongo://mongo-host:mongo-port -T mongo-db=mongo-database-name
TarMK o crx2 con S3DataStore TarMK segment-custom-ds Consulte la sección Resolución de problemas a continuación
TarMK sin almacén de datos TarMK segment-no-ds
MongoMK MongoMK No es necesario realizar ninguna migración

Donde:

  • mongo-host es la IP del servidor MongoDB (por ejemplo, 127.0.0.1)

  • mongo-port es el puerto del servidor MongoDB (por ejemplo: 27017)

  • mongo-database-name representa el nombre de la base de datos (por ejemplo: aem-author)

También puede requerir conmutadores adicionales para los siguientes escenarios:

  • Si está realizando la actualización en un sistema Windows en el que la asignación de memoria Java no se administra correctamente, añada el parámetro --disable-mmap al comando.

  • Si utiliza Java 7, agregue el parámetro -XX:MaxPermSize=2048m justo después del parámetro -Xmx.

Para obtener instrucciones adicionales sobre el uso de la herramienta crx2oak, consulte Uso de la Herramienta de migración CRX2Oak. El JAR de ayuda de crx2oak se puede actualizar manualmente si es necesario, reemplazándolo manualmente con versiones más recientes después de desempaquetar el inicio rápido. Su ubicación en la carpeta de instalación de AEM es: <aem-install>/crx-quickstart/opt/extensions/crx2oak.jar. La versión más reciente de la herramienta de migración CRX2Oak está disponible para su descarga desde el Repositorio de Adobes en: https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/crx2oak/

Si la migración se ha completado correctamente, la herramienta se cerrará con un código de salida de cero. Además, compruebe los mensajes WARN y ERROR en el archivo upgrade.log, ubicado en crx-quickstart/logs en el directorio de instalación de AEM, ya que podrían indicar errores no mortales que se produjeron durante la migración.

Compruebe los archivos de configuración en la carpeta crx-quickstart/install. Si era necesaria una migración, se actualizarán para reflejar el repositorio de destino.

NOTA

Mientras que FileDataStore es el nuevo valor predeterminado para las instalaciones AEM 6.3, no es necesario usar un almacén de datos externo. Aunque se recomienda utilizar un almacén de datos externo como práctica recomendada para implementaciones de producción, no es un requisito previo para la actualización. Debido a la complejidad ya presente en la actualización de AEM, recomendamos realizar la actualización sin realizar una migración del almacén de datos. Si lo desea, se puede ejecutar posteriormente una migración del almacén de datos como un esfuerzo independiente.

Solución de problemas de migración

Por favor, omita esta sección si está actualizando desde la versión 6.3. Aunque los perfiles crx2oak proporcionados deben satisfacer las necesidades de la mayoría de los clientes, en ocasiones será necesario usar parámetros adicionales. Si se produce un error durante la migración, es posible que haya aspectos del entorno que requieran opciones de configuración adicionales. Si es así, es probable que encuentre el siguiente error:

Los puntos de comprobación no se copiarán, ya que no se ha especificado ningún almacén de datos externo. Esto resultará en la reindexación completa del repositorio en el primer inicio. Utilice —skip-checkpoints para forzar la migración o consulte https://jackrabbit.apache.org/oak/docs/migration.html#Checkpoints_migration para obtener más información.

Por alguna razón, el proceso de migración necesita acceder a los binarios en el almacén de datos y no puede encontrarlo. Para especificar la configuración del almacén de datos, incluya los siguientes indicadores en la parte <<ADDITIONAL_FLAGS>> del comando de migración:

Para los almacenes de datos S3:

--src-s3config=/path/to/SharedS3DataStore.config --src-s3datastore=/path/to/datastore

Donde /path/to/SharedS3DataStore.config representa la ruta al archivo de configuración del almacén de datos S3 y /path/to/datastore representa la ruta al almacén de datos S3.

Para los almacenes de datos de archivos:

--src-datastore=/path/to/datastore

Donde /path/to/datastore representa la ruta al almacén de datos del archivo.

Realización De La Actualización

Si utiliza S3:

  1. Elimine los tarros debajo de crx-quickstart/install asociados con una versión anterior del conector S3.

  2. Descargue la última versión del conector 1.8.x S3 desde https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/com.adobe.granite.oak.s3connector/

  3. Extraiga el paquete en una carpeta temporal y copie el contenido de jcr_root/libs/system/install en la carpeta crx-quickstart/install.

Determinación del comando correcto de inicio de la actualización

Para ejecutar la actualización, es importante comenzar AEM utilizar el archivo jar para que aparezca la instancia. Para actualizar a la versión 6.4, consulte también otras opciones de migración y reestructuración de contenido en Migración de contenido diferido que puede elegir con el comando de actualización.

Tenga en cuenta que iniciar AEM desde el script de inicio no iniciará la actualización. La mayoría de los clientes empiezan AEM usando el script de inicio y han personalizado este script de inicio para incluir conmutadores para configuraciones de entorno como configuración de memoria, certificados de seguridad, etc. Por este motivo, recomendamos seguir este procedimiento para determinar el comando de actualización adecuado:

  1. En una instancia de AEM en ejecución, ejecute lo siguiente desde la línea de comandos:

    ps -ef | grep java
    
  2. Busque el proceso de AEM. Se parecerá a:

    /usr/bin/java -server -Xmx1024m -XX:MaxPermSize=256M -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar crx-quickstart/app/cq-quickstart-6.2.0-standalone-quickstart.jar start -c crx-quickstart -i launchpad -p 4502 -Dsling.properties=conf/sling.properties
    
  3. Modifique el comando reemplazando la ruta al jar existente ( crx-quickstart/app/aem-quickstart*.jar en este caso) con el nuevo jar que es un elemento secundario de la carpeta crx-quickstart. Con nuestro comando anterior como ejemplo, nuestro comando sería:

    /usr/bin/java -server -Xmx1024m -XX:MaxPermSize=256M -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar cq-quickstart-6.4.0.jar -c crx-quickstart -p 4502 -Dsling.properties=conf/sling.properties
    

    Esto asegurará que se apliquen todos los parámetros de memoria adecuados, modos de ejecución personalizados y otros parámetros ambientales para la actualización. Una vez finalizada la actualización, la instancia puede iniciarse desde el script de inicio en futuras iniciaciones.

Implementar base de código actualizada

Una vez completado el proceso de actualización in situ, se debe implementar la base de código actualizada. Los pasos para actualizar el código base para que funcione en la versión de destino de AEM se encuentran en la página Actualización de código y personalizaciones.

Realizar comprobaciones y resolución de problemas posteriores a la actualización

Consulte Comprobaciones posteriores a la actualización y resolución de problemas.

En esta página

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now