Débogage de fichiers script Jython sur WebSphere Application Server

Vous pouvez détecter et diagnostiquer les erreurs dans votre script Jython avec le débogueur.Vous pouvez contrôler l'exécution de votre script en définissant des points d'arrêt, en interrompant des unités d'exécution, en passant en revue le code et en vérifiant le contenu des variables. Pour déboguer des scripts Jython, utilisez le programme de lancement de script d'administration WebSphere Application Server pour définir l'environnement d'exécution pour interpréter votre script et les paramètres de sécurité, si votre script est exécuté sur un serveur sécurisé.

Avant de commencer

Restriction : WebSphere Application Server v6.1 et versions ultérieures est le seul environnement d'exécution pris en charge pur le débogage des fichiers script Jython. Toutefois, lorsque vous exéutez (et pas déboguez) des fichiers script Jython, il existe une autre liste d'environnements d'exécution pris en charge. Voir la rubrique sur l'exécution des fichiers script d'administration sur WebSphere Application Server pour obtenir plus de détails.
Conseil : La différence entre l'exécution et le débogage des scripts Jython est la suivante : pour le débogage des scripts Jython, vous pouvez définir des points d'arrêt dans le script, alors qu'au cours de l'exécution d'un script Jython, vous exécutez le script sans interruptions.
Restriction : Pour déboguer les scripts Jython, les scripts Jython doivent exister dans le plan de travail à la suite d'une création ou d'une importation. Vous devez déboguer votre script Jython dans le plan de travail, contrairement à l'exécution d'un script Jython situé sur le système de fichiers.Les outils de débogage tels que la marge de point d'arrêt pour définir les points d'arrêt ne sont pas disponibles lorsque vous déboguez le script Jython script en-dehors du plan de travail sur le système de fichiers.

Pourquoi et quand exécuter cette tâche

Pour déboguer les scripts Jython :

