Envoi de travaux

Dans un environnement de gestion flexible, vous pouvez soumettre des travaux à des cibles distantes pour gérer des applications, modifier la configuration du produit sur des machines distantes ou procéder à une tâche plus générale, comme exécuter un script. Vous pouvez indiquer l'heure de démarrage des travaux, s'ils se répètent et leur expiration.

Avant de commencer

Avant de pouvoir soumettre un travail, vous devez avoir enregistré au moins une cible auprès du gestionnaire de travaux. Il peut s'agir d'une cible de serveur d'applications qui a tout d'abord été enregistrée auprès d'un agent d'administration, d'une cible de gestionnaire de déploiement ou d'un ordinateur hôte.

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.

Votre ID de gestionnaire de travaux doit être autorisé pour le rôle d'administrateur ou opérateur pour pouvoir envoyer 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 de la ou des cibles. 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. Lorsque vous soumettez un travail à plusieurs cibles, le nom d'utilisateur et le mot de passe ou les données d'identification de l'émetteur du travail doivent s'appliquer à toutes les cibles du travail.

Vous pouvez simplifier l'administration d'un grand nombre de cibles en soumettant des travaux à des groupes de cibles. Chaque groupe de cibles représente un groupe de cibles. Avant de pouvoir soumettre un travail pour un groupe de cibles, vous devez avoir créé le groupe de cibles.

La fonctionnalité de gestionnaire de travaux existe dans un gestionnaire de travaux et dans un gestionnaire de déploiement. Pour plus de simplicité, cette documentation fait référence à la fonctionnalité en tant que gestionnaire de travaux.

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 des travaux afin d'effectuer des tâches, telles que la gestion d'applications ou la modification de la configuration du produit sur des postes de travail distants, ou pour procéder à des tâches plus générales, comme exécuter un script. Pour terminer la soumission du travail, choisissez le type de travail, les cibles sur lesquelles le travail doit s'exécuter et indiquez les paramètres du travail spécifiques à son type, planifiez-le, consultez le récapitulatif, puis soumettez le travail.

Les rubriques de cette section expliquent comment soumettre des travaux en utilisant la console du gestionnaire de travaux ou la console du gestionnaire de déploiement. Au lieu d'utiliser une console, vous pouvez soumettre des travaux depuis la ligne de commande en utilisant la commande wsadmin submitJob du groupe de commandes AdministrativeJobs. Voir la rubrique sur les types de travaux d'administration.

