Exécution de fichiers script administratifs sur WebSphere Application Server

Vous pouvez exécuter des scripts d'administration dans l'environnement de développement sans avoir à utiliser l'interpréteur de commandes non graphique, l'outil wsadmin WebSphere Application Server.Utilisez le programme de lancement de script de WebSphere Application Server Administrative pour exécuter les fichiers script sur WebSphere Application Server. Pour exécuter des fichiers script dans l'environnement de développement, vous devez spécifier l'emplacement de votre script, l'environnement d'exécution pour interpréter votre script, et les paramètres de sécurité, si votre script s'exécute sur un serveur sécurisé.

Avant de commencer

Pourquoi et quand exécuter cette tâche

Exécutez les fichiers scripts administratifs sur WebSphere Application Server.

Procédure

  1. Vous pouvez ouvrir WebSphere Application Server Administrative Script Launcher de l'une des manières suivantes :
    • Dans la vue Serveurs, cliquez avec le bouton droit sur un serveur WebSphere Application Server et sélectionnez Administration > Exécuter des scripts administratifs
    • Cliquez avec le bouton droit sur un éditeur de texte, par exemple l'éditeur Jython, et sélectionnez Exécuter en tant que > Script administratif
    • Dans l'Explorateur d'entreprise ou la vue Navigateur, cliquez avec le bouton droit sur un fichier avec une extension de fichier valide, et sélectionnez Exécuter en tant que > Script administratif
    • Dans la barre d'outils de la perspective Java™ or Java EE, sélectionnez Exécuter > Exécuter les configurations > Script administratif WebSphere Application Server, puis sélectionnez Nouvelle configuration de lancement (Capture d'écran du bouton de nouvelle configuration de lancement.)
  2. La page Script est la page principale de WebSphere Application Server Administrative Script Launcher.
  3. Dans la zone Script d'administration, spécifiez l'emplacement de votre fichier script en procédant de l'une des façons suivantes :
    • Tapez le chemin vers votre fichier script.
    • Cliquez sur Espace de travail pour accéder à votre fichier script sur l'espace de travail.
    • Cliquez sur Système de fichiers pour accéder à votre fichier script sur le système de fichiers.
    • Cliquez sur Variables pour développer automatiquement le chemin de votre fichier script lorsqu'une ressource est sélectionnée sur votre espace de travail.
  4. Dans la liste d'environnement d'exécution de script, sélectionnez un nom d'environnement d'exécution WebSphere Application Server installé 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 déroulante, 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. Bien que vous puissiez créer des environnements d'exécution à l'aide de l'assistant Nouvel environnement d'exécution du serveur, WebSphere Application Server Administrative Script Launcher prend en charge uniquement les environnements d'exécution locaux suivants :
    • WebSphere Application Server v6.1 ou version ultérieure
    Par conséquent, la liste déroulante d'environnements d'exécution de script va afficher uniquement les environnements d'exécution pris en charge.
  5. 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.
  6. 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.
  7. 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.
  8. 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é.
  9. Cliquez sur Exécuter pour exécuter votre fichier script.
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 : twsadminlauncher.html