Realización de una actualización in situ performing-an-in-place-upgrade
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
-
Descargue el nuevo archivo jar AEM 6.5 LTS
-
Detenga la instancia si se está ejecutando
-
Utilice el nuevo JAR de AEM 6.5 LTS para reemplazar el anterior fuera de la carpeta
crx-quickstart
-
Realice una copia de seguridad del archivo
sling.properties
(normalmente presente encrx-quickstart/conf/
) y elimínelo -
Desempaquete el nuevo JAR de inicio rápido ejecutando:
code language-shell java -Xmx4096m -jar aem-quickstart.jar -unpack
-
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:
-
Elimine cualquier JAR por debajo de
crx-quickstart/install
asociado con una versión anterior del conector S3. -
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/
-
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:- Copiar
com.adobe.granite.oak.s3connector-1.60.2/jcr_root/libs/system/install/1
encrx-quickstart/install/1
- Copiar
com.adobe.granite.oak.s3connector-1.60.2/jcr_root/libs/system/install/15
encrx-quickstart/install/15
- Copiar
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
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:
-
En una instancia de AEM en ejecución, ejecute lo siguiente desde la línea de comandos:
code language-shell ps -ef | grep java
-
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
-
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 carpetacrx-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.