Dans un environnement de gestion flexible, vous pouvez soumettre le travail Exécuter un script wsadmin pour exécuter les commandes d'un script wsadmin sur les cibles gérées du gestionnaire de travaux. Quand vous voulez soumettre des travaux exécutant un script, vous devez préalablement distribuer le fichier du script wsadmin aux noeuds concernés.
Avant de commencer
Avant d'exécuter le travail Exécuter un script wsadmin, effectuez les actions suivantes :
- Démarrez le gestionnaire de travaux et les cibles. Si une cible est un serveur d'applications autonome, démarrez aussi l'agent d'administration.
- Développez le fichier script wsadmin.
Par exemple, créez un fichier script nommé extract_server_props.py contenant le script suivant en langage Jython :
AdminTask.extractConfigProperties('[-propertiesFileName server.props -configData Server=server1 ]')
Le script exécute la commande extractConfigProperties pour extraire le fichier de propriétés de configuration du serveur d'un serveur d'applications nommé server1.
Les propriétés de configuration du serveur sont écrites dans un fichier nommé server.props.
Le
code retour du script détermine le succès ou l'échec d'un travail
exécutant le script. Si le script présente un code retour de zéro (0),
le travail est exécuté avec succès. Si le code retour est une valeur différente de zéro, le travail
échoue.
Pour plus d'informations, voir les rubriques
relatives aux scripts wsadmin.
- Copiez le fichier script dans le répertoire /config/temp/JobManager du profil du gestionnaire de travaux.
Si le répertoire JobManager
n'existe pas, créez le répertoire JobManager dans le répertoire
/config/temp du profil du gestionnaire de travaux.
Pour créer ce répertoire et y accéder, vous devez disposer des droits appropriés.
Si le fichier script existe sur une cible gérée, vous pouvez exécuter le travail Collecter un fichier pour copier le fichier script de la cible gérée vers le répertoire profil_gestionnaire_travaux/config/temp/JobManager/jeton_travail/nom_cible.
Voir la rubrique sur le travail de collecte de fichier.
- Exécutez le travail Distribuer un fichier pour copier le fichier de script sur les cibles gérées. N'oubliez pas la valeur de destination qui est spécifiée au moment de la
distribution du fichier. Voir la rubrique sur le travail de distribution de fichier.
Dans l'exemple de script extract_server_props.py, vous pouvez attribuer la valeur Destination extract_server_props.py.
Pourquoi et quand exécuter cette tâche
Vous pouvez utiliser la console d'administration du gestionnaire de travaux ou du gestionnaire de déploiement
pour soumettre un travail qui
exécute un fichier script wsadmin sur des cibles sélectionnées. Dans la console, sélectionnez le travail
Exécuter un script wsadmin, indiquez le fichier à exécuter, indiquez les options du travail,
planifiez le travail, vérifiez le récapitulatif, puis soumettez le travail.
Au lieu d'utiliser une console, vous
pouvez exécuter le travail runWsadminScript dans le groupe de commandes AdministrativeJobs. Pour plus d'informations, voir la rubrique relative aux différents types de travaux d'administration.
Procédure
- Cliquez sur dans l'arborescence de navigation de la console
d'administration.
- Choisissez un travail pour exécuter un script.
- Sélectionnez le type de travail Exécuter un script wsadmin dans la liste.
- Ajoutez une description pour le travail si vous le souhaitez.
- Cliquez sur Suivant.
- Sélectionnez les cibles sur lesquelles vous voulez exécuter le script.
- Sélectionnez un groupe de cibles dans la liste ou sélectionnez Noms cible.
- Si vous avez sélectionné Noms cible, entrez un nom de cible et cliquez sur Ajouter, ou cliquez sur Rechercher, puis indiquez les cibles choisies
dans la page Rechercher des cibles.
Par exemple, supposons que vous avez soumis un travail qui a distribué le fichier script
Jython extract_server_props.py. Indiquez les cibles possédant un serveur appelé server1.
Si un agent d'administration ou un gestionnaire de déploiement gère plusieurs
cibles de serveur d'applications ayant un serveur appelé server1,
indiquez une seule cible. Lorsque vous indiquez plusieurs cibles,
seul le dernier fichier server.props créé est conservé. Les fichiers server.props créés précédemment sont remplacés.
- Si une authentification de l'utilisateur est requise, spécifiez un nom d'utilisateur ou toute autre valeur d'authentification nécessaire.
- Cliquez sur Suivant.
- Indiquez les paramètres du travail.
- Pour la zone Emplacement du fichier de script, indiquez la valeur de la zone Destination fournie au moment de la distribution du fichier de script.
Par exemple, supposons que vous avez soumis un travail qui a distribué le fichier script
Jython extract_server_props.py et que vous avez affecté au paramètre
Destination la valeur extract_server_props.py.
Dans la zone Emplacement du fichier de script, entrez la valeur de destination suivante :
extract_server_props.py
Pour que le script extract_server_props.py puisse s'exécuter, les cibles spécifiées pour Noms cible doivent posséder un serveur nommé server1.
- Pour le paramètre Emplacement du profil, vous pouvez éventuellement indiquer la valeur de destination du profil qui a été fournie quand le fichier a été distribué aux cibles.
- Pour Paramètres du script, indiquez les paramètres requis pour exécuter le script wsadmin.
Si un attribut de paramètre contient des espaces, placez des guillemets doubles (") autour du paramètre. Si un attribut de paramètre entre guillemets contient des guillemets intégrés, placez une barre oblique inversée avant les guillemets intégrés.
Dans l'exemple de extract_server_props.py, si vous le souhaitez, indiquez que wsadmin utilise le langage Jython :-lang jython
- Cliquez sur Suivant.
- Planifiez le travail.
Les heures et dates que vous indiquez
sont relatives au gestionnaire de travaux.
- Vous pouvez éventuellement indiquer une ou plusieurs adresses e-mail à notifier
lorsque le travail est terminé.
- Sélectionnez le moment où le travail est disponible pour la soumission.
Vous
pouvez soumettre le travail afin qu'il soit disponible maintenant ou vous pouvez indiquer une heure et une date
à laquelle il est extrait du gestionnaire de travaux.
- Sélectionnez l'expiration du travail.
- Vous pouvez également définir un intervalle de récurrence pour le travail ainsi qu'une heure et une date de démarrage et
d'arrêt pour l'intervalle.
- Cliquez sur Suivant.
- Vérifiez le récapitulatif et cliquez sur Terminer pour soumettre le travail.
Résultats
Les cibles exécutent le travail.
Que faire ensuite
Dans la page Etat du travail, cliquez sur l'ID du travail Exécuter le travail de script wsadmin et examinez l'état du travail. Cliquez sur l'icône de régénération d'état
pour régénérer l'état affiché.
Si le travail a échoué, examinez les messages d'erreur issus de l'exécution, corrigez les erreurs indiquées puis soumettez à nouveau le travail.
Si l'état de travail est Abouti, vérifiez que l'exécution du script s'est déroulée correctement. Pour l'exemple extract_server_props.py, lorsque le script s'exécute correctement, les cibles extraient les propriétés de server1 vers un fichier nommé server.props. Un gestionnaire de déploiement place le fichier dans son répertoire principal, par exemple, Dmgr01.
Une cible autonome place le fichier dans le répertoire principal de son
agent d'administration, par exemple AdminAgent01.