Guide d'administration de Sun N1 System Manager 1.0

Chapitre 7 Gestion des tâches et des entrées des journaux

Ce chapitre contient une description des tâches, des événements et des notifications dans les sections suivantes :

Gestion des tâches

Chaque action importante effectuée dans N1 System Manager démarre une tâche. Vous pouvez utiliser le journal des tâches pour surveiller l'état d'une action en cours d'exécution ou pour vérifier qu'une tâche est terminée. Le contrôle des tâches s'avère particulièrement utile pour les actions de N1 System Manager relativement longues, comme l'installation d'une distribution de SE sur un ou plusieurs serveurs de déploiement.

Vous pouvez suivre des tâches sous l'onglet Tâches dans l'interface de navigateur ou en utilisant la commande show job. La commande show job renvoie des informations sur la plupart des caractéristiques suivantes :

ID de tâche

Identifiant univoque.

Date

Date à laquelle la tâche a été commencée.

Type de tâche

Type de tâche. Pour plus de détails, reportez-vous à show job. Quand vous utilisez la commande show job avec le paramètre type, vous pouvez entrer l'un quelconque des types suivants :

disco – Détection de serveurs
distro – Crée une distribution de SE à partir d'une image ISO ou de CD-ROM/DVD.
fwdeploy – Installation d'une mise à jour d'un microprogramme sur un serveur.
osdeploy – Installation d'un SE sur un serveur.
pkgdeploy – Mise à jour du SE sur le serveur.
pkguninstall– Désinstallation d'une mise à jour d'un SE sur un serveur.
poweroff – Mise hors tension d'un serveur.
poweron – Mise sous tension d'un serveur.
rcmd – Exécution d'une commande à distance.
raprep – Préparation d'un agent distant.
reboot – Réinitialisation d'un serveur.
refresh – Rafraîchissement d'un serveur.
setagentip – Installation d'un agent de gestion de SE : interface IP identifiée pour le contrôle, agent de contrôle installé (s'il n'est pas déjà installé). Agent de déploiement de packages installé (s'il n'est pas déjà installé) et exécution d'une commande à distance activée.
jobdelete – Suppression de tâche.

État

État de l'étape en cours d'exécution. Les étapes indiquent la progression d'une tâche et mettent à jour les résultats. Chaque phase de tâche est associée à un type, une heure de début et, quand la tâche est terminée, une heure de fin. Il existe un mappage programmatique entre une tâche et ses étapes. Pour des motifs de filtrage, les états des tâches sont définis à l'aide d'étapes intermédiaires. La progression des tâches est indiquée avec les états suivants :

notstarted
preflight
running
pendingstop

L'achèvement d'une tâche est indiqué avec les états suivants :

completed
warning
stopped
error
timed_out

WARNING est un avertissement qui peut survenir pendant l'exécution de la tâche. Un avertissement indique la présence d'un problème qui peut être plus ou moins grave et n'entraîne pas nécessairement d'erreurs à la fin de la tâche. Complete - Warning apparaît dans la sortie de l'état d'une tâche complète, si toutes les étapes de la tâche ont été correctement exécutées, mais qu'un ou plusieurs WARNING ont été émis pendant l'exécution de la tâche et que ces avertissemens n'étaient pas suffisamment graves pour terminer la tâche avec des erreurs.

Vous pouvez filtrer des tâches en fonction de leur état. Pour plus de détails, reportez-vous à show job.

Propriétaire

L'utilisateur qui a démarré la tâche. Il est également appelé l'auteur de la tâche.

Résultat de la tâche

Fournit des détails sur le résultat d'une tâche achevée. Vous pouvez vérifier la sortie standard de la commande à distance et les états d'achèvement de tous les autres types de tâches.

En théorie, toutes les tâches peuvent être arrêtées. Toutefois, dans la pratique, l'arrêt d'une tâche n'est possible que si elle n'est pas encore arrivée à sa dernière étape. Certaines tâches comprennent une seule étape et ne peuvent donc jamais être arrêtées. Les opérations exécutées sur des groupes de nombreux serveurs peuvent prendre plus longtemps et comporter un nombre élevé d'étapes.

Affichage de la liste des tâches

Étapes

Connectez-vous à N1 System Manager.

Pour plus de détails, reportez-vous à Accès à la ligne de commande de N1 System Manager .

Affichez la liste des tâches.
N1-ok> show job all
Pour plus de détails, reportez-vous à show job.

La liste de toutes les tâches pour N1 System Manager s'affiche.

