Comment déboguer une application AEM à l’aide d’Eclipse
Pour déboguer une application AEM, vous pouvez utiliser le débogage à distance Java.
Description 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 resolution
Pour déboguer une application AEM, vous pouvez utiliser le 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 à la variable d'environnement
crx-quickstart/bin/startscriptCQ_JVM_OPTS(de sorte que votre serveur démarre toujours en mode de débogage). - Incluez-le comme paramètre lorsque vous commencez AEM directement avec
java -jar. 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 :
- Ouvrez Eclipse.
- Sélectionnez Exécuter
>Déboguer les configurations. - Cliquez avec le bouton droit de la souris sur Applications Java distantes et sélectionnez Nouveau.
- Sélectionnez votre projet AEM sous Projet.
- 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).
- 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é.