Démarrage du client de scriptage wsadmin à l'aide de l'outil de scriptage wsadmin

L'outil wsadmin permet de configurer et d'administrer les serveurs d'applications, le déploiement des applications et les opérations d'exécution des serveurs.

Pourquoi et quand exécuter cette tâche

L'outil wsadmin permet d'automatiser des tâches de configuration pour votre environnement via l'exécution de scripts. Cependant, les limitations suivantes s'appliquent à l'utilisation de l'outil wsadmin :
  • L'outil wsadmin prend uniquement en charge les langages de script Jython et Jacl.

    La version 6.1 de WebSphere Application Server représentait le début du processus d'obsolescence pour la syntaxe Jacl qui est associée à l'outil wsadmin. La syntaxe Jacl pour l'outil wsadmin reste dans le produit et est prise en charge pour au moins deux éditions principales du produit. Ensuite, la prise en charge du langage Jacl est susceptible d'être retirée de l'outil wsadmin. La syntaxe Jython pour l'outil wsadmin est la direction stratégique de l'automatisation d'administration WebSphere Application Server. Le serveur d'applications contient des fonctions et des outils d'administration très avancés qui prennent en charge l'automatisation du produit et l'utilisation de la syntaxe Jython.

    Fonction obsolète Fonction obsolète: Jacl est obsolète ; Jython est le langage de script par défaut.depfeat
    Eviter les incidents Eviter les incidents: Toutes les classes de composant WebSphere Application Server ne sont pas rassemblées dans le même fichier .jar. Si vous envisagez d'utiliser l'outil wsadmin pour l'exécution des scripts Jython, incluez la propriété système jython.package.path à votre commande wsadmin afin de vous assurer que tous les fichiers JAR requis ont le chemin de package jython au démarrage de wsadmin.
    ./wsadmin.sh -lang jython -javaoption
    "-Djython.package.path=/usr/WebSphere70/AppServer/plugins/com.ibm.ws.wlm.jar"   

    Si vous souhaitez appeler les fonctions WebSphere Application Server à partir de différentes classes WebSphere Application Server rassemblées dans des fichiers .jar autres que runtime.jar et admin.jar, vous pouvez inclure plusieurs fichiers JAR dans le chemin spécifié pour la propriété système jython.package.path en les séparant par un point-virgule (;).

    ./wsadmin.sh -lang jython -javaoption
    "-Djython.package.path=/usr/WebSphere70/AppServer/plugins/com.ibm.ws.wlm.jar;com.ibm.ws.wccm.jar"  

    Si vous souhaitez appeler les fonctions WebSphere Application Server dans un script jython à l'aide de ws_ant, vous pouvez créer un fichier texte .prop et inclure la ligne suivante à ce fichier :

    jython.package.path=/usr/WebSphere70/AppServer/plugins/com.ibm.ws.wlm.jar  

    Incluez ensuite le fichier de propriétés au fichier XML de script ant. Par exemple :

    <taskdef name="wsadmin" classname="com.ibm.websphere.ant.tasks.WsAdmin"/>
    <target name="main">  
        <wsadmin conntype="NONE" lang="jython" failonerror="true" properties="/tmp/jython.prop"
                 script="/home/fsgapp/MSTWasBuild/project/scripts/socr/socr/jython/configure.py"> 
        </wsadmin>
    </target>  
    gotcha
  • L'outil wsadmin permet de gérer les opérations d'installation, de configuration, de déploiement et d'exécution pour les serveurs d'applications qui exécutent la même version ou une version supérieure du produit. L'outil wsadmin ne peut pas se connecter à un serveur d'applications qui exécute une version de produit antérieure à la version de l'outil wsadmin. Par exemple, un client wsadmin version 7.x ne peut pas se connecter à un serveur d'applications version 6.x. Cependant, un client wsadmin version 6.x peut se connecter à un serveur d'applications version 7.x. Cette limitation s'explique par l'ajout d'une nouvelle fonctionnalité à l'outil wsadmin à chaque édition du produit. Vous ne pouvez pas utiliser de nouvelles fonctionnalités de commande sur des serveurs d'applications exécutant des versions antérieures du produit.