Exemple 7–1 Affichage de la liste de toutes les tâches

N1-ok> show job all
Job ID          Date                       Type                  Status        Creator
7               2005-02-16T10:51:07-0700   Discovery             Completed      root
6               2005-02-14T14:42:52-0700   Server Reboot         Error          root
5               2005-02-14T14:38:25-0700   Server Power On       Completed      root
4               2005-02-14T14:29:20-0700   Server Power Off      Completed      root
3               2005-02-09T13:01:35-0700   Discovery             Completed      root
2               2005-02-09T12:38:16-0700   Discovery             Completed      root
1               2005-02-09T10:32:40-0700   Discovery             Completed      root

Affichage d'une tâche spécifique

Étapes

Connectez-vous à N1 System Manager.

Pour plus de détails, reportez-vous au point Accès à la ligne de commande de N1 System Manager .

Affichez une tâche spécifique.
N1-ok> show job tâche
Pour plus de détails, reportez-vous à show job.

La commande renvoie des informations détaillées sur la tâche.

Exemple 7–2 Affichage des détails d'une tâche

N1-ok> show job 5
Job ID:      5
Date:        2005-02-14T14:38:25-0700
Type:        Server Power On
Status:      Completed
Creator:     root
Errors:      0
Warnings:    0
Step 1:      
Type:        103
Description: native procedure /bin/sh /opt/sun/n1gc/bin/serverPowerOn.sh :[SERVER_NAME] :[JOBID_KEY]
Start:       2005-02-14T14:38:25-0700
Completion:  2005-02-14T14:38:25-0700
Result:      Complete
Exception:   No Data Available
Step 2:      
Type:        103
Description: native procedure /bin/sh /opt/sun/n1gc/bin/serverPowerOn.sh :[SERVER_NAME] :[JOBID_KEY]
Start:       2005-02-14T14:38:28-0700
Completion:  2005-02-14T14:38:35-0700
Result:      Complete
Exception:   No Data Available
Step 3:      
Type:        135
Description: connect and lock hosts
Start:       2005-02-14T14:38:25-0700
Completion:  2005-02-14T14:38:25-0700
Result:      Complete
Exception:   No Data Available
Step 4:      
Type:        135
Description: connect and lock hosts
Start:       2005-02-14T14:38:27-0700
Completion:  2005-02-14T14:38:28-0700
Result:      Complete
Exception:   No Data Available
Result 1:    
Server:      192.168.200.3
Status:      0
Message:     The server operation was successful.
N1-ok>

Arrêt d'une tâche

Étapes

Connectez-vous à N1 System Manager.

Pour plus de détails, reportez-vous au point Accès à la ligne de commande de N1 System Manager .

Arrêtez une tâche spécifique.
N1-ok> stop job tâche
Pour plus de détails, reportez-vous à stop job.

La tâche est arrêtée.

Affichez les détails de la tâche.
N1-ok> show job tâche
Pour plus de détails, reportez-vous à show job.

La partie Résultat de la sortie indique que la tâche a été annulée.

Arrêt d'une tâche commandée à distance

Étapes

Connectez-vous à N1 System Manager.

Pour plus de détails, reportez-vous au point Accès à la ligne de commande de N1 System Manager .

Arrêtez la tâche commandée à distance.
N1-ok> stop job tâche
Pour plus de détails, reportez-vous à show job.stop job

La tâche est arrêtée.

Affichez les détails de la tâche.
N1-ok> show job tâche
Pour plus de détails, reportez-vous à show job.

La partie Résultat de la sortie indique que la tâche a été annulée.

Exemple 7–3 Arrêt d'une tâche commandée à distance

N1-ok> stop job 9

Stop Job "9" request received.

N1-ok> show job 9

Job ID:   9
Date:     2005-02-15T16:43:58-0700
Type:     Remote Command
Status:   Stopped
Owner:    root
Errors:   0
Warnings: 0

Step 1:     
Type:        135
Description: connect and lock hosts
Start:       2005-02-15T16:43:58-0700
Completion:  2005-02-15T16:43:58-0700
Result:      Complete
Exception:   No Data Available

Step 2:     
Type:        103
Description: native procedure /bin/sh /opt/sun/n1gc/bin/remotecmd.sh
:[RCMD_KEY]
Start:       2005-02-15T16:43:58-0700
Completion:  2005-02-15T16:43:58-0700
Result:      Complete
Exception:   No Data Available

