Étapes de mise à niveau pour les installations de serveur d’applications (Tomcat) upgrade-steps-for-application-server-installations-tomcat
Étapes préalables à la mise à niveau pre-upgrade-steps
Avant d’exécuter votre mise à niveau, plusieurs étapes doivent être réalisées. Voir Mise à niveau du code et des personnalisations et Tâches de maintenance avant la mise à niveau pour plus d’informations. En outre, assurez-vous que votre système répond à la configuration requise pour AEM 6.5 LTS, consultez les considérations relatives à la planification de la mise à niveau et comment Analyzer peut vous aider à estimer la complexité.
Conditions préalables à la migration migration-prerequisites
- Version Java minimale requise : assurez-vous d’avoir installé Oracle® JRE 17/21 sur votre serveur Tomcat.
- Serveur Tomcat : les versions prises en charge du serveur Tomcat pour AEM 6.5 LTS sont 10.0.x et 10.1.x.
Exécuter la mise à niveau performing-the-upgrade
Tous les exemples de cette procédure utilisent Tomcat comme serveur d’applications et présument que vous disposez d’une version de travail d’AEM déjà déployée. La procédure est destinée à documenter les mises à niveau d’AEM version 6.5 vers 6.5 LTS.
-
Si AEM 6.5 est déjà déployé, vérifiez que les lots fonctionnent correctement en accédant à :
https://<serveraddress:port>/system/console/bundles -
Ensuite, arrêtez AEM 6.5. Pour ce faire, utilisez Tomcat App Manager à l’adresse :
https://<serveraddress:port>/manager/html -
Assurez-vous d’avoir terminé les activités pré-mise à niveau telles que la sauvegarde du serveur AEM 6.5 avant d’effectuer toute activité de mise à niveau
-
Installez Java 17/Java 21 et assurez-vous qu’il est correctement installé en exécutant la commande :
code language-none java –version -
Configuration d’un serveur Tomcat compatible avec AEM 6.5 LTS
-
Vérifiez les paramètres de démarrage du serveur AEM et assurez-vous de les mettre à jour en fonction de la configuration requise. Voir Considérations relatives à Java 17/Java 21 pour plus d’informations
-
Déployez le fichier war 6.5 LTS récemment téléchargé sur le serveur Tomcat à l’aide de Java 17/Java 21 et démarrez le serveur Tomcat 6.5 LTS AEM en exécutant :
code language-none $CATALINA_HOME/bin/catalina.sh start -
Une fois AEM en cours d’exécution, assurez-vous que tous les lots sont en cours d’exécution en accédant à :
https://<serveraddress:port>/cq/system/console/bundles -
Arrêtez le serveur Tomcat LTS AEM 6.5 . Dans la plupart des cas, vous pouvez le faire en exécutant le script
./catalina.sh, en exécutant cette commande à partir du terminal :code language-none $CATALINA_HOME/bin/catalina.sh stop -
À présent, migrez votre contenu d’AEM 6.5 vers AEM 6.5 LTS en suivant les étapes ci-dessous : Migration de contenu AEM 6.5 vers AEM 6.5 LTS à l’aide de la mise à niveau d’Oak
-
Une fois le contenu migré, appliquez les modifications personnalisées requises dans le fichier
sling.properties -
Démarrez le serveur Tomcat LTS AEM 6.5 en exécutant :
code language-none $CATALINA_HOME/bin/catalina.sh start -
Surveillez les journaux d’erreurs pendant le démarrage d’AEM pour vérifier qu’il n’y a aucune erreur et qu’AEM s’exécute correctement
-
Une fois AEM 6.5 LTS démarré, vérifiez que les lots fonctionnent correctement en accédant à :
https://<serveraddress:port>/cq/system/console/bundles
Déployer le base de code mise à niveau deploy-upgraded-codebase
Une fois le processus de mise à niveau terminé, la base de code mise à jour doit être déployée. La procédure de mise à jour de la base de code pour qu’elle fonctionne dans la version cible d’AEM est disponible dans la page Mise à niveau du code et personnalisations.
Effectuer Des Vérifications Et Un Dépannage Après La Mise À Niveau perform-post-upgrade-checks-and-troubleshooting
Voir Vérifications et dépannage après la mise à niveau pour plus d’informations.