Procédure

  1. Cliquez sur Travaux > Soumettre dans l'arborescence de navigation de la console du gestionnaire de travaux ou du gestionnaire de déploiement.
  2. Choisissez le type de travail.
    1. Sélectionnez le type de travail dans la liste.

      La liste des types de travaux varie en fonction des cibles enregistrées auprès du gestionnaire de travaux. Les valeurs affichées dans la liste sont récupérées à partir des commandes getJobTypes et getJobTypeMetadata de l'objet AdminTask. Vous pouvez disposer de types de travaux qui gèrent des applications, modifient la configuration du produit sur des machines distantes, ou exécutent des tâches plus générales, tel qu'un script.

    2. Vous pouvez indiquer une description pour le travail.

      La description est une chaîne pouvant contenir jusqu'à 256 caractères. La description par défaut correspond au type du travail. Vous pouvez modifier ou ajouter des éléments à la description par défaut. La description se révèle utile lorsque vous utilisez l'option Rechercher pour afficher les travaux existants.

    3. Cliquez sur Suivant.
  3. Choisissez les cibles du travail.

    Il s'agit de déterminer les cibles sur lesquelles exécuter le travail.

    1. Sélectionnez un groupe de cibles dans la liste ou sélectionnez Nom de la cible.

      Seuls les groupes de cibles valides pour le type de travail sélectionné sont affichés dans la liste des groupes de cibles.

    2. Si vous avez sélectionné Nom de la cible, entrez un nom de cible et cliquez sur Ajouter ou compilez une liste de cibles à l'aide de l'option Rechercher.
      Nom de la cible que vous entrez
      Si vous entrez un nom de cible, il doit s'agir d'une cible qui a été enregistrée auprès du gestionnaire de travaux. Le nom de la cible est validé lorsque vous cliquez sur Suivant.
      Liste de noms de cibles
      1. Cliquez sur Rechercher.

        La page Rechercher des cibles s'affiche.

      2. Dans Type de cible, sélectionnez Tous, Hôte ou Noeud. La valeur par défaut est Tous.
      3. Si vous souhaitez exécuter l'opération Rechercher sur des mots-clés spécifiques, indiquez un opérateur valide et une chaîne de texte.

        La liste des mots clés est dynamique. Les opérateurs valides sont = (égal à), != (différent de), is null et is not null. La chaîne de texte peut être entière ou partielle et peut contenir un astérisque (*) afin d'inclure des caractères variables ou inconnus.

      4. Cliquez sur Rechercher.

        Les résultats s'affichent dans la liste Cibles exclues et ils sont sélectionnés.

      5. Transférez les cibles à cibler de la liste Cibles exclues vers la liste Cibles choisies.
        • Pour transférer des cibles spécifiques de la liste Cibles exclues vers la liste Cibles choisies, sélectionnez les cibles dans la liste Cibles exclues et cliquez sur >.
        • Pour transférer des cibles spécifiques de la liste Cibles choisies vers la liste Cibles exclues, sélectionnez les cibles dans la liste Cibles choisies et cliquez sur <.
      6. Une fois que vous disposez d'une liste des cibles souhaitées dans la liste Cibles choisies, cliquez sur OK.

        Les cibles s'affichent sur la page Sélectionner des cibles de travail.

    3. Si la cible exige une authentification, indiquez un nom d'utilisateur et un mot de passe pour permettre à la cible d'exécuter le travail.

      Par exemple, pour accéder à un hôte cible, vous indiquez généralement des valeurs pour Nom d'utilisateur et Authentification par mot de passe. Le nom d'utilisateur et le mot de passe sont les valeurs de connexion de l'hôte. Si l'hôte cible ne requiert pas de mot de passe, laissez les zones vides.

      Si vous voulez qu'un autre utilisateur exécute des commandes sur l'hôte cible, sélectionnez Utiliser sudo pour changer d'utilisateur avant l'exécution d'un travail et spécifier ensuite le nom d'utilisateur et le mot de passe de l'autre utilisateur. sudo signifie "exécuter en se substituant à l'utilisateur". S'il n'est pas nécessaire d'indiquer de mot de passe pour l'hôte cible, laissez ces zones vides. Les combinaisons de sélection suivantes sont valides :
      • Sélection de l'option Utiliser sudo sans indiquer de nom d'utilisateur et de mot de passe sudo. Dans ce cas, l'utilisateur par défaut défini dans le fichier /etc/sudoers et le mot de passe de l'utilisateur s'étant connecté sont utilisés.
      • Sélection de l'option Utiliser sudo en indiquant un nom d'utilisateur mais sans entrer le mot de passe sudo. Dans ce cas, l'utilisateur spécifié ainsi que le mot de passe de l'utilisateur s'étant connecté sont utilisés.
      • Sélection de l'option Utiliser sudo en indiquant un nom d'utilisateur et un mot de passe sudo. Dans ce cas, l'utilisateur spécifié et le mot de passe sudo sont utilisés.
      Par défaut, sudo n'est pas utilisé. L'option sudo est prise en charge uniquement sur les systèmes d'exploitation AIX, HP-UX, Linux et Solaris.
      Si vous souhaitez utiliser l'authentification par clé publique-privée, sélectionnez Authentification par clé publique-privée et indiquez le chemin d'accès complet au fichier de clés et, si cela est requis pour ce dernier, la phrase passe.
      pratiques recommandées : Pour utiliser l'authentification par clé publique-privée, commencez par générer une paire de clés à l'aide d'un outil de génération de clé tel que ssh-keygen. Ensuite, ajoutez la clé publique au fichier authorized_keys de l'utilisateur sur l'hôte cible. Enfin, dans cette page Sélectionner des cibles de travail, indiquez le nom d'utilisateur, le nom qualifié complet du fichier de clés privées et, en option, la phrase passe qualifiée complète.
    4. Cliquez sur Suivant.
  4. Indiquez les paramètres du travail.

    La liste des paramètres de travail est dynamique et dépend du type de travail. Par exemple, si le type de travail est d'installer une application, indiquez le nom de l'application, l'emplacement de l'application à installer et éventuellement le nom du serveur où le système installe l'application.

    Lorsque vous soumettez un travail à plusieurs cibles, les valeurs des paramètres doivent être applicables à toutes les cibles du travail.

    Le tableau suivant décrit les types de paramètres.

    Type de paramètre Description
    Chaîne Vous pouvez entrer du texte pour les paramètres appropriés. Le texte n'est validé qu'au moment de la soumission du travail.
    Ressource cible Vous pouvez sélectionner une ressource de cible. L'option Rechercher vous permet de rechercher la ressource, en fonction du type de travail que vous avez sélectionné au cours de la première étape.
    1. Vous pouvez cliquer sur Rechercher, si l'option est disponible.

      La page Rechercher les ressources cible s'affiche.

    2. Si vous souhaitez exécuter l'opération Rechercher sur des mots-clés spécifiques, indiquez un opérateur valide et une chaîne de texte.

      La liste des mots clés est dynamique. Les opérateurs valides sont = (égal à), != (différent de), is null et is not null. La chaîne de texte peut être entière ou partielle et peut contenir un astérisque (*) afin d'inclure des caractères variables ou inconnus.

    3. Cliquez sur Rechercher.

      Les résultats s'affichent dans la liste Ressources disponibles communes à tous les noeuds finaux.

    4. Cliquez sur OK pour enregistrer les résultats et revenir à la page de définition des paramètres de travail.
    5. Cliquez sur Suivant.
  5. Planifiez le travail.

    Les heures et dates que vous indiquez sont relatives au gestionnaire de travaux.

    1. Vous pouvez indiquer une ou plusieurs adresses e-mail à notifier lorsque le travail est terminé.

      Si vous indiquez plusieurs adresses e-mail, séparez-les avec une virgule. Les adresses e-mail sont enregistrées dans vos préférences de console. Chaque adresse e-mail est validée pour vérifier sa syntaxe.

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

    3. Sélectionnez l'expiration du travail.

      L'expiration du travail est le moment auquel le travail ne peut plus être exécuté pour les cibles. Vous pouvez utiliser l'expiration par défaut, indiquer une heure et une date d'expiration ou indiquer une durée au bout de laquelle le travail expire. L'expiration par défaut est définie dans la page de configuration du gestionnaire de travaux.

    4. 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.
    5. Cliquez sur Suivant.
  6. Consultez le récapitulatif et soumettez le travail.
    1. Si vous souhaitez modifier les options, cliquez sur Précédent jusqu'à ce que vous atteigniez la page appropriée. Apportez les corrections dans la page, puis affichez les différentes pages jusqu'à la page de récapitulatif et d'envoi du travail.
    2. Lorsque le paramétrage des options vous convient, cliquez sur Terminer pour soumettre le travail.

      La page de collecte Statut du travail s'affiche : seul l'état du travail que vous venez de soumettre y figure.

