DocumentationAEM 6.5 LTSGuide de l’utilisateur

Effectuer une mise à niveau statique performing-an-in-place-upgrade

Last update: Wed Sep 24 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • S'applique à :
  • Experience Manager 6.5 LTS
  • Rubriques :

Créé pour :

  • Administration
NOTE
Cette page décrit la procédure de mise à niveau sur place pour AEM 6.5 LTS. Si vous disposez d’une installation déployée sur un serveur d’applications, voir Procédure de mise à niveau pour les installations de serveur d’applications.

É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 sur la manière dont Analyzer peut vous aider à estimer la complexité.

Conditions préalables à la migration migration-prerequisites

  • Version Java minimale requise : Vérifiez qu’Oracle Java™ 17/21 est installé sur votre système.

Préparation du fichier jar de démarrage rapide AEM prep-quickstart-file

  1. Téléchargez le nouveau fichier JAR LTS d’AEM 6.5

  2. Détermination de la commande de démarrage de mise à niveau appropriée

  3. Arrêter l’instance si elle est en cours d’exécution

  4. Utilisez le nouveau fichier jar LTS AEM 6.5 pour remplacer l’ancien en dehors du dossier crx-quickstart

  5. Effectuez une sauvegarde du fichier sling.properties (généralement présent dans le crx-quickstart/conf/), puis supprimez-le

  6. Décompressez le nouveau fichier jar de démarrage rapide en exécutant :

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

  7. Si le fichier sling.properties personnalisé doit être appliqué, créez une nouvelle instance AEM locale et récupérez le fichier sling.properties dans son répertoire crx-quickstart/conf. Appliquez les modifications personnalisées requises à ce fichier, puis copiez-le dans le répertoire crx-quickstart/conf de l’instance AEM mise à niveau. S’il n’existe aucune propriété personnalisée, cette étape peut être ignorée.

Exécution de la mise à niveau performing-the-upgrade

Si vous utilisez S3 :

  1. Supprimez les fichiers JAR sous crx-quickstart/install associés à une version antérieure du connecteur S3.

  2. Téléchargez la dernière version du connecteur S3 1.60.2 à partir de https://repo1.maven.org/maven2/com/adobe/granite/com.adobe.granite.oak.s3connector/

  3. Extrayez le connecteur S3 (version 1.60.2) et copiez le contenu des dossiers suivants sous crx-quickstart/install, comme suit :

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

Démarrez à présent l’instance AEM à l’aide de la nouvelle commande déterminée à l’aide des informations de la section Détermination de la commande de démarrage de mise à niveau appropriée.

Détermination de la commande de démarrage de mise à niveau appropriée determining-the-correct-upgrade-start-command

NOTE
La prise en charge de certains arguments Java 8/11 a été supprimée dans Java 17/21, voir Documents Oracle Java™ 17, Documents Oracle Java™ 21 et Considérations relatives aux arguments Java&trade pour AEM 6.5 LTS.

Pour exécuter la mise à niveau, il est important de démarrer AEM à l’aide du fichier jar pour afficher l’instance.

Notez que le démarrage d’AEM à partir du script de démarrage ne lance pas la mise à niveau. La plupart des clientes et clients démarre AEM à l’aide du script de démarrage et ont personnalisé ce script de démarrage pour inclure des commutateurs pour les configurations d’environnement telles que les paramètres de mémoire, les certificats de sécurité, etc. Pour cette raison, Adobe recommande de suivre cette procédure pour déterminer la commande de mise à niveau appropriée :

  1. Sur une instance d’AEM en cours d’exécution, exécutez les opérations ci-dessous dans une ligne de commande :

    code language-shell 
    ps -ef | grep java

  2. Recherchez le processus AEM. Le code se présente comme suit :

    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. Modifiez la commande en remplaçant le chemin d’accès dans le fichier jar existant ( crx-quickstart/app/aem-quickstart*.jar dans ce cas) par le nouveau fichier jar LTS d’AEM 6.5 qui est un frère du dossier crx-quickstart. Avec la commande précédente comme exemple, la commande serait la suivante :

    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

    Cela permet de s’assurer que tous les paramètres de mémoire appropriés, les modes d’exécution personnalisés et d’autres paramètres d’environnement sont appliqués pour la mise à niveau. Une fois la mise à niveau terminée, l’instance peut être lancée à partir du script de démarrage lors des prochains lancements.

Déployer le base de code mise à niveau deploy-upgraded-codebase

Une fois la mise à niveau statique terminée, la base de code mise à niveau 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 les vérifications et le dépannage après la mise à niveau perform-post-upgrade-check-troubleshooting

Voir Vérifications et dépannage après une mise à niveau.

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