11 报告和日志记录

本章介绍如何:

  • 创建定制卷报告

  • 创建卷移动统计信息报告

创建定制卷报告

可以使用 volrpt 实用程序创建卷报告;有关更多信息,请参见volrpt$ACS_HOME/data/external/volrpt/owner_id.volrpt 是一个样例输入文件,可运行它并将其用作创建定制卷报告的模板。还可以将定制的卷报告保存在 $ACS_HOME/data/external/volrpt 目录中。使用此过程创建用于 volrpt 实用程序的输入文件,以创建定制卷报告。

要创建定制卷报告,请完成以下步骤:

  1. acsss 身份登录。

  2. 打开 UNIX 命令工具。

  3. 更改为定制卷报告目录:

    cd /home/ACSSS/data/external/volrpt

  4. 将卷报告样例文件复制到新的定制文件。

    cp owner_id.volrpt my.volrpt

    my.volrpt 是要分配给新文件的名称。

  5. 使用文本编辑器(如 vi)编辑 my.volrpt 文件,以指定要在定制报告中查看的字段和格式。

    • 您可以指定样例文件中列出的任何字段。

    • 每个条目的格式为:field_name field_length delimiter_length

    • 您可以根据需要指定任意大小的字段长度和分隔符。只是应确保在输出报告时,您指定的所有字段都在一行上。

    • 样例文件中提供了详细的编辑说明。

  6. 编辑完文件后保存它。

定制卷报告

通过在输入文件中指定字段、字段长度和分隔符长度可创建定制报告,如以下示例所示。

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

从该输入文件可生成所示的定制报告。除此之外,在以下示例中所示的定制报告还可以用于报告卷的所有者。

使用输入文件的定制卷报告示例:

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

定制卷报告示例

以下 volrpt 包括 ACS 0 和 1、缺失和已弹出的卷,并显示卷状态。

输入 volrpt 选项:

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

这些控制语句用于选择和格式化输出。

定制卷报告控制语句示例:

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

显示缺失和已弹出的卷的定制 volrpt 示例:

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

创建卷统计信息报告日志记录

可以使用卷统计信息日志文件 (acsss_stats.log) 记录卷移动统计信息。这些统计信息包含每次 ACSLS 检测到卷的位置发生更改时记录的条目。ACSLS 记录装入、弹出、挂载、卸载的条目,以及每次审计检测到卷的位置发生更改(通常通过手动移动)的条目。

使用 acsss_config 配置程序执行以下操作:

  • 使用 LIB_VOL_STATS 变量启用或禁用卷统计信息日志记录。

  • 指定卷统计信息日志文件的最大大小。

  • 指定卷统计信息日志文件的滚动文件数。

stats_report 实用程序使用 acsss_stats.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

在上例中,收集模式条目显示从 2014 年 6 月 30 日上午 8:53 开始收集统计信息,并在当天上午 10:45 结束收集。这些收集开始和停止时间包括此收集期间的卷统计信息条目。

卷统计信息条目的格式为:

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

    vol_id home_loc function_loc client_host_ID

其中:

  • yyyy-mm-dd 是条目的年份、月份和日期。支持四位数的年份格式。可使用 acsss_config 指定日期格式。

  • hh:mm:ss 是条目的小时、分钟和秒。

  • command 是移动了卷或(审计)检测到卷已移动的 ACSLS 命令或客户机请求。

    • MOUNT 是挂载请求。

    • DISMOUNT 是卸载请求。

    • ENTER 是手动或自动模式装入请求。

    • EJECT 是弹出请求。

    • AUDIT 是审计请求。

    • ACSMV 是移动请求。

    • ACSCR 是卷恢复活动。此活动由 ACSLS 处理自动生成。

  • vol_id 是卷标识符。

  • home_loc 是卷的起始(存储单元)位置。

  • function_loc 是按以下方式使用卷的请求的卷位置:

    • mountdismount 请求

      位置是传送装置 ID。

    • entereject 请求

      位置是 CAP ID。

  • audit 请求指定审计检测到了以下错误之一:

    • STATUS_VOLUME_FOUND

      审计发现卷所在的位置与数据库中指定的位置不一致。

    • STATUS_VOLUME_NOT_FOUND

      审计未在数据库中指定的位置中找到卷。

    • Volume Recovery activity

      位置可以是单元 ID 或传送装置 ID,表示卷恢复检测到了以下情况之一:

      • STATUS_VOLUME_FOUND

        找到的卷未记录在数据库中,并且正在添加它。

      • STATUS_VOLUME_NOT_FOUND

        在任何记录的位置中未找到数据库中的卷,并且正在删除它。

  • client_host_ID 是以下之一:

    • 对于客户机应用程序请求,它是主机 IP 地址。

    • 对于 cmd_proc 命令,如果在启动了 cmd_proc 的 shell 环境中设置了环境变量 LIBVOLSTATS_CMD_PROC_ID(只能包含 ASCII 字符),该条目是环境变量值的前 12 个字符。

    • 对于 cmd_proc 命令,如果环境变量 LIBVOLSTATS_CMD_PROC_ID 未设置或包含非 ASCII 字符,则条目是 Local。