Module Lanceur de scripts

Le module Lanceur de scripts vous permet de déléguer des fonctions de gestion aux agents. Les fonctions de gestion sont des scripts de gestion écrits dans un langage de scripts de gestion. Le module Lanceur de scripts est un module multi-instance. Toutes les instances du module Lanceur de scripts accèdent au même module Référentiel de scripts pour les informations sur les langages et les scripts.

Ce module inclut les deux tables suivantes :

• La Table Lancements – Cette table décrit les scripts qui sont prêts à être lancés et en indique les paramètres.

• La Table Résultats – Cette table vous permet de voir les résultats de l'exécution d'un script sélectionné.

Le module Lanceur de scripts vous permet de manipuler les scripts comme suit :

• Vous pouvez contrôler qui est autorisé à lire, écrire et exécuter des scripts à partir du module Référentiel de scripts.

• Vous pouvez spécifier des arguments pour les scripts de gestion.

• Vous pouvez commencer et finir des scripts de gestion.

• Vous pouvez surveiller et contrôler l'exécution de scripts de gestion.

• Vous pouvez afficher les résultats obtenus en exécutant les scripts de gestion.

• Vous pouvez contrôler qui est autorisé à lire, écrire et exécuter des scripts.

Pour le module Lanceur de scripts, la sécurité est mise en oeuvre comme suit :

• root ne peut pas faire partie du champ launchOwner de la Table Lancements. Pour autoriser l'utilisateur root d'une machine à exécuter des scripts en tant que super-utilisateur, créez un nouvel utilisateur sur cette machine et utilisez son nom pour exécuter les scripts.

• Le launchOwner (propriétaire du lancement) doit faire partie d'un nouveau groupe esscrusers sur le serveur. Seuls les membres de esscrusers peuvent créer des lignes ou apporter des changements dans la Table Lancements.

• Le Propriétaire du lancement, ou launchOwner, doit être un utilisateur valide sur la machine agent. L'utilisateur doit être un utilisateur local ou une personne ajoutée par le biais d'un service tel que NIS sur l'agent. Les scripts sont exécutés avec la permission du propriétaire.

Accès au module Lanceur de scripts

1. Chargez le module.

   Pour plus d'informations, consultez le Guide de l'utilisateur de Sun Management Center 3.5. Le module Référentiel de scripts figure sous Applications locales dans la fenêtre Explorateur.

2. Double-cliquez sur Applications locales dans la fenêtre Explorateur.

3. Double-cliquez sur Lanceur de scripts.

   Le Lanceur de scripts affiche la Table Lancements et la Table Résultats.

   

Table Lancements

La Table Lancements contrôle l'exécution de tous les scripts. Cette table décrit les scripts qui sont prêts à être lancés et en indique les paramètres.

Une entrée de la Table Lancements rattache un argument à un script. Une entrée définit également le propriétaire, qui est utilisé pour associer les permissions d'exécution du script.

Plusieurs instances d'un script peuvent entre créées par le biais d'une unique entrée de cette table. De même, plusieurs entrées de cette table peuvent pointer sur le même script dans la Table Scripts. Vous pouvez exécuter plusieurs scripts identiques avec différents arguments et permissions. Les scripts peuvent uniquement être exécutés avec la permission de leurs propriétaires respectifs.

Les arguments de la Table Lancements sont listés dans le tableau ci-après.

Tableau 5–2 Attributs de la Table Lancements

Attribut	Description
Propriétaire du lancement	Le gestionnaire propriétaire de l'entrée.
Nom du lancement	Nom de l'entrée. Les noms doivent être uniques pour chaque ligne de la Table Lancements.
Propriétaire du script	En association avec le nom du script, cet argument identifie le script.
Nom du script	En association avec le propriétaire du script, cet argument identifie le script.
Arguments	Arguments à fournir au script.
Démarrage du lancement	Lance l'exécution d'un script. Avant qu'un script soit lancé, les conditions suivantes doivent être satisfaites : Le Statut opération de l'entrée doit être Activé. Il devrait y avoir dans la Table Scripts une entrée présentant les mêmes valeurs dans les champs Propriétaire du script et Nom du script. Le champ Statut opération du script de la table Scripts devrait être à l'état activé. Le Propriétaire du lancement a les permissions de sécurité nécessaires pour lancer le script.
Contrôle du lancement	Cet objet est utilisé pour demander un changement d'état pour tous les scripts en cours d'exécution dans la table d'exécution démarrés depuis la Table Lancements.
Statut admin	Statut désiré de cette entrée de la table Lancements, peut être au choix activé ou désactivé.
Statut opération	Statut courant de cette entrée de la table Lancements, peut être au choix activé ou désactivé.
Exécution maxi.	Nombre maximal de scripts s'exécutant simultanément qui peuvent être appelés depuis cette entrée. La valeur par défaut est 3. Ce champ peut être modifié en écrivant directement dedans.
Durée maxi	La valeur par défaut est 3. Nombre maximal de scripts terminés appelés depuis cette entrée de la Table Lancements qui sont autorisés à être retenus dans la Table Résultats.
Durée de vie (s)	Durée maximale par défaut pendant laquelle un script lancé depuis cette entrée peut s'exécuter. La valeur par défaut est 86 400 secondes (1 jour).
Expiration du délai (s)	Durée maximale par défaut pendant laquelle les informations relatives à un script lancé depuis cette entrée sont conservées dans la Table Résultats une fois l'exécution du script terminée.

