Rapports SEF (System Error Facility)

Le système de rapports SEF (System Error Facility) capture des données d'analyse de journalisation provenant des périphériques à bande d'une bibliothèque automatisée, les écrit dans un fichier journal et les convertit en un format lisible par l'utilisateur. Il comprend les éléments suivants :

Un fichier journal qui contient des données provenant de pages d'analyse du journal des périphériques à bande.
Une commande, sefreport, pour l'écriture du fichier journal dans stdout sous une forme lisible par l'utilisateur. Ce fichier journal peut être utilisé comme entrée dans un script d'analyse fourni par l'utilisateur.

Les pages d'analyse du journal varient selon le fabricant. Pour connaître la signification des codes de paramètres, bits de contrôle et valeurs de paramètres, consultez la documentation du fabricant fournie pour chaque périphérique.

Les rapports SEF ne sont pas pris en charge pour les lecteurs de bande autonomes. La génération de rapports SEF est plus utile pour les anciens périphériques SCSI-2 qui ne prennent pas en charge la fonctionnalité tapealert. Pour plus d'informations, reportez-vous à la section tapealert(1M) du manuel Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual.

Pour activer les rapports SEF

Connectez-vous en tant que superutilisateur.
Exécutez la commande mkdir pour créer le répertoire SEF.
Par exemple :
```
# mkdir /var/opt/SUNWsamfs/sef
```
Utilisez la commande touch pour créer le fichier journal.
Vous pouvez activer les rapports SEF à tout moment après l'installation en créant le fichier journal sefdata. A l'origine, le fichier journal SEF doit être vide. La commande suivante illustre la création du fichier journal SEF à l'emplacement par défaut.
```
# touch /var/opt/SUNWsamfs/sef/sefdata
```
Utilisez les commandes samd stop et samd start pour lancer la création de rapports SEF.
```
# samd stop
# samd config
# samd start
```
1. Patientez jusqu'à ce que les lecteurs de bande soient inactifs. Déchargez ensuite les lecteurs de bande.
  Pour eq, spécifiez le numéro d'équipement du lecteur.
2. Saisissez la commande samd unload pour décharger tous les médias amovibles :
```
# samd unload eq
```
Répétez les étapes 1 à 4 pour chaque lecteur de bande.
Les données SEF sont ajoutées au fichier journal dès sa génération.

Remarque - Les rapports SEF sont activés tant que le fichier journal sefdata existe. Pour désactiver les rapports SEF, renommez ou supprimez ce fichier.

Vous pouvez configurer les rapports SEF pour consigner et lire des données d'analyse de journalisation à partir d'un autre emplacement. Pour plus d'informations sur la lecture des données d'analyse de journalisation à partir d'un autre emplacement, reportez-vous à la section sefreport(1M) du manuel Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual.

Génération de la sortie de rapport SEF

La sortie de rapport SEF est constituée de lignes d'en-tête et de données d'analyse du journal.

Vérifiez que /opt/SUNWsamfs/sbin est situé dans le chemin d'accès défini dans la commande.
Exécutez la commande sefreport pour générer la sortie SEF.
Vous trouverez ci-dessous les options les plus couramment utilisées avec la commande sefreport :
- L'option -d. L'option -d génère des informations supplémentaires sur le périphérique. Elle écrit une ligne d'en-tête supplémentaire contenant le nombre ordinal d'équipement et le nom du chemin d'accès du périphérique pour chaque enregistrement Cela facilite la recherche et la localisation d'enregistrements SEF relatifs à un périphérique spécifique.
- L'option -v ou l'option -t. Ne spécifiez pas les options -t et -v sur la même ligne de commande. Elles s'excluent mutuellement.
  - L'option -v génère des informations en mode détaillé. Elle ajoute des informations relatives au nombre ordinal d'équipement, au code de page et au nom de série de volume (VSN) pour chaque ligne d'un enregistrement. De cette manière, vous pouvez sélectionner uniquement les lignes relatives à un périphérique ou à un volume donnés.
  - L'option -t génère une sortie d'analyse de journalisation avec des textes descriptifs. Pour chaque ligne de sortie des données d'analyse de journalisation, le rapport inclut une chaîne supplémentaire contenant le nombre ordinal d'équipement, le code de page, le VSN et la description de code de paramètre.
    
    Par exemple, la commande SEF suivante lit le fichier journal SEF à partir de l'emplacement par défaut, écrit le numéro de périphérique et le nom du chemin d'accès de chaque périphérique, puis génère la sortie suivante :
```
# sefreport -d /var/opt/SUNWsamfs/sef/sefdata > sef.output
```

Exemple 17-3 Contenu du fichier sef.output

