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

NOTE
Esta página describe el procedimiento de actualización in situ para AEM 6.5 LTS. 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 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 AEM 6.5 LTS y vea las consideraciones sobre la planificación de la actualización y cómo Analyzer puede ayudarle a calcular la complejidad.

Requisitos previos de migración migration-prerequisites

  • Versión mínima de Java requerida: Asegúrese de que tiene Java™ 17/21 de Oracle instalado en el sistema.

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

  1. Descargue el nuevo archivo jar AEM 6.5 LTS

  2. Determinar el comando de inicio de actualización correcto

  3. Detenga la instancia si se está ejecutando

  4. Utilice el nuevo JAR de AEM 6.5 LTS para reemplazar el anterior fuera de la carpeta crx-quickstart

  5. Realice una copia de seguridad del archivo sling.properties (normalmente presente en crx-quickstart/conf/) y elimínelo

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

    code language-shell
    java -Xmx4096m -jar aem-quickstart.jar -unpack
    
  7. Si es necesario aplicar sling.properties personalizado, cree una nueva instancia local de AEM y recupere el archivo sling.properties de su directorio crx-quickstart/conf. Aplique los cambios personalizados necesarios a este archivo y, a continuación, cópielo en el directorio crx-quickstart/conf de la instancia de AEM que se está actualizando. Si no hay propiedades personalizadas, este paso se puede omitir.

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

Si se usa S3:

  1. Elimine cualquier JAR por debajo de crx-quickstart/install asociado con una versión anterior del conector S3.

  2. Descargue la última versión del conector 1.60.2 S3 desde https://repo1.maven.org/maven2/com/adobe/granite/com.adobe.granite.oak.s3connector/

  3. Extraiga el conector S3 (versión 1.60.2) y copie el contenido de las siguientes carpetas en crx-quickstart/install, de la siguiente manera:

    1. Copiar com.adobe.granite.oak.s3connector-1.60.2/jcr_root/libs/system/install/1 en crx-quickstart/install/1
    2. Copiar com.adobe.granite.oak.s3connector-1.60.2/jcr_root/libs/system/install/15 en crx-quickstart/install/15

Ahora, inicie la instancia de AEM con el nuevo comando determinado mediante la información de la sección Determinación del comando de inicio de actualización correcto.

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

NOTE
La compatibilidad con algunos argumentos de Java 8/11 se ha eliminado en Java 17/21. Consulte Documentos de Oracle Java™ 17, Documentos de Oracle Java™ 21 y Consideraciones sobre los argumentos de Java&trade para AEM 6.5 LTS.

Para ejecutar la actualización, es importante iniciar AEM con el archivo jar para que se muestre la instancia.

Tenga en cuenta que iniciar AEM desde el script de inicio no iniciará la actualización. La mayoría de los clientes inician AEM con 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. En una instancia de AEM en ejecución, ejecute lo siguiente desde la línea de comandos:

    code language-shell
    ps -ef | grep java
    
  2. Busque el proceso de AEM. 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 jar AEM 6.5 LTS que es secundario de la carpeta crx-quickstart. Utilizando nuestro comando anterior como ejemplo, nuestro comando sería:

    code language-shell
    /usr/bin/java -server -Xmx4096m -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar <AEM-6.5-LTS.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. Los pasos para actualizar el código base para que funcione en la versión de destino de AEM se encuentran en Página de actualización de código y personalizaciones.

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

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

recommendation-more-help
51c6a92d-a39d-46d7-8e3e-2db9a31c06a2