Step 3:     
Type:        135
Description: connect and lock hosts
Start:       2005-02-15T16:44:00-0700
Completion:  2005-02-15T16:44:00-0700
Result:      Complete
Exception:   No Data Available

Step 4:     
Type:        103
Description: native procedure /bin/sh /opt/sun/n1gc/bin/remotecmd.sh
:[RCMD_KEY]
Start:       2005-02-15T16:44:00-0700
Completion:  2005-02-15T16:44:49-0700
Result:      Incomplete - Aborted
Exception:   No Data Available

Result :        
Server:          server1
Status:          -1
Message:         Command running on server1 was canceled. Command:
/root/sleep.sh 60
Standard Output: Sleeping for 60 seconds...

Voir aussi

Envoi d'une commande à distance sur un serveur ou un groupe de serveurs

Suppression d'une tâche

Étapes

Connectez-vous à N1 System Manager.

Pour plus de détails, reportez-vous au point Accès à la ligne de commande de N1 System Manager .

Déterminez la tâche à supprimer.
N1-ok> show job all
Pour plus de détails, reportez-vous à show job.

Toutes les tâches et leurs ID s'affichent en sortie.

Supprimez la tâche souhaitée.
N1-ok> delete job tâche
Pour plus de détails, reportez-vous à delete job.

La tâche est supprimée.

Vérifiez que la tâche a bien été supprimée.
N1-ok> show job all
Pour plus de détails, reportez-vous à show job.

La tâche supprimée ne devrait pas apparaître en sortie.

Exemple 7–4 Suppression d'une tâche

N1-ok> show job all
Job ID          Date                       Type                  Status           Creator
7               2005-02-16T10:51:07-0700   Discovery             Completed        root
6               2005-02-14T14:42:52-0700   Server Reboot         Error            root
5               2005-02-14T14:38:25-0700   Server Power On       Completed        root
4               2005-02-14T14:29:20-0700   Server Power Off      Completed        root
3               2005-02-09T13:01:35-0700   Discovery             Completed        root
2               2005-02-09T12:38:16-0700   Discovery             Completed        root
1               2005-02-09T10:32:40-0700   Discovery             Completed        root
N1-ok> delete job 6

N1-ok> show job all
Job ID          Date                       Type                  Status           Creator
7               2005-02-16T10:51:07-0700   Discovery             Completed        root
5               2005-02-14T14:38:25-0700   Server Power On       Completed        root
4               2005-02-14T14:29:20-0700   Server Power Off      Completed        root
3               2005-02-09T13:01:35-0700   Discovery             Completed        root
2               2005-02-09T12:38:16-0700   Discovery             Completed        root
1               2005-02-09T10:32:40-0700   Discovery             Completed        root

Gestion des entrées du journal des événements

Des événements sont générés en présence de certaines conditions liées à des attributs. Chaque type d'événement est associé à une rubrique. Par exemple, quand le serveur de gestion détecte un serveur, il génère un événement associé à la rubrique Action.Physical.Discovered. Pour la liste complète des rubriques d'événements, reportez-vous à create notification.

Les événements peuvent être contrôlés : le contrôle est lié à la diffusion des événements de chaque serveur ou groupe de serveurs contrôlé. Si le contrôle a été activé pour un serveur, l'événement cause l'émission d'une notification correspondante en provenance du serveur de gestion à condition qu'une règle de notification ait été ajoutée pour cet événement. Reportez-vous au point Configuration des notifications pour en savoir plus sur les notifications. Lors de l'interrogation d'un attribut, si sa valeur est supérieure au seuil de sécurité par défaut ou défini par l'utilisateur, un événement est généré avec un message d'état. Pour en savoir plus, reportez-vous au point Contrôle des valeurs des seuils .

Si le contrôle a été désactivé pour un serveur, les événements ne seront pas contrôlés pour ce serveur. Vous pouvez donc, par exemple, désactiver le contrôle de composants matériels pour l'exécution de tâches de maintenance sans générer d'événements. Reportez-vous au point Introduction au contrôle pour en savoir plus sur le contrôle. Reportez-vous au point Configuration des notifications pour en savoir plus sur les notifications. Les événements liés au cycle de vie continuent à être générés même quand le contrôle est désactivé. Les événements liés au cycle de vie comprennent la détection de serveurs, les modifications et les suppressions ou les créations de groupes. Si vous avez demandé une notification de ce type d'événements, vous recevrez les notifications même si le contrôle est désactivé.