[AIX Solaris HP-UX Linux Windows]Le programme de lancement wsadmin prend en charge plusieurs objets de scriptage, notamment les objets AdminConfig, AdminControl, AdminApp, AdminTask et Help. Les scripts utilisent ces objets pour la gestion des applications, la configuration, le contrôle des opérations et la communication avec les MBeans exécutés dans les processus du produit. Pour effectuer une tâche en utilisant le scriptage, vous devez au préalable démarrer le client de scriptage.

Eviter les incidents Eviter les incidents: La conception de la gestion des applications ne permet pas d'installer un module ou un fichier EAR de niveau spécification EE situé à un niveau supérieur au client. Le code client exécuté dans wsadmin lit le fichier EAR et utilise l'introspection du contenu pour générer les options de configuration de déploiement qui sont applicables à cette application. Le code côté client ne peut pas traiter un niveau de spécification supérieur à celui pris en charge par le client. gotcha

Procédure

  1. Recherchez la commande qui démarre le client de scriptage wsadmin.
    [AIX Solaris HP-UX Linux Windows][IBM i]Choisissez l'une des façons suivantes :
    • Appelez le processus de script à l'aide d'un profil spécifique. La commande QShell d'appel du processus de script se trouve dans le répertoire racine_profil/bin. Le nom du script QShell est wsadmin. Si vous utilisez cette option, vous n'avez pas besoin d'indiquer le paramètre -profileName nom_profil.
    • Appelez le processus de script à l'aide du profil par défaut. La commande Qshell wsadmin se trouve dans le répertoire racine_serveur_app/bin. Si vous ne souhaitez pas vous connecter au profil par défaut, vous devez définir le paramètre -profileName nom_profil pour indiquer le profil à utiliser.
  2. Examinez les options de connexion supplémentaires pour l'outil wsadmin.
    Vous disposez de plusieurs méthodes pour démarrer le client de scriptage wsadmin. Pour spécifier la méthode d'exécution des scripts, exécutez l'une des options de l'outil wsadmin suivantes :
    Exécution de commandes de script en mode interactif

    Exécutez wsadmin avec une option autre que -f ou -c, ou sans option. L'outil wsadmin démarre et affiche un shell interactif présentant une invite wsadmin. A partir de l'invite wsadmin, entrez une commande Jacl ou Jython. Vous pouvez également appeler des commandes en utilisant les objets wsadmin AdminControl, AdminApp, AdminConfig, AdminTask ou Help. Pour quitter une session de scriptage interactive, utilisez la commande quit ou exit. Ces commandes n'utilisent pas d'arguments.

    Les exemples suivants lancent l'outil wsadmin :
    • Lancement de l'outil wsadmin à l'aide de Jython :
      [AIX][HP-UX][Linux][Solaris]
      wsadmin.sh -lang jython
      [IBM i]
      wsadmin -lang jython
      [Windows]
      wsadmin.bat -lang jython
    • Lancement de l'outil wsadmin à l'aide de Jython lorsque la sécurité est activée :
      [AIX][HP-UX][Linux][Solaris]
      wsadmin.sh -lang jython -user nom_utilisateur -password mot_de_passe
      [IBM i]
      wsadmin -lang jython -user nom_utilisateur -password mot_de_passe
      [Windows]
      wsadmin.bat -lang jython -user nom_utilisateur -password mot_de_passe
    • Lancement de l'outil wsadmin à l'aide de Jacl sans option :
      [AIX][HP-UX][Linux][Solaris]
      wsadmin.sh -lang jacl
      [IBM i]
      wsadmin -lang jacl
      [Windows]
      wsadmin.bat -lang jacl
    Exécution des commandes de scriptage en tant que commandes individuelles.

    Exécutez l'outil wsadmin avec l'option -c.

    [AIX][HP-UX][Linux][Solaris]Si vous appelez une commande incluant un signe dollar ($) à l'aide de l'option wsadmin -c, la ligne de commande tente de remplacer une variable. Pour éviter cet incident, placez une barre oblique inverse devant le signe dollar (\). Par exemple : wsadmin -c "\$AdminApp install ...".

    Les exemples suivants exécutent des commandes individuellement :
    • Exécutez la commande list pour l'objet AdminApp à l'aide de Jython:
      [AIX][HP-UX][Linux][Solaris]
      wsadmin.sh -lang jython -c 'AdminApp.list()'
      [IBM i]
      wsadmin -lang jython -c "AdminApp.list()"
      [Windows]
      wsadmin -lang jython -c "AdminApp.list()"
    • Exécutez la commande list pour l'objet AdminApp à l'aide de Jacl :
      [AIX][HP-UX][Linux][Solaris]
      wsadmin.sh -c "\$AdminApp list"
      ou
      wsadmin.sh -c '$AdminApp list'
      [IBM i]
      wsadmin -c "$AdminApp list"
      [Windows]
      wsadmin -c "$AdminApp list"
    Exécution des commandes de script dans un script

    Exécutez l'outil wsadmin avec l'option -f et placez les commandes à exécuter dans le fichier.

    Les exemples suivants exécutent des scripts :
    • Exécution du script a1.py à l'aide de Jython :
      [AIX][HP-UX][Linux][Solaris]
      wsadmin.sh -lang jython -f  al.py
      [IBM i]
      wsadmin -lang jython -f  al.py
      [Windows]
      wsadmin -lang jython -f  al.py

      où le fichier a1.py contient les commandes suivantes :

      apps = AdminApp.list()
      print apps
    Exécution de commandes de script dans un script de profil

    Un script de profil est un script qui est exécuté avant le script principal, ou avant de passer en mode interactif. Vous pouvez utiliser les scripts de profil pour configurer un environnement de scriptage personnalisé pour l'utilisateur ou l'installation.

    Par défaut, les fichiers de script de profil suivants peuvent être configurés pour la propriété de profils com.ibm.ws.scripting.profiles dans le fichier racine_serveur_app/properties/wsadmin.properties :
    • racine_serveur_app/bin/securityProcs.jacl
    • racine_serveur_app/bin/LTPA_LDAPSecurityProcs.jacl

    Par défaut, ces fichiers sont enregistrés en ASCII. Si vous utilisez l'option profile.encoding pour exécuter les fichiers de script de profil encodé EBCDIC, modifiez l'encodage des fichiers en EBCDIC.

    Pour exécuter les commandes de scriptage dans un script de profil, exécutez l'outil wsadmin avec l'option -profile et incluez les commandes que vous souhaitez exécuter dans le script de profil.

    Pour personnaliser l'environnement de script, spécifiez un ou plusieurs scripts de profil à exécuter.

    N'utilisez pas de parenthèses dans les noms de noeud lors de la création des profils.

    Les exemples suivants exécutent des scripts de profil :
    • Exécution du script a1prof.py à l'aide de Jython :
      [AIX][HP-UX][Linux][Solaris]
      wsadmin.sh -lang jython -profile alprof.py
      [IBM i]
      wsadmin -lang jython -profile alprof.py
      [Windows]
      wsadmin.bat -lang jython -profile alprof.py

      où le fichier a1prof.py contient les commandes suivantes :

      apps = AdminApp.list()
      print "Applications actuellement installées :\n " + apps
    • Exécution du script a1prof.py à l'aide de Jacl :
      [AIX][HP-UX][Linux][Solaris]
      wsadmin.sh -profile alprof.jacl
      [IBM i]
      wsadmin -profile alprof.jacl
      [Windows]
      wsadmin.bat -profile alprof.jacl

      où le fichier a1prof.py contient les commandes suivantes :

      set apps [$AdminApp list]
      puts "Applications actuellement installées :\n$apps"

Résultats

L'outil wsadmin retourne la sortie suivante lorsqu'une connexion est établie vers le processus du serveur :

Exemple de sortie Jython :
Applications currently installed:
 DefaultApplication
ivtApp
requête
WASX70311 : Pour obtenir de l'aide, entrez : "print Help.help()"
wsadmin>
Exemple de sortie Jacl :
Applications actuellement installées :
 DefaultApplication
ivtApp
requête
WASX70311: Pour obtenir l'aide, entrez : "$Help help"
wsadmin>

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=txml_launchscript
Nom du fichier : txml_launchscript.html