Débogage de programmes Java distants

La présente documentation explique comment déboguer des programmes Java sur un serveur distant. Cette fonction s'applique aux programmes stockés sur un serveur distant POWER Linux ou AIX. Vous disposez de deux méthodes pour déboguer une application distante. La première méthode est une procédure simple comportant une seule étape et acceptant toutes les valeurs par défaut pour l'application distante. La seconde méthode permet d'indiquer des variables et des paramètres supplémentaires en utilisant une configuration de lancement personnalisée.

Pour consulter une présentation du débogage et des configurations de lancement, voir Remote debugging, and choosing the right debugger.

Méthode 1 : Pour accepter les valeurs par défaut définies pour l'application, procédez comme suit :

  1. Dans la vue Systèmes distants, affichez tous les dossiers et les fichiers jusqu'à ce que vous localisiez le fichier de classe Java exécutable à déboguer.
  2. Cliquez avec le bouton droit de la souris sur le fichier et sélectionnez Débogage > Application Java hôte.

Méthode 2 : Pour indiquer des variables et des paramètres supplémentaires, procédez comme suit :

  1. Dans la vue Systèmes distants, affichez tous les dossiers et les fichiers jusqu'à ce que vous localisiez le fichier de classe Java exécutable à déboguer.
  2. Cliquez avec le bouton droit de la souris sur le fichier et sélectionnez Débogage > Application Java hôte pour ouvrir la boîte de dialogue de configuration de lancement et effectuer le débogage à distance.
  3. Dans la zone Nom, entrez le nom d'une nouvelle configuration, par exemple Débogage Java.
  4. Si vous disposez d'un projet local associé à des fichiers Java, cochez la case Est associé à un projet Java. Cliquez sur Parcourir pour accéder au dossier local contenant tous les fichiers Java.
  5. Dans la zone Classe principale, indiquez la classe Java principale si cette zone ne contient pas encore de valeur.
  6. Dans la zone Répertoire de travail distant, indiquez le répertoire du serveur distant où vous souhaitez exécuter le débogage.
  7. Cliquez sur l'onglet Arguments. Entrez les arguments de programme ou de machine virtuelle Java nécessaires et cliquez sur Appliquer.
  8. Cliquez sur l'onglet Chemin de classe. Cliquez sur Ajouter pour indiquer un nouveau chemin de classe. Vous pouvez sélectionner plusieurs éléments lorsque vous recherchez des fichiers. Cliquez sur Appliquer.
  9. Cliquez sur l'onglet Environnement. Cliquez sur Nouveau pour ajouter des variables d'environnement, si nécessaire.
  10. Cliquez sur l'onglet Source. Cet onglet permet d'indiquer l'emplacement source distant à déboguer. Par défaut, cet emplacement correspond au répertoire de travail distant indiqué dans l'onglet Principal. Cliquez sur Ajouter pour indiquer d'autres emplacements source distants.
    1. La boîte de dialogue Ajout d'un type de source s'affiche. Elle permet d'indiquer les types d'emplacement source distant à déboguer. Sélectionnez Dossier distant pour des fichiers de classe ou des fichiers Java distants ou Archive distante pour un fichier d'archive, tel qu'un fichier JAR. Cliquez sur OK.

    2. Dans la boîte de dialogue Recherche de dossier, accédez aux connexions affichées pour rechercher l'emplacement source distant de votre code Java. Vous pouvez lancer la recherche sur plusieurs serveurs pour indiquer des fichiers de classe stockés dans plusieurs emplacements. Cette fonction est utile si les fichiers de classe ne sont pas disponibles lors de l'exécution et que vous devez indiquer un emplacement différent.
    3. Sélectionnez le dossier qui contient l'emplacement source Java et cliquez sur OK.
    4. L'emplacement du serveur distant apparaît désormais dans l'onglet Source, sous le chemin de recherche de source. Cette procédure vous permettra d'indiquer d'autres emplacements source distants à l'avenir. Par défaut, le système utilise le premier emplacement source trouvé pour effectuer le débogage. Si vous souhaitez lancer une recherche dans tous les emplacements source en double, cochez la case Rechercher les fichiers source en double dans le chemin. Lors de la session de débogage, le système vous invite à sélectionner le fichier source à utiliser dans la liste des fichiers source en double. Cliquez sur Appliquer.
  11. Cliquez sur l'onglet Avancé. Vous pouvez indiquer le port hôte à utiliser pour le débogage Java à distance. En général, le débogueur détecte automatiquement un port disponible.
  12. Cliquez sur l'onglet Commun pour définir des propriétés supplémentaires dans la configuration :
    1. Utilisez les boutons pour indiquer si cette configuration doit être disponible en local dans l'instance du plan de travail ou être partagée avec votre équipe.
    2. Cochez l'une des cases représentant les boutons de la barre d'outils pour indiquer où vous souhaitez afficher la configuration en tant que favori (raccourci sous forme de signet).
    3. Cliquez sur Appliquer.
  13. Cliquez sur Débogage.
La perspective Débogage s'ouvre automatiquement et affiche les différentes vues que vous pouvez utiliser pour déboguer le programme. Vous pouvez travailler dans cette perspective pour diagnostiquer des erreurs. Pour plus d'informations et pour des liens vers des description de tâches, consultez la rubrique relative au débogage.

Vous pouvez également ouvrir la boîte de dialogue Débogage en sélectionnant Exécuter > Débogage dans le menu du plan de travail ou en cliquant sur les boutons de la barre d'outils Débogage .

La configuration de lancement est enregistrée. La prochaine fois que vous ouvrez la boîte de dialogue de la configuration de lancement pour déboguer une application Java distante, la configuration de débogage correspondante est automatiquement sélectionnée. Vous pouvez utiliser cette configuration, créer une configuration ou copier une configuration existante en cliquant dessus avec le bouton droit de la souris si vous souhaitez uniquement modifier un ou deux attributs.

Concepts associés
Exécution de programmes et de commandes
Tâches associées
Exécution de programmes à distance à l'aide d'outils externes
Utilisation de configurations de lancement d'exécution pour des programmes Java