Les journaux sont créés quand les événements se produisent. Par exemple, un événement est généré si l'une quelconque des adresses IP surveillées est introuvable. Cet événement est consigné dans un journal accessible à l'aide de l'interface de navigateur.

Lors de l'installation et de la configuration de N1 System Manager, vous pouvez spécifier les événements à consigner et indiquer interactivement leurs niveaux de gravité. Reportez-vous au point Configuration du système N1 System Manager du Guide d’installation et de configuration de Sun N1 System Manager 1.0.

Un journal peut générer une notification, même s'il n'est pas enregistré.

Pour les événements générés pendant l'exécution d'une tâche, la source est le numéro de l'événement.

Présentation du journal des événements

Utilisez la commande show avec le mot-clé log pour afficher les informations suivantes sur les événements.

Date – Date et heure de l'événement
Sujet – Serveur sur lequel l'événement s'est produit
Type d'événement – Type de l'événement survenu. Cette information peut s'avérer utile pour la configuration de notifications. Reportez-vous au point Configuration des notifications pour en savoir plus sur la configuration des notifications.
Gravité – Gravité relative de l'événement
Niveau – Niveau relatif de l'événement
Source – Nom du composant qui a généré l'événement
Rôle – Rôle ou nom de l'utilisateur qui a créé l'événement
Message – Texte complet du message du journal des événements

Affichage du journal des événements

Étapes

Connectez-vous à N1 System Manager.

Pour plus de détails, reportez-vous au point Accès à la ligne de commande de N1 System Manager .

Tapez la commande suivante :
N1-ok> show log [count=compteur]
Le journal des événements affiche les événements par ordre chronologique, en commençant par le plus récent. La valeur de l'attribut count est le nombre des événements affichés en sortie de la commande. La valeur par défaut de count est 500. Pour plus de détails, reportez-vous à show log.

Voir aussi

Présentation du journal des événements

Filtrage du journal des événements.

Étapes

Connectez-vous à N1 System Manager.

Pour plus de détails, reportez-vous au point Accès à la ligne de commande de N1 System Manager .

Tapez la commande suivante :
N1-ok> show log [severity=gravité] [before=date] [after=date]
La sortie de la commande n'affiche que les événements remplissant les critères spécifiés. Les valeurs de la variable date doivent être au format approprié, par exemple, 2005-07-20T11:53:04. Les valeurs possibles pour la gravité sont critical , fatal, information, major , minor, other, unknown , and warning. Pour plus de détails, reportez-vous àshow log.

Affichage des détails des événements

Étapes

Connectez-vous à N1 System Manager.

Pour plus de détails, reportez-vous au point Accès à la ligne de commande de N1 System Manager .

Tapez la commande suivante :
N1-ok> show log journal
Les détails de l'événement s'affichent. La variable log est l'ID du journal. Pour plus de détails, reportez-vous àshow log.

Exemple 7–5 Affichage des détails d'un événement

N1-ok> show log 72
ID:       72
Date:     2005-03-15T13:35:59-0700
Subject:  RemoteCmdPlan
Topic:    Action.Logical.JobStarted
Severity: Information
Level:    FINE
Source:    Job Service
Role:     root
Message:  RemoteCmdPlan job initiated by root: job ID = 15.

Configuration des notifications

N1 System Manager permet de configurer des notifications par e-mail ou SNMP des événements survenus dans N1 System Manager ou des événements spécifiques survenus dans les serveurs de déploiement. Vous pouvez personnaliser les règles de notification avec autant de scénarios que vous le souhaitez. La configuration des notifications n'est possible que depuis la ligne de commande.

Utilisez la commande create notification pour créer des règles de notification en fonction de l'intérêt que vous portez à des événements survenus ou pouvant survenir. Utilisez une rubrique pour créer une notification.

Vous pouvez utiliser une règle de notification pour envoyer une notification de chaque type d'événement à une destination choisie, en utilisant l'e-mail ou SNMP comme moyen de communication. Par exemple, vous pouvez créer une règle de notification selon laquelle chaque fois qu'un nouveau serveur de déploiement est détecté par le serveur de gestion, vous recevez un message sur votre pager indiquant que l'événement s'est produit :

create notification notification destination destination topic rubrique 
type type [description description]

Reportez-vous à create notification pour en savoir plus sur la syntaxe de cette commande.

Lors de l'installation et de la configuration de N1 System Manager, vous pouvez configurer votre serveur SMTP pour utiliser la notification des événements. Reportez-vous au point Configuration du système N1 System Manager du Guide d’installation et de configuration de Sun N1 System Manager 1.0.

