Realización de una actualización in situ performing-an-in-place-upgrade

NOTE
AEM Esta página describe el procedimiento de actualización para la versión 6.5 de la versión de. 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 pre-upgrade-steps

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

Requisitos previos de migración migration-prerequisites

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

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

AEM Preparación del archivo jar de Quickstart de prep-quickstart-file

  1. Detenga la instancia si se está ejecutando.

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

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

    code language-shell
    java -Xmx4096m -jar aem-quickstart.jar -unpack
    

Migración del repositorio de contenido content-repository-migration

AEM Esta migración no es necesaria si actualiza desde la versión 6.3 de la versión de. En el caso de las versiones anteriores a la 6.3, el Adobe AEM proporciona una herramienta que se puede utilizar para migrar el repositorio a la nueva versión de Oak Segment TAR presente en la versión 6.3 de. Se proporciona como parte del paquete de inicio rápido y es obligatorio para cualquier actualización que utilice 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 de Segment TAR, consulte la Preguntas frecuentes sobre la migración a Oak Segment Tar.

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

NOTE
Si está realizando una migración de contenido del repositorio TarMK mediante la extensión de inicio rápido CRX2Oak, puede quitar la variable samplecontent runmode 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 que figuran en la tabla siguiente:

Repositorio de origen
Repositorio de destino
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 necesaria 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 es posible que necesite modificadores adicionales para los siguientes casos:

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

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 por versiones más nuevas después de desempaquetar el inicio rápido. AEM Su ubicación en la carpeta de instalación de la 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 en el Repositorio de Adobe en: https://repo1.maven.org/maven2/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 upgrade.log archivo, ubicado bajo crx-quickstart/logs AEM en el directorio de instalación de la, ya que esto podría indicar errores no graves que se produjeron durante la migración.

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

Una nota sobre los almacenes de datos:

While FileDataStore AEM es el nuevo valor predeterminado para instalaciones de 6.3; no se requiere el uso de 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. AEM Debido a la complejidad que ya existe en la actualización de los datos, Adobe recomienda 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 troubleshooting-migration-issues

Omita esta sección si actualiza desde la versión 6.3. Aunque los perfiles crx2oak proporcionados deben satisfacer las necesidades de la mayoría de los clientes, hay momentos en que se necesitarán parámetros adicionales. Si se produce un error durante la migración, es posible que haya aspectos del entorno que requieran que se proporcionen opciones de configuración adicionales. Si es así, es probable que se produzca el siguiente error:

Los puntos de comprobación no se copian porque no se ha especificado ningún almacén de datos externo. Esto conllevará 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 del almacén de datos y no puede encontrarlo. 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 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 almacenes de datos de archivos:

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

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

Realización De La Actualización performing-the-upgrade

Si se usa S3:

  1. Elimine los tarros que haya debajo crx-quickstart/install asociado a una versión anterior del conector S3.

  2. Descargue la última versión del conector S3 1.10.x desde https://repo1.maven.org/maven2/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 a la crx-quickstart/install carpeta.

Determinar el comando de inicio de actualización correcto determining-the-correct-upgrade-start-command

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

IMPORTANT
Si está ejecutando Java 11 de Oracle AEM (o, por lo general, versiones de Java más recientes que la 8), se deben agregar modificadores adicionales a la línea de comandos al iniciar la ejecución de un comando de. Para obtener más información, consulte Consideraciones sobre Java 11.

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

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

    code language-shell
    ps -ef | grep java
    
  2. AEM Busque el proceso de. Se verá algo así como:

    code language-shell
    /usr/bin/java -server -Xmx1024m -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar crx-quickstart/app/cq-quickstart-6.5.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 frasco que es un hermano del crx-quickstart carpeta. Utilizando nuestro comando anterior como ejemplo, nuestro comando sería:

    code language-shell
    /usr/bin/java -server -Xmx1024m -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar cq-quickstart-6.5.0.jar -c crx-quickstart -p 4502 -Dsling.properties=conf/sling.properties
    

    Esto garantizará que se apliquen todos los ajustes 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 se puede iniciar desde el script de inicio en futuros inicios.

Implementar base de código actualizada deploy-upgraded-codebase

Una vez completado el proceso de actualización in situ, se debe implementar la base de código actualizada. AEM Los pasos para actualizar el código base para que funcione en la versión de destino de la aplicación se pueden encontrar en la siguiente sección: Página Actualizar código y personalizaciones.

Realizar comprobaciones posteriores a la actualización y solucionar problemas perform-post-upgrade-check-troubleshooting

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

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