Show Menu
TEMAS×

Realización de una actualización in situ

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 de Application Server.

Pasos previos a la actualización

Antes de ejecutar la actualización, deben realizarse 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 el sistema cumple los requisitos de la nueva versión de AEM. Vea cómo el Detector de patrones puede ayudarle a estimar la complejidad de la actualización y también consulte la sección Alcance de 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 versiones posteriores, JRE 8 de Oracle y JRE 7 y 8 de IBM son las únicas versiones admitidas.
  • ​Instancia actualizada: Si va a realizar la actualización 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 de AEM

  1. Detenga la instancia si se está ejecutando.
  2. Descargue el nuevo archivo AEM jar y úselo para reemplazar el antiguo que se encuentra fuera de la crx-quickstart carpeta.
  3. Desempaca el nuevo frasco de arranque rápido ejecutando:
    java -Xmx4096m -jar aem-quickstart.jar -unpack
    
    

Migración del repositorio de contenido

Esta migración no es necesaria si está actualizando desde AEM 6.3. Para las versiones anteriores a la 6.3, Adobe proporciona una herramienta que se puede utilizar para migrar el repositorio a la nueva versión de la barra de segmentos Oak presente en AEM 6.3. Se proporciona como parte del paquete de inicio rápido y es obligatorio para cualquier actualización que vaya a utilizar TarMK. Las actualizaciones para entornos que utilizan MongoMK no requieren migración de repositorio. For more information on what the benefits of the new Segment Tar format are, see the Migrating to Oak Segment Tar FAQ .
La migración real se realiza utilizando el archivo jar AEM de inicio rápido estándar, ejecutado con una nueva -x crx2oak opción que ejecuta la herramienta crx2oak para simplificar la actualización y hacerla más robusta.
Si está realizando la migración de contenido del repositorio TarMK con la extensión CRX2Oak Quickstart, puede quitar el modo de ejecución de contenido de muestra agregando 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 tabla siguiente:
Repositorio de origen Repositorio de objetivos Perfil Indicadores adicionales
crx2 o TarMK con FileDataStore TarMK segment-fds Consulte la sección Resolución de problemas más abajo
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 más abajo
TarMK sin almacén de datos TarMK segment-no-ds
MongoMK MongoMK No se necesita 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: 27 de noviembre de 2017)
  • 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 gestiona correctamente, agregue el --disable-mmap parámetro al comando.
  • Si utiliza Java 7, agregue el -XX:MaxPermSize=2048m parámetro justo después del -Xmx parámetro.
Para obtener instrucciones adicionales sobre el uso de la herramienta crx2oak, consulte Uso de la herramienta de migración CRX2Oak. El JAR de ayuda crx2oak se puede actualizar manualmente si es necesario, reemplazándolo manualmente por versiones más nuevas 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 se puede descargar del repositorio de Adobe 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 si hay mensajes WARN y ERROR en el upgrade.log archivo, ubicado crx-quickstart/logs en el directorio de instalación de AEM, ya que podrían indicar errores no fatales que se produjeron durante la migración.
Compruebe los archivos de configuración debajo de la crx-quickstart/install carpeta. Si fuera necesaria una migración, se actualizarán para reflejar el repositorio de destino.
Aunque FileDataStore es el nuevo valor predeterminado para las instalaciones de AEM 6.3, no es necesario utilizar 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 que ya existe en la actualización de AEM, recomendamos realizar la actualización sin realizar una migración al almacén de datos. Si lo desea, la migración del almacén de datos se puede ejecutar posteriormente como un esfuerzo independiente.

Solución de problemas de migración

Si está actualizando desde la versión 6.3, omita esta sección. Aunque los perfiles crx2oak proporcionados deben satisfacer las necesidades de la mayoría de los clientes, en ocasiones se necesitarán parámetros adicionales. Si se produce un error durante la migración, es posible que haya aspectos de su entorno que requieran opciones de configuración adicionales. Si es así, probablemente se producirá el siguiente error:
No se copiarán los puntos de comprobación porque no se especificó ningún almacén de datos externo. Esto resultará en la reindexación completa del repositorio en el primer inicio. Use —Skicheckpoints 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 encontrarlos. Para especificar la configuración del almacén de datos, incluya los siguientes indicadores en la <<ADDITIONAL_FLAGS>> parte del comando de migración:
Para almacenes de datos S3:
--src-s3config=/path/to/SharedS3DataStore.config --src-s3datastore=/path/to/datastore

Donde /path/to/SharedS3DataStore.config representa la ruta de acceso al archivo de configuración del almacén de datos S3 y /path/to/datastore representa la ruta de acceso al almacén de datos S3.
Para almacenes de datos de archivos:
--src-datastore=/path/to/datastore

Donde /path/to/datastore representa la ruta de acceso al almacén de datos de archivos.

Realización De La Actualización

Si utiliza S3:
  1. Retire los vástagos que haya debajo crx-quickstart/install de una versión anterior del conector S3.
  2. Extraiga el paquete en una carpeta temporal y copie el contenido de jcr_root/libs/system/install en la crx-quickstart/install carpeta.

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

Para ejecutar la actualización, es importante iniciar AEM utilizando el archivo jar para que se muestre 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 Migración de contenido diferido de contenido diferido que puede elegir con el comando upgrade.
Tenga en cuenta que iniciar AEM desde el script de inicio no iniciará la actualización. La mayoría de los clientes inician AEM utilizando 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 correcto:
  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 verá como:
    /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 de acceso al tarro existente ( crx-quickstart/app/aem-quickstart*.jar en este caso) por el nuevo tarro que es un elemento secundario de la crx-quickstart carpeta. Usando 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 garantizará que se apliquen todos los parámetros de memoria adecuados, los modos de ejecución personalizados y otros parámetros ambientales para la actualización. Una vez completada la actualización, la instancia puede iniciarse desde la secuencia de comandos de inicio en futuras inicios.

Implementar base de código actualizada

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

Realizar comprobaciones posteriores a la actualización y solucionar problemas