Comment déboguer une application AEM à l’aide d’Eclipse

Dernière mise à jour : 2023-11-16

Pour déboguer une application AEM, vous pouvez utiliser Débogage à distance Java.

Description

Environnement

  • Adobe Experience Manager (AEM) 6.4
  • Adobe Experience Manager (AEM) 6.5

Problèmes/symptômes

Comment déboguer une application s’exécutant sur un serveur d’AEM distant (ou local) ?

Résolution

Pour déboguer une application AEM, vous pouvez utiliser Débogage à distance Java.

Avertissement : N’activez pas le débogage à distance dans votre environnement de production, sauf si cela est nécessaire, car cela pourrait affecter considérablement les performances de votre application.

Étape 1 : Ajout du paramètre JVM de débogage à distance

Pour utiliser le débogage à distance, vous devez commencer AEM avec ce paramètre JVM :
-agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n

Vous pouvez ajouter le paramètre en effectuant l’une des opérations suivantes :

  • Ajoutez-le à votre crx-quickstart/bin/start script CQ_JVM_OPTS Variable d’environnement (de sorte que votre serveur démarre toujours en mode de débogage).
  • l’inclure en tant que paramètre lors du démarrage d’AEM avec java -jar directement. Par exemple, java -Xmx512m -agentlib:jdwp=transport=dt_socket,address=8000,server=y,suspend=n -jar cq-author-4502.jar

Notes

  • Au besoin, vous pouvez modifier le port défini sous "…address=8000,…" de 8000 à quelque chose qui fonctionne mieux dans votre environnement.
  • Si vous remarquez qu’il ne fonctionne pas, évitez de dupliquer le processus java en spécifiant l’option de ligne de commande -nofork .
  • Le script de démarrage se trouve sous crx-quickstart/bin

Étape 2 : démarrage d’une session de débogage à distance

Pour démarrer une session de débogage à distance à partir d’Eclipse, procédez comme suit :

  1. Ouvrez Eclipse.
  2. Choisir Exécuter >  Déboguer les configurations.
  3. Cliquez avec le bouton droit de la souris sur Applications Java distantes et sélectionnez Nouveau.
  4. Sélectionnez votre projet AEM sous Projet.
  5. Saisissez dans le port la configuration "address" du paramètre jvm défini ci-dessus. Dans l’exemple, il s’agit du port 8000 (et du nom d’hôte de la machine à laquelle vous vous connectez, probablement localhost).
  6. Pour démarrer une session de débogage, double-cliquez sur votre nouvelle configuration dans l’écran Configurations de débogage après l’avoir enregistré.

Sur cette page