Affichage et modification des notifications

Utilisez les commandes show et set avec les mots-clés notification pour afficher et modifier les détails d'une notification. Tapez help show notification ou help set notification sur la ligne de commande N1–ok pour connaître la syntaxe et les paramètres de la commande.

Affichage des notifications

Étapes

Connectez-vous à N1 System Manager.

Pour plus de détails, reportez-vous au point Accès à la ligne de commande de N1 System Manager .

Tapez la commande suivante :
N1-ok> show notification all
Les notifications pour lesquelles vous bénéficiez de droits d'accès en lecture s'affichent. Pour plus de détails, reportez-vous show notification.

Affichage des détails d'une notification

Étapes

Connectez-vous à N1 System Manager.

Pour plus de détails, reportez-vous au point Accès à la ligne de commande de N1 System Manager .

Tapez la commande suivante :
N1-ok> show notification notification
Les détails de la notification spécifiée s'affichent. Pour plus de détails, reportez-vousshow notification.

Exemple 7–6 Affichage des détails d'une notification

N1-ok> show notification test2
Name:          test2
Event Topic:   EReport.Physical.ThresholdExceeded
Notifier Type: Email
Destination:   nobody@sun.com
State:         enabled

Modification d'une notification

Cette procédure décrit comment modifier le nom, la description ou la destination d'une notification.

Étapes

Connectez-vous à N1 System Manager.

Reportez-vous à Accès à la ligne de commande de N1 System Manager for details.

Tapez la commande suivante :
N1-ok> set notification notification name nom descriptiondescription destination destination
Les nouvelles valeurs entrées sont appliquées aux attributs de la notification spécifiée. Reportez-vous à set notification.

Exemple 7–7 Modification du nom d'une notification

N1-ok> set notification test2 name test3

Création, test et suppression de notifications

Utilisez la commande create ou delete avec le mot-clé notification pour créer ou supprimer des notifications. Utilisez la commande create avec le mot-clé notification et la sous-commande test pour tester une notification. Tapez la commande help create notification ou help delete notification à l'invide N1–ok de la ligne de commande pour connaître la syntaxe et les paramètres de la commande.

Création et test d'une notification

Étapes

Connectez-vous à N1 System Manager.

Pour plus de détails, reportez-vous au point Accès à la ligne de commande de N1 System Manager .

Tapez la commande suivante :
N1-ok> create notification notification topic rubrique type type destination destination
La notification est créée et activée. Pour plus de détails et connaître les rubriques admises, reportez-vous à create notification.

Tapez la commande suivante :
N1-ok> start notification notification test
Un message de notification de test en envoyé. Pour plus de détails, reportez-vous à start notification.

Exemple 7–8 Création d'une notification par e-mail

N1-ok> create notification test2 topic EReport.Physical.ThresholdExceeded 
type email destination nobody@sun.com
N1-ok> show notification
Name    Event Topic                         Destination       State
test2   EReport.Physical.ThresholdExceeded  nobody@sun.com     enabled

Exemple 7–9 Création d'une notification par SNMP

N1-ok> create notification test2 topic EReport.Physical.ThresholdExceeded 
type snmp destination sun.com
N1-ok> show notification
Name    Event Topic                         Destination  State
test2   EReport.Physical.ThresholdExceeded  sun.com     enabled

Suppression d'une notification

Étapes

Connectez-vous à N1 System Manager.

Pour plus de détails, reportez-vous au point Accès à la ligne de commande de N1 System Manager .

Tapez la commande suivante :
N1-ok> delete notification notification
La notification est supprimée.

Démarrage et arrêt de notifications

Les notifications sont activées ou démarrées par défaut à leur création. Utilisez la commande start avec le mot-clé notification pour activer une notification qui avait été désactivée. Tapez help start notification à l'invite N1–ok de la ligne de commande pour connaître la syntaxe et les paramètres de la commande.

Démarrage d'une notification

Étapes

Connectez-vous à N1 System Manager.

Pour plus de détails, reportez-vous au point Accès à la ligne de commande de N1 System Manager .

Tapez la commande suivante :
N1-ok> start notification notification
La notification est activée. Pour plus de détails, reportez-vous à start notification.

Arrêt d'une notification

Étapes

Connectez-vous à N1 System Manager.

Pour plus de détails, reportez-vous au point Accès à la ligne de commande de N1 System Manager .

Tapez la commande suivante :
N1-ok> stop notification notification
La notification est désactivée. Pour plus de détails, reportez-vous à stop notification.