Résultats

Après avoir envoyé un travail, le travail peut ne pas être exécuté immédiatement. Le gestionnaire des travaux placent les travaux envoyés en file d'attente. Les agents d'administration et les gestionnaires de déploiement demandent les travaux au gestionnaire des travaux lorsqu'ils sont en ligne en fonction de leur fréquence d'interrogation. La fréquence d'interrogation est de 30 secondes. Les agents d'administration et les gestionnaires de déploiement nécessitent au moins deux cycles d'interrogation pour extraire les travaux et les envoyer au gestionnaire des travaux. Selon la durée de traitement d'un travail par la cible, plus de deux cycles peuvent être nécessaires pour exécuter le travail.

Que faire ensuite

Après avoir envoyé un travail, la page Statut du travail indique un seul ID de travail, tel que 122763380912576341. Vous pouvez utiliser cet ID pour interroger, suspendre, reprendre ou supprimer le travail. Lorsque vous cliquez sur un ID de travail, vous affichez les propriétés du travail, notamment ses heures d'activation et d'expiration et son état. Si vous cliquez sur le lien d'état du travail, vous affichez son historique pour chaque cible. Cliquez sur l'icône de régénération d'état Spécifie l'icône de la vue de régénération de l'état d'un travail pour régénérer l'état affiché.

Vous pouvez vérifier l'état d'un travail en utilisant la console du gestionnaire de travaux ou une commande wsadmin.

L'état d'un travail indique l'avancement du travail au niveau du gestionnaire des travaux. Le tableau 1 répertoire les états des travaux.

Tableau 1. Etats des travaux. L'état indique si le travail est actif.
Etats des travaux Description
En attente Vous avez envoyé le travail, mais il n'est pas encore prêt à être exécuté sur les cibles.
Actif Une ou plusieurs cibles ont commencé à exécuter le travail.
Expiré Le travail a expiré. Si une cible avait commencé à exécuter le travail avant son expiration, le travail se poursuit. Lorsqu'un travail expire, une cible ne peut pas l'exécuter.
Interrompu Le travail est suspendu. Si une cible avait commencé à exécuter le travail avant sa suspension, le travail se poursuit. Lorsqu'un travail est suspendu, une cible ne peut pas l'exécuter.

L'état du travail indique l'historique de son traitement sur une cible gérée. Un historique type indique le passe de l'état Distribué à l'état En cours et à l'état Terminé. Le tableau 2 indique les valeurs d'état.

Tableau 2. Descriptions des statuts des travaux. L'état indique si le travail a abouti.
Etat du travail Description
Aucune tentative La cible n'a pas reçu le travail. L'état est NOT_ATTEMPTED.
Réparti La cible a reçu le travail. L'état est DISTRIBUTED.
En cours La cible exécute le travail en même temps que d'autres travaux. L'état est ASYNC_IN_PROGRESS.
Echec Le travail a échoué et il ne s'exécute plus. L'état est FAILED.
Refusé La cible a rejeté le travail, car elle ne prend pas en charge ce type de travail, par exemple. L'état est REJECTED.
Succès Le travail a été exécuté. L'état est SUCCEEDED.
Partiellement réussi S'applique uniquement aux travaux startCluster et stopCluster pour lesquels le cluster contient plusieurs membres et aux travaux startApplication et stopApplication pour lesquels l'application est installée sur plusieurs cibles. Si seuls certains membres sont démarrés ou arrêtés ou que l'application ne démarre pas sur toutes les cibles, l'état du travail est PARTIALLY_SUCCEEDED.

Par défaut, les travaux envoyés restent actifs pendant 24 heures. Un travail actif est un processus Java actif qui consomment des ressources machine. Supprimez les travaux devenus inutiles. Vous pouvez utiliser la page d'état des travaux de la console du gestionnaire des travaux. Cliquez sur Travaux > Etat, sélectionnez les travaux et cliquez sur Supprimer.


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=tagt_jobsub
Nom du fichier : tagt_jobsub.html