Initiation à l'outil de scriptage wsadmin

Script est une alternative non graphique que vous pouvez utiliser pour configurer et gérer WebSphere® Application Server.

[z/OS]

Avant de commencer

Vérifiez que les ID utilisateur qui s'exécutent WebSphere Application Server for z/OS® les scripts, y compris les ID utilisateur du serveur, de l'administrateur et du client, s'exécutent avec les variables d'environnement LANG et LC_ALL définies sur les mêmes paramètres régionaux en fonction de la page de codes IBM-1047. Les paramètres basés sur une autre page de codes peuvent provoquer l'échec des scripts. Voir le Changer les paramètres régionaux dans le shell sujet dans Guide de l'utilisateur des services système UNIX pour plus d'informations.

A propos de cette tâche

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

Restriction: L'outil wsadmin ne s'applique pas à Liberty. Voir Administration de Liberty à partir de la ligne de commande plutôt.
La figure ci-dessous illustre les principaux composants impliqués dans une solution de scriptage wsadmin :
Figure 1 : UN WebSphere Application Server solution de script. Cette figure illustre les principaux composants impliqués dans une solution de scriptage wsadmin.
Illustre les principaux composants d'une solution de script 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 de 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 MBeans qui est exécuté dans le cadre des processus de WebSphere Application Server. Les MBeans sont des objets Java™ qui représentent des ressources Java Management Extensions (JMX). JMX est un module facultatif ajouté à 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, notamment le AdminApp installer, AdminApp mise à jour, et certains AdminTask Les commandes nécessitent que l'ID utilisateur sous lequel le serveur est exécuté dispose d'une autorisation de 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.

Etape suivante

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