11 Informes y logs

En este capítulo, se describen las siguientes tareas:

  • Creación de un informe de volumen personalizado

  • Creación un informe sobre estadísticas de movimiento de volúmenes

Creación un informe de volumen personalizado

La utilidad volrpt permite crear un informe de volumen; para obtener más información, consulte volrpt. $ACS_HOME/data/external/volrpt/owner_id.volrpt es un ejemplo de archivo de entrada que puede ejecutar o utilizar como plantilla para crear informes de volumen personalizados. También puede guardar sus informes de volumen personalizados en el directorio $ACS_HOME/data/external/volrpt. Utilice este procedimiento para crear un archivo de entrada para la utilidad volrpt a fin de crear un informe de volumen personalizado.

Para crear un informe de volumen personalizado, realice lo siguiente:

  1. Inicie sesión como acsss.

  2. Abra una herramienta de comandos de UNIX.

  3. Cambie al directorio de informes de volumen personalizados:

    cd /home/ACSSS/data/external/volrpt

  4. Copie el archivo de informe de volumen de ejemplo a un archivo personalizado nuevo.

    cp owner_id.volrpt my.volrpt

    my.volrpt es el nombre que desea asignar al archivo nuevo.

  5. Edite el archivo my.volrpt utilizando un editor de texto, como vi, para especificar los campos y formatos que desea ver en el informe personalizado.

    • Puede especificar cualquiera de los campos que se muestran en el archivo de ejemplo.

    • El formato para cada entrada es: field_name field_length delimiter_length

    • Puede configurar los delimitadores y las longitudes de campo con los tamaños que desee. Asegúrese de que todos los campos que especifique entren en una línea cuando se imprima el informe.

    • En el archivo de ejemplo, se proporcionan instrucciones detalladas de edición.

  6. Guarde el archivo cuando termine de editarlo.

Informe de volumen personalizado

Un informe personalizado se crea especificando los campos, las longitudes de campo y las longitudes de delimitador en un archivo de entrada, como el que se muestra en el ejemplo que se proporciona a continuación.

################################################################
#
# 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

Desde este archivo de entrada, genere el informe personalizado que se muestra. Entre otros usos, un informe personalizado, como se muestra en el siguiente ejemplo, permite informar los propietarios de los volúmenes.

Este es un ejemplo de un informe de volumen personalizado creado a partir del archivo de entrada:

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

Ejemplo de informe de volumen personalizado

La siguiente utilidad volrpt incluye los ACS 0 y 1, los volúmenes ausentes y expulsados, y muestra el estado de los volúmenes.

La opción volrpt de entrada es la siguiente:

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

Estas sentencias de control se utilizan para seleccionar la salida y aplicarle formato.

Ejemplo de las sentencias de control de un informe de volumen personalizado:

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

Ejemplo de utilidad volrpt personalizada que muestra los volúmenes ausentes y expulsados:

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

Creación de un informe de estadísticas de volumen de log

Puede utilizar el archivo del log de estadísticas de volumen (acsss_stats.log) para registrar las estadísticas de movimiento de volumen. Estas estadísticas incluyen entradas para cada cambio que ACSLS detecta en la ubicación del volumen. ACSLS registra entradas para introducciones, expulsiones, montajes, desmontajes, y para cada cambio que una auditoría detecta en la ubicación de un volumen (normalmente, por un movimiento manual).

Utilice el programa de configuración acsss_config para realizar lo siguiente:

  • Active o desactive el log de estadísticas de volumen mediante la variable LIB_VOL_STATS.

  • Especifique el tamaño máximo del archivo del log de estadísticas de volumen.

  • Especifique el número de archivos de renovación para el archivo del log de estadísticas de volumen.

La utilidad stats_report usa el archivo acsss_stats.log para informar todos los montajes y el uso de unidades de cinta.

El archivo del log de estadísticas de volumen contiene entradas del modo de recopilación que informan si el log de estadísticas de volumen está activado o desactivado, y entradas de estadísticas de volumen.

Ejemplo de entradas de archivo del log de estadísticas de volumen:

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

En el ejemplo anterior, las entradas del modo de recopilación muestran que la recopilación de estadísticas comenzó el 30 de junio de 2014 a las 8:53 a. m. y finalizó a las 10:45 a. m. del mismo día. Estas horas de comienzo y finalización de la recopilación limitan las entradas de estadísticas de volumen para este período de recopilación.

El formato de las entradas de estadísticas de volumen es el siguiente:

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

    vol_id home_loc function_loc client_host_ID

Donde:

  • yyyy-mm-dd es el año, el mes y el día de la entrada. Se admiten los formatos de cuatro dígitos para el año. El formato de fecha se especifica mediante acsss_config.

  • hh:mm:ss es la hora, los minutos y los segundos de la entrada.

  • command es la solicitud de cliente o comando de ACSLS que movió el volumen o (para las auditorías) detectó que se movió el volumen.

    • MOUNT es la solicitud de montaje.

    • DISMOUNT es la solicitud de desmontaje.

    • ENTER es la solicitud de enter en modo manual o automático.

    • EJECT es la solicitud de expulsión.

    • AUDIT es la solicitud de auditoría.

    • ACSMV es la solicitud de movimiento.

    • ACSCR es la actividad de recuperación de volumen. Esta actividad se genera automáticamente mediante el procesamiento de ACSLS.

  • vol_id es el identificador de volumen.

  • home_loc es la ubicación de origen de volumen (celda de almacenamiento).

  • function_loc es la ubicación del volumen para las solicitudes que lo utilizaron de la siguiente manera:

    • Solicitudes mount o dismount

      La ubicación es un ID de transporte.

    • Solicitudes enter o eject

      La ubicación es un ID de CAP.

  • La solicitud audit especifica que una auditoría detectó uno de los siguientes errores:

    • STATUS_VOLUME_FOUND

      La auditoría encontró un volumen en una ubicación que no coincidía con la ubicación especificada en la base de datos.

    • STATUS_VOLUME_NOT_FOUND

      La auditoría no encontró un volumen en la ubicación especificada en la base de datos.

    • Volume Recovery activity

      La ubicación puede ser un ID de celda o un ID de transporte, lo cual indica que la recuperación de volumen detectó una de las siguientes situaciones:

      • STATUS_VOLUME_FOUND

        Se encontró un volumen que no estaba registrado en la base de datos y que se está agregando.

      • STATUS_VOLUME_NOT_FOUND

        Un volumen de la base de datos no se encontró en ninguna ubicación registrada y se está suprimiendo.

  • El client_host_ID es uno de los siguientes:

    • Para las solicitudes de aplicación de cliente, es la dirección IP del host.

    • Para los comandos cmd_proc, si se establece la variable de entorno LIBVOLSTATS_CMD_PROC_ID (solo caracteres ASCII) en el entorno del shell que inició el comando cmd_proc, la entrada se forma con los doce primeros caracteres del valor de la variable de entorno.

    • Para los comandos cmd_proc, si la variable de entorno LIBVOLSTATS_CMD_PROC_ID no se define o contiene caracteres que no son ASCII, la entrada es local.