Exécution de travaux administratifs à l'aide de l'outil de scriptage wsadmin

Cette rubrique permet, à l'aide de l'outil wsadmin, de soumettre des travaux administratifs et d'effectuer leur suivi dans un environnement de gestion souple.

Avant de commencer

Configurez un gestionnaire de travaux et un agent d'administration, puis enregistrez des noeuds et des gestionnaires de déploiement auprès du gestionnaire de travaux pour configurer un environnement de gestion souple. Vous pouvez également créer, en option, des groupes de gestion pour soumettre un travail simultanément sur plusieurs noeuds.

Pourquoi et quand exécuter cette tâche

Après la configuration d'un environnement de gestion souple, vous pouvez soumettre, contrôler et gérer des travaux pour les noeuds enregistrés auprès du gestionnaire de travaux. Votre ID au niveau du gestionnaire de travaux doit disposer des droits du rôle administrateur ou du rôle opérateur pour soumettre des travaux. Votre ID au niveau du gestionnaire de travaux doit disposer des droits du rôle administrateur ou du rôle opérateur pour soumettre des travaux. Lorsque vous soumettez un travail, vous pouvez indiquer un nom d'utilisateur et un mot de passe pour l'authentification et l'autorisation au niveau du noeud ou des noeuds cible. Si vous n'indiquez pas un nom d'utilisateur et un mot de passe dans les paramètres du travail, les données d'identification de l'émetteur du travail au niveau du gestionnaire de travaux sont utilisées à la place.
Remarque : Lorsque vous soumettez un travail à plusieurs noeuds cibles, le nom d'utilisateur et le mot de passe ou les données d'identification de l'émetteur du travail doivent être applicables à toutes les cibles du travail.

Procédure

  1. Démarrez l'outil wsadmin. Accédez au répertoire racine_serveur_app/bin et utilisez la commande suivante pour connecter l'outil wsadmin au processus gestionnaire de travaux :
    wsadmin -profileName myJobManager -lang jython
  2. Soumettez le travail administratif au gestionnaire de travaux.
    La commande submitJob permet de soumettre des travaux administratifs. Une soumission de travail comprend les informations suivantes :
    Type de travail
    Indique le type de travail à réaliser. Il existe de nombreux travaux dans l'environnement de gestion souple, notamment des travaux de gestion d'application, de configuration et de contrôle d'exécution du serveur d'applications.
    Liste de cibles de travaux et groupe cible
    La liste de cibles de travaux et le groupe indiquent les noeuds et groupes de noeuds au niveau desquels le travail s'exécute.
    Paramètres spécifiques au travail
    La plupart des travaux administratifs nécessitent des informations pour leur exécution, outre le type de travail et la cible. Les paramètres de travail sont spécifiques à chaque type de travail.
    Remarque : Lorsque vous soumettez un travail à plusieurs noeuds cibles, le nom d'utilisateur et le mot de passe ou les données d'identification de l'émetteur du travail doivent être applicables à toutes les cibles du travail.
    Paramètres génériques facultatifs
    Outre les paramètres spécifiques au travail, vous pouvez inclure l'un des paramètres facultatifs suivants lors de la soumission du travail :
    Tableau 1. Description des paramètres génériques facultatifs submitJob. Indiquez les paramètres facultatifs avec un tiret (-) avant le nom du paramètre.
    Paramètre Description Type
    nom_utilisateur Indique le nom d'utilisateur à utiliser pour soumettre le travail lorsque que la sécurité est activée. Chaîne
    mot_de_passe Indique le mot de passe du nom d'utilisateur à utiliser pour soumettre le travail lorsque la sécurité est activée. Chaîne
    description Indique la description du travail. Chaîne
    activationDateTime Indique la date et l'heure auxquelles activer le travail, dans le format suivant : "2006-05-03T10:30:45-0000". La section "-0000" de la valeur du paramètre activationDateTime représente le fuseau horaire. La lettre de raccourci Z permet d'indiquer le temps moyen de Greenwich (GMT). Par exemple : "2006-05-03T10:30:45Z". Si vous n'indiquez pas de fuseau horaire, le système emploie le fuseau horaire du serveur. Chaîne
    expirationDateTime Indique la date d'expiration du travail, dans le format "2006-05-03T10:30:45-0000". La section "-0000" de la valeur du paramètre expirationDateTime représente le fuseau horaire. Vous pouvez indiquer Z comme raccourci pour le temps moyen de Greenwich (GMT), par exemple "2006-05-03T10:30:45Z". Si vous n'indiquez pas de fuseau horaire, le système emploie le fuseau horaire du serveur. Chaîne
    executionWindow Indique l'intervalle de récurrence du travail. Chaîne
    executionWindowUnit Indique l'unité de mesure de l'intervalle de récurrence pour la valeur définie par le paramètre executionWindow. Indiquez DAILY pour exécuter le travail tous les jours, WEEKLY pour l'exécuter toutes les semaines, MONTHLY pour l'exécuter tous les mois, YEARLY pour l'exécuter tous les ans ou CONNECTION pour exécuter le travail à chaque connexion et interrogation du noeud à la recherche de travaux. Chaîne
    email Indique l'adresse électronique à laquelle le système envoie les notifications de travaux. Chaîne
    L'exemple suivant soumet un travail pour démarrer un serveur d'applications. L'exemple de commande suivant soumet le travail de démarrage de l'application et attribue la variable MyStartJob au jeton de travail renvoyé :
    myStartJob = AdminTask.submitJob('-jobType startApplication -targetList [MyNode01] -jobParams [applicationName myApplication] -email admin@company.com')
  3. Facultatif : Contrôlez l'état du travail.
    Utilisez la commande getOverallJobStatus pour afficher l'état du travail, tel qu'illustré dans l'exemple suivant :
    AdminTask.getOverallJobStatus('[-jobTokenList [myStartJob]]')
    Si vous n'avez pas défini la variable myStartJob au cours de l'étape précédente, indiquez la valeur de retour de la commande submitJob pour le paramètre -jobTokenList.
    La commande renvoie des informations sur l'état du travail ou des travaux qui vous intéressent. Le système affiche les attributs suivants relatifs à l'état global des travaux :
    • STATE indique l'état en cours du travail.
    • TOTAL_RESULTS indique le nombre total de travaux.
    • DISTRIBUTED indique le nombre de travaux répartis.
    • ASYNC_IN_PROGRESS indique le nombre de travaux asynchrones en cours.
    • SUCCEEDED indique le nombre de travaux ayant abouti.
    • PARTIALLY_SUCCEEDED indique le nombre de travaux ayant partiellement abouti. Un succès partiel peut se produire, par exemple, lorsqu'un noeud représente plusieurs serveurs et que seuls certains de ces serveurs aboutissent.
    • FAILED indique le nombre de travaux ayant échoué.
    • REJECTED indique le nombre de travaux rejetés.
    • NOT_ATTEMPTED indique le nombre de travaux que le système n'a pas tenté d'exécuter.

Que faire ensuite

Soumettez d'autres travaux administratifs au gestionnaire de travaux et contrôlez les travaux existants. Vous pouvez également planifier les travaux administratifs ultérieurs.


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_7runjob
Nom du fichier : txml_7runjob.html