Procédure

  1. Ouvez un fichier script Jython dans l'éditeur Jython :
    1. Dans la vue Navigateur, développez le projet de Jython qui contient le fichier script Jython que vous souhaitez déboguer.
    2. Cliquez avec le bouton droit sur le fichier script Jython.
    3. Dans le menu, sélectionnez Ouvrir avec > Editeur Jython.
  2. Définissez les points d'arrêt dans le script Jython. Pour définir un ou plusieurs points d'arrêt dans l'éditeur Jython, cliquez deux fois dans la marge située à côté de la ligne de code que vous souhaitez définir en point d'arrêt.
  3. Dans l'éditeur Jython, cliquez avec le bouton droit et sélectionnez dans le menu Déboguer en tant que > Script administratif. WebSphere Application Server Administrative Script Launcher s'ouvre. Utilisez WebSphere Application Server Administrative Script Launcher pour déboguer des fichiers scripts administratifs sur WebSphere Application Server à partir de l'environnement de développement.
  4. La page Script est la page principale de WebSphere Application Server Administrative Script Launcher.
  5. La zone Script administratif est automatiquement pré-remplie avec le chemin de votre fichier script.
  6. Dans la liste d'environnement d'exécution de script, sélectionnez un nom d'environnement d'exécution WebSphere Application Server tel que défini dans la page Préférences (Fenêtre > Préférences > Serveur > Environnements d'exécution). Vous devez spécifier un environnement d'exécution situé sur votre système de fichiers local pour interpréter votre fichier script.Si l'environnement d'exécution de votre choix pour interpréter votre fichier script n'est pas disponible dans la liste, cliquez sur Nouveau pour définir un nouvel environnement d'exécution WebSphere Application Server. L'assistant Nouvel environnement d'exécution du serveur s'ouvre. Vous pouvez créer tout environnement d'exécution avec l'assistant Nouvel environnement d'exécution du serveur.Toutefois, lorsque vous utilisez WebSphere Application Server Administrative Script Launcher pour déboguer le script Jython, seul l'environnement d'exécution WebSphere Application Server v6.1 ou version supérieure est pris en charge pour le débogage.
  7. Dans la liste des noms de profils, sélectionnez un profil qui appartient à l'environnement d'exécution sélectionné précédemment. Un profil est l'ensemble de fichiers définissant l'environnement d'exécution. Si vous sélectionnez l'option [Non spécifié], l'outil choisir le profil auquel est affecté le rôle par défaut.
  8. Dans la zone arguments wsadmin, indiquez la syntaxe d'appel de ligne de commande avancée pour le client de script wsadmin. Une référence de syntaxe d'appel de ligne de commande est disponible dans la documentation de WebSphere Application, voir la rubrique sur l'outil Wsadmin pour obtenir plus de détails. WebSphere Application Server Administrative Script Launcher gère déjà les informations suivantes transmises au client de script wsadmin :
    • Nom du fichier et chemin du fichier script
    • Langage du fichier script
    • Nom du profil WebSphere Application Server utilisé pour exécuter votre fichier script
    • ID utilisateur et mot de passe permettant l'authentification sur le serveur sécurisé cible
    Inutile de préciser à nouveau les informations dans la zone arguments wsadmin.

    Si vous exécutez les scripts administratifs sur un serveur distant, indiquez si vous utilisez un type de connexion SOAP ou RMI et la valeur du port. Si la sécurité est activée sur le serveur distant, indiquez les paramètres -user et -password. Utilisez l'une des syntaxes de commande suivantes dans la zone Arguments wsadmin :

    • Pour un type de connexion SOAP :
      -conntype SOAP [-host host_name] [-port port_number] [-user userid] [-password password]

      Par exemple : -conntype SOAP -host mycomputer.mycompany.com -port 8800 -user myUserID -password myPassword

    • Pour un type de connexion RMI :
      -conntype RMI [-host host_name] [-port port_number] [-user userid] [-password password]

      Par exemple : -conntype RMI -host mycomputer.mycompany.com -port 2809 -user myUserID -password myPassword

    Conseil : Si vous souhaitez transmettre les arguments à votre script Jython, ne les spécifiez pas dans cette zone d'arguments wsadmin, étant donné que cette zone est la cible du client de script wsadmin. A la place, sélectionnez la page Arguments et spécifiez vos arguments de programme dans la zone appropriée.
    Remarque : Si vous devez spécifier les arguments de programme pour exécuter vos scripts Jython, n'oubliez pas que le premier paramètre de programme est utilisé à différentes fins lors du débogage et exécution des scripts Jython.
  9. Dans la section Sécurité, spécifiez si votre script est exécuté sur un serveur sécurisé en sélectionnant l'une des options suivantes.
    Option Description
    Aucune sécurité sur le serveur cible Indique que votre script est exécuté sur un serveur qui n'est pas sécurisé.
    Tel que défini dans le fichier soap.client.props ou sas.client.props

    Indique que votre script s'exécute sur un serveur WebSphere Application Server sécurisé, et que vous avez fournit les informations d'authentification dans les fichiers sas.client.props ou the soap.client.props pour communiquer avec ce serveur sécurisé.

    Les fichiers sas.client.props et soap.client.props sont dans le répertoire de propriétés pour chaque profil WebSphere Application Server, par exemple x:/profilePath/properties.

    Si vous utilisez un connecteur RMI, définissez des valeurs pour les propriétés suivantes dans le fichier sas.client.props avec les valeurs appropriées.

    com.ibm.CORBA.loginUserid=
    com.ibm.CORBA.loginPassword=
    Définissez également la propriété suivante :
    com.ibm.CORBA.loginSource=properties
    La valeur de cette propriété est prompt dans le fichier sas.client.props. Si vous conservez la valeur par défaut, une boîte de dialogue apparaît, vous invitant à entrer votre mot de passe. Si le script s'exécute sans surveillance, il semble qu'il se bloque.
    Si vous utilisez un connecteur SOAP, définissez des valeurs pour les propriétés suivantes dans le fichier soap.client.props :
    com.ibm.SOAP.securityEnabled=true
    com.ibm.SOAP.loginUserid=
    com.ibm.SOAP.loginPassword=
    Le cas échéant, définissez la propriété suivante :
    com.ibm.SOAP.loginSource=none
    La valeur par défaut de cette propriété est figure dans le fichier soap.client.props. Si vous conservez la valeur par défaut sans indiquer loginUserid ni loginPassword, une boîte de dialogue s'affiche avec une invite de mot de passe. Si le script s'exécute sans surveillance, il semble qu'il se bloque.
    Remarque : Si vous spécifiez l'utilisateur et le mot de passe dans la section de spécification et dans le fichier sas.client.props ou le fichier soap.client.props, WebSphere Application Server Administrative Script Launcher écrase les informations du fichier .props.
    Spécification Indique que votre script est exécuté sur un serveur qui est sécurisé.

    Dans les zones ID utilisateur et Mot de passe, tapez les ID utilisateur et mot de passe permettant de vous authentifier sur le serveur sécurisé cible.

    Si vous indiquez les informations d'ID utilisateur et mot de passe dans cette section et dans le fichier sas.client.props ou soap.client.props, WebSphere Application Server Administrative Script Launcher écrase les informations dans le fichier .props.

    Avertissement : L'utilisation de la zone mot de passe peut entraîner des problèmes de sécurité puisque les informations de mot de passe deviennent visibles au programme de statut système comme la commande ps, qui peut être démarrée par d'autres utilisateurs pour afficher tous les processus en cours d'exécution. N'utilisez pas cette option si ce genre d'exposition pose un problème. A la place, sélectionnez l'option tel que défini dans le fichier soap.client.props ou sas.client props, et indiquez les informations d'ID utilisateur et mot de passe dans le fichier soap.client.props pour le connecteur SOAP ou le fichier sas.client.props pour le connecteur RMI. Les fichiers soap.client.props et sas.client.props figurent dans le répertoire de propriétés de votre profil WebSphere Application Server.
  10. Cliquez sur Appliquer pour sauvegarder votre configuration. Les arguments VM appropriés et chemins de classe pour votre environnement d'exécution WebSphere Application Server sont automatiquement remplis.
    Conseil : Si vous changez votre sélection pour la liste d'environnements d'exécution de script, cliquez sur Appliquer pour chaque modification pour renseigner automatiquement les arguments VM corrects et les chemins de classe pour votre environnement d'exécution WebSphere Application Server venant d'être sélectionné.
  11. Vérifiez que vous disposez de points d'arrêt définis dans l'éditeur Jython (spécifiés dans les étapes précédentes).Sinon, votre session de débogage s'exécute.
  12. Cliquez sur Déboguer pour déboguer votre script. La perspective de débogage apparaît.

Que faire ensuite

Le débogueur s'interrompt sur le point d'arrêt de votre script Jython, et vous pouvez déboguer le script dans la perspective Débogage.
Icône indiquant le type de rubrique Rubrique de tâche
Dispositions pour les centres de documentation | Commentaires en retour

Icône d'horodatage Dernière mise à jour: May 29, 2014 10:11

Nom de fichier : tjythondebug.html