11 Création de rapport et journalisation

Ce chapitre explique comment :

  • Créer un rapport de volume personnalisé

  • Créer un rapport statistique des mouvements de volume

Création d'un rapport de volume personnalisé

Vous pouvez utiliser l'utilitaire volrpt pour créer un rapport de volume. Pour plus d'informations, voir volrpt. $ACS_HOME/data/external/volrpt/owner_id.volrpt est un exemple de fichier d'entrée que vous pouvez exécuter ou utiliser comme modèle pour créer vos rapports de volume personnalisés. Vous pouvez également enregistrer vos rapports de volume personnalisés dans le répertoire $ACS_HOME/data/external/volrpt. Utilisez cette procédure pour créer un fichier d'entrée pour l'utilitaire volrpt, afin de créer un rapport de volume personnalisé.

Pour créer un rapport de volume personnalisé, procédez comme suit :

  1. Connectez-vous en tant qu'utilisateur acsss.

  2. Ouvrez un outil de commande UNIX.

  3. Modifiez le répertoire du rapport de volume personnalisé :

    cd /home/ACSSS/data/external/volrpt

  4. Copiez-collez l'exemple de fichier de rapport de volume dans un nouveau fichier personnalisé.

    cp owner_id.volrpt my.volrpt

    my.volrpt est le nom que vous allez donner au nouveau fichier.

  5. Avec un éditeur de texte, tel que vi, modifiez le fichier my.volrpt de façon à indiquer les champs et les formats que vous souhaitez utiliser dans le rapport personnalisé.

    • Vous pouvez indiquer n'importe quel champ parmi ceux répertoriés dans l'exemple de fichier.

    • Format de chaque entrée : field_name field_length delimiter_length

    • Vous pouvez choisir la longueur de champ et les délimiteurs que vous souhaitez. Assurez-vous que tous les champs indiqués tiennent sur une ligne lors de l'affichage du rapport.

    • Des instructions détaillées de modification sont fournies dans l'exemple de fichier.

  6. Enregistrez le fichier lorsque vous avez fini de le modifier.

Rapport de volume personnalisé

Vous créez un rapport personnalisé en définissant les champs, leur longueur, la longueur des délimiteurs dans un fichier d'entrée, tel que celui de l'exemple ci-dessous.

################################################################
#
# FIle name: owner_id.volrpt
#
# This file describes the report layout for volrpt invoked with   # the -f option. # volrpt -f <filename>
#
# The format of a line is:
# field_namefield_lengthdelimiter_length
#
# The field length is the number of characters which will be printed for
# the field. The delimiter length is the number of spaces that will be
# printed after the field. If you leave out the lengths, or specify a
# value of -1, the default values will be used. Default delimiters are
# always 2. ere are the fields and their default lengths.
# 
# ACCESS_COUNT       5      2
# ACCESS_DATE       15      2
# CELL_ID           14      2
# DRIVE_ID          10      2
# ENTRY_DATE        15      2
# LABEL_ATTR         5      2
# LOCK_ID            5      2
# LOCK_TIME         15      2
# MAX_USE            5      2
# MEDIA_TYPE         7      2
# OWNER_ID          20      2
# POOL_ID            5      2
# VOLUME_ID          6      2
# VOL_STATUS        17      2
# VOLUME_TYPE        4      2
#
# Revision History:
# xx/xx/xx Name     Changes
#
################################################################
VOLUME_ID            6      2
MEDIA_TYPE           7      2
DRIVE_ID            12      2
CELL_ID             14      2
OWNER ID            -1      0

A partir de ce fichier d'entrée, générez le rapport personnalisés affiché. Parmi les utilisations possibles, un rapport personnalisé, comme celui de l'exemple suivant, vous permet de rapporter les propriétaires des volumes.

Exemple de rapport de volume personnalisé utilisant le fichier d'entrée :

2014-06-30 13:22:07

TOTAL    VOLUMES:2   SEQUENCE:   sort by volume identifier

Volume   Media                     Home                   Owner

Label    Type       Drive ID       Location               ID

RB1400   3480       Not-in-drv     0, 1, 1, 0, 0          cray
RB1401   DD3A       0, 0, 1, 0     0, 1, 2, 0, 0          cray

Exemple de rapport de volume personnalisé

Le volrpt suivant comprend les ACS 0 et 1, les volumes absents et éjectés, et affiche l'état des volumes.

