Procédure de mise à niveau pour les installations de serveur d’applications (WLP) upgrade-steps-for-application-server-installations-wlp

Assurez-vous d’avoir effectué les étapes avant la mise à niveau telles que la sauvegarde du serveur AEM 6.5 avant d’effectuer toute activité de mise à niveau

Selon vos besoins, choisissez l’un des chemins de mise à niveau suivants :

1. Mise à niveau statique : si votre serveur WLP actuel prend en charge le servlet 6, vous pouvez effectuer une mise à niveau statique et passer à l’étape 3.
2. Sidegrade : si vous préférez une nouvelle configuration ou si votre serveur WLP ne prend pas en charge le servlet 6, configurez une nouvelle instance WLP avec AEM 6.5 LTS et migrez le contenu en suivant la Migration de contenu AEM 6.5 vers AEM 6.5 LTS à l’aide d’Oak-upgrade et passez à la section Déployer la base de code mise à niveau

Désactivez l’instance AEM. Cette opération peut généralement être effectuée à l’aide de la commande suivante :

<path-to-wlp-directory>/bin/server stop server_name

Supprimez les fichiers et les dossiers qui ne sont plus nécessaires. Les éléments à supprimer sont les suivants :

• Le fichier cq-quickstart-65.war du dossier dropins et du dossier expanded se trouvant généralement respectivement à l’emplacement <path-to-aem-server>/dropins/cq-quickstart-65.war et <path-to-aem-server>/apps/expanded/cq-quickstart-65.war

• Le dossier launchpad/startup. Vous pouvez le supprimer en exécutant la commande suivante dans le terminal , à condition que vous soyez dans le dossier du serveur :

  code language-shell
  rm -rf crx-quickstart/launchpad/startup

• Le fichier base.jar. Pour ce faire, exécutez les commandes suivantes :

  code language-shell
  find crx-quickstart/launchpad -type f -name "org.apache.sling.launchpad.base.jar*" -exec rm -f {} \;

• Fichier BootstrapCommandFile_timestamp.txt :

  code language-shell
  rm -f crx-quickstart/launchpad/felix/bundle0/BootstrapCommandFile_timestamp.txt

• Supprimez le fichier sling.options en exécutant :

  code language-shell
  find crx-quickstart/launchpad -type f -name "sling.options.file" -exec rm -rf {} \;

• Supprimez le fichier sling.bootstrap.txt :

  code language-shell
  rm -rf crx-quickstart/launchpad/sling_bootstrap.txt

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

Remplacez la version du servlet par 6.0 dans le fichier server.xml

Installez Java 17/Java 21 et assurez-vous qu’il est correctement installé en exécutant :

java -version

Vérifiez les paramètres de démarrage du serveur AEM et assurez-vous de mettre à jour les paramètres en fonction de vos besoins. Pour plus d’informations, consultez les Considérations relatives à Java 17/Java 21.

Téléchargez le nouveau fichier war LTS 6.5 et copiez-le dans le dossier dropins situé à l’adresse : /<path-to-aem-server>/dropins/

Démarrez l’instance AEM : vous pouvez généralement le faire à l’aide de la commande suivante :

<path-to-wlp-directory>/bin/server start server_name

Si vous disposez de modifications personnalisées dans sling.properties, suivez les instructions ci-dessous :

1. Arrêtez l’instance AEM en exécutant <path-to-wlp-directory>/bin/server stop server_name
2. Appliquez vos modifications de sling.properties personnalisées au fichier sling.properties nouvellement généré (en vous référant au fichier de sauvegarde créé à l’étape 5)
3. Démarrez l’instance AEM. Vous pouvez le faire généralement en exécutant : <path-to-wlp-directory>/bin/server start server_name