Initiation à l'outil de scriptage wsadmin

Les scripts sont une solution non graphique à laquelle vous pouvez recourir pour configurer et gérer WebSphere Application Server.

[z/OS]

Avant de commencer

Vérifiez que les ID utilisateur qui exécutent des scripts WebSphere Application Server for z/OS, y compris les ID utilisateur serveur, administrateur et client, disposent des variables d'environnement LANG et LC_ALL définies pour le même environnement local basé sur la page de codes IBM-1047. Les paramètres basés sur une autre page de codes peuvent provoquer l'échec des scripts. Pour plus d'informations, voir la rubrique "Changing the Locale in the Shell" du document UNIX System Services User's Guide.

Pourquoi et quand exécuter cette tâche

L'outil wsadmin de WebSphere Application Server permet d'exécuter des scripts. Il prend en charge l'ensemble des fonctions d'administration du produit.

La figure ci-dessous illustre les composants principaux impliqués dans une solution de scriptage wsadmin :
Figure 1. Solution avec des scripts WebSphere Application Server. Cette figure illustre les composants principaux impliqués dans une solution de scriptage wsadmin.Illustre les composants principaux d'une solution de scriptage wsadmin.

L'outil wsadmin prend en charge deux langages de script : Jacl et Jython. Cinq objets sont disponibles pour l'utilisation de scripts :

  • AdminControl : Permet d'exécuter des commandes liées aux opérations.
  • AdminConfig : Permet d'exécuter des commandes de configuration afin de créer ou de modifier des éléments de configuration WebSphere Application Server.
  • AdminApp : Permet d'administrer des applications.
  • AdminTask : Permet d'exécuter des commandes d'administration.
  • Help : Permet d'afficher l'aide générale.

Les scripts utilisent ces objets pour communiquer avec les MBeans (Managed Beans) exécutés dans les processus WebSphere Application Server. Les beans MBean sont des objets Java™ qui représentent des ressources JMX (Java Management Extensions). JMX est un module facultatif de J2SE (Java 2 Platform Standard Edition). JMX est une technologie qui permet de gérer de manière standard et en toute facilité les objets Java.

Important : Certains scripts wsadmin, y compris AdminApp install, AdminApp update, et certaines commandes AdminTask, requièrent que L'ID utilisateur sous lequel s'exécute le serveur dispose des droits en lecture sur les fichiers créés par l'utilisateur qui exécute les scripts wsadmin. Par exemple, si le serveur d'applications s'exécute sous utilisateur1, et vous exécutez les scripts wsadmin sous utilisateur2, des exceptions concernant un répertoire temporaire peuvent survenir. Lorsqu'utilisateur2 exécute des scripts wsadmin pour déployer une application, un répertoire temporaire est créé pour le fichier EAR (Enterprise Application Archive). Cependant, au moment où le serveur d'applications tente de lire et de décompresser le fichier EAR en tant qu'utilisateur1, le processus échoue. Il n'est pas recommandé de définir à 022 ou 023 la valeur umask de l'utilisateur qui exécute les scripts wsadmin pour contourner ce problème. Cette opération permettrait à d'autres utilisateurs de lire tous les fichiers créés par cet utilisateur. Pour résoudre ce problème, envisagez les solutions suivantes, basées sur vos règles administratives :
  • Exécutez les scripts wsadmin avec l'ID utilisateur qui exécute le gestionnaire de déploiement ou le serveur d'applications. Un superutilisateur peut basculer d'un ID à l'autre pour effectuer ces actions.
  • Définissez le même ID de groupe pour l'utilisateur qui exécute le gestionnaire de déploiement ou le serveur d'applications et pour celui qui exécute les scripts wsadmin. En outre, définissez au minimum la valeur umask 027 pour l'utilisateur qui exécute les scripts wsadmin, pour que les fichiers créés par les scripts wsadmin puissent être lus par les autres membres du groupe.
  • Exécutez les scripts wsadmin à partir d'une autre machine. Cette situation, qui implique obligatoirement le transfert des fichiers, constitue une solution de contournement au problème d'autorisation de copie des fichiers.

Pour effectuer une tâche en utilisant le scriptage, procédez comme suit :

Procédure

  1. Sélectionnez un langage de script. L'outil wsadmin prend uniquement en charge les langages de script Jacl et Jython. Jacl est le langage indiqué par défaut. Si vous souhaitez utiliser le langage de script Jython, utilisez l'option -lang ou spécifiez-le dans le fichier de propriétés de l'outil wsadmin.
  2. Démarrez le client de scriptage en mode interactif, en utilisant une commande individuelle, dans un script ou dans un profil.

Que faire ensuite

Avant d'effectuer une tâche à l'aide de scripts, assurez-vous que vous maîtrisez les concepts suivants :

  • Java Management Extensions (JMX)
  • Modèle de configuration WebSphere Application Server
  • Outil wsadmin
  • Syntaxe Jacl ou syntaxe Jython
  • Objets de scriptage

Vous pouvez également personnaliser l'environnement de scriptage. Pour plus d'informations, reportez-vous à la rubrique relative aux propriétés d'administration du scriptage wsadmin.

Une fois que vous connaissez les concepts du scriptage, choisissez un langage et lancez le client de scriptage. Vous êtes alors prêt à réaliser des tâches à l'aide de scripts.


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_script
Nom du fichier : txml_script.html