Ce chapitre explique comment :
Créer un rapport de volume personnalisé
Créer un rapport statistique des mouvements de volume
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 :
Connectez-vous en tant qu'utilisateur acsss
.
Ouvrez un outil de commande UNIX.
Modifiez le répertoire du rapport de volume personnalisé :
cd /home/ACSSS/data/external/volrpt
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.
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.
Enregistrez le fichier lorsque vous avez fini de le modifier.
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
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
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.