snmpevent 命令

在线编辑

用途

向 SNMP 代理程序发送 ERRM 事件。

语法

snmpevent [-a 主机名 ] [-c 社区 ] [-h]

描述

snmpevent 脚本将事件响应资源管理器 (ERRM) 事件的简单网络管理协议 (SNMP) 陷阱发送到运行 SNMP 代理程序的主机。 代理程序将陷阱信息格式化为 SNMP 陷阱并将其发送到在其配置文件中定义的 SNMP 管理器。 此脚本应由预定义的 ERRM 响应 Generate SNMP trap调用。 捕获事件或重整事件信息并由该 ERRM 事件或重整事件发生时所生成的环境变量传递。

snmpevent 脚本也可以用作模板来创建其他用户定义的操作。 请参阅 RSCT Administration Guide 以了解事件响应资源如何运行操作命令。

当发生事件或重整事件并且 snmpevent 是定义的响应时，会将以下消息模板作为陷阱发送:
 [ERRM_COND_SEVERITY] [ERRM_TYPE] occurred:
           Condition: [ ERRM_COND_NAME]
           Node:  [ERRM_NODE_NAME]
           Resource: [ERRM_RSRC_NAME]
           Resource Class:  [ERRM_RSRC_CLASS_NAME]
           Resource Attribute: [ERRM_ATTR_NAME]
           Attribute Type: [ERRM_DATA_TYPE]
           Attribute Value: [ERRM_VALUE]
环境变量具有以下定义：
ERRM_COND_SEVERITY
指定引起事件或重整事件的条件资源的重要性。 有效值为：关键、警告或信息性。
ERRM_TYPE
指定发生的事件类型。 有效值为：事件或重整事件。
ERRM_COND_NAME
用属性值指定条件资源名（该属性值的更改引起事件或重整事件）。
ERRM_NODE_NAME
指定发生事件或重整事件的主机名。
ERRM_RSRC_NAME
用属性指定资源名（该属性值的更改引起事件或重整事件）。
ERRM_RSRC_CLASS_NAME
指定引起事件或重整事件的资源所属的资源类名称。
ERRM_ATTR_NAME
指定资源属性名称，其更改引起事件或重整事件。
ERRM_DATA_TYPE
指定资源属性的数据类型。
ERRM_VALUE
指定资源属性值，其更改引起事件或重整事件。

snmpevent 命令捕获这些环境变量值，并格式化通过调用 snmptrap 命令作为陷阱发送的通用消息。

标志

-主机名
指定AIX®子代理将连接的 SNMP 代理的主机名。 缺省情况下，该子代理将连接到在本地节点上运行的 SNMP 代理上。
-c
指定要使用的 SNMP 共用体。 这可以是 SNMP 代理可接受的任何字符串。 缺省值为 public。
-h
将该脚本的用法语句写到标准输出。

参数

日志文件
指定记录事件信息的文件名。 应当指定 log_file 参数的绝对路径。

log_file 被当作一个循环日志且其大小固定为 64KB。 当 log_file 写满时，新项覆盖 现有最旧的项。

如果 log_file 已经存在，事件信息被追加到它的后面。 如果 log_file 不存在，会创建它以使事件信息能写入其中。

退出状态

0
脚本已成功运行。
1
脚本运行时发生错误。

限制

此脚本必须在运行 ERRM 的节点上运行。

标准输出

当指定 -h 标志时，此脚本的用法语句将写入标准输出。

示例

  1. 假设命令 /opt/rsct/bin/snmpevent 是与 CSM 预定义条件 NodeChanged相关联的紧急通知响应中的操作。 可以使用后跟 startcondresp 命令的 mkcondresp 命令来完成此操作。 应该将 /etc/snmpdv3.conf 文件配置为将陷阱发送到的位置。 在此示例中，如果要将陷阱发送到 9.117.16.246，请按如下所示编写 /etc/snmpdv3.conf 文件:
    VACM_GROUP group1 SNMPv1 public -

VACM_VIEW defaultView        internet                   - included 
-VACM_ACCESS  group1 - - noAuthNoPriv SNMPv1  defaultView - defaultView -

NOTIFY notify1 traptag trap -

#TARGET_ADDRESS Target1 UDP 127.0.0.1       traptag trapparms1 - - -
TARGET_ADDRESS Target1 UDP 9.117.16.246       traptag trapparms1 - - -

TARGET_PARAMETERS trapparms1 SNMPv1  SNMPv1  public  noAuthNoPriv -

COMMUNITY public    public     noAuthNoPriv 0.0.0.0     0.0.0.0         -

DEFAULT_SECURITY no-access - -

logging         file=/usr/tmp/snmpdv3.log       enabled
logging         size=0                          level=0

smux            1.3.6.1.4.1.2.3.1.2.1.2         gated_password  # gated

snmpd smuxtimeout=200 #muxatmd
smux 1.3.6.1.4.1.2.3.1.2.3.1.1 muxatmd_password #muxatmd
    然后，通过首先终止当前正在运行的 snmpd 守护程序，然后再次启动该守护程序，重新启动 snmpd 守护程序:
    # ps -ef | grep snmpd
    root  4570 12956   1 08:24:32  pts/0  0:00 grep snmpd
    root 13810     1   0 08:11:04      -  0:00 snmpd
# kill -9 13810
# snmpd
    下一步，将节点 c175n08 的 LParID 属性改为 12：
    # chnode c175n08 LParID=12
    现在，在节点 9.117.16.158 (具有在 /etc/snmpdv3.conf 文件中指定的 SNMP 管理器的节点) 上， SNMP 管理器应该记录如下内容:
    2002-07-15 09:09:25 c174tr1.ppd.pok.ibm.com [9.114.78.17] TRAP, SNMP v1, 
community public
        enterprises.ibm Enterprise Specific Trap (1) Uptime: 0:01:45.00
        enterprises.ibm.ibmProd.191.1.6.1.0 = "Informational Event 
occurred. Condition=NodeChanged Node=c174tr1.ppd.pok.ibm.com 
Resource=c175n08.ppd.pok.ibm.com Resource Class=Node Resource 
Attribute=Changed Attributes Attribute Type=CT_CHAR_PTR_ARRAY Attribute 
Val={LParID} "

    输出内容根据 SNMP 管理器而变化。

位置

/opt/rsct/bin/snmpevent