Ajout d'une nouvelle entrée à la Table Lancements

1. Accédez à la Table Lancements comme décrit dans Accès au module Lanceur de scripts.

2. Appuyez avec le bouton 3 de la souris sur le titre de la Table Lancements.

   Un menu contextuel s'affiche.

   

3. Choisissez Nouvelle ligne et indiquez tous les paramètres requis.

   Les valeurs Propriétaire du script et Nom du script pointent sur le script qui est démarré depuis ce bouton de lancement.

Lancement d'une instance de script

1. Accédez à la Table Lancements comme décrit dans Accès au module Lanceur de scripts.

2. Appuyez avec le bouton 3 de la souris sur la ligne qui contient le nom du script choisi.

3. Sélectionnez Lancer le script.

   Le script est lancé.

Arrêt des scripts

1. Accédez à la Table Lancements comme décrit dans Accès au module Lanceur de scripts.

2. Appuyez avec le bouton 3 de la souris sur la ligne qui contient le nom du script que vous voulez arrêter.

   Un menu contextuel apparaît.

3. Choisissez Abandonner les scripts.

   L'exécution du script s'arrête.

Table Résultats

La Table Résultats liste tous les scripts dont l'exécution est en cours ou terminée depuis peu. Elle contient les informations suivantes :

• L'heure à laquelle l'exécution du script a commencé et s'est terminée.

• La raison de la fin de l'exécution du script.

• Le résultat du script.

• Le temps pendant lequel le script peut encore s'exécuter.

Chaque ligne de la Table Résultats contient les arguments transférés pendant l'appel du script, les résultats produits par le script et le code de sortie du script. La Table Résultats fournit également des informations sur l'état d'exécution courant ainsi que les heures de début et de fin.

La Table Résultats indique les attributs listés dans le tableau suivant.

Tableau 5–3 Attributs de la Table Résultats

Attribut	Description
Indice exécution	Identificateur unique associé au script. Sa valeur est obtenue en faisant précéder le Nom du lancement d'un entier croissant. Les entiers commencent à 0.
Argument	Argument fourni au script à son démarrage.
Code de sortie	Raison de la fin de l'exécution d'un script. Peut prendre l'une des valeurs suivantes :   None (aucun) – Le script est encore en cours d'initialisation ou d'exécution. Halted (arrêté) – Le script a été abandonné. Successful (réussite) – L'exécution du script s'est terminée avec succès. Failed (échec) – L'exécution du script s'est terminée par une erreur.
Journal des résultats	Chemin du fichier journal.
Contrôle de l'exécution	Statut désiré de l'exécution de script définie par cette ligne (abort ou noop).
Etat de l'exécution	Statut de l'exécution du script. Peut prendre l'une des valeurs suivantes :   Initializing (en cours d'initialisation) – Le script est en cours d'initialisation. Running (en cours d'exécution) – Le script est en cours d'exécution. Not Running (pas en cours d'exécution) – Le script peut être dans cet état suite à une exécution terminée avec succès, un échec ou un abandon. La raison exacte de la non-exécution du script est indiquée dans le champ Code de sortie.
Journal d'erreur	Chemin du fichier journal.
Heure de début	Date et heure auxquelles l'exécution a commencé.
Heure de fin	Date et heure auxquelles l'exécution s'est terminée.
Durée de vie (s)	Temps pendant lequel le script peut s'exécuter. Si le script n'est pas terminé à l'expiration de ce délai, il est automatiquement éliminé.
Expiration du délai (s)	Temps pendant lequel cette ligne peut exister dans la Table Résultats après la fin du script. Cet attribut est la valeur du champ Expiration du délai (s) de la Table Lancements au moment du lancement du script. Une entrée de script est supprimée de la Table Résultats quand les secondes d'Expiration du délai (s) sont écoulées depuis que le script a atteint l'état Not Running.

Affichage des résultats à partir de la Table Résultats

1. Accédez à la Table Lancements comme décrit dans Accès au module Lanceur de scripts.

2. Dans la Table Résultats, appuyez avec le bouton 3 de la souris sur une entrée de script en cours d'exécution.

   Un menu contextuel s'affiche.

3. Choisissez Afficher le journal des résultats pour afficher le fichier journal de résultats qui correspond au script en cours d'exécution sélectionné.

   La fenêtre Afficheur sonde apparaît et affiche le résultat du journal.

   ---

   Remarque :

   Vous pouvez aussi accéder aux fichiers journaux depuis la ligne de commande. Les fichiers journaux sont enregistrés dans le répertoire /var/opt/SUNWsymon/SysMgmtPack/script-launcher/scripts/NomUtilisateur/logs. Le nom d'un fichier journal reprend l'instance en cours d'exécution de sorte que le fichier journal courant est facilement identifiable lorsqu'un utilisateur exécute le même script plusieurs fois.

   ---

Suppression d'une ligne de la Table Résultats

1. Accédez à la Table Lancements comme décrit dans Accès au module Lanceur de scripts.

2. Dans la Table Résultats, appuyez avec le bouton 3 de la souris sur une ligne.

   Un menu contextuel s'affiche.

3. Choisissez Supprimer la ligne.

   Une boîte de dialogue apparaît vous permettant de confirmer ou d'annuler la suppression.

4. Cliquez sur Oui (Yes) pour confirmer.

   Une fois la ligne supprimée, la Table Résultats est automatiquement rafraîchie.