Option d'entrée volrpt :

volrpt -f my.volrpt -a 0 1 -i

Ces instructions de contrôle servent à sélectionner et à formater la sortie.

Exemple d'instructions de contrôle d'un rapport de volume personnalisé :

CELL_ID          14           2
VOLUME_ID         6           2
VOL_STATUS       17           0
POOL_ID           5           2
ACCESS_COUNT      5           1
LOCK_ID           5           1
OWNER_ID         20           0

Exemple d'un volrpt personnalisé affichant les volumes absents et éjectés :

VOLUME REPORT UTILITY

2014-06-03 15:27:48

TOTAL VOLUMES: 61      SEQUENCE: sort by volume identifier

Home            Volume   Volume         Pool  Times  Lock Owner
Location---     Label   Status          ID    Mount  ID   ID------------

1, 0, 0, 0, 0   ABC001  VOLUME_HOME      0    2     0     presc
0,-1, 0, 0, 0   ABC002  VOLUME_ABSENT    0    0     0
0,-1, 0, 0, 0   ABC003  VOLUME_ABSENT    0    0     0
1, 3, 0, 0, 3   ABC004  VOLUME_MISSING   0    0     0
1, 3, 0, 0, 4   ABC005  VOLUME_MISSING   4    0     28001 tom
1, 3, 0, 0, 5   ABC006  VOLUME_MISSING   0    0     0
0,-1, 0, 0, 0   ABC007  VOLUME_ABSENT    0    0     0
1, 0, 0, 0, 7   ABC008  VOLUME_HOME      0    0     0
0,-1, 0, 0, 0   ABC009  VOLUME_ABSENT    0    0     0
0,-1, 0, 0, 0   ABC010  VOLUME_ABSENT    0    0     0     presc
1, 0, 0, 0,10   ABC011  VOLUME_HOME      0    0     0
1, 0, 0, 0,12   ABC012  VOLUME_HOME      0    0     2371  abc012
1, 0, 0, 0,13   ABC013  VOLUME_HOME      0    0     28001
1, 0, 0, 0,14   ABC014  VOLUME_HOME      0    0     28001
0,-1, 0, 0, 0   ABC015  VOLUME_ABSENT    1    0     29712
0,-1, 0, 0, 0   ABC016  VOLUME_EJECTED   1    0     29712
0,-1, 0, 0, 0   ABC017  VOLUME_ABSENT    1    0     29712
0,-1, 0, 0, 0   ABC018  VOLUME_ABSENT    1    0     29712
1, 0, 0, 0,19   ABC019  VOLUME_HOME      1    0     0
1, 0, 0, 0,20   ABC020  VOLUME_HOME      1    0     0
0,-1, 0, 0, 0   ABC021  VOLUME_ABSENT    0    0     0
0,-1, 0, 0, 0   ABC022  VOLUME_ABSENT    4    0     0

Création d'un journal de statistiques sur les volumes

Vous pouvez utiliser le fichier Volume Statistic Log (acsss_stats.log) pour enregistrer les statistiques de mouvement de volume. Ces statistiques se présentent sous forme d'entrées insérées à chaque fois qu'ACSLS détecte une modification d'emplacement de volume. ACSLS enregistre des entrées pour chaque insertion, éjection, montage, démontage et à chaque fois qu'un audit détecte que l'emplacement d'un volume a changé (généralement dû à un déplacement manuel).

Utilisez le programme de configuration acsss_config pour effectuer les tâches suivantes :

  • Activez ou désactivez la journalisation des statistiques sur les volumes avec la variable LIB_VOL_STATS.

  • Indiquez la taille maximal du fichier Volume Statistics Log.

  • Indiquez le nombre de fichiers de report du fichier Volume Statistic Log.

L'utilitaire stats_report utilise acsss_stats.log pour signaler tous les montages et l'utilisation des lecteurs de bande.

Le fichier Volume Statistics Log contient des entrées du mode de collecte qui indiquent si la journalisation des statistiques de volume est activée ou désactivée, ainsi que des entrées statistiques de volumes.

Exemples d'entrées du fichier Volume Statistics Log :

2014-06-30 08:53:00 CONFIG
Library volume statistics on.

2014-06-30 09:23:08 EJECT
U01120 Home 0,0,1,3,5 Cap 1,0,0 Client Host Id 129.81.15.25