Record no. 1
Mon Mar 26 11:17:48 2001 STK 9840 1.25 VSN 002981
Eq no. 32 Dev name /dev/rmt/1cbn
PAGE CODE 2
param code control param value
00h 74h 0x0
01h 74h 0x0
02h 74h 0x0
03h 74h 0x0
04h 74h 0x0
05h 74h 0x40050
06h 74h 0x0
PAGE CODE 3
param code control param value
00h 74h 0x0
01h 74h 0x0
02h 74h 0x0
03h 74h 0x0
04h 74h 0x0
05h 74h 0x140
06h 74h 0x0
PAGE CODE 6
param code control param value
00h 74h 0x0
Record no. 2
Mon Mar 26 11:30:06 2001 STK 9840 1.25 VSN 002999
Eq no. 31 Dev name /dev/rmt/0cbn
PAGE CODE 2
param code control param value
00h 74h 0x0
01h 74h 0x0
02h 74h 0x0
03h 74h 0x0
04h 74h 0x0
05h 74h 0x1400a0
06h 74h 0x0

PAGE CODE 3
param code control param value
00h 74h 0x0
01h 74h 0x0
02h 74h 0x0

03h 74h 0x0
04h 74h 0x0
05h 74h 0x190
06h 74h 0x0
PAGE CODE 6
param code control param value
00h 74h 0x0
Record no. 3
Mon Mar 26 11:30:23 2001 STK 9840 1.25 VSN 002981
Eq no. 32 Dev name /dev/rmt/1cbn
PAGE CODE 2
param code control param value
00h 74h 0x0
01h 74h 0x0
02h 74h 0x0
03h 74h 0x0
04h 74h 0x0
05h 74h 0x18400f0
06h 74h 0x0

PAGE CODE 3
param code control param value
00h 74h 0x0
01h 74h 0x0
02h 74h 0x0
03h 74h 0x0
04h 74h 0x0
05h 74h 0x1e0
06h 74h 0x0
PAGE CODE 6
param code control param value
00h 74h 0x0
.
.
.

Pour plus d'informations sur le fichier journal SEF, notamment son contenu et son format, reportez-vous à la section sefdata(4) du manuel Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual. Pour plus d'informations sur les formats de rapport SEF facultatifs, reportez-vous à la section sefreport(1M) du manuel Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual.

Gestion du fichier journal SEF

Le fichier journal SEF peut être géré de la même manière que tout autre fichier journal SAM-QFS. Une tâche cron peut être exécutée régulièrement pour enregistrer le fichier journal en cours à un autre endroit, pour supprimer les anciens fichiers SEF, pour créer de nouveaux fichiers SEF (vides) ou pour effectuer d'autres tâches.

Vous pouvez également utiliser l'utilitaire log_rotate.sh pour gérer la rotation de ce fichier journal.

Pour plus d'informations sur le fichier journal SEF, reportez-vous aux pages de manuel cron(1M) or log_rotate.sh(1M).

Fonctionnalité `sysevent` SEF

En plus d'utiliser le fichier journal SEF, vous pouvez utiliser la fonction sysevent d'Oracle Solaris afin que le lecteur de bande SCSI consigne les pages 2 et 3 du compteur d'erreur d'analyse en vue de l'analyse du média. Par défaut, la fonctionnalité sysevent SEF est activée et définie pour pouvoir interroger une fois avant le déchargement. Le comportement de la fonctionnalité sysevent SEF est contrôlé par defaults.conf et samset.

Dans le fichier defaults.conf, le paramètre sef permet d'activer la fonctionnalité sysevent SEF par nombre ordinal d'équipement ou pour spécifier la fréquence de sondage de l'analyse du journal. Pour plus d'informations, reportez-vous à la page de manuel defaults.conf(4) du manuel Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual.

Pour créer le gestionnaire `sysevent` SEF

Créez un fichier /var/tmp/xx.

Par exemple :

# !/bin/ksh
echo "$@" >> /var/tmp/xx.dat
exit 0

Faites en sorte que le fichier /var/tmp/xx soit exécutable.

# chmod a+rwx /var/tmp/xx

Ajoutez le gestionnaire sysevent SEF au fichier syseventd en ajoutant les informations suivantes.

# syseventadm add -vSUNW -pSUNWsamfs -cDevice -sSEF 
/var/tmp/xx "$VENDOR" "$PRODUCT" "$USN" "$REV" 
$TOD $EQ_ORD "$NAME" $INQ_TYPE "$MEDIA_TYPE" "$VSN" 
$LABEL_TIME $LP2_PC0 $LP2_PC1 $LP2_PC2 $LP2_PC3 $LP2_PC4 
$LP2_PC5 $LP2_PC6 $LP3_PC0 $LP3_PC1 $LP3_PC2 $LP3_PC3 
$LP3_PC4 $LP3_PC5 $LP3_PC6 $WHERE $sequence
# syseventadm restart

Cette commande crée le fichier /etc/sysevent/config/SUNW,SUNWsamfs,Device,sysevent.conf contenant le gestionnaire sysevent SEF /var/tmp/xx et charge le gestionnaire d'événements dans le démon syseventd.

Pour charger le gestionnaire sysevent SEF, exécutez la commande suivante :
```
# pkill -HUP syseventd 
```
Pour plus d'informations, reportez-vous à la section sefsysevent(4) du manuel Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual.

Ignorer les liens de navigation
Quitter l'aperu
	Guide de configuration et d'administration de Sun Storage Archive Manager 5.3 Sun QFS and Sun Storage Archive Manager 5.3 Information Library (Français)