使用系统错误工具报告

系统错误工具 (system error facility, SEF) 报告系统用于捕获自动化库中的磁带设备生成的日志检测数据，然后将这些数据写入日志文件并转换成可读的格式。此实用程序包括以下项目：

日志文件，包含从磁带设备日志检测页收集的数据。
sefreport 命令，以可读的格式将日志文件写入 stdout。该日志文件可以作为用户分析脚本的输入项。

日志检测页因供应商而异。有关参数代码、控制位和参数值的含义，请参见每一个特定设备的供应商文档。

独立磁带机不支持 SEF。对于那些不支持 tapealert 功能的旧 SCSI-2 设备，SEF 报告功能非常有用。有关更多信息，请参见《Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual》中的"tapealert(1M)"。

如何启用 SEF 报告

成为超级用户。
运行 mkdir 命令创建 SEF 目录。
例如：
```
# mkdir /var/opt/SUNWsamfs/sef
```
使用 touch 命令创建日志文件。
在安装报告系统后，您随时可以通过创建 sefdata 日志文件来启用 SEF 报告功能。起初，SEF 日志文件必须为空。以下命令显示要在默认位置创建的 SEF 日志文件。
```
# touch /var/opt/SUNWsamfs/sef/sefdata
```
使用 samd stop 和 samd start 命令初始化 SEF 报告。
```
# samd stop
# samd config
# samd start
```
1. 等待至磁带机空闲。然后卸载磁带机。
  对于 eq，请指定驱动器的设备编号。
2. 使用 samd unload 命令卸载所有可移除介质：
```
# samd unload eq
```
对于每个磁带机，重复步骤 1 到 4。
生成的 SEF 数据将添加至日志文件的末尾。

注 - 只要 sefdata 日志文件存在，就会启用 SEF 报告功能。要禁用 SEF 报告功能，请重命名或删除该文件。

您可以对 SEF 报告功能进行配置，以便在其他位置记录和读取日志检测数据。有关从备选位置读取日志检测数据的更多信息，请参见《Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual》中的"sefreport(1M)"。

如何生成 SEF 报告输出

SEF 报告输出的内容由标题行和日志检测数据组成。

验证 /opt/SUNWsamfs/sbin 是否在命令路径中。
使用 sefreport 命令生成 SEF 输出。
下面是 sefreport 命令最常用的选项：
- -d 选项。-d 选项用于生成附加的设备信息。它将为每一条记录写入附加的包含设备序号和路径名的标题行。利用此进程，能够更轻松地搜索和查找与某个特定设备相关的 SEF 记录。
- -v 选项或 -t 选项。不要在同一命令行中指定 -t 和 -v 选项。它们是互相排斥的。
  - -v 选项用于生成详细的信息。它将与设备序号、页码和 VSN 相关的信息添加至记录的每一行。利用此方法，可仅选择与某个特定设备或特定卷相关的那些行。
  - -t 用于生成包含文字说明的日志检测输出。对于日志检测数据输出的每一行，报告中都包含了一个额外的字符串，字符串的内容包括：设备序号、页码、VSN 和参数编码说明。
    
    例如，下面的 SEF 命令从默认位置读取 SEF 日志文件，写入每一个设备的设备编号和路径名，并生成输出：
```
# sefreport -d /var/opt/SUNWsamfs/sef/sefdata > sef.output
```

示例 17-3 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
.
.
.

有关 SEF 日志文件的更多信息（包括其内容和格式），请参见《Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual》中的"sefdata(4)"。有关可选 SEF 报告格式的更多信息，请参见《Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual》中的"sefreport(1M)"。

管理 SEF 日志文件

SEF 日志文件的管理方式与任何其他 SAM-QFS 日志文件相同。您可以定期运行 cron 作业，以将当前日志文件保存至另一位置、删除旧 SEF 文件、创建新（空）的 SEF 文件或执行其他文件管理任务。

此外，还可以使用 log_rotate.sh 实用程序来轮转此日志文件。

有关用于管理 SEF 日志文件的工具的更多信息，请参见 cron(1M) 或 log_rotate.sh(1M) 手册页。

SEF `sysevent` 功能

除了使用 SEF 日志文件之外，您还可以使用 Oracle Solaris sysevent 功能来获取磁带机 SCSI 日志检测错误计数器的第 2 页和第 3 页，以便进行介质分析。默认情况下，SEF sysevent 功能处于启用状态，并设置为在卸载之前轮询一次。SEF sysevent 的行为由 defaults.conf 和 samset 控制。

在 defaults.conf 文件中，sef 参数可用于按设备序号启用 SEF sysevent 功能，或者用于指定日志检测轮询频率。有关更多信息，请参见《Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual》中的"defaults.conf(4)"。

如何创建 SEF `sysevent` 处理程序

创建 /var/tmp/xx 文件。

例如：

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

使 /var/tmp/xx 文件成为可执行文件。

# chmod a+rwx /var/tmp/xx

通过添加以下信息，将 SEF sysevent 处理程序添加到 syseventd 文件。

# 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

此命令将创建包含 SEF sysevent 处理程序 /var/tmp/xx 的 /etc/sysevent/config/SUNW,SUNWsamfs,Device,sysevent.conf 文件，并将该事件处理程序装入 syseventd 守护进程。

要装入 SEF sysevent 处理程序，请运行以下命令：
```
# pkill -HUP syseventd 
```
有关更多信息，请参见《Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual》中的"sefsysevent(4)"。

跳过导航链接
退出打印视图
	Sun Storage Archive Manager 5.3 配置和管理指南 Sun QFS and Sun Storage Archive Manager 5.3 Information Library (简体中文)