- 产品与解决方案
- 行业解决方案
- 服务
- 支持
- 合作伙伴
- 新华三人才研学中心
- 关于我们
04-SNMP命令
本章节下载： 04-SNMP命令 (303.35 KB)
目 录
1.1.1 display snmp-agent community
1.1.2 display snmp-agent context
1.1.3 display snmp-agent group
1.1.4 display snmp-agent local-engineid
1.1.5 snmp-agent community-map
1.1.6 display snmp-agent mib-node
1.1.7 display snmp-agent mib-view
1.1.8 display snmp-agent remote
1.1.9 display snmp-agent statistics
1.1.10 display snmp-agent sys-info
1.1.11 display snmp-agent trap queue
1.1.12 display snmp-agent trap-list
1.1.13 display snmp-agent usm-user
1.1.14 enable snmp trap updown
1.1.16 snmp-agent calculate-password
1.1.20 snmp-agent local-engineid
1.1.23 snmp-agent packet max-size
1.1.27 snmp-agent sys-info contact
1.1.28 snmp-agent sys-info location
1.1.29 snmp-agent sys-info version
1.1.32 snmp-agent trap if-mib link extended
1.1.35 snmp-agent trap queue-size
1.1.36 snmp-agent usm-user { v1 | v2c }
设备运行于FIPS模式时，本特性部分配置相对于非FIPS模式有所变化，具体差异请见本文相关描述。有关FIPS模式的详细介绍请参见“安全配置指导”中的“FIPS”。
SNMP告警信息包括SNMP Trap和Inform信息，用来告知NMS设备上发生了重要事件，比如，用户的登录/退出，接口状态变成up/down等。如无特殊说明，本文中的告警信息均指Trap和Inform两种信息。
display snmp-agent community命令用来显示SNMPv1或SNMPv2c的团体信息。
【命令】
display snmp-agent community [ read | write ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
mdc-admin
mdc-operator
【参数】
read：显示只读访问权限的团体信息。
write：显示读写访问权限的团体信息。
【使用指导】
FIPS模式下，不支持本命令。
不带参数时，显示所有SNMP团体的信息。
用户可以使用snmp-agent community命令来创建团体，另外，配置snmp-agent usm-user { v1 | v2c }和snmp-agent group { v1 | v2c }命令成功创建SNMPv1或SNMPv2c用户以及相应的组后，系统会自动添加一个新的同名的只读团体名。display snmp-agent community会显示这两种方式创建的团体的信息。
【举例】
# 显示设备当前所有已配置的团体信息。
<Sysname> display snmp-agent community
Community name: aa
Group name: aa
ACL:2001
Storage-type: nonVolatile
Community name: bb
Group name: bb
Storage-type: nonVolatile
Community name: userv1
Group name: testv1
Storage-type: nonVolatile
表1-1 display snmp-agent community命令显示信息描述表
|
字段 |
描述 |
|
Community name |
团体名： · 如果团体是通过snmp-agent community命令创建的，则显示的是团体名 · 如果团体名是通过snmp-agent usm-user { v1 | v2c }命令创建的，则显示的是用户名 |
|
Group name |
组名： · 如果团体名是通过snmp-agent community命令创建的，则组名和团体名相同 · 如果团体名是通过snmp-agent usm-user { v1 | v2c }命令创建的，则显示用户所在的组名 |
|
SNMP用户所在团体绑定的角色名： 通过snmp-agent community命令的RBAC方式创建的团体名可绑定用户角色 |
|
|
ACL |
使用的ACL列表的编号 |
|
Storage-type |
表示存储方式，分为以下几种： · volatile：重启后信息丢失 · nonVolatile：重启后信息仍保存 · permanent：重启后信息仍保存，允许更改，但不许删除 · readOnly：重启后信息仍保存，既不允许更改，也不许删除 · other：其他 |
【相关命令】
· snmp-agent community
· snmp-agent usm-user { v1 | v2c }
display snmp-agent context 命令用来显示指定的SNMP上下文。
【命令】
display snmp-agent context [ context-name ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
mdc-admin
mdc-operator
【参数】
context-name：显示指定的SNMP上下文，为1～32个字符的字符串，区分大小写。
【使用指导】
不指定参数时，显示设备上所有已创建的SNMP上下文。
【举例】
<Sysname> display snmp-agent context
trillcontext
isiscontext
【相关命令】
· snmp-agent context
display snmp-agent group命令用来显示SNMP组信息，包括组名、安全模式、视图、存储方式等。
【命令】
display snmp-agent group [ group-name ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
mdc-admin
mdc-operator
【参数】
group-name：非FIPS模式下，指定要显示信息的SNMPv1、SNMPv2c或SNMPv3组名；FIPS模式下，指定要显示信息的SNMPv3组名。为1～32个字符的字符串，区分大小写。
【使用指导】
不指定参数时，显示设备上所有已创建的SNMP组的信息。
【举例】
# 显示所有SNMP组的信息。
<Sysname> display snmp-agent group
Group name: groupv3
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 |
SNMP组配置的安全模式，包括版本信息和安全模式，以空格分隔： · 对于SNMPv1和SNMPv2c版本，认证加密级别只能为noAuthNoPriv（无认证无加密） · 对于SNMPv3版本，安全模式分为三种：authPriv（既认证又加密）、authNoPriv（只认证不加密）、noAuthNoPriv（不认证不加密） |
|
Readview |
SNMP组对应的只读的MIB视图名 |
|
Writeview |
SNMP组对应的可写的MIB视图名 |
|
Notifyview |
SNMP组对应的可以发Trap和Inform信息的MIB视图名 |
|
Storage-type |
存储方式，分为以下几种：volatile、nonVolatile、permanent、readOnly、other，具体请参见表1-1 |
|
ACL |
使用的ACL列表的编号 |
【相关命令】
· snmp-agent group
display snmp-agent local-engineid命令用来显示本地设备的SNMP实体引擎ID。
【命令】
display snmp-agent local-engineid
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
mdc-admin
mdc-operator
【使用指导】
SNMP实体引擎ID是SNMP实体的唯一标识，它在一个SNMP管理域内是唯一的。SNMP实体引擎是SNMP实体的重要组成部分，完成SNMP信息的信息调度、信息处理、安全验证、访问控制等功能。
【举例】
# 显示本地设备的SNMP实体引擎ID。
<Sysname> display snmp-agent local-engineid
SNMP local engine ID: 800007DB7F0000013859
【相关命令】
· snmp-agent local-engineid
snmp-agent community-map命令用来创建一个团体名到SNMP上下文的映射。
undo snmp-agent community-map命令用来删除一个指定的映射。
【命令】
snmp-agent community-map community-name context context-name
undo snmp-agent community-map community-name context context-name
【缺省情况】
设备上没有团体名到SNMP上下文的映射。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
community-name：团体名，为1～32个字符的字符串，区分大小写。
context-name：SNMP上下文。为1～32个字符的字符串，区分大小写。
【使用指导】
用户配置成功后，使用SNMP v1/v2版本连接SNMP Agent时，SNMP客户端所获取的上下文，是此时NMS访问Agent，使用的团体名映射的上下文。如团体名未配置上下文映射，则获取不到。
系统中可配置的映射最多为10个。
【举例】
# 配置一个团体名到SNMP上下文的映射。
<Sysname> system-view
[Sysname] snmp-agent community-map private context trillcontext
【相关命令】
· display snmp-agent community
display snmp-agent mib-node命令用来显示当前SNMP支持的MIB节点信息。
【命令】
display snmp-agent mib-node [ details | index-node | trap-node | verbose ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
mdc-admin
mdc-operator
【参数】
details： 表示显示SNMP支持的MIB节点细节信息，包括节点名、OID末位、下一个叶子节点名。
index-node：显示SNMP支持的MIB表及索引节点OID。
trap-node：显示SNMP支持的MIB告警节点名及对应的OID、告警绑定变量节点名及对应的OID。
verbose：显示SNMP支持的MIB节点详细信息，包括节点名、OID、节点类型、访问权限、数据类型，对应MOR（Managed Object Repository，管理对象库）定义、父子兄弟节点信息等。
【使用指导】
未指定任何参数时，显示SNMP支持的MIB节点信息，包括节点名、OID和节点访问权限。
特性包中可以包含不同的MIB插件，设备根据加载特性包的不同，支持的MIB不相同。
【举例】
# 显示SNMP支持MIB节点信息。
<Sysname> display snmp-agent mib-node
iso<1>(NA)
|-std<1.0>(NA)
|-iso8802<1.0.8802>(NA)
|-ieee802dot1<1.0.8802.1>(NA)
|-ieee802dot1mibs<1.0.8802.1.1>(NA)
|-lldpMIB<1.0.8802.1.1.2>(NA)
|-lldpNotifications<1.0.8802.1.1.2.0>(NA)
|-lldpNotificationPrefix<1.0.8802.1.1.2.0.0>(NA)
|-lldpRemTablesChange<1.0.8802.1.1.2.0.0.1>(NA)
|-lldpObjects<1.0.8802.1.1.2.1>(NA)
|-lldpConfiguration<1.0.8802.1.1.2.1.1>(NA)
|-*lldpMessageTxInterval<1.0.8802.1.1.2.1.1.1>(RW)
|-*lldpMessageTxHoldMultiplier<1.0.8802.1.1.2.1.1.2>(RW)
|-*lldpReinitDelay<1.0.8802.1.1.2.1.1.3>(RW)
表1-3 display snmp-agent mib-node命令显示信息描述表
|
字段 |
描述 |
|
-std |
MIB节点名 |
|
<1.0> |
MIB节点对应的OID |
|
(NA) |
MIB节点访问权限，取值为： NA：表示节点不可访问 NF：表示节点支持告警 RO：表示节点支持只读访问 RW：表示节点支持读写访问 RC：表示节点支持读写创建访问 WO：表示节点支持只写访问 |
|
* |
表示叶子节点或表节点 |
# 显示SNMP支持MIB节点细节信息。
<Sysname> display snmp-agent mib-node details
iso(1)(lldpMessageTxInterval)
|-std(0)(lldpMessageTxInterval)
|-iso8802(8802)(lldpMessageTxInterval)
|-ieee802dot1(1)(lldpMessageTxInterval)
|-ieee802dot1mibs(1)(lldpMessageTxInterval)
|-lldpMIB(2)(lldpMessageTxInterval)
|-lldpNotifications(0)(lldpMessageTxInterval)
|-lldpNotificationPrefix(0)(lldpMessageTxInterval)
|-lldpRemTablesChange(1)(NULL)
|-lldpObjects(1)(lldpMessageTxInterval)
|-lldpConfiguration(1)(lldpMessageTxInterval)
|-*lldpMessageTxInterval(1)(lldpMessageTxHoldMultiplier)
|-*lldpMessageTxHoldMultiplier(2)(lldpReinitDelay)
|-*lldpReinitDelay(3)(lldpTxDelay)
|-*lldpTxDelay(4)(lldpNotificationInterval)
|-*lldpNotificationInterval(5)(lldpPortConfigPortNum)
|-lldpPortConfigTable(6)(lldpPortConfigPortNum)
|-lldpPortConfigEntry(1)(lldpPortConfigPortNum)
|-*lldpPortConfigPortNum(1)(lldpPortConfigAdminStatus)
|-*lldpPortConfigAdminStatus(2)(lldpPortConfigNotificationEnable)
|-*lldpPortConfigNotificationEnable(3)(lldpPortConfigTLVsTxEnable)
|-*lldpPortConfigTLVsTxEnable(4)(lldpConfigManAddrPortsTxEnable)
表1-4 display snmp-agent mib-node details命令显示信息描述表
|
字段 |
描述 |
|
-std |
MIB节点名 |
|
(0) |
MIB节点对应OID末位 |
|
(lldpMessageTxInterval) |
MIB节点下一个叶子节点名 |
|
* |
表示叶子节点或表节点 |
# 显示SNMP支持的MIB表名、索引节点名及对应的OID。
<Sysname> display snmp-agent mib-node index-node
Table |lldpPortConfigTable
Index ||lldpPortConfigPortNum
OID ||| 1.0.8802.1.1.2.1.1.6.1.1
Table |lldpConfigManAddrTable
Index ||lldpLocManAddrSubtype
OID ||| 1.0.8802.1.1.2.1.3.8.1.1
Index ||lldpLocManAddr
OID ||| 1.0.8802.1.1.2.1.3.8.1.2
Table |lldpStatsTxPortTable
Index ||lldpStatsTxPortNum
OID ||| 1.0.8802.1.1.2.1.2.6.1.1
Table |lldpStatsRxPortTable
Index ||lldpStatsRxPortNum
OID ||| 1.0.8802.1.1.2.1.2.7.1.1
Table |lldpLocPortTable
Index ||lldpLocPortNum
OID ||| 1.0.8802.1.1.2.1.3.7.1.1
表1-5 display snmp-agent mib-node index-node命令显示信息描述表
|
字段 |
描述 |
|
Table |
MIB表名 |
|
Index |
MIB索引节点名 |
|
OID |
MIB索引节点对应的OID |
# 显示SNMP支持的MIB告警节点名及对应的OID、告警绑定变量节点名及对应的OID。
<Sysname> display snmp-agent mib-node trap-node
Name |lldpRemTablesChange
OID ||1.0.8802.1.1.2.0.0.1
Trap Object
Name |||lldpStatsRemTablesInserts
OID ||||1.0.8802.1.1.2.1.2.2
Name |||lldpStatsRemTablesDeletes
OID ||||1.0.8802.1.1.2.1.2.3
Name |||lldpStatsRemTablesDrops
OID ||||1.0.8802.1.1.2.1.2.4
Name |||lldpStatsRemTablesAgeouts
OID ||||1.0.8802.1.1.2.1.2.5
Name |lldpXMedTopologyChangeDetected
OID ||1.0.8802.1.1.2.1.5.4795.0.1
Trap Object
Name |||lldpRemChassisIdSubtype
OID ||||1.0.8802.1.1.2.1.4.1.1.4
Name |||lldpRemChassisId
OID ||||1.0.8802.1.1.2.1.4.1.1.5
Name |||lldpXMedRemDeviceClass
OID ||||1.0.8802.1.1.2.1.5.4795.1.3.1.1.3
Name |mplsL3VpnVrfUp
OID ||1.3.6.1.2.1.10.166.11.0.1
Trap Object
Name |||mplsL3VpnIfConfRowStatus
OID ||||1.3.6.1.2.1.10.166.11.1.2.1.1.5
Name |||mplsL3VpnVrfOperStatus
OID ||||1.3.6.1.2.1.10.166.11.1.2.2.1.6
表1-6 display snmp-agent mib-node trap-node命令显示信息描述表
|
字段 |
描述 |
|
Name |
MIB告警节点名 |
|
OID |
MIB告警节点对应的OID |
|
Trap Object |
MIB告警绑定变量节点相关信息（其中Name表示告警绑定变量节点名，OID表示变量名节点对应的OID） |
# 显示SNMP支持的MIB节点详细信息，包括节点名、OID、节点类型、访问权限、数据类型，对应MOR定义、父子兄弟节点信息等。
<Sysname> display snmp-agent mib-node verbose
Name |lldpNotificationInterval
OID ||1.0.8802.1.1.2.1.1.5
Properties ||NodeType: Leaf
||AccessType: RW
||DataType: Integer32
||MOR: 0x020c1105
Parent ||lldpConfiguration
First child ||
Next leaf ||lldpPortConfigPortNum
Next sibling ||lldpPortConfigTable
Allow ||get/set/getnext
Value range || [5..3600]
Name |lldpPortConfigTable
OID ||1.0.8802.1.1.2.1.1.6
Properties ||NodeType: Table
||AccessType: NA
||DataType: NA
||MOR: 0x00000000
Parent ||lldpConfiguration
First child ||lldpPortConfigEntry
Next leaf ||lldpPortConfigPortNum
Next sibling ||lldpConfigManAddrTable
Name |lldpPortConfigEntry
OID ||1.0.8802.1.1.2.1.1.6.1
Properties ||NodeType: Row
||AccessType: NA
||DataType: NA
||MOR: 0x00000000
Parent ||lldpPortConfigTable
First child ||lldpPortConfigPortNum
Next leaf ||lldpPortConfigPortNum
Next sibling ||
Index ||[indexImplied:0, indexLength:1]:
Name |lldpPortConfigPortNum
OID ||1.0.8802.1.1.2.1.1.6.1.1
Properties ||NodeType: Column
||AccessType: NA
||DataType: Integer32
||MOR: 0x020c1201
Parent ||lldpPortConfigEntry
First child ||
Next leaf ||lldpPortConfigAdminStatus
Next sibling ||lldpPortConfigAdminStatus
Allow ||get/set/getnext
Index ||[indexImplied:0, indexLength:1]:
Value range || [1..4096]
Name |lldpPortConfigAdminStatus
OID ||1.0.8802.1.1.2.1.1.6.1.2
Properties ||NodeType: Column
||AccessType: RW
||DataType: Integer
||MOR: 0x020c1202
Parent ||lldpPortConfigEntry
First child ||
Next leaf ||lldpPortConfigNotificationEnable
Next sibling ||lldpPortConfigNotificationEnable
Allow ||get/set/getnext
Index ||[indexImplied:0, indexLength:1]:
Value range ||
|| ['txOnly', 1]
|| ['rxOnly', 2]
|| ['txAndRx', 3]
|| ['disabled', 4]
表1-7 display snmp-agent mib-node verbose命令显示信息描述表
|
字段 |
描述 |
|
Name |
MIB节点名 |
|
OID |
MIB节点对应的OID |
|
NodeType |
MIB节点类型，取值为： · Table：表节点 · Row：表中行节点 · Column：表中列节点 · Leaf：叶子节点 · Group：组节点（叶子节点的父节点） · Trapnode：告警节点 · Other：其他类型 |
|
AccessType |
MIB节点访问权限，取值为： · NA：表示节点不可访问 · NF：表示节点支持告警 · RO：表示节点支持只读访问 · RW：表示节点支持读写访问 · RC：表示节点支持读写创建访问 · WO：表示节点支持只写访问 |
|
DataType |
MIB节点数据类型，取值为： · Integer：整数 · Integer32：32位整数 · Unsigned32：32位无符号整数 · Gauge：可增可减的非负整数 · Gauge32：32位可增可减的非负整数 · Counter：可增不可减的非负整数 · Counter32：32位可增不可减的非负整数 · Counter64：64位可增不可减的非负整数 · Timeticks：用于计时的非负整数 · Octstring：八进制字符串 · OID：对象标识符 · IPaddress：用于IP规范格式的32位地址 · Networkaddress：网络IP地址 · Opaque：任意数据 · Userdefined：用户类型 · BITS：所述位枚举 |
|
MOR |
MIB节点对应的MOR定义 |
|
Parent |
父节点名 |
|
First child |
第一个子节点名 |
|
Next leaf |
下一个叶子节点名 |
|
Next sibling |
右兄弟节点名 |
|
Allow |
允许的操作类型，取值包括如下： · get/set/getnext：允许所有操作 · get：只允许Get操作 · set：只允许Set操作 · getnext：只允许GetNext操作 |
|
Value range |
节点的取值范围 |
|
Index |
表索引，仅表节点显示此字段 |
display snmp-agent mib-view命令用来显示MIB视图的信息。
【命令】
display snmp-agent mib-view [ exclude | include | viewname view-name ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
mdc-admin
mdc-operator
【参数】
exclude：显示属性为exclude的MIB视图的信息。
include：显示属性为include的MIB视图的信息。
viewname view-name：显示指定名称MIB视图的信息，view-name为视图的名称。
【使用指导】
不指定参数时，显示所有MIB视图的信息。
【举例】
# 显示设备的所有MIB视图。
<Sysname> display snmp-agent mib-view
View name: ViewDefault
MIB Subtree: iso
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
以上信息表明，设备上当前有四个MIB视图，名称均为ViewDefault。使用ViewDefault视图名限制NMS访问时，除了snmpUsmMIB、snmpVacmMIB、snmpModules.18子树下的MIB对象，NMS可以访问iso子树下其它所有MIB对象。
表1-8 display snmp-agent mib-view命令显示信息描述表
|
字段 |
描述 |
|
View name |
视图名 |
|
MIB Subtree |
MIB视图对应的MIB子树 |
|
Subtree mask |
MIB子树的掩码 |
|
Storage-type |
存储方式，分为以下几种：volatile、nonVolatile、permanent、readOnly、other，具体请参见表1-1 |
|
View Type |
MIB视图的类型（即该视图与MIB子树的关系），包括included和excluded两种： · included表示当前视图包括该子树的所有节点，即可以访问子树内的所有MIB对象 · excluded表示当前视图不包括该子树的任意节点，即子树内的所有MIB对象都不能被访问 |
|
View status |
MIB视图的状态，包括： · active表示MIB视图可用 · inactive表示MIB视图不可用 对MIB视图状态节点执行Set操作可以修改MIB视图的状态 |
【相关命令】
· snmp-agent mib-view
display snmp-agent remote命令用来显示远端SNMP实体的引擎ID。
【命令】
display snmp-agent remote [ ip-address [ vpn-instance vpn-instance-name ] | ipv6 ipv6-address [ vpn-instance vpn-instance-name ] ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
mdc-admin
mdc-operator
【参数】
ip-address：显示指定IP地址的远端SNMP实体的引擎ID。
ipv6 ipv6-address：显示指定IPv6地址的远端SNMP实体的引擎ID。
vpn-instance vpn-instance-name：指定远端SNMP实体所属的VPN。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则表示远端SNMP实体位于公网中。
【使用指导】
SNMP实体引擎ID是SNMP实体的唯一标识，它在一个SNMP管理域内是唯一的。SNMP实体引擎是SNMP实体的重要组成部分，完成SNMP信息的信息调度、信息处理、安全验证、访问控制等功能。
【举例】
# 显示所有远端SNMP实体的引擎ID。
<Sysname> display snmp-agent remote
Remote engined: 800063A28000A0FC00580400000001
IPv4 address: 1.1.1.1
VPN instance: vpn1
表1-9 display snmp-agent remote命令显示信息描述表
|
字段 |
描述 |
|
Remote engined |
远端SNMP实体的引擎，可通过snmp-agent remote命令配置 |
|
IPv4 address |
远端SNMP实体的IPv4地址 如果配置snmp-agent remote命令时绑定的是IPv6地址，则显示IPv6 address |
|
VPN instance |
远端SNMP实体所属的VPN。只有配置snmp-agent remote命令且绑定了VPN时，才显示该信息 |
【相关命令】
· snmp-agent remote
display snmp-agent statistics命令用来显示SNMP报文的统计信息。
【命令】
display snmp-agent statistics
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
mdc-admin
mdc-operator
【举例】
# 显示SNMP报文的统计信息。
<Sysname> display snmp-agent statistics
1684 messages delivered to the SNMP entity.
5 messages were for an unsupported version.
0 messages used an unknown SNMP community name.
0 messages represented an illegal operation for the community supplied.
0 ASN.1 or BER errors in the process of decoding.
1679 messages passed from the SNMP entity.
0 SNMP PDUs had badValue error-status.
0 SNMP PDUs had genErr error-status.
0 SNMP PDUs had noSuchName error-status.
0 SNMP PDUs had tooBig error-status (Maximum packet size 1500).
16544 MIB objects retrieved successfully.
2 MIB objects altered successfully.
7 GetRequest-PDU accepted and processed.
7 GetNextRequest-PDU accepted and processed.
1653 GetBulkRequest-PDU accepted and processed.
1669 GetResponse-PDU accepted and processed.
2 SetRequest-PDU accepted and processed.
0 Trap PDUs accepted and processed.
0 alternate Response Class PDUs dropped silently.
0 forwarded Confirmed Class PDUs dropped silently.
表1-10 display snmp-agent statistics命令显示信息描述表
|
字段 |
描述 |
|
messages delivered to the SNMP entity |
Agent收到的数据报文个数 |
|
messages were for an unsupported version |
版本不支持的数据报文个数 |
|
messages used an unknown SNMP community name |
使用了非法团体名的数据报文个数 |
|
messages represented an illegal operation for the community supplied |
包含了超出团体名权限的操作的数据报文个数 |
|
ASN.1 or BER errors in the process of decoding |
在解码过程中发生ASN.1（Abstract Syntax Notation dot one，抽象记法1）或BER（Basic Encoding Rules ，基本编码规则）错误的数据报文个数 |
|
messages passed from the SNMP entity |
Agent发送给别的SNMP实体的数据报文个数 |
|
SNMP PDUs had badValue error-status |
错误类型为BadValues的数据报文个数 |
|
SNMP PDUs had genErr error-status |
genErr错误的数据报文个数 |
|
SNMP PDUs had noSuchName error-status |
NoSuchName错误的数据报文个数 |
|
SNMP PDUs had tooBig error-status |
TooBig错误的数据报文个数 |
|
MIB objects retrieved successfully |
已成功获取的MIB对象个数 |
|
MIB objects altered successfully |
已成功修改的MIB对象个数 |
|
GetRequest-PDU accepted and processed |
已接收并处理的Get请求的个数 |
|
GetNextRequest-PDU accepted and processed |
已接收并处理的GetNext请求的个数 |
|
GetBulkRequest-PDU accepted and processed |
已接收并处理的GetBulk请求的个数 |
|
GetResponse-PDU accepted and processed |
已接收并处理的Get响应的个数 |
|
SetRequest-PDU accepted and processed |
已接收并处理的Set请求的个数 |
|
Trap PDUs accepted and processed |
已接收并处理的Trap和Inform报文的个数 |
|
alternate Response Class PDUs dropped silently |
被丢弃的响应数据报文个数 |
|
forwarded Confirmed Class PDUs dropped silently |
被丢弃的转发数据报文个数 |
display snmp-agent sys-info命令用来显示当前SNMP设备的系统信息。
【命令】
display snmp-agent sys-info [ contact | location | version ] *
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
mdc-admin
mdc-operator
【参数】
contact：显示当前设备维护者的联系信息。
location：显示当前设备的物理位置信息。
version：显示当前设备中运行的SNMP版本号。
【使用指导】
不指定参数时，显示设备的全部系统信息。
【举例】
# 显示设备系统信息。
<Sysname> display snmp-agent sys-info
The contact information of the agent:
Hangzhou H3C Technologies Co., Ltd.
The location information of the agent:
Hangzhou, China
The SNMP version of the agent:
SNMPv3
【相关命令】
· snmp-agent sys-info
display snmp-agent trap queue命令用来显示告警信息队列的基本信息，包括告警信息队列名、队列长度以及队列中当前告警信息的数量。
【命令】
display snmp-agent trap queue
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
mdc-admin
mdc-operator
【举例】
# 显示当前告警信息队列的配置及使用情况。
<Sysname> display snmp-agent trap queue
Queue size: 100
Message number: 6
表1-11 display snmp-agent trap queue命令显示信息描述表
|
字段 |
描述 |
|
Queue size |
告警信息队列长度 |
|
Message number |
告警信息队列中当前告警信息的个数 |
【相关命令】
· snmp-agent trap life
· snmp-agent trap queue-size
display snmp-agent trap-list命令用来显示设备当前可以生成告警信息的模块及其告警信息的使能状态。
【命令】
display snmp-agent trap-list
【视图】
任意视图
【使用指导】
如果一个模块包含多个子模块，只要有任何一个子模块的告警信息是使能的，就显示整个模块是使能的。
【举例】
# 显示设备当前可以生成告警信息的模块及其告警信息的使能状态。
<Sysname> display snmp-agent trap-list
arp notification is disabled.
configuration notification is enabled.
l3vpn notification is enabled.
ldp notification is enabled.
mpls notification is enabled.
ospf notification is enabled.
radius notification is disabled.
standard notification is enabled.
system notification is enabled.
Enabled notifications: 7; Disabled notifications: 2
以上显示信息中enable表示允许该模块生成告警信息，disable表示不允许该模块生成告警信息。enable或者disable可以通过命令行配置。
【相关命令】
· snmp-agent trap enable
display snmp-agent usm-user命令用来显示SNMPv3用户信息。
【命令】
display snmp-agent usm-user [ engineid engineid | group group-name | username user-name ] *
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
mdc-admin
mdc-operator
【参数】
engineid engineid：显示指定引擎ID的SNMPv3用户信息，engineid表示SNMP引擎ID。SNMPv3用户创建的时候，系统会记录当时设备的SNMP实体引擎ID，如果设备的引擎ID被修改，则被创建的SNMPv3用户将暂时无效，只有引擎ID恢复后，才能继续生效。
group group-name：显示属于指定SNMP组的SNMPv3用户信息，区分大小写。
username user-name：显示指定名字的SNMPv3用户信息，区分大小写。
【使用指导】
使用snmp-agent usm-user命令可以创建SNMPv1/v2c/v3用户，如果创建是的SNMPv1/v2c用户，系统自动添加一个新的同名的团体名，并将这个用户当成SNMPv1/v2c团体来处理。所以，不能通过display snmp-agent usm-user命令来查看SNMPv1/v2c用户的信息，能通过display snmp-agent community查看SNMPv1/v2c用户对应的团体的信息。
【举例】
# 显示设备上已创建的所有SNMPv3用户的信息。
<Sysname> display snmp-agent usm-user
Username: userv3
Group name: mygroupv3
Engine ID: 800063A203000FE240A1A6
Storage-type: nonVolatile
UserStatus: active
Username: userv3code
Group name: groupv3code
Engine ID: 800063A203000FE240A1A6
Storage-type: nonVolatile
UserStatus: active
表1-12 display snmp-agent usm-user命令显示信息描述表
|
字段 |
描述 |
|
Username |
SNMP用户的用户名 |
|
Group name |
SNMP用户所在组的组名 |
|
SNMP用户的角色名称 |
|
|
Engine ID |
SNMP用户创建时使用的SNMP实体引擎ID |
|
Storage-type |
存储方式，分为以下几种：volatile、nonVolatile、permanent、readOnly、other，具体请参见表1-1 |
|
UserStatus |
SNMP用户的状态，分为以下几种： · active：有效 · notInService：当前不可用 · notReady：未配置完成 · other：其他 |
|
ACL |
使用的ACL列表的编号（该字段仅在用户与ACL绑定后显示） |
【相关命令】
· snmp-agent usm-user v3
enable snmp trap updown命令用来开启接口状态变化的告警功能。
undo enable snmp trap updown命令用来关闭接口状态变化的告警功能。
【命令】
enable snmp trap updown
undo enable snmp trap updown
【缺省情况】
接口状态变化的告警功能处于开启状态。
【视图】
接口视图
【缺省用户角色】
network-admin
mdc-admin
【使用指导】
需要注意的是，如果要求接口在状态发生改变时生成接口状态变化的告警信息，需要开启全局告警功能并在接口开启接口状态变化的告警功能。接口下开启请使用命令enable snmp trap updown，全局下开启请使用命令snmp-agent trap enable standard [ linkdown | linkup ] *。
【举例】
# 允许发送端口Ten-GigabitEthernet1/0/1的linkUp/linkDown的SNMP告警，使用团体名public，向IP地址为10.1.1.1的目的主机发送Trap报文。
<Sysname> system-view
[Sysname] snmp-agent trap enable
[Sysname] snmp-agent target-host trap address udp-domain 10.1.1.1 params securityname public
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] enable snmp trap updown
【相关命令】
· snmp-agent target-host
· snmp-agent trap enable
snmp-agent命令用来开启SNMP Agent功能。
undo snmp-agent命令用来关闭SNMP Agent功能。
【命令】
snmp-agent
undo snmp-agent
【缺省情况】
SNMP Agent功能处于关闭状态。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【使用指导】
执行除snmp-agent calculate-password外任何以snmp-agent开头的命令都可以开启SNMP Agent功能。
【举例】
# 开启设备的SNMP Agent功能。
<Sysname> system-view
[Sysname] snmp-agent
snmp-agent calculate-password命令用来计算用户给定明文密码通过加密算法处理后的密文密码。
【命令】
非FIPS模式下：
snmp-agent calculate-password plain-password mode { 3desmd5 | 3dessha | md5 | sha } { local-engineid | specified-engineid engineid }
FIPS模式下：
snmp-agent calculate-password plain-password mode sha { local-engineid | specified-engineid engineid }
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
plain-password：需要被加密的明文密码。
mode：指明使用的认证算法或加密算法。AES、3DES和DES是加密算法，这三个加密算法的安全性由高到低依次是：AES、3DES、DES，安全性高的加密算法实现机制复杂，运算速度慢。对于普通的安全要求，DES算法就可以满足需要；MD5和SHA-1是认证算法，其中MD5算法的计算速度比SHA-1算法快，而SHA-1算法的安全强度比MD5算法高。
· 3desmd5：用于将明文密码转换为密文密码，此时对应的认证算法必须为MD5，加密协议必须为3DES。
· 3dessha：用于将明文密码转换为密文密码，此时对应的认证算法必须为SHA-1，加密协议必须为3DES。
· md5：用于将明文认证密码转换为密文认证密码，此时对应的认证算法必须为MD5；或者用于将明文加密密码转换为密文加密密码，此时对应的认证算法必须为MD5，加密协议可以为AES也可以是DES（当认证协议为MD5时，加密协议不管是AES还是DES，转换后的结果是一样的）。
· sha：用于将明文认证密码转换为密文认证密码，此时对应的认证算法必须为SHA-1；或者用于将明文加密密码转换为密文加密密码，此时对应的认证算法必须为SHA-1，加密协议可以为AES也可以是DES（当认证协议为SHA-1时，加密协议不管是AES还是DES，转换后的结果是一样的）。
local-engineid：使用本地引擎ID计算密文密码，引擎ID的相关描述与配置可参考命令snmp-agent local-engineid。
specified-engineid：使用用户指定的引擎ID计算密文密码。
engineid：引擎ID，必须为偶数个十六进制数，偶数的取值范围为10～64。全0和全F均被认为是无效参数。
【使用指导】
执行本命令前，必须先开启设备的SNMP Agent功能。
在创建SNMPv3用户时，如果指明认证或者加密密码采用密文形式，则可以借助此命令生成相应的密文密码所对应的摘要。
生成的密码是和引擎ID相关联的，在某一引擎ID下生成的密码，也只在此引擎ID下生效。
通过该命令可以得到密文密码对应的摘要，从而在配置用户时使用摘要，避免由于输入明文密码造成的安全隐患，同时由于密码可以解密，摘要不可逆，所以增强了安全性。
【举例】
# 使用本地引擎ID和SHA-1认证算法计算明文为authkey的加密密码所对应摘要。
<Sysname> system-view
[Sysname] snmp-agent calculate-password authkey mode sha local-engineid
The encrypted key is: 09659EC5A9AE91BA189E5845E1DDE0CC
【相关命令】
· snmp-agent local-engineid
· snmp-agent usm-user v3
snmp-agent community命令用来创建一个新的SNMP团体，并设置该团体的参数，包括访问权限、配置团体名方式、访问控制列表和可访问的MIB视图。
undo snmp-agent community命令用来删除指定的团体。
【命令】
VACM方式：
snmp-agent community { read | write } [ simple | cipher ] community-name [ mib-view view-name ] [ acl acl-number | acl ipv6 ipv6-acl-number ] *
undo snmp-agent community { read | write } [ cipher ] community-name
RBAC方式：
undo snmp-agent community [ cipher ] community-name
【缺省情况】
设备上没有配置SNMP团体。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
read：表示对MIB对象的访问权限为只读。NMS使用该团体名访问Agent时只能执行读操作。
write：表示对MIB对象的访问权限为读写。NMS使用该团体名访问Agent时可以执行读、写操作。
simple:表示以明文方式配置团体名并以密文方式保存到配置文件中，缺省情况下，以明文方式配置团体名，并以明文方式保存到配置文件。
cipher:表示以密文方式配置团体名并以密文方式保存到配置文件中，缺省情况下，以明文方式配置团体名，并以明文方式保存到配置文件。
community-name：设置明文团体名或密文团体名，是限制NMS访问Agent时所使用的团体名。区分大小写，需要转义的字符请加“\”后输入。当以明文方式配置时，团体名为1～32个字符的字符串；当以密文方式配置时，团体名为33～73个字符的字符串。
mib-view view-name：用来指定NMS可以访问的MIB对象的范围，view-name表示MIB视图名，为1～32个字符的字符串。不指定参数时，缺省视图为ViewDefault。
user-role role-name：该团体对应的角色名称，role-name为1~63个字符的字符串，区分大小写。acl acl-number：将团体名与基本ACL绑定，限制了只有IP地址符合条件的NMS可以访问Agent。acl-number表示访问列表号，取值范围为2000～2999。当未引用ACL或者引用的ACL不存在时，允许所有NMS访问设备；当引用的ACL为空时，会禁止所有的NMS访问设备；当引用的ACL非空时，则只有ACL中permit的NMS才能访问设备，其它NMS不允许访问设备，以免非法NMS访问设备。关于ACL的详细描述和介绍请参见“ACL和QoS配置指导”中的“ACL”。
acl ipv6 ipv6-acl-number：将团体名与基本IPv6 ACL绑定，限制了只有IPv6地址符合条件的NMS可以访问Agent。ipv6-acl-number表示访问列表号，取值范围为2000～2999。当未引用IPv6 ACL或者引用的IPv6 ACL不存在，允许所有NMS访问设备；当引用的IPv6 ACL为空时，会禁止NMS访问设备；当引用的IPv6 ACL非空时，则只有IPv6 ACL中permit的NMS才能访问设备，其它NMS不允许访问设备，以免非法NMS访问设备。
【使用指导】
FIPS模式下，不支持本命令。
该命令用于SNMPv1和SNMPv2c组网环境。
系统中可配置的SNMP团体最多为10个，如果想创建并配置更多的SNMP团体，可以通过snmp-agent usm-user { v1 | v2c }命令建立。
团体是NMS和Agent的集合，用团体名来标志。团体名相当于密码，团体内的设备通信时使用团体名来进行认证。只有NMS和Agent上配置的团体名相同时，才能互相访问。通常情况下，“public”被用来作为读权限团体名、“private”被用来作为写权限团体名。为了增强安全性，网络管理员也可以配置其它团体名。
创建SNMP团体时，可以通过两种配置方式来控制团体的访问：
· VACM（View-based Access Control Model，基于视图的访问控制模型）的配置方式，通过mib-view参数限制NMS可以访问的Agent上的MIB对象，名称为view-name的所有MIB视图都会被访问引用；通过read、write参数限制NMS可以对Agent执行的操作类型。
· RBAC（Role Based Access Control，基于角色的访问控制）的配置方式，通过user-role role-name配置团体的角色。角色定义了SNMP用户能够访问的MIB对象以及操作类型（通过rule规则来限定）。该角色可以是系统中预定义的角色，也可以是用户通过role命令自定义的角色。有关用户角色的详细信息，请参见“基础配置指导”中的“RBAC”。
多次使用两种配置方式配置同一团体时，以最后一次的配置方式为准。
RBAC配置方式要求NMS在访问Agent时，不仅需要授予NMS对MIB节点的访问权限，还要求团体名/用户名所绑定的用户角色具有执行相应操作的权限，而VACM方式只需通过控制MIB节点的访问权限即可，所以推荐使用RBAC配置方式，安全性更高。
【举例】
# 以明文方式创建团体readaccess，并且允许使用该团体名进行只读访问。
<Sysname> system-view
[Sysname] snmp-agent sys-info version v1 v2c
[Sysname] snmp-agent community read simple readaccess
在NMS上将版本号设置为SNMPv1或者SNMPv2c，并将只读团体名填写为readaccess，建立连接，就可以对设备上缺省视图内的MIB对象进行只读操作。
# 以明文方式设置团体名writeaccess，并且只允许IP地址为1.1.1.1的NMS使用该团体名设置Agent MIB对象的值，禁止其它NMS使用该团体名执行写操作。
<Sysname> system-view
[Sysname] acl number 2001
[Sysname-acl-basic-2001] rule permit source 1.1.1.1 0.0.0.0
[Sysname-acl-basic-2001] rule deny source any
[Sysname-acl-basic-2001] quit
[Sysname] snmp-agent sys-info version v2c
[Sysname] snmp-agent community write simple writeaccess acl 2001
将NMS的IP地址配置为1.1.1.1，版本号指定为SNMPv2c，Write community选项填写为writeaccess，即可以对设备上缺省视图内的MIB对象进行读写操作。
# 以明文方式创建团体名wr-sys-acc，使用该团体名访问设备时只能对system（OID为1.3.6.1.2.1.1）子树下的MIB对象执行写操作。
<Sysname> system-view
[Sysname] snmp-agent sys-info version v1 v2c
[Sysname] undo snmp-agent mib-view ViewDefault
[Sysname] snmp-agent mib-view included test system
[Sysname] snmp-agent community write simple wr-sys-acc mib-view test
在NMS上将版本号设置为SNMPv1或者SNMPv2c，并将Write community填写为wr-sys-acc，建立连接，就可以对设备上system视图内的MIB对象进行读写操作。
【相关命令】
· display snmp-agent community
· snmp-agent mib-view
snmp-agent context命令用来创建一个新的SNMP上下文。
undo snmp-agent context命令用来删除指定的SNMP上下文。
【命令】
snmp-agent context context-name
undo snmp-agent context context-name
【缺省情况】
设备上没有配置SNMP上下文。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
context-name：SNMP上下文，为1～32个字符的字符串，区分大小写。
【使用指导】
NMS未配置或者配置与Agent相同的上下文时，可以连接Agent，否则返回超时。
系统中可配置的SNMP上下文最多为20个。
【举例】
# 创建一个新的context。
<Sysname> system-view
[Sysname] snmp-agent context trillcontext
【相关命令】
· display snmp-agent context
snmp-agent group命令用来创建一个新的SNMP组，并设置其访问权限。
undo snmp-agent group命令用来删除一个指定的SNMP组。
【命令】
非FIPS模式下：
SNMPv1和SNMPv2c版本下的命令格式是：
snmp-agent group { v1 | v2c } group-name [ read-view view-name ] [ write-view view-name ] [ notify-view view-name ] [ acl acl-number | acl ipv6 ipv6-acl-number ] *
undo snmp-agent group { v1 | v2c } group-name
SNMPv3版本下的命令格式是：
snmp-agent group v3 group-name [ authentication | privacy ] [ read-view read-view ] [ write-view write-view ] [ notify-view notify-view ] [ acl acl-number | acl ipv6 ipv6-acl-number ] *
undo snmp-agent group v3 group-name [ authentication | privacy ]
FIPS模式下：
snmp-agent group v3 group-name { authentication | privacy } [ read-view read-view ] [ write-view write-view ] [ notify-view notify-view ] [ acl acl-number | acl ipv6 ipv6-acl-number ] *
undo snmp-agent group v3 group-name { authentication | privacy }
【缺省情况】
设备上没有配置SNMP组。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
v1：SNMPv1版本。
v2c：SNMPv2c版本。
v3：SNMPv3版本。
group-name：SNMP组名，为1～32个字符的字符串，区分大小写。
authentication：表示对报文进行认证但不加密。
privacy：表示对报文进行认证和加密。
read-view view-name：只读视图名，为1～32个字符的字符串。缺省值为ViewDefault。
write-view view-name：读写视图名，为1～32个字符的字符串。缺省情况下，未配置读写视图，即NMS不能对设备的所有MIB对象进行写操作。
notify-view view-name：可以发告警信息的视图名，为1～32个字符的字符串。缺省情况下，未配置告警信息视图。
acl acl-number：将组与基本ACL绑定，acl-number表示访问列表号，取值范围为2000～2999。当未引用ACL或者引用的ACL不存在，允许所有NMS访问设备；当引用的ACL为空时，会禁止所有的NMS访问设备；当引用的ACL非空时，则只有ACL中permit的NMS才能访问设备，其它NMS不允许访问设备，以免非法NMS访问设备。
acl ipv6 ipv6-acl-number：将组与基本IPv6 ACL绑定，ipv6-acl-number表示访问列表号，取值范围为2000～2999。当未引用IPv6 ACL或者引用的IPv6 ACL不存在时，允许所有NMS访问设备；当引用的IPv6 ACL为空时，会禁止NMS访问设备；当引用的IPv6 ACL非空时，则只有IPv6 ACL中permit的NMS才能访问设备，其它NMS不允许访问设备，以免非法NMS访问设备。
【使用指导】
FIPS模式下，不支持SNMPv1和SNMPv2c版本下的本命令。
SNMP组可以定义安全模式、视图权限等信息，配置在此组内的用户都具有这些公共属性。
系统中可配置的SNMP组最多为20个。
当不指定authentication和privacy时，表示不认证不加密。此时，使用和该组绑定的用户名建立SNMP连接时，均不认证不加密。即便用户配置了认证密码/加密密码，认证密码/加密密码也不生效。
当指定authentication时，表示认证不加密。此时，使用和该组绑定的用户名建立SNMP连接时，均认证不加密。即便用户配置了加密密码，加密密码也不生效。
当指定privacy时，表示认证加密。此时，使用和该组绑定的用户名建立SNMP连接时，均认证加密。该组内的用户必须配置认证密码和加密密码，否则，不能建立SNMP连接。
【举例】
# 在运行SNMPv3版本的设备上创建一个SNMP组group1，采用不认证、不加密方式。
<Sysname> system-view
[Sysname] snmp-agent group v3 group1
【相关命令】
· display snmp-agent group
· snmp-agent mib-view
· snmp-agent usm-user
snmp-agent local-engineid命令用来设置本地SNMP实体的引擎ID。
undo snmp-agent local-engineid命令用来恢复缺省情况。
【命令】
snmp-agent local-engineid engineid
undo snmp-agent local-engineid
【缺省情况】
设备引擎ID为公司的“企业号＋设备信息”。设备信息由各个产品决定，可以是IP地址、MAC地址或者自定义的十六进制数字串。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
engineid：引擎ID，必须为偶数个十六进制数，偶数的取值范围为10～64。全0和全F均被认为是无效参数。
【使用指导】
引擎ID有两个作用：
· 在NMS管理的所有设备中，每一台设备都需要用一个唯一的引擎ID来标识Agent，缺省情况下每个设备有一个缺省的引擎ID，网络管理员需要确保管理域内不能有重复的引擎ID。
· SNMPv3版本的用户名、密文密码等都和引擎ID相关联，如果更改了引擎ID，则原引擎ID下配置的用户名、密码失效。
通常情况下，使用设备的缺省引擎ID即可，用户也可以根据网络整体规划给设备配置方便记忆的引擎ID，比如A栋一楼的一号设备可以将它的引擎ID设置为000Af0010001，二号设备可以配置为000Af0010002。
【举例】
# 配置本地设备的引擎ID为123456789A。
<Sysname> system-view
[Sysname] snmp-agent local-engineid 123456789A
【相关命令】
· display snmp-agent local-engineid
· snmp-agent usm-user
snmp-agent log命令用来开启SNMP日志功能。
undo snmp-agent log命令用来关闭SNMP日志功能。
【命令】
snmp-agent log { all | authfail | get-operation | set-operation }
undo snmp-agent log { all | authfail | get-operation | set-operation }
【缺省情况】
SNMP日志功能处于关闭状态。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
all：表示SNMP Get、Set操作和SNMP认证失败的日志开关。
get-operation：表示SNMP Get操作的日志开关。
set-operation：表示SNMP Set操作的日志开关。
authfail：表示SNMP认证失败的日志开关。
【使用指导】
当打开SNMP指定的日志开关，NMS对Agent执行指定的操作、或NMS访问Agent认证失败时，Agent会记录与该操作相关的信息并保存到设备的信息中心。通过设置信息中心的参数，最终决定SNMP日志的输出规则（即是否允许输出以及输出方向）。
【举例】
# 打开SNMP Get操作的日志开关。
<Sysname> system-view
[Sysname] snmp-agent log get-operation
# 打开SNMP Set操作的日志开关。
<Sysname> system-view
[Sysname] snmp-agent log set-operation
snmp-agent mib-view命令用来创建或者更新MIB视图的信息，以指定NMS可以访问的MIB对象。
undo snmp-agent mib-view命令用来删除指定视图。
【命令】
snmp-agent mib-view { excluded | included } view-name oid-tree [ mask mask-value ]
undo snmp-agent mib-view view-name
【缺省情况】
设备上已创建了四个视图，视图名均为ViewDefault：
· 视图一包含MIB子树iso；
· 视图二不包含子树snmpUsmMIB；
· 视图三不包含子树snmpVacmMIB；
· 视图四不包含子树snmpModules.18。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
excluded：表示当前视图不包括该MIB子树的任何节点（即禁止访问MIB子树的所有节点）。
included：表示当前视图包括该MIB子树的所有节点（即允许访问MIB子树的所有节点）。
view-name：视图名，为1～32个字符的字符串。
oid-tree：MIB子树，用子树根节点的OID（如“1.3.6.1.2.1.1”）或名称（如“system”）表示。OID是由一系列的整数组成，标明节点在MIB树中的位置，它能唯一地标识一个MIB库中的对象。
mask mask-value：对象子树的掩码，十六进制数，长度为1～32中的偶数。
【使用指导】
MIB视图是MIB的子集，由视图名和MIB子树来唯一确定一个MIB视图。视图名相同但包含的子树不同，则认为是不同的视图。除缺省视图外，用户最多可以创建16个MIB视图。
缺省视图可以通过display snmp-agent mib-view命令来查看。如果使用缺省视图限制NMS的访问权限时，除了snmpUsmMIB、snmpVacmMIB、snmpModules.18子树下的MIB对象，NMS可以访问iso子树下其它所有MIB对象。缺省视图可以通过undo snmp-agent mib-view命令删除，但是删除以后，可能导致不能对Agent的所有MIB节点执行读写操作，除非另外手工配置视图。
【举例】
# 创建并更新MIB视图信息，名字为mibtest，先创建一个包含mib-2子树（OID为“1.3.6.1”）所有对象的MIB视图，再更新为不包含“system”子树(OID为“1.3.6.1.2.1.1”)所有对象的MIB视图。
[Sysname] snmp-agent sys-info version v1
[Sysname] snmp-agent mib-view included mibtest 1.3.6.1
[Sysname] snmp-agent mib-view excluded mibtest system
[Sysname] snmp-agent community read public mib-view mibtest
以上配置成功后，当NMS使用SNMPv1版本，public团体名访问设备时，不能查询system子树的所有对象（比如sysDescr和sysObjectID等节点），可以查询mib-2子树下的其它所有对象。
【相关命令】
· display snmp-agent mib-view
· snmp-agent group
snmp-agent packet max-size命令用来设置Agent能接收或发送的SNMP报文的最大长度。
undo snmp-agent packet max-size命令用来恢复缺省情况。
【命令】
snmp-agent packet max-size byte-count
undo snmp-agent packet max-size
【缺省情况】
Agent能处理的SNMP报文的最大长度为1500。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
byte-count：Agent能接收/发送的SNMP报文的最大长度，取值范围为484～17940，单位为字节。
【使用指导】
设置报文的最大长度是为了防止网络中存在不支持分片的主机，而导致超长数据被丢弃。通常情况下，使用缺省值即可。
【举例】
# 设置Agent能接收/发送的SNMP报文的最大长度为1024字节。
<Sysname> system-view
[Sysname] snmp-agent packet max-size 1024
snmp-agent port命令用来指定设备上接收SNMP报文的本地端口号。
undo snmp-agent port命令用来恢复缺省情况。
【命令】
snmp-agent port port-num
undo snmp-agent port
【缺省情况】
使用161作为本地端口号接收SNMP报文。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
port-num：设备上接收SNMP报文的本地端口号。取值范围为1～65535，缺省值为161。
【使用指导】
用户配置成功后，使用新端口重新连接设备后，可以进行Get/Set等操作，此时使用display current-configurantion命令查看SNMP相关配置，此项配置可以显示。
【举例】
# 指定新的端口号。
<Sysname> system-view
[Sysname] snmp-agent port 5555
# 恢复默认端口号。
<Sysname> system-view
[Sysname] undo snmp-agent port
snmp-agent remote命令用来配置远端SNMP实体的引擎。
undo snmp-agent remote命令用来取消已配置的远端SNMP实体的引擎。
【命令】
snmp-agent remote { ip-address | ipv6 ipv6-address } [ vpn-instance vpn-instance-name ] engineid engineid
undo snmp-agent remote ip-address
【缺省情况】
设备上没有配置远端SNMP实体的引擎。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
ip-address：远端SNMP实体的IP地址。
ipv6 ipv6-address：远端SNMP实体的IPv6地址。
vpn-instance vpn-instance-name：指定远端SNMP实体所属的VPN。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则表示远端SNMP实体位于公网中。
engineid：引擎ID，必须为偶数个十六进制数，偶数的取值范围为10～64。全0和全F均被认为是无效参数。
【使用指导】
当设备需要向NMS发送SNMPv3 Inform报文时，必须配置该命令，并将ip-address配置为NMS的IP地址，engineid配置为NMS的引擎ID。因为协议要求SNMPv3 Inform报文中必须携带一个权威引擎ID，NMS收到该报文后，会用自己的引擎ID和这个权威引擎ID比较，如果相同，才能接收。
用户最多可以配置20个远端SNMP实体引擎ID。
【举例】
# 配置IP地址为10.1.1.1的SNMP实体的引擎为123456789A。
<Sysname> system-view
[Sysname] snmp-agent remote 10.1.1.1 engineid 123456789A
【相关命令】
· display snmp-agent remote
snmp-agent source命令用来指定告警信息中的源IP地址。
undo snmp-agent source命令用来恢复缺省情况。
【命令】
snmp-agent { inform | trap } source interface-type interface-number
undo snmp-agent { inform | trap } source
【缺省情况】
由SNMP选择路由出接口的IP地址作为告警信息源IP地址。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
inform：用来指定Inform报文中的源IP地址。
trap：用来指定Trap报文中的源IP地址。
interface-type interface-number：指定三层接口类型与接口编号。
【使用指导】
执行该命令后，系统会使用指定接口的主IP地址作为发送出去的告警信息的源IP地址。这样，在NMS上就可以使用该IP地址唯一标志Agent。即便Agent使用不同的出接口发送告警信息，NMS都可以使用该IP地址来过滤Agent发送的所有告警信息。
在将某个接口设置为获取告警信息的源地址接口之前需要注意的是：
· 如果配置的接口已存在，并且配置了合法的IP地址，则该IP地址将作为告警信息的源地址；
· 如果配置的接口不存在，则该命令会配置失败；
· 如果配置的接口已存在，但没有配置合法的IP地址，则该命令不生效，在接口配置了合法IP地址后，该命令会自动生效。
【举例】
# 配置Trap报文的源地址为以太网接口Ten-GigabitEthernet1/0/1上的接口主IP地址。
<Sysname> system-view
[Sysname] snmp-agent trap source ten-gigabitethernet 1/0/1
# 配置Inform报文的源地址为以太网接口Ten-GigabitEthernet1/0/2上的接口主IP地址。
<Sysname> system-view
[Sysname] snmp-agent inform source ten-gigabitethernet 1/0/2
【相关命令】
· snmp-agent trap enable
· snmp-agent target-host
snmp-agent sys-info contact命令用来配置设备的维护联系信息。
undo snmp-agent sys-info contact命令用来恢复缺省情况。
【命令】
snmp-agent sys-info contact sys-contact
undo snmp-agent sys-info contact
【缺省情况】
设备的维护联系信息为Hangzhou H3C Tech. Co., Ltd。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
sys-contact：描述系统维护联系信息，为1～255个字符的字符串。
【使用指导】
如果设备发生故障，设备维护人员可以利用系统维护联系信息，及时与设备生产厂商取得联系。
【举例】
# 配置设备的维护联系信息为Dial System Operator # 27345。
<Sysname> system-view
[Sysname] snmp-agent sys-info contact Dial System Operator # 27345
【相关命令】
· display snmp-agent sys-info
snmp-agent sys-info location命令用来配置设备的物理位置信息。
undo snmp-agent sys-info location命令用来恢复缺省情况。
【命令】
snmp-agent sys-info location sys-location
undo snmp-agent sys-info location
【缺省情况】
物理位置信息为Hangzhou, China。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
sys-location：设备的物理位置信息，为1～255个字符的字符串。
【使用指导】
为便于识别和管理设备，请使用该命令将设备所处的物理位置记录在设备中。
【举例】
# 配置设备的物理位置信息为Room524-row1-3。
<Sysname> system-view
[Sysname] snmp-agent sys-info location Room524-row1-3
【相关命令】
· display snmp-agent sys-info
snmp-agent sys-info version命令用来设置系统启用的SNMP版本号。
undo snmp-agent sys-info version命令用来禁止使用指定版本的SNMP功能。
【命令】
非FIPS模式下：
snmp-agent sys-info version { all | { v1 | v2c | v3 } * }
undo snmp-agent sys-info version { all | { v1 | v2c | v3 } * }
FIPS模式下：
snmp-agent sys-info version v3
undo snmp-agent sys-info version v3
【缺省情况】
启用SNMPv3版本。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
all：启用SNMPv1、SNMPv2c和SNMPv3版本。
v1：启用SNMPv1版本。
v2c：启用SNMPv2c版本。
v3：启用SNMPv3版本。
【使用指导】
FIPS模式下，不支持设置SNMPv1和SNMPv2c版本。
启用指定的SNMP版本后，设备才能收发该版本的SNMP报文。只有NMS和Agent使用的SNMP版本相同，NMS才能和Agent建立连接。
【举例】
# 启用SNMPv3版本。
<Sysname> system-view
[Sysname] snmp-agent sys-info version v3
【相关命令】
· display snmp-agent sys-info
snmp-agent target-host命令用来设置接收SNMP告警信息的目的主机（能够解析Trap和Inform报文的设备，通常为NMS）的属性。
undo snmp-agent target-host命令用来取消当前设置。
【命令】
非FIPS模式下：
snmp-agent target-host inform address udp-domain { target-host | ipv6 target-host } [ udp-port port-number ] [ vpn-instance vpn-instance-name ] params securityname security-string { v2c | v3 [ authentication | privacy ] }
snmp-agent target-host trap address udp-domain { target-host | ipv6 target-host } [ udp-port port-number ] [ vpn-instance vpn-instance-name ] params securityname security-string [ v1 | v2c | v3 [ authentication | privacy ] ]
undo snmp-agent target-host { trap | inform } address udp-domain { target-host | ipv6 target-host } params securityname security-string [ vpn-instance vpn-instance-name ]
FIPS模式下：
snmp-agent target-host inform address udp-domain { target-host | ipv6 target-host } [ udp-port port-number ] [ vpn-instance vpn-instance-name ] params securityname security-string v3 { authentication | privacy }
snmp-agent target-host trap address udp-domain { target-host | ipv6 target-host } [ udp-port port-number ] [ vpn-instance vpn-instance-name ] params securityname security-string v3 { authentication | privacy }
undo snmp-agent target-host { trap | inform } address udp-domain { target-host | ipv6 target-host } params securityname security-string [ vpn-instance vpn-instance-name ]
【缺省情况】
设备上没有设置告警主机。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
inform：配置接收Inform报文的目的主机的参数。
trap：配置接收Trap报文的目的主机的参数。
address：指定设备发出的SNMP信息中的目的地址。
udp-domain：指定使用UDP协议来传输SNMP告警信息。
target-host：接收告警信息的目的主机的IPv4地址或主机名，主机名为1～253个字符的字符串，不区分大小写，字符串仅可包含字母、数字、“-”、“_”或“.”。若使用主机名配置，将获取主机名对应的IPv4地址，向对应的主机发送告警信息。
ipv6 target-host：接收告警信息的目的主机的IPv6地址或主机名，主机名为1～253个字符的字符串，不区分大小写，字符串仅可包含字母、数字、“-”、“_”或“.”。若使用主机名配置，发送时将获取主机名对应的IPv6地址，向对应的主机发送告警信息。
udp-port port-number：指定目的主机上用来接收告警信息的端口号，缺省值为162。
vpn-instance vpn-instance-name：指定目的主机所属的VPN。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则表示目的主机位于公网中。
params securityname security-string：指定认证的参数，security-string为SNMPv1、SNMPv2c的团体名或SNMPv3的用户名，为1～32个字符的字符串。
v1：SNMPv1版本。
v2c：SNMPv2c版本。
v3：SNMPv3版本。
· authentication：指明对报文进行认证但不加密。认证功能用来验证报文的完整性或报文是否被篡改等，认证密码在创建SNMPv3用户时配置。
· privacy：指明对报文进行认证和加密。加密是对报文的数据部分进行加密处理以防信息被窃取，认证密码和加密密码在创建SNMPv3用户时配置。
【使用指导】
根据实际组网需要，用户可以多次使用该命令配置不同的目的主机的属性，使得设备可以向多个NMS发送告警信息。
· 不指定udp-port port-number参数时，使用的端口号为162。162是SNMP协议规定的NMS接收告警信息的端口，通常情况下（比如使用iMC或者MIB Browser作为NMS时），使用该缺省值即可。如果要将该参数修改为其它值，则必须和NMS上的配置保持一致。
· 不指定v1、v2c、v3版本参数时，使用的版本是v1。设备配置的SNMP版本必须和NMS上运行的SNMP版本一致，否则，NMS将收不到告警信息。
· 不指定authentication和privacy参数时，使用的是不认证不加密的安全级别。
【举例】
# 允许向10.1.1.1发送SNMPv3 Trap报文，用户名为public。
<Sysname> system-view
[Sysname] snmp-agent trap enable standard
[Sysname] snmp-agent target-host trap address udp-domain 10.1.1.1 params securityname public v3
【相关命令】
· snmp-agent source
· snmp-agent trap enable
· snmp-agent trap life
snmp-agent trap enable命令用来在全局下开启告警功能。
undo snmp-agent trap enable命令用来在全局下关闭告警功能。
【命令】
snmp-agent trap enable [ protocol | standard [ authentication | coldstart | linkdown | linkup | warmstart ] * | system ]
undo snmp-agent trap enable [ protocol | standard [ authentication | coldstart | linkdown | linkup | warmstart ] * | system ]
【缺省情况】
SNMP标准告警和系统告警功能处于开启状态，其他各模块告警功能是否开启请参见各模块手册。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
protocol：开启指定协议模块的SNMP告警功能。有关此参数的详细介绍，请参见各模块的命令手册。
standard：SNMP标准告警信息。包括以下五种：
· authentication：NMS访问设备时认证失败，输出SNMP认证失败的告警信息。
· coldstart：当设备重新启动时，输出设备冷启动告警信息。
· linkdown：当接口的链路down时，输出linkDown告警信息。
· linkup：当接口的链路up时，输出linkUp告警信息。
· warmstart：当SNMP模块重新启动时，输出热启动告警信息。
system：配置该参数后，如果系统时间被修改、系统重启或系统主用启动软件包不可用，均会生成告警信息。
【使用指导】
开启告警功能，设备就可以向目的主机发送告警信息。具体是发送Inform报文还是Trap报文，以及发往哪个目的主机，请通过snmp-agent target-host命令来配置。
不指定可选参数时，表示在全局下开启/关闭所有可选模块的告警功能。
【举例】
# 允许发送SNMP认证失败的告警信息，使用团体名public，向IP地址为10.1.1.1的目的主机发送Trap报文。
<Sysname> system-view
[Sysname] snmp-agent target-host trap address udp-domain 10.1.1.1 params securityname public
[Sysname] snmp-agent trap enable standard authentication
【相关命令】
· snmp-agent target-host
snmp-agent trap if-mib link extended命令用来对标准格式的linkUp或linkDown告警信息进行私有扩展。
undo snmp-agent trap if-mib link extended命令用来恢复缺省情况。
【命令】
snmp-agent trap if-mib link extended
undo snmp-agent trap if-mib link extended
【缺省情况】
系统发送的linkUp/linkDown告警信息的格式为标准格式，不对其进行私有扩展。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【使用指导】
扩展格式的linkUp/linkDown告警信息由标准格式的linkUp/linkDown告警信息后增加接口描述和接口类型信息构成，使用扩展格式的告警信息有助于网络管理员快速定位问题。
需要注意的是，配置该命令后，设备发送的linkUp/linkDown告警信息为扩展格式的信息。如果NMS不支持扩展格式，可能会无法解析信息。
【举例】
# 对标准格式的linkUp/linkDown告警信息进行私有扩展。
<Sysname> system-view
[Sysname] snmp-agent trap if-mib link extended
snmp-agent trap log命令用来开启SNMP告警日志功能。
undo snmp-agent trap log命令用来关闭SNMP告警日志功能。
【命令】
snmp-agent trap log
undo snmp-agent trap log
【缺省情况】
SNMP告警日志功能处于关闭状态。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【使用指导】
打开SNMP告警日志开关，Agent向NMS发送告警时，Agent会记录该告警相关的信息并保存到设备的信息中心。通过设置信息中心的参数，最终决定SNMP告警日志的输出规则（即是否允许输出以及输出方向）。
【举例】
# 打开SNMP告警日志开关。
<Sysname> system-view
[Sysname] snmp-agent trap log
snmp-agent trap life命令用来设置告警信息的保存时间，超过该时间的告警信息都将被丢弃。
undo snmp-agent trap life命令用来恢复缺省情况。
【命令】
snmp-agent trap life seconds
undo snmp-agent trap life
【缺省情况】
SNMP告警信息的保存时间为120秒。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
seconds：超时时间，取值范围为1～2592000，单位为秒。
【使用指导】
SNMP模块使用队列来发送告警信息，告警信息进入消息发送队列时会启动一个存活定时器。如果直到定时器超时（即达到snmp-agent trap life命令设置的时间），告警信息还没有被发送出去，系统就会将该告警信息从发送队列中删除。
【举例】
# 设置告警信息的保存时间为60秒。
<Sysname> system-view
[Sysname] snmp-agent trap life 60
【相关命令】
· snmp-agent trap enable
· snmp-agent target-host
· snmp-agent trap queue-size
snmp-agent trap queue-size命令用来设置告警信息发送队列的长度。
undo snmp-agent trap queue-size命令用来恢复缺省情况。
【命令】
snmp-agent trap queue-size size
undo snmp-agent trap queue-size
【缺省情况】
告警信息的发送队列最多可以存储100条告警信息。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
size：消息队列中可以存储的告警信息的数目，取值范围1～1000。
【使用指导】
告警信息产生后，会进入告警信息消息队列进行发送，告警信息消息队列的长度决定了队列最多可以存储的告警信息的数目。当告警信息队列达到设定长度后，最新生成的告警信息会进入消息队列，最早产生的告警信息被丢弃。
【举例】
# 设置发送告警信息的消息队列最多可以存储200条告警信息。
<Sysname> system-view
[Sysname] snmp-agent trap queue-size 200
【相关命令】
· snmp-agent trap enable
· snmp-agent target-host
· snmp-agent trap life
snmp-agent usm-user { v1 | v2c }命令用来为SNMP组添加新用户。
undo snmp-agent usm-user { v1 | v2c }命令用来删除SNMP组的用户。
【命令】
snmp-agent usm-user { v1 | v2c } user-name group-name [ acl acl-number | acl ipv6 ipv6-acl-number ] *
undo snmp-agent usm-user { v1 | v2c } user-name group-name
【缺省情况】
设备上没有配置SNMP用户。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
v1：表示配置的用户名适用于SNMPv1组网环境。
v2c：表示配置的用户名适用于SNMPv2c组网环境。
user-name：用户名，为1～32个字符的字符串，区分大小写。
group-name：该用户对应的组名，为1～32个字符的字符串，区分大小写。
acl acl-number：将用户与基本ACL绑定，acl-number表示访问列表号，取值范围为2000～2999。当未引用ACL、或者引用的ACL不存在时，允许所有NMS访问设备；当引用的ACL为空时，会禁止所有的NMS访问设备；当引用的ACL非空时，则只有ACL中permit的NMS才能访问设备，其它NMS不允许访问设备，以免非法NMS访问设备。
acl ipv6 ipv6-acl-number：将用户与基本IPv6 ACL绑定，ipv6-acl-number表示访问列表号，取值范围为2000～2999。当未引用IPv6 ACL或者引用的IPv6 ACL不存在时，允许所有NMS访问设备；当引用的IPv6 ACL为空时，会禁止NMS访问设备；当引用的IPv6 ACL非空时，则只有IPv6 ACL中permit的NMS才能访问设备，其它NMS不允许访问设备，以免非法NMS访问设备。
【使用指导】
FIPS模式下，不支持本命令。
SNMPv1和SNMPv2c组网应用中NMS和Agent之间使用团体名来认证，SNMPv3组网应用中使用用户名来认证。
设备支持配置SNMPv1和SNMPv2c用户以供习惯用户名配置方式的用户。创建一个SNMPv1或SNMPv2c用户相当于添加一个新的团体名，其读写属性依赖于用户所在组的读、写、通知视图配置。
要使配置的用户生效，必须先创建SNMP组。
【举例】
# 在SNMP组readCom里创建SNMPv2c用户userv2c。
<Sysname> system-view
[Sysname] snmp-agent sys-info version v2c
[Sysname] snmp-agent group v2c readCom
[Sysname] snmp-agent usm-user v2c userv2c readCom
如果NMS需要访问Agent，则应将NMS的版本号指定为SNMPv2c，Read community选项填写为userv2c。
# 在SNMP组readCom里创建SNMPv2c用户userv2c，并且只允许IP地址为1.1.1.1的NMS使用该用户名访问Agent，禁止其它NMS使用该用户名访问。
<Sysname> system-view
[Sysname] acl number 2001
[Sysname-acl-basic-2001] rule permit source 1.1.1.1 0.0.0.0
[Sysname-acl-basic-2001] rule deny source any
[Sysname-acl-basic-2001] quit
[Sysname] snmp-agent sys-info version v2c
[Sysname] snmp-agent group v2c readCom
[Sysname] snmp-agent usm-user v2c userv2c readCom acl 2001
此时在IP地址为1.1.1.1，版本号指定为SNMPv2c，Read community的NMS上，将SNMP协议版本号指定为SNMPv2c，Read community和Write community选项均填写为userv2c，就可以访问Agent了。
【相关命令】
· snmp-agent group
· snmp-agent community
· dispaly snmp-agent community
snmp-agent usm-user v3命令用来创建SNMPv3用户。
undo snmp-agent usm-user v3命令用来删除SNMPv3用户。
【命令】
非FIPS模式下：
· VACM方式：
snmp-agent usm-user v3 user-name group-name [ remote { ip-address | ipv6 ipv6-address } [ vpn-instance vpn-instance-name ] ] [ { cipher | simple } authentication-mode { md5 | sha } auth-password [ privacy-mode { aes128 | des56 } priv-password ] ] [ acl acl-number | acl ipv6 ipv6-acl-number ] *
undo snmp-agent usm-user v3 user-name group-name { local | engineid engineid-string | remote { ip-address | ipv6 ipv6-address } [ vpn-instance vpn-instance-name ] }
· RBAC方式：
FIPS模式下：
· VACM方式：
snmp-agent usm-user v3 user-name group-name [ remote { ip-address | ipv6 ipv6-address } [ vpn-instance vpn-instance-name ] ] [ { cipher | simple } authentication-mode sha auth-password [ privacy-mode aes128 priv-password ] ] [ acl acl-number | acl ipv6 ipv6-acl-number ] *
undo snmp-agent usm-user v3 user-name group-name { local | engineid engineid-string | remote { ip-address | ipv6 ipv6-address } [ vpn-instance vpn-instance-name ] }
· RBAC方式：
【缺省情况】
设备上没有配置SNMPv3用户。
【视图】
系统视图
【缺省用户角色】
network-admin
mdc-admin
【参数】
user-name：用户名，为1～32个字符的字符串，区分大小写。
group-name：该用户对应的组名，为1～32个字符的字符串，区分大小写。
user-role role-name：该用户对应的角色名称，role-name为1~63个字符的字符串，区分大小写。
remote { ip-address | ipv6 ipv6-address }：接收Inform信息的目的主机的IP地址或者IPv6地址，通常为NMS的IP地址或者IPv6地址。当设备需要向目的主机发送SNMPv3 Inform报文时，该参数必须配置，还需要使用snmp-agent remote命令将目的主机的IP地址或者IPv6地址和引擎ID绑定。
vpn-instance vpn-instance-name：目的主机所属的VPN。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则表示目的主机位于公网中。
cipher：以密文方式设置认证密码和加密密码。当使用16进制字符作为密文密码时可以使用snmp-agent calculate-password命令来计算获得。
simple：以明文方式设置认证密码和加密密码。
authentication-mode：指明安全模式为需要认证。MD5算法的计算速度比SHA算法快，而SHA算法的安全强度比MD5算法高。
· md5：指定认证协议为MD5。
· sha：指定认证协议为SHA-1。
auth-password：设置认证密码，区分大小写，具体如下。
· 采用明文设置认证密码时：非FIPS模式下，认证密码的长度范围是1～64个字符，FIPS模式下，认证密码的长度范围是15～64字符，密码元素的最少组合类型为4（必须包括数字、大写字母、小写字母以及特殊字符）。
· 采用密文设置认证密码时：对密文加密密码的要求请参见表1-13。
|
认证算法 |
16进制格式的认证密码长度 |
非16进制格式的认证密码长度 |
|
md5 |
32 |
53 |
|
sha |
40 |
57 |
privacy-mode：表示安全模式为需要加密。加密算法的安全性由高到低依次是：AES、3DES、DES，安全性高的加密算法实现机制复杂，运算速度慢。
· aes128：指定加密协议为AES（Advanced Encryption Standard，高级加密标准）。
· 3des：指定加密协议为3DES（Triple Data Encryption Standard，三重数据加密标准）。
· des56：指定加密协议为DES（Data Encryption Standard，数据加密标准）。
priv-password：设置的明文加密密码或密文加密密码，区分大小写。明文加密密码的长度范围是1～64；如果选择密文方式，对密文加密密码的要求请参见表1-14。
|
认证算法 |
加密算法 |
16进制格式的认证密码长度 |
非16进制格式的认证密码长度 |
|
md5 |
aes128或des56 |
32 |
53 |
|
sha |
aes128或des56 |
40 |
53 |
acl acl-number：将用户与基本ACL绑定，acl-number表示访问列表号，取值范围为2000～2999。当未引用ACL或者引用的ACL不存在时，允许所有NMS访问设备；当引用的ACL为空时，会禁止所有的NMS访问设备；当引用的ACL非空时，则只有ACL中permit的NMS才能访问设备，其它NMS不允许访问设备，以免非法NMS访问设备。
acl ipv6 ipv6-acl-number：将用户与基本IPv6 ACL绑定，ipv6-acl-number表示访问列表号，取值范围为2000～2999。当未引用IPv6 ACL或者引用的IPv6 ACL不存在时，允许所有NMS访问设备；当引用的IPv6 ACL为空时，会禁止NMS访问设备；当引用的IPv6 ACL非空时，则只有IPv6 ACL中permit的NMS才能访问设备，其它NMS不允许访问设备，以免非法NMS访问设备。
local：表示本地实体引擎。
engineid engineid-string：指定与该用户相关联的引擎ID字符串，必须为偶数个十六进制数，十六进制数的个数为10～64。全0和全F均被认为是无效参数。由于SNMPv3版本的用户名、密文密码等都和引擎ID相关联，如果更改了引擎ID，则原引擎ID下配置的用户名、密码失效，更改后可以使用该参数将engineid-string指定为创建该用户时的本地引擎ID。
【使用指导】
该命令配置的用户名适用于SNMPv3组网环境。
SNMPv3用户与SNMP实体引擎相关联，缺省情况下，创建的SNMPv3用户与本地SNMP实体引擎相关联。使用remote ip-address参数创建与远端SNMP实体引擎关联的SNMP用户。
创建SNMPv3用户时，可以通过两种配置方式来控制用户访问的权限：
· 通过VACM方式配置的SNMP用户依附于SNMP组，创建用户前，请先创建组。否则，用户能够创建成功但是不生效。一个组可以包含多个用户。组定义了用户能够访问的SNMP对象（通过MIB视图来限定）以及是否进行认证和加密等，而认证和加密的具体算法和密码则是在创建用户时定义。
· 通过RBAC方式配置的SNMP用户依附于用户角色，创建用户时，通过user-role role-name参数配置用户的角色。用户角色定义了SNMP用户能够访问的SNMP对象以及操作类型（通过rule规则来限定）。使用RBAC方式创建SNMP v3用户后，还可以使用snmp-agent usm-user v3 user-role命令为该用户绑定更多的用户角色，最多可绑定64个用户角色。
需要注意的是：
· 同时通过VACM和RBAC方式配置SNMP用户时，当用户名相同，新配置会覆盖旧配置，以最后一次配置为准。
· 通过RBAC方式配置SNMP用户时，可以多次使用本命令为已创建的SNMPv3用户添加角色，若未配置其他参数，则其他配置不变，只添加角色；若同时配置其他参数（如认证方式），则为用户添加角色，同时修改其他配置。
· 以明文或密文方式设置的密码，均以密文方式保存在配置文件中。
· NMS在访问设备时，必须输入明文密码，因此在创建用户时请牢记用户名以及对应的明文密码。
· RBAC配置方式要求NMS在访问Agent时，不仅需要授予NMS对MIB节点的访问权限，还要求团体名/用户名所绑定的用户角色具有执行相应操作的权限，而VACM方式只需通过控制MIB节点的访问权限即可，所以推荐使用RBAC配置方式，安全性更高。
【举例】
# 为v3组testGroup加入一个用户testUser，安全级别为只认证不加密，认证协议为SHA-1，认证密码明文为123456TESTplat&!。
<Sysname> system-view
[Sysname] snmp-agent group v3 testGroup authentication
[Sysname] snmp-agent usm-user v3 testUser testGroup simple authentication-mode sha 123456TESTplat&!
在NMS上将版本号设置为SNMPv3，并将用户名填写为testUser，认证协议设置为SHA-1，认证密码填写为123456TESTplat&!，建立连接，就可以对设备上缺省视图内的MIB对象进行访问了。
# 为v3组testGroup加入一个用户testUser，安全级别为认证和加密，认证协议为SHA-1、加密协议为AES，认证密码明文为123456TESTauth&!，加密密码明文为123456TESTencr&!。
<Sysname> system-view
[Sysname] snmp-agent group v3 testGroup privacy
[Sysname] snmp-agent usm-user v3 testUser testGroup simple authentication-mode sha 123456TESTauth&! privacy-mode aes128 123456TESTencr&!
在NMS上将版本号设置为SNMPv3，并将用户名填写为testUser，认证协议设置为SHA-1，认证密码填写为123456TESTauth&!，加密协议设置为AES，加密密码填写为123456TESTencr&!，建立连接，就可以对设备上缺省视图内的MIB对象进行访问了。
# 为v3组testGroup加入一个与IP为10.1.1.1的远端SNMP实体引擎相关联的SNMPv3用户remoteUser，安全级别为认证和加密，认证协议为SHA-1、加密协议为AES，认证密码明文为123456TESTauth&!，加密密码明文为123456TESTencr&!。
<Sysname> system-view
[Sysname] snmp-agent remote 10.1.1.1 engineid 123456789A
[Sysname] snmp-agent group v3 testGroup privacy
[Sysname] snmp-agent usm-user v3 remoteUser testGroup remote 10.1.1.1 simple authentication-mode sha 123456TESTauth&! privacy-mode aes128 123456TESTencr&!
RBAC方式：
# 创建一个新的SNMPv3用户testUser，角色为network-operator，安全级别为只认证不加密，认证协议为SHA-1，认证密码明文为123456TESTplat&!。
[Sysname] snmp-agent usm-user v3 testUser user-role network-operator simple authentication-mode sha 123456TESTplat&!
在NMS上将版本号设置为SNMPv3，并将用户名填写为testUser，认证协议设置为SHA-1，认证密码填写为123456TESTplat&!，建立连接，就可以对设备上所有MIB对象进行只读操作。
【相关命令】
· display snmp-agent usm-user
· snmp-agent group
· snmp-agent usm-user { v1 | v2c }
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!
支持
售前咨询
售后咨询
人工在线咨询
