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 des serveurs d'applications, des gestionnaires de déploiement, des agents d'administration et des gestionnaires de travaux 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, un gestionnaire de déploiement, un agent d'administration ou un gestionnaire de travaux 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 existe car de nouvelles fonctionnalités sont ajoutées à l'outil wsadmin dans chaque édition de 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.
  • L'outil wsadmin fonctionne au niveau du noeud du gestionnaire de déploiement dans un environnement avec des cellules mixtes. Afin de garantir la disponibilité de toutes les fonctionnalités de commande, n'exécutez pas wsadmin au niveau du noeud du serveur d'applications.

[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.

[z/OS]Avant de lancer l'outil wsadmin avec la sécurité activée, reportez-vous aux rubriques Remarques sur SSL (Secure Sockets Layer) à l'intention des administrateurs WebSphere Application Server et Définition de la sécurité SSL pour les clients et les serveurs.

Dans un environnement de gestion souple, vous pouvez connecter l'outil à un processus du serveur d'applications de base, du gestionnaire de déploiement, de l'agent d'administration ou du gestionnaire de travaux. Sans indication du port du serveur d'applications de base ou du nom du profil attribué au gestionnaire de travaux, l'outil wsadmin se connecte automatiquement à l'agent d'administration.

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.

    [z/OS]La commande d'appel d'un processus de script se trouve dans le répertoire racine_serveur_app/bin. Utilisez le fichier wsadmin.sh.

    [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. Dans un environnement de gestion souple, déterminez si la connexion doit s'effectuer vers un processus du serveur d'applications de base, de l'agent d'administration ou du gestionnaire de travaux.
    • Connexion à un processus de l'agent d'administration.
      Connectez l'outil wsadmin à l'agent d'administration pour configurer, gérer et administrer des serveurs. Sans indication des options de connexion, l'outil wsadmin se connecte automatiquement au processus de l'agent d'administration. La commande suivante permet de se connecter à l'agent d'administration :
      wsadmin -lang jython
    • Connexion à un processus du serveur d'applications de base.
      Connectez l'outil wsadmin à un serveur d'applications de base pour gérer des paramètres pour un serveur particulier. Utilisez ce type de connexion pour une connexion vers un noeud qui contient un serveur et qui est enregistré avec l'agent d'administration. Une commande similaire à la suivante permet de se connecter à un serveur d'applications de base :
      wsadmin -conntype SOAP [-port 4213] -lang jython
    • Connexion au processus du gestionnaire de travaux.
      Connectez l'outil wsadmin au gestionnaire de travaux pour soumettre, surveiller et gérer des travaux d'administration. Une commande similaire à la suivante permet de se connecter au gestionnaire de travaux :
      wsadmin -profileName JobMgr01 -lang jython
  3. 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][z/OS]
      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][z/OS]
      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][z/OS]
      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][z/OS]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][z/OS]
      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][z/OS]
      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.

    [z/OS]WebSphere Application Server for z/OS prend en charge plusieurs codages pour les fichiers de commande Jacl et Jython. Le codage par défaut pour les fichiers de commande est ASCII. Pour exécuter un fichier Jacl codé EBCDIC, ajoutez l'argument JVM (Java virtual machine) ci-dessous au fichier wsadmin.sh en utilisant l'indicateur -javaoption :
    -Dscript.encoding=Cp1047
    Exemple :
    wsadmin.sh -javaoption -Dprofile.encoding=Cp1047
    Vous pouvez également disposer de deux versions du fichier wsadmin.sh, l'une référençant la version ASCII du fichier, l'autre référençant la version EBCDIC du fichier. Par exemple, copiez le fichier wsadmin.sh dans le fichier wsadminE.sh. Ajoutez -Dscript.encoding=Cp1047 au fichier wsadminE.sh.
    Les exemples suivants exécutent des scripts :
    • Exécution du script a1.py à l'aide de Jython :
      [AIX][HP-UX][Linux][Solaris][z/OS]
      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.

    [z/OS]WebSphere Application Server for z/OS prend en charge plusieurs codages pour les scripts de profil Jacl et Jython. Le codage par défaut pour le fichier de profil est ASCII. Pour exécuter un fichier de profil codé EBCDIC, ajoutez l'argument JVM (Java virtual machine) ci-dessous au fichier wsadmin.sh :
    -Dprofile.encoding=Cp1047
    Exemple :
    wsadmin.sh -javaoption -Dprofile.encoding=Cp1047
    Vous pouvez également disposer de deux versions du fichier wsadmin.sh, l'une référençant la version ASCII du fichier, l'autre référençant la version EBCDIC du fichier. Par exemple, copiez le fichier wsadmin.sh dans le fichier wsadminE.sh. Ajoutez -Dprofile.encoding=Cp1047 au fichier wsadminE.sh.
    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][z/OS]
      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][z/OS]
      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>
[z/OS]Si le message suivant apparaît :
[ Impossible d'allouer un segment Java avec une taille initiale de 268435456 octets. ]
[ **Mémoire insuffisante, abandon** ]
[ *** panic: JVMST016: Impossible d'allouer de la mémoire au segment Java initial ]
CEE5207E Le signal SIGABRT a été reçu.
Le client de scriptage wsadmin n'a pas pu démarrer car la taille de région sur votre page de connexion n'est pas suffisante pour allouer la taille de segment minimale (-Xms) indiquée sur la JVM qui est créée lors du démarrage de wsadmin. La valeur par défaut pour l'option -Xms, comme indiquée dans l'instruction de fichier wsadmin.sh PERF_JVM_OPTIONS="-Xms256m -Xmx256m, est 256 Mo. Pour résoudre cet incident, déconnectez-vous de TSO, puis lorsque vous vous connectez de nouveau, essayez d'augmenter la valeur du paramètre Size sur votre écran de connexion. Si vous ne pouvez pas augmenter cette valeur, vérifiez s'il existe des IEFUSI qui pourraient vous empêcher d'effectuer cette opération.

[z/OS]Si vous vous connectez par telnet à OMVS, la valeur utilisée pour déterminer la taille d'espace adresse reçue par votre connexion est indiquée dans le membre BPXPRMxx parmlib. BPXPRMxx contrôle l'environnement complet de z/OS UNIX. Par conséquent, la valeur définie pour le paramètre MAXASSIZE détermine la taille de l'espace adresse. Toutefois, si vous utilisez RACF, la taille d'adresse peut également être définie pour un utilisateur individuel dans le segment RACF OMVS concerné. Dans ce cas, la valeur fournie pour le paramètre ASSIZEMAX indique la limite de taille d'espace adresse, en octets, pour cet utilisateur. Par exemple, ASSIZEMAX=0268435456 indique que l'espace adresse alloué à cet utilisateur est 256 Mo.


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-nd-mp&topic=txml_launchscript
Nom du fichier : txml_launchscript.html