2014-06-30 10:36:05 ENTER
PB0444 Home 0,0,4,3,5 Cap 0,0,0 Client Host Id 129.81.15.25

2014-06-30 10:42:48 MOUNT
PB0478 Home 0,0,1,35,1 Drive 0,0,1,0 Client Host Id Local

2014-06-30 10:43:19 DISMOUNT
PB0478 Home 0,0,1,35,1 Drive 0,0,1,0 Client Host Id Local

2014-06-30 10:43:19 AUDIT 
RB0478 0,0,1,35,1  STATUS_VOLUME_NOT_FOUND Client Host Id JBHUTTO

2014-06-30  10:43:19  AUDIT
PB0444  0,0,1,32,1 STATUS_VOLUME_FOUND Client Host Id JBHUTTO

2014-06-30 10:45:00 CONFIG
Library volume statistics off.

2015-01-16 09:51:07 ACSCR
0A1235 Home 0,0,5,14,14 STATUS_VOLUME_NOT_FOUND Client Host Id Local

2015-01-16 09:40:13 ACSCR
0A123A Home 0,0,5,14,15 STATUS_VOLUME_FOUND Client Host Id Local

Dans l'exemple ci-dessus, les entrées du mode de collecte indiquent que la collecte de données statistiques a démarré le 30 juin 2014 à 8:53 pour s'achever à 10:45, le même jour. Les heures de début et de fin de collecte permettent d'identifier les entrées statistiques de volume recueillies au cours de cette période de collecte.

Format des entrées statistiques de volume :

  • yyyy-mm-dd hh:mm:ss command

    vol_id home_loc function_loc client_host_ID

Où :

  • yyyy-mm-dd correspond à l'année, au mois et au jour de l'entrée. Les formats d'année à quatre chiffres sont pris en charge. Indiquez le format de date avec acsss_config.

  • hh:mm:ss correspond à l'heure, aux minutes et aux secondes de l'entrée.

  • command est la commande ACSLS ou la demande du client suite à laquelle le volume a été déplacé ou (pour les audits) qui a détecté le fait que le volume ait été déplacé.

    • MOUNT correspond à la demande de montage.

    • DISMOUNT correspond à la demande démontage.

    • ENTER correspond à la demande enter en mode manuel ou automatique.

    • EJECT correspond à la demande d'éjection.

    • AUDIT correspond à la demande d'audit.

    • ACSMV correspond à la demande de déplacement.

    • ACSCR correspond à l'activité Volume Recovery. Cette activité est générée automatiquement par le traitement ACSLS.

  • vol_id correspond à l'identificateur de volume.

  • home_loc correspond à l'emplacement (cellule de stockage) d'origine des volumes.

  • function_loc correspond à l'emplacement des volumes pour les demandes qui utilisent le volume comme suit :

    • L'emplacement des demandes mount ou dismount

      correspond à l'ID transport.

    • L'emplacement des demandes enter ou eject

      correspond à l'ID CAP.

  • Les demandes audit indiquent qu'un audit a détecté une des erreurs suivantes :

    • STATUS_VOLUME_FOUND

      L'audit a identifié un volume dans un emplacement qui ne correspond pas à l'emplacement indiqué dans la base de données.

    • STATUS_VOLUME_NOT_FOUND

      L'audit n'a pas identifié de volume dans l'emplacement indiqué dans la base de données.

    • Volume Recovery activity

      L'emplacement peut correspondre à un ID cellule ou à un ID transport qui indique que Volume Recovery a détecté l'une des situations suivantes :

      • STATUS_VOLUME_FOUND

        Un volume qui n'est pas enregistré dans la base de données a été identifié et ajouté.

      • STATUS_VOLUME_NOT_FOUND

        Un volume de la base de données n'a été identifié dans aucun emplacement enregistré et a été supprimé.

  • client_host_ID correspond à l'un des éléments suivants :

    • Pour les demandes d'application client, il s'agit de l'adresse IP hôte.

    • Pour les commandes cmd_proc, si la variable d'environnement LIBVOLSTATS_CMD_PROC_ID est définie (caractères ASCII uniquement) dans l'environnement shell à l'origine de la commande cmd_proc, l'entrée correspond aux douze premiers caractères de la valeur de la variable d'environnement.

    • Pour les commandes cmd_proc, si la variable d'environnement LIBVOLSTATS_CMD_PROC_ID n'est pas définie ou contient des caractères non ASCII, l'entrée est Local.