- 产品与解决方案
- 行业解决方案
- 服务
- 支持
- 合作伙伴
- 关于我们
32-SNMP-RMON命令
本章节下载 (334.96 KB)
目 录
1.1.2 display snmp-agent community
1.1.3 display snmp-agent group
1.1.4 display snmp-agent mib-view
1.1.5 display snmp-agent statistics
1.1.6 display snmp-agent sys-info
1.1.7 display snmp-agent trap-list
1.1.8 display snmp-agent usm-user
1.1.13 snmp-agent local-engineid
1.1.16 snmp-agent packet max-size
1.1.21 snmp-agent trap queue-size
【命令】
display snmp-agent { local-engineid | remote-engineid }
【视图】
任意视图
【参数】
local-engineid：本地SNMP实体引擎ID。
remote-engineid：远端SNMP实体引擎ID。
【描述】
display snmp-agent 命令用来显示本地或远程SNMP实体引擎ID。
SNMP引擎ID是SNMP管理域的标识，它在一个管理域内唯一的标识一个SNMP实体。SNMP引擎是SNMP实体的重要组成部分，完成SNMP消息的收发、验证、提取PDU、组装消息、与SNMP应用程序通信等功能。
【举例】
# 显示本地设备的引擎ID。
<H3C> display snmp-agent local-engineid
SNMP local EngineID: 800007DB00E0FC0031006877
以上信息中，SNMP local EngineID表示本地SNMP实体引擎ID。
【命令】
display snmp-agent community [ read | write ]
【视图】
任意视图
【参数】
read：显示具有只读访问权限的团体信息。
write：显示具有读写访问权限的团体信息。
【描述】
display snmp-agent community命令用来显示SNMP V1或SNMP V2C当前配置的团体信息。
不指定参数时，显示所有团体的信息。
【举例】
# 显示当前配置的团体信息。
<H3C> display snmp-agent community
Community name:public
Group name:public
Storage-type: nonVolatile
Community name:private
Group name:private
Storage-type: nonVolatile
表1-1 display snmp-agent community命令显示信息描述表
|
字段 |
描述 |
|
Community name |
团体名 |
|
Group name |
组名 |
|
Storage-type |
存储类型，有以下几种类型： volatile、 nonVolatile、 permanent、 readOnly、other |
【命令】
display snmp-agent group [ group-name ]
【视图】
任意视图
【参数】
group-name：指定要显示SNMP信息的组名，取值范围为1～32个字符。
【描述】
display snmp-agent group命令用来显示以太网交换机上的组信息。包括组名、安全模式、各种视图的状态以及组存储方式。
不指定参数时，显示所有组的信息。
【举例】
# 显示SNMP组名以及安全模式。以下显示内容相应的域的说明见表1-2。
<H3C> display snmp-agent group
Group name: v3r2
Security model: v3 noAuthnoPriv
Readview: ViewDefault
Writeview: <no specified>
Notifyview :<no specified>
Storage-type: nonVolatile
表1-2 display snmp-agent group命令显示信息描述表
|
字段 |
描述 |
|
Group name |
用户对应的SNMP组名 |
|
Security model |
该组的安全模式，分三种：有鉴权有加密（AuthPriv）、有鉴权无加密（AuthnoPriv）、无鉴权无加密（noAuthnoPriv） |
|
Readview |
该组对应的只读的MIB视图名 |
|
Writeview |
该组对应的可写的MIB视图名 |
|
Notifyview |
该组对应的通知的MIB视图名 |
|
storage-type |
存储方式，有以下几种类型： volatile、 nonVolatile、 permanent、 readOnly、other |
【命令】
display snmp-agent mib-view [ exclude | include | viewname view-name ]
【视图】
任意视图
【参数】
exclude：显示排除属性SNMP MIB视图。
include：显示包含属性SNMP MIB视图。
view-name：显示指定的SNMP MIB视图名称。
【描述】
display snmp-agent mib-view命令用来显示当前以太网交换机的MIB视图配置信息。
不指定参数时，显示当前以太网交换机的所有MIB视图配置信息。
【举例】
# 显示当前配置的MIB视图。
<H3C> display snmp-agent mib-view
View name:ViewDefault
MIB Subtree:internet
Subtree mask:
Storage-type: nonVolatile
View Type:included
View status:active
View name:ViewDefault
MIB Subtree:snmpUsmMIB
Subtree mask:
Storage-type: nonVolatile
View Type:excluded
View status:active
View name:ViewDefault
MIB Subtree:snmpVacmMIB
Subtree mask:
Storage-type: nonVolatile
View Type:excluded
View status:active
View name:ViewDefault
MIB Subtree:snmpModules.18
Subtree mask:
Storage-type: nonVolatile
View Type:excluded
View status:active
上述显示域中参数的说明见下表1-3。
表1-3 display snmp-agent mib-view命令显示信息描述表
|
字段 |
描述 |
|
View name |
视图名 |
|
MIB Subtree |
MIB子树 |
|
Subtree mask |
子树掩码 |
|
Storage-type |
存储方式 |
|
ViewType: included/excluded |
标志对一个MIB对象的访问是允许或者是禁止 |
|
View status |
用来指示MIB视图的状态 |
【命令】
display snmp-agent statistics
【视图】
任意视图
【参数】
无
【描述】
display snmp-agent statistics命令用来显示SNMP报文的统计信息。
【举例】
# 显示SNMP报文的统计信息。
<H3C> display snmp-agent statistics
1276 Messages delivered to the SNMP entity
0 Messages which were for an unsupported version
0 Messages which used a SNMP community name not known
0 Messages which represented an illegal operation for the community supplied
0 ASN.1 or BER errors in the process of decoding
1291 Messages passed from the SNMP entity
0 SNMP PDUs which had badValue error-status
0 SNMP PDUs which had genErr error-status
7 SNMP PDUs which had noSuchName error-status
0 SNMP PDUs which had tooBig error-status (Maximum packet size 1500)
3669 MIB objects retrieved successfully
26 MIB objects altered successfully
420 GetRequest-PDU accepted and processed
832 GetNextRequest-PDU accepted and processed
0 GetBulkRequest-PDU accepted and processed
1276 GetResponse-PDU accepted and processed
24 SetRequest-PDU accepted and processed
15 Trap PDUs accepted and processed
0 Alternate Response Class PDUs droped silently
0 Forwarded Confirmed Class PDUs droped silently
【命令】
display snmp-agent sys-info [ contact | location | version ]*
【视图】
任意视图
【参数】
contact：显示当前设备节点的联系信息。
location：显示当前设备节点的物理位置信息。
version：显示系统中运行的SNMP的版本信息。
【描述】
display snmp-agent sys-info命令用来显示当前SNMP设备的系统信息。
不选择参数则显示全部信息。
【举例】
# 显示SNMP设备的系统信息。
<H3C> display snmp-agent sys-info
The contact person for this managed node:
R&D Hangzhou, H3C Technologies Co.,Ltd.
The physical location of this node:
Hangzhou China
SNMP version running in the system:
SNMPv1 SNMPv2c SNMPv3
【命令】
display snmp-agent trap-list
【视图】
任意视图
【参数】
无
【描述】
display snmp-agent trap-list命令用来显示系统Trap列表信息。
相关配置可参考命令snmp-agent trap enable。
【举例】
# 显示Trap列表信息。
<H3C> display snmp-agent trap-list
bgp trap enable
configuration trap enable
flash trap enable
ospf trap enable
system trap enable
vrrp trap enable
oadp trap disable
standard trap disable
Enable traps :6; Disable traps 2
【命令】
display snmp-agent usm-user [ engineid engineid | username user-name | group group-name ]*
【视图】
任意视图
【参数】
engineid：显示指定引擎ID的SNMP V3的用户信息，取值范围为10～64个十六进制数。
user-name：显示指定SNMP V3用户的信息，取值范围为1～32个字符。
group-name：显示属于指定SNMP组的用户信息，取值范围为1～32个字符。
【描述】
display snmp-agent usm-user命令用来显示SNMP用户信息。不选择参数则显示全部信息。
【举例】
# 显示当前所有的用户信息。
<H3C> display snmp-agent usm-user
User name: usm-user
Group name: usm-group
Engine ID: 800007DB00E0FC0031006877
Storage-type: nonVolatile
UserStatus: active
上述显示域中参数的说明见下表1-4。
表1-4 display snmp-agent usm-user命令显示信息描述表
|
字段 |
描述 |
|
User name |
SNMP用户名 |
|
Group name |
SNMP用户所属组的组名 |
|
Engine ID |
标识SNMP设备的字符串 |
|
Storage-type |
存储方式，有以下几种类型： volatile、 nonVolatile、 permanent、 readOnly、other |
|
UserStatus |
SNMP 用户的状态 |
【命令】
enable snmp trap updown
undo enable snmp trap updown
【视图】
以太网端口视图/接口视图
【参数】
无
【描述】
enable snmp trap updown命令用来设置允许发送端口或者接口的LINK UP和LINK DOWN的SNMP Trap信息。undo enable snmp trap updown命令用来设置禁止发送当前端口或者接口的LINK UP和LINK DOWN的SNMP Trap信息。
缺省情况下，允许发送端口或者接口的Trap信息。
enable snmp trap updown命令要和snmp-agent target-host命令协同使用，使用snmp-agent target-host命令来指定哪些主机可以接收Trap信息。为了发送Trap信息，用户必须配置至少一条snmp-agent target-host命令。
【举例】
# 允许使用public团体名，发送端口GigabitEthernet1/0/1 的LINK UP和LINK DOWN的SNMP Trap信息到IP地址为10.1.1.1的网管站上。
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] snmp-agent trap enable
[H3C] snmp-agent target-host trap address udp-domain 10.1.1.1 params securityname public
[H3C] interface GigabitEthernet1/0/1
[H3C-GigabitEthernet1/0/1] enable snmp trap updown
【命令】
snmp-agent
undo snmp-agent
【视图】
系统视图
【参数】
无
【描述】
snmp-agent命令用来启动SNMP Agent。undo snmp-agent命令用来禁止SNMP Agent。
缺省情况下，SNMP Agent功能处于关闭状态。
【举例】
# 禁止正在运行的SNMP Agent。
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] undo snmp-agent
& 说明：
S5600以太网交换机为防止恶意用户对未使用SOCKET的攻击，提高交换机的安全性，提供了如下功能：
l 在启动SNMP功能时，才打开SNMP-agent使用的UDP 161端口和SNMP-TRAP Client使用的UDP 1024端口。
l 在关闭SNMP功能时，同时关闭UDP 161端口和UDP 1024端口。
具体的实现是：
l 执行snmp-agent命令或执行snmp-agent的任何一条配置命令，都可以启动SNMP Agent，同时打开SNMP Agent使用的UDP 161端口和SNMP TRAP Client使用的UDP 1024端口。
l 应用undo snmp-agent命令的同时即可关闭UDP 161端口和UDP 1024端口。
【命令】
snmp-agent community { read | write } community-name [ acl acl-number | mib-view view-name ] *
undo snmp-agent community community-name
【视图】
系统视图
【参数】
read：表明对MIB对象进行只读的访问，具有只读权限的团体只能对设备信息进行查询。
write：表明对MIB对象进行读写的访问，具有读写权限的团体可以对设备进行配置。
community-name：团体名，取值范围为1～32个字符。
view-name：MIB视图名，取值范围为1～32个字符。
acl-number：该团体名指定的基本访问控制列表，取值范围为2000～2999。
【描述】
snmp-agent community命令用来设置团体访问名、允许对SNMP协议进行访问。undo snmp-agent community命令用来取消团体访问名设置。
【举例】
# 设置团体名为comaccess，并且允许使用该团体名进行只读访问。
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] snmp-agent community read comaccess
# 设置团体名为mgr，并且可以进行读写访问。
[H3C] snmp-agent community write mgr
# 删除团体名comaccess。
[H3C] undo snmp-agent community comaccess
【命令】
(1) V1、V2C版本
snmp-agent group { v1 | v2c } group-name [ read-view read-view ] [ write-view write-view ] [ notify-view notify-view ] [ acl acl-number ]
undo snmp-agent group { v1 | v2c } group-name
(2) V3版本
snmp-agent group v3 group-name [ authentication | privacy ] [ read-view read-view ] [ write-view write-view ] [ notify-view notify-view ] [ acl acl-number ]
undo snmp-agent group v3 group-name [ authentication | privacy ]
【视图】
系统视图
【参数】
v1：SNMP V1版本。
v2c：SNMP V2C版本。
v3：SNMP V3版本。
group-name：组名，取值范围为1～32个字符。
authentication：指明对报文进行认证但不加密。
privacy：指明对报文进行认证和加密。
read-view：只读视图名，取值范围为1～32个字符。
write-view：读写视图名，取值范围为1～32个字符。
notify-view：通知视图名，取值范围为1～32个字符。
acl-number：基本访问控制列表，取值范围为2000～2999。
【描述】
snmp-agent group命令用来配置一个新的SNMP组，即将SNMP用户映射到SNMP视图。undo snmp-agent group命令用来删除一个指定的SNMP组。
缺省情况下，snmp-agent group v3命令配置的SNMP组采用不认证、不加密方式。
相关配置可参考命令snmp-agent mib-view，snmp-agent usm-user。
【举例】
# 创建一个SNMP V3组group1。
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] snmp-agent group v3 group1
【命令】
snmp-agent local-engineid engineid
undo snmp-agent local-engineid
【视图】
系统视图
【参数】
engineid：引擎ID字符串，必须为十六进制数字，取值为10～64个十六进制数，两个十六进制字符构成一个八位组。
【描述】
snmp-agent local-engineid命令用来设置本地SNMP实体的引擎ID。undo snmp-agent local-engineid命令用来恢复缺省设置。
缺省情况下，设备引擎ID为公司的“企业号＋设备信息”。设备信息由各个产品自己决定，可以是IP地址，MAC地址或者自己定义的十六进制数字串。
相关配置可参考命令snmp-agent usm-user。
【举例】
# 配置本地设备的名称为123456789A。
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] snmp-agent local-engineid 123456789A
【命令】
snmp-agent log { set-operation | get-operation | all }
undo snmp-agent log { set-operation | get-operation | all }
【视图】
系统视图
【参数】
set-operation：将网管的设置（set）操作记入日志系统。
get-operation：将网管的查询（get）操作记入日志系统。
all：将网管发送来的get、set操作都记入日志系统。
【描述】
snmp-agent log命令用来打开网管操作的日志功能。undo snmp-agent log命令用来关闭网管操作的日志功能。
缺省情况下，网管操作的日志功能关闭。
& 说明：
l 在单台设备的环境中，用户只需要在当前设备上使用display logbuffer命令，就可查看网管发送过来的get和set操作的日志信息。
l 在堆叠的环境中，请在主设备上使用display logbuffer命令，查看网管发送过来的set操作的日志信息；请在收到get消息的设备上使用display logbuffer命令，查看网管发送过来的get操作的日志信息。
【举例】
# 打开网管查询和设置操作的日志功能。
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] snmp-agent log all
【命令】
snmp-agent mib-view { included | excluded } view-name oid-tree
undo snmp-agent mib-view view-name
【视图】
系统视图
【参数】
view-name：视图名。
oid-tree：MIB对象子树的OID MIB子树，可以是变量OID的字符串（如1.4.5.3.1），也可以是变量名的字符串（如system），还可以有“*”来做通配符，例如：1.4.5.*.*.1。
included：表示包括该MIB子树。
excluded：表示排除该MIB子树。
【描述】
snmp-agent mib-view命令用来创建或者更新MIB视图的信息，以限制NMS可以访问的MIB对象。undo snmp-agent mib-view命令用来取消当前设置。
缺省情况下，视图名为ViewDefault，OID为1。
相关配置可参考命令snmp-agent group。
【举例】
# 创建一个SNMP MIB视图，包含MIB子树mib2（对应OID为1.3.6.1.2.1）的所有对象。
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] snmp-agent mib-view included mib2 1.3.6.1.2.1
【命令】
snmp-agent packet max-size byte-count
undo snmp-agent packet max-size
【视图】
系统视图
【参数】
byte-count：Agent能接收/发送的SNMP消息包长度的最大值，单位为字节，取值范围为484～17940。
【描述】
snmp-agent packet max-size命令用来设置Agent能接收/发送的SNMP消息包长度的最大值。undo snmp-agent packet max-size命令用来恢复消息包长度的缺省值。
缺省情况下，Agent能接收/发送的SNMP消息包长度的最大值为1500字节。
【举例】
# 设置Agent能接收/发送的SNMP消息包最长为1042字节。
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] snmp-agent packet max-size 1042
【命令】
snmp-agent sys-info { contact sys-contact | location sys-location | version { { v1 | v2c | v3 }* | all } }
undo snmp-agent sys-info { contact | location | version { { v1 | v2c | v3 }* |all } }
【视图】
系统视图
【参数】
sys-contact：描述系统维护联系信息的字符串。
sys-location：设备节点的物理位置信息。
version：设置系统启用的SNMP版本号。
v1：SNMP V1版本。
v2c：SNMP V2C版本。
v3：SNMP V3版本。
all：SNMP V1、SNMP V2C、SNMP V3版本。
【描述】
snmp-agent sys-info命令用来设置系统信息，包括系统维护联系信息、设备节点的物理位置信息、启用的SNMP版本号等。undo snmp-agent sys-info命令用来恢复系统的缺省配置。
如果设备发生故障，设备维护人员可以利用系统维护联系信息，及时与设备生产厂商取得联系。
缺省情况下，S5600系列以太网交换机的系统维护联系信息为“R&D Hangzhou, H3C Technologies Co.,Ltd.”；物理位置信息为“Hangzhou China”；版本为SNMP V3。
相关配置可参考命令display snmp-agent sys-info。
【举例】
# 设置系统维护联系信息为Dial System Operator # 1234。
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] snmp-agent sys-info contact Dial System Operator # 1234
【命令】
snmp-agent target-host trap address udp-domain ip-address [ udp-port port-number ] params securityname security-string [ v1 | v2c | v3 [authentication | privacy ] ]
undo snmp-agent target-host ip-address securityname security-string
【视图】
系统视图
【参数】
trap：表示该主机为Trap主机。
address：表示SNMP Trap消息传输的目标主机地址。
udp-domain：表示目标主机的传输协议采用UDP。
ip-address：接受Trap的主机的IPV4地址。
port-number：指定接收Trap报文的端口号。
params：指定目标主机信息以用于产生SNMP消息。
security-string：SNMP V1、SNMP V2C的团体名或SNMP V3的用户名，取值范围为1～32个字符。
v1：代表SNMP V1版本。
v2c：代表SNMP V2C版本。
v3：代表SNMP V3版本。
authentication：指明对报文进行认证但不加密。
privacy：指明对报文进行认证和加密。
【描述】
snmp-agent target-host命令用来设置接收SNMP Trap报文的目的地。undo snmp-agent target-host命令用来取消当前设置。
若要一台设备可以发送Trap消息，需要将snmp-agent target-host命令与snmp-agent trap enable或enable snmp trap updown命令协同使用：
(1) 使用snmp-agent trap enable或enable snmp trap updown命令设置允许发送的Trap报文(默认是可以发送所有Trap的)。
(2) 使用snmp-agent target-host命令来设置接收SNMP Trap报文的目的主机地址。
相关配置可参考命令snmp-agent trap enable，snmp-agent trap source，snmp-agent trap life。
【举例】
# 允许向10.1.1.1发送SNMP Trap报文 ，使用团体名public。
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] snmp-agent trap enable standard
[H3C] snmp-agent target-host trap address udp-domain 10.1.1.1 params securityname public
【命令】
snmp-agent trap enable [ bgp [ backwardtransition | established ] * | configuration | flash | ospf [ process-id ] [ ospf-trap-list ] | standard [ authentication | coldstart | linkdown | linkup | warmstart ]* | system | vrrp [ authfailure | newmaster ] ]
undo snmp-agent trap enable [ bgp [ backwardtransition | established ] * | configuration | flash | ospf [ process-id ] [ ospf-trap-list ] | standard [ authentication | coldstart | linkdown | linkup | warmstart ]* | system | vrrp [ authfailure | newmaster ] ]
【视图】
系统视图
【参数】
bgp [ backwardtransition | established ] *：发送BGP协议的trap信息。
configuration：发送配置操作的Trap报文。
flash：发送Flash的Trap信息。
ospf [ process-id ] [ ospf-trap-list ]：发送OSPF协议的Trap报文。process-id是进程标识符；ospf-trap-list是允许发送的Trap报文列表。
standard：发送SNMP标准的通知或Trap信息。
authentication：认证失败时，发送SNMP协议的认证失败的Trap信息。
coldstart：当设备重新启动时，发送SNMP协议的冷启动Trap信息。
linkdown：当端口由up状态变为down状态时，发送SNMP协议的链路down掉的Trap信息。
linkup：当端口由down状态变为up状态时，发送SNMP协议的链路up的Trap信息。
warmstart：当SNMP协议重新启动时，发送SNMP协议的热启动Trap报文。
system：发送H3C-SYS-MAN-MIB（私有MIB）的Trap信息。
vrrp [ authfailure | newmaster ]：发送VRRP的Trap报文。
【描述】
snmp-agent trap enable命令用来设置允许发送设备的Trap报文。undo snmp-agent trap enable命令用来设置禁止设备发送Trap报文。
缺省情况下，允许发送所有类型的Trap报文。
snmp-agent trap enable命令需要与snmp-agent target-host命令协同使用，使用snmp-agent target-host命令来指定哪些主机可以接收Trap信息。为了发送Trap信息，用户必须配置至少一条snmp-agent target-host命令。
【举例】
# 允许向10.1.1.1发送SNMP认证失败Trap报文，使用团体名为public。
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] snmp-agent trap enable authentication
[H3C] snmp-agent target-host trap address udp-domain 10.1.1.1 params securityname public
【命令】
snmp-agent trap life seconds
undo snmp-agent trap life
【视图】
系统视图
【参数】
seconds：老化时间，单位为秒，取值范围为1～2592000。
【描述】
snmp-agent trap life命令用来设置Trap报文的老化时间，超过该时间的Trap报文都将被丢弃。undo snmp-agent trap life命令用来恢复Trap报文老化时间的缺省值。
缺省情况下，SNMP Trap报文的老化时间为120秒。
相关配置可参考命令snmp-agent trap enable，snmp-agent target-host。
【举例】
# 设置Trap报文的老化时间为60秒。
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] snmp-agent trap life 60
【命令】
snmp-agent trap queue-size size
undo snmp-agent trap queue-size
【视图】
系统视图
【参数】
size：消息队列的长度，取值范围为1～1000。
【描述】
snmp-agent trap queue-size命令用来设置发往目的主机的Trap报文的消息队列的长度。undo snmp-agent trap queue-size命令用来恢复Trap报文的消息队列的长度的缺省值。
缺省情况下，发往目的主机的Trap报文的消息队列的长度为100条。
相关配置可参考命令snmp-agent trap enable，snmp-agent target-host，snmp-agent trap life。
【举例】
# 设置发送Trap报文的消息队列的长度为200条。
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] snmp-agent trap queue-size 200
【命令】
snmp-agent trap source interface-type interface-number
undo snmp-agent trap source
【视图】
系统视图
【参数】
interface-type：接口类型。
interface-number：接口编号。
【描述】
snmp-agent trap source命令用来指定发送Trap消息的源地址。undo snmp-agent trap source命令用来取消当前配置。
从一台服务器发出的SNMP Trap消息，无论从哪个接口发出，都共用同一个发送Trap报文的源IP地址，即所配置接口的IP地址。
缺省情况下，由SNMP选择一个出接口。
如果用户想使用Trap地址来跟踪特定事件时，可以使用这条配置命令。
& 说明：
在将某个接口设置为发送Trap的源地址之前，必须保证该接口已经配置了IP地址。
相关配置可参考命令snmp-agent trap enable，snmp-agent target-host。
【举例】
# 将VLAN接口1的IP地址作为Trap报文的源地址。
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] snmp-agent trap source Vlan-interface 1
【命令】
(1) V1、V2C版本
snmp-agent usm-user { v1 | v2c } user-name group-name [ acl acl-number ]
undo snmp-agent usm-user { v1 | v2c } user-name group-name
(2) V3版本
snmp-agent usm-user v3 user-name group-name [ authentication-mode { md5 | sha } auth-password [ privacy-mode des56 priv-password ] ] [ acl acl-number ]
undo snmp-agent usm-user v3 user-name group-name { local | engineid engineid-string }
【视图】
系统视图
【参数】
v1：用户使用V1的安全模式。
v2c：用户使用V2C的安全模式。
v3：用户使用V3的安全模式。
user-name：用户名，取值范围为1～32个字符。
group-name：该用户对应的组名，取值范围为1～32个字符。
authentication-mode：指明安全级别为需要认证。如果不输入该参数，则默认是无认证，无加密模式。
md5：指定认证协议为HMAC MD5算法。
sha：指定认证协议为HMAC SHA算法。
auth-password：认证密码，字符串，取值范围为1～64个字符。
privacy：指明安全级别为加密。
des56：指定加密协议为DES（Data Encryption Standard，数据加密标准）。
priv-password：加密密码，字符串，取值范围为1～64个字符。
acl-number：基本访问控制列表，取值范围为2000～2999。
local：表示本地实体用户。
engineid-string：指定与该用户相关联的引擎ID，取值范围为10～64个十六进制数。
【描述】
snmp-agent usm-user命令用来为一个SNMP组添加一个新用户。undo snmp-agent usm-user命令用来删除SNMP组的一个用户。
对于SNMP V3用户，在为某个代理配置了远端用户后，在进行验证时，需要用到engineID。如果配置用户后引擎ID（engineID）改变，则原引擎ID相应的用户无效。
执行该命令，对于SNMP V1、SNMP V2C来说，是添加一个新的团体名；对SNMP V3来说，是为一个SNMP的组添加一个新用户。
相关配置可参考命令snmp-agent group，snmp-agent community，snmp-agent local-engineid。
【举例】
# 为SNMP V3组Johngroup加入一个用户John，安全级别为需要认证，指定认证协议为HMAC-MD5、认证密码为hello。
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] snmp-agent group v3 Johngroup
[H3C] snmp-agent usm-user v3 John Johngroup authentication-mode md5 hello
【命令】
display rmon alarm [ entry-number ]
【视图】
任意视图
【参数】
entry-number：告警表项索引号，取值范围为1～65535。此项如果为空，则显示所有告警的配置信息。
【描述】
display rmon alarm命令用来显示所有或指定RMON告警的配置信息。
相关配置可参考命令rmon alarm。
【举例】
# 显示RMON告警信息。
Alarm table 1 owned by user1 is Valid.
Samples type : absolute
Variable formula : 1.3.6.1.2.1.16.1.1.1.4.1<etherStatsOctets.1>
Sampling interval : 6(sec)
Rising threshold : 10000(linked with event 1)
Falling threshold : 2000(linked with event 1)
When startup enables : risingOrFallingAlarm
Latest value : 0
表2-1 display rmon alarm显示信息描述表
|
字段 |
描述 |
|
Alarm table |
告警表项的索引号 |
|
user1 |
创建者 |
|
Valid |
与该索引对应的告警表项有效 |
|
Samples type |
采样类型：变化值或绝对值 |
|
Variable formula |
被采样节点的变量表示 |
|
Sampling interval |
采样的时间间隔 |
|
Rising threshold |
告警上限，当采样值从正常值达到该值时引发上限告警 |
|
Falling threshold |
告警下限，当采样值从正常值达到该值时引发下限告警 |
|
When startup enables |
告警启动类型： risingOrFallingAlarm（允许上限和下限触发告警） risingAlarm（允许上限触发告警） FallingAlarm（允许下限触发告警） |
|
Latest value |
最近一次采样值 |
【命令】
display rmon event [ event-entry ]
【视图】
任意视图
【参数】
event-entry：事件表项的索引号，取值范围为1～65535。此项如果为空，则显示所有事件的配置信息。
【描述】
display rmon event命令用来显示所有或指定RMON事件的配置信息。
显示信息包括：事件表中的事件索引、事件的所有者、对事件的描述、事件引发的动作（日志或告警消息）、最近一次事件发生的时刻（此时间是以系统初始化/启动以来的秒数计算的）等。
相关配置可参考命令rmon event。
【举例】
# 显示RMON事件。
<H3C> display rmon event
Event table 1 owned by user1 is VALID.
Description: null.
Will cause log-trap when triggered, last triggered at 0days 00h:02m:27s.
表2-2 display rmon event显示信息描述表
|
字段 |
描述 |
|
Event table |
事件表项 |
|
VALID |
索引对应的表项状态为有效 |
|
Description |
事件描述 |
|
Will cause log-trap when triggered |
事件引发日志和Trap告警 |
|
last triggered at |
最近一次事件发生时刻 |
【命令】
display rmon eventlog [ event-entry ]
【视图】
任意视图
【参数】
event-entry：事件表项的索引号，取值范围为1～65535。此项如果为空，则显示所有事件日志的配置信息。
【描述】
display rmon eventlog命令用来显示所有或指定RMON事件日志的配置信息。
显示的RMON事件日志信息包括：事件表中的事件索引及事件当前的状态。事件产生日志的时刻（此时间是以系统初始化/启动以来的秒数计算的）等，以及事件的描述。
【举例】
# 显示RMON事件日志。
<H3C> display rmon eventlog 1
Event table 1 owned by user1 is VALID.
Generates eventLog 1.1 at 0days 00h:01m:39s.
Description: The 1.3.6.1.2.1.16.1.1.1.4.1 defined in alarm table 1,
less than(or =) 100 with alarm value 0. Alarm sample type is absolute.
Generates eventLog 1.2 at 0days 00h:02m:27s.
Description: The alarm formula defined in private alarm table 1,
less than(or =) 100 with alarm value 0. Alarm sample type is absolute.
表2-3 display rmon eventlog显示信息描述表
|
字段 |
描述 |
|
Event table |
事件表项 |
|
VALID |
索引对应的表项状态为有效 |
|
Generates eventLog 1.1 at 0days 00h:02m:27s |
事件发生的时刻，事件可能被触发过多次，1.1表明这是事件1第一次被触发的时间 |
|
Description |
事件日志描述，记录了事件被触发的具体情况 |
【命令】
display rmon history [ interface-type interface-number | unit unit-number ]
【视图】
任意视图
【参数】
interface-type：接口类型。
interface-number：接口编号。
unit：设备单元。
unit-number：具体的设备单元号。
【描述】
display rmon history命令用来显示RMON历史控制表及其最近一次历史采样信息，这些信息包括利用率、错误数和总包数等。
不指定参数时，显示所有端口和设备单元的历史信息。
相关配置可参考命令rmon history。
【举例】
# 显示端口GigabitEthernet 1/0/1的RMON历史信息。
<H3C> display rmon history GigabitEthernet 1/0/1
History control entry 1 owned by user1 is VALID
Samples interface : GigabitEthernet1/0/1<ifIndex.4227625>
Sampling interval : 5(sec) with 10 buckets max
Latest sampled values :
dropevents : 0 , octets : 0
packets : 0 , broadcast packets : 0
multicast packets : 0 , CRC alignment errors : 0
undersize packets : 0 , oversize packets : 0
fragments : 0 , jabbers : 0
collisions : 0 , utilization : 0
表2-4 display rmon history显示信息描述表
|
字段 |
描述 |
|
History control entry |
历史控制表项的索引号 |
|
VALID |
索引对应的表项状态为有效 |
|
Samples interface |
采样端口 |
|
Sampling interval |
采样间隔 |
|
buckets |
历史控制表中的记录数 |
|
Latest sampled values |
最新的采样信息 |
|
dropevents |
丢包事件 |
|
octets |
采样时间内接收或发送的字节数 |
|
packets |
采样时间内接收或发送的包数 |
|
broadcastpackets |
广播包数 |
|
multicastpackets |
组播包数 |
|
CRC alignment errors |
校验错误的包数 |
|
undersize packets |
过小的包数 |
|
oversize packets |
超大的包数 |
|
fragments |
过小且校验错误的包数 |
|
jabbers |
超大且校验错误的包数 |
|
collisions |
冲突的包数 |
|
utilization |
带宽利用率 |
【命令】
display rmon prialarm [ prialarm-entry-number ]
【视图】
任意视图
【参数】
prialarm-entry-number：扩展告警表项索引，取值范围为1～65535。此项如果为空，则显示所有扩展告警的配置信息。
【描述】
display rmon prialarm命令用来显示所有或指定的RMON扩展告警的配置信息。
不指定参数时，显示所有扩展告警的配置信息。
相关配置可参考命令rmon prialarm。
【举例】
# 显示所有的RMON扩展告警信息。
Prialarm table 1 owned by user1 is VALID.
Samples type : absolute
Variable formula : ((.1.3.6.1.2.1.16.1.1.1.4.1)*100)
Description :
Sampling interval : 10(sec)
Rising threshold : 10000(linked with event 1)
Falling threshold : 2000(linked with event 1)
When startup enables : risingOrFallingAlarm
This entry will exist : forever.
Latest value : 0
表2-5 display rmon prialarm显示信息描述表
|
字段 |
描述 |
|
Prialarm table |
扩展告警表项的索引号 |
|
owned by user1 |
创建者为user1 |
|
VALID |
与该索引号对应的告警表项有效 |
|
Samples type |
采样类型：变化值或绝对值 |
|
Variable formula |
被采样节点的变量表示 |
|
Description |
描述 |
|
Sampling interval |
采样间隔 |
|
Rising threshold |
告警上限，当采样值从正常值达到该值时引发上限告警 |
|
Falling threshold |
告警下限，当采样值从正常值达到该值时引发下限告警 |
|
linked with event |
告警对应的事件索引 |
|
When startup enables: risingOrFallingAlarm |
告警启动类型： risingOrFallingAlarm（允许上限和下限触发告警） risingAlarm（允许上限触发告警） FallingAlarm（允许下限触发告警） |
|
This entry will exist: forever |
该表项的存在期限， 可以是forever（永远存在），也可以是cycle（在规定的时间内存在） |
|
Latest value |
最近一次采样值 |
【命令】
display rmon statistics [ interface-type interface-number | unit unit-number ]
【视图】
任意视图
【参数】
interface-type：接口类型。
interface-number：接口编号。
unit：设备单元。
unit-number：具体的unit号。
【描述】
display rmon statistics命令用来显示RMON统计消息。
显示的RMON统计消息包括：网络冲突数、CRC校验错误报文数、过小（或超大）的数据报文数、广播、多播的报文数以及接收字节数、接收报文数等。
不指定参数时，显示所有端口和设备单元的统计消息。
相关配置可参考命令rmon statistics。
【举例】
# 显示RMON统计信息。
<H3C> display rmon statistics GigabitEthernet 1/0/1
Statistics entry 1 owned by user1-rmon is VALID.
Interface : GigabitEthernet1/0/1<ifIndex.4227625>
etherStatsOctets : 0 , etherStatsPkts : 0
etherStatsBroadcastPkts : 0 , etherStatsMulticastPkts : 0
etherStatsUndersizePkts : 0 , etherStatsOversizePkts : 0
etherStatsFragments : 0 , etherStatsJabbers : 0
etherStatsCRCAlignErrors : 0 , etherStatsCollisions : 0
etherStatsDropEvents (insufficient resources): 0
Packets received according to length:
64 : 0 , 65-127 : 0 , 128-255 : 0
256-511: 0 , 512-1023: 0 , 1024-1518: 0
表2-6 display rmon statistics显示信息描述表
|
字段 |
描述 |
|
Statistics entry |
统计信息表项的索引号 |
|
VALID |
有效 |
|
Interface |
被统计端口 |
|
etherStatsOctets |
接收到的字节数 |
|
etherStatsPkts |
接收到的数据包数 |
|
etherStatsBroadcastPkts |
接收到的广播的包数 |
|
etherStatsMulticastPkts |
接收到的组播的包数 |
|
etherStatsUndersizePkts |
接收到的过小的包数 |
|
etherStatsOversizePkts |
接收到的超大的包数 |
|
etherStatsFragments |
接收到的过小且校验错误的包数 |
|
etherStatsJabbers |
接收到的超大且校验错误的包数 |
|
etherStatsCRCAlignErrors |
接收到的校验错误的包数 |
|
etherStatsCollisions |
接收到的冲突的包数 |
|
etherStatsDropEvents |
丢包事件 |
|
Packets received according to length |
按照字节长度统计的包数 |
【命令】
rmon alarm entry-number alarm-variable sampling-time { delta | absolute } rising-threshold threshold-value1 event-entry1 falling-threshold threshold-value2 event-entry2 [ owner text ]
undo rmon alarm entry-number
【视图】
系统视图
【参数】
entry-number：添加/删除表项的索引号，取值范围为1～65535。
alarm-variable：告警变量，字符串类型size（1～256），格式为节点OID的点分格式，如1.3.6.1.2.1.2.1.10.1，只有可以解析为ASN.1中INTEGER (INTEGER, Counter, Gauge, or TimeTicks)的数据类型的变量才能作为告警变量。
sampling-time：采样间隔时间，取值范围为5～65535，单位为秒。
delta：采样类型为变化值（选定变量的当前采样值相对于最近一次采样值的变化量）。
absolute：采样类型为绝对值。
rising-threshold threshold-value1：上限阈值，取值范围为0～2147483647。
event-entry1：上限阈值相应的事件号，取值范围为0～65535。
falling-threshold threshold-value2：下限阈值，取值范围为0～2147483647。
event-entry2：下限阈值相应的事件号，取值范围为0～65535。
owner text：该表项的创建者，字符串，长度为1～127个字符。
【描述】
rmon alarm命令用来在告警表中添加一个表项。undo rmon alarm命令用来在告警表中删除一个表项。
本命令用来设置告警项以便在出现异常时触发告警事件，再由告警事件来决定记录日志和向网管站发送Trap。
不指定参数owner时，此表项创建者信息为空。
& 说明：
在添加告警表项之前，需要通过rmon event命令定义好告警表项中引用的事件。
用户定义了告警表项后，系统对告警表项的处理如下：
l 对所定义的告警变量（alarm-variable）按照定义的时间间隔（sampling-time）进行采样；
l 将采样值和设定的阈值进行比较，按照下表执行相应的处理过程。
|
实际情况 |
处理过程 |
|
采样值大于等于设定的上限threshold-value1 |
触发事件表中定义的事件event-entry1 |
|
采样值小于设定的下限threshold-value2 |
触发事件表中定义的事件event-entry2 |
& 说明：
l 在添加告警表项之前，需要通过rmon event命令定义好告警表项中引用的事件。
l rmon alarm命令在对节点进行监控时，要求被监控的节点必须存在，否则配置无效。
【举例】
# 在告警表中添加索引号为1的表项，对节点1.3.6.1.2.1.16.1.1.1.4.1以10秒的采样间隔进行采样，当采样值超过50的上限阈值触发事件1，低于下限阈值5时触发事件2；创建者为user1。
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] rmon event 1 log
[H3C] rmon event 2 none
[H3C]interface GigabitEthernet 1/0/1
[H3C-GigabitEthernet1/0/1] rmon statistics 1
[H3C-GigabitEthernet1/0/1] quit
[H3C] rmon alarm 1 1.3.6.1.2.1.16.1.1.1.4.1 10 absolute rising_threshold 50 1 falling_threshold 5 2 owner user1
# 在告警表中删除索引号为15的表项。
[H3C] undo rmon alarm 15
【命令】
rmon event event-entry [ description string ] { log | trap trap-community | log-trap log-trapcommunity | none } [ owner text ]
undo rmon event event-entry
【视图】
系统视图
【参数】
event-entry：添加/删除表项的索引号，取值范围为1～65535。
description string：事件的描述，字符串，长度为1～127个字符。
log：日志事件。
trap：定义事件为Trap事件。
trap-community：接收事件消息的网管站的团体名属性，字符串，长度为1～127个字符。
log-trap：定义事件为日志和Trap事件。
log-trapcommunity：接收事件消息的网管站的团体名属性，字符串，长度为1～127个字符。
none：不产生动作的事件。
owner text：该表项的创建者,字符串，长度为1～127个字符。
【描述】
rmon event命令用来在事件表中添加表项。undo rmon event命令用来在事件表中删除表项。
RMON的事件管理定义事件号及事件的处理方式包括：记日志、向网管站发Trap消息、记日志同时向网管站发Trap消息。这样系统就可以对告警表中定义的告警事件进行相应的处理。
不指定参数owner时，此表项创建者信息为空。
【举例】
# 在事件表中添加索引号为10的表项，标记为日志事件。
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C] rmon event 10 log
【命令】
rmon history entry-number buckets number interval sampling-interval [ owner text ]
undo rmon history entry-number
【视图】
以太网端口视图
【参数】
entry-number：添加/删除表项的索引号，取值范围为1～65535。
buckets number：该控制表项对应历史表容量。取值范围为1～65535（目前设备只能支持1～10，如果输入大于10的参数，实际表容量将取为10）。
interval sampling-interval：采样时间，取值范围为5～3600，单位为秒。
owner text：该表项的创建者，字符串，长度为1～127个字符。
【描述】
rmon history命令用来在历史控制表中添加表项。undo rmon history命令用来在历史控制表中删除表项。
本命令可以设定对某个端口进行抽样，设置抽样参数（抽样时间间隔）和保存数量。设置之后RMON就定期对指定的端口进行数据采集并保存起来以备查看。抽样信息包括利用率、错误数和总包数等。
不指定参数owner时，此表项创建者信息为空。
用户可以通过display rmon history命令来显示历史控制表项的统计信息。
【举例】
# 创建索引号为1，表容量为10，采样时间为5秒的历史控制表项，创建者为user1。
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C]interface GigabitEthernet 1/0/1
[H3C-GigabitEthernet1/0/1]rmon history 1 buckets 10 interval 5 owner user1
# 删除索引号为15的历史控制表项。
[H3C-GigabitEthernet1/0/1] undo rmon history 15
【命令】
rmon prialarm entry-number prialarm-formula prialarm-des sampling-timer { delta | absolute | changeratio } rising_threshold threshold-value1 event-entry1 falling_threshold threshold-value2 event-entry2 entrytype { forever | cycle cycle-period } [ owner text ]
undo rmon prialarm entry-number
【视图】
系统视图
【参数】
entry-number：该新建表项的索引号，取值范围为1～65535。
prialarm-fromula ：对告警变量进行计算的告警公式，字符串长度为1～256个字符。公式中的告警变量必须以OID来表示，例如(.1.3.6.1.2.1.2.1.10.1)*8；用户可以使用加减乘除四种运算方法对告警变量进行运算，该运算公式的结果取值为长整型数。用户在编写公式的时候需要注意，公式中每一步的运算结果都不能超过长整型数的取值范围，否则可能会得出错误的结果。
prialarm-des：对该告警的描述，长度为1～128。
sampling-timer：采样间隔时间，取值范围为10～65535，单位为秒。
delta | absolute | changeratio：采样类型，变化值、绝对值或者变化率。
threshold-value1：上限阈值，取值范围为0～2147483647。
event-entry1：上限阈值相应的事件号，取值范围为0～65535。
threshold-value2：下限阈值，取值范围为0～2147483647。
event-entry2：下限阈值相应的事件号，取值范围为0～65535。
forever ：告警实例存活类型为永久。
cycle：告警实例存活类型为周期。
cycle-period：告警实例的存活时间，取值范围0～2147483647，单位为秒。
owner text：该表项的创建者，字符串，长度为1～127。
【描述】
rmon prialarm命令用来在扩展RMON告警表中添加一个表项。undo rmon prialarm命令用来在扩展RMON告警表中删除一个表项。
不指定参数owner时，此表项创建者信息为空。
& 说明：
l 在添加扩展告警表项之前，需要通过rmon event命令定义好扩展告警表项中引用的事件。
l rmon event命令在对节点进行监控时，要求被监控的节点必需存在，否则配置无效。
l 用户最多可以定义50个扩展告警表项。
用户定义了扩展告警表项后，系统对扩展告警表项的处理如下：
l 对定义的扩展告警公式prialarm-formula中的告警变量按照定义的时间间隔sampling-timer进行采样；
l 将采样值按照定义的运算公式prialarm-formula进行计算；
l 将计算结果和与设定的阈值进行比较，按照下表2-8执行相应的处理过程。
|
实际情况 |
处理过程 |
|
计算值大于等于设定的上限threshold-value1 |
触发事件表中定义的事件event-entry1 |
|
计算值小于等于设定的下限threshold-value2 |
触发事件表中定义的事件event-entry2 |
【举例】
#在扩展告警表中添加索引号为2的表项，对相应告警变量以公式((.1.3.6.1.2.1.16.1.1.1.4.1)*100)运算，对该运算结果以10秒的采样间隔进行监视，当变化率大于上限阈值50时触发事件1，小于下限阈值5时触发事件2，设置告警实例采样类型为forever，创建者为user1。
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C]interface GigabitEthernet 1/0/1
[H3C-GigabitEthernet1/0/1] rmon statistics 1
[H3C-GigabitEthernet1/0/1] quit
[H3C] rmon prialarm 2 ((.1.3.6.1.2.1.16.1.1.1.4.1)*100) test 10 changeratio rising_threshold 50 1 falling_threshold 5 2 entrytype forever owner user1
# 在扩展RMON告警表中删除索引号为2的表项。
[H3C] undo rmon prialarm 2
【命令】
rmon statistics entry-number [ owner text ]
undo rmon statistics entry-number
【视图】
以太网端口视图
【参数】
entry-number：添加/删除表项的索引号，取值范围为1～65535。
owner text：该表项的创建者，字符串，长度为1～127个字符。
【描述】
rmon statistics命令用来在统计表中添加一个表项。undo rmon statistics命令用来在统计表中删除一个表项。
RMON统计管理功能可以用于统计被监视端口的使用及错误。统计信息包括网络冲突数、CRC校验错误报文数、过小（或超大）的数据报文数、广播、多播的报文数以及接收字节数、接收报文数等。
不指定参数owner时，此表项创建者信息为空。
& 说明：
一个端口下只能创建一个RMON统计表项。即如果在一个端口下已经创建了一个统计表项，再在该端口下创建一个其他索引号的统计表项也不能成功。
用户可以通过display rmon statistics命令来显示统计表项的信息。
【举例】
# 在统计表中添加索引号为20的表项，统计端口GigabitEthernet1/0/1的信息。
<H3C> system-view
System View: return to User View with Ctrl+Z.
[H3C]interface GigabitEthernet 1/0/1
[H3C-GigabitEthernet1/0/1] rmon statistics 20
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!
支持
