snmp-agent target-host trap ipv6

Function

The snmp-agent target-host trap ipv6 command configures a target host to receive SNMP trap messages.

The undo snmp-agent target-host ipv6 command deletes the configuration of a target host to receive SNMP trap messages.

By default, the target host that receives SNMP trap messages is not set.

Format

snmp-agent target-host trap ipv6 address udp-domain ipv6-address [ udp-port port-number | vpn-instance vpn-instance-name ] ^* params securityname cipher security-name [ [ v1 | v2c ] | private-netmanager | notify-filter-profile profile-name | ext-vb ] ^*

undo snmp-agent target-host ipv6 ipv6-address securityname { security-name | cipher security-name } [ vpn-instance vpn-instance-name ]

undo snmp-agent target-host trap ipv6 address udp-domain ipv6-address [ udp-port port-number | vpn-instance vpn-instance-name ] ^* params securityname { security-name | cipher security-name }

Parameters

Parameter	Description	Value
ipv6 address	Sets the IPv6 address of the target host used to receive SNMP trap messages.	-
udp-domain	Indicates that trap messages are sent to the target host through the User Datagram Protocol (UDP).	-
ipv6-address	Specifies the IPv6 address of the target host.	-
udp-port port-number	Specifies the port number used to receive trap messages.	The value is an integer that ranges from 0 to 65535. The default value is 162.
vpn-instance vpn-instance-name	Specifies a VPN instance name. If the vpn-instance vpn-instance-name parameter is not specified, the system accesses the target host on the public network. The device cannot send traps to a target host on the VPN interface specified by the set net-manager vpn-instance command.	The vpn-instance parameter is optional. If vpn-instance is configured, the VPN instance specified by vpn-instance vpn-instance-name, IP address, and security name specified by securityname security-string form a 3-tuple to identify a host on a VPN.
params securityname security-name	Specifies the SNMP security name that is displayed as the user name on the NMS. For SNMPv3, securityname must be configured as the user name. securityname configured on the host needs to be the same as that configured on the NMS, or the NMS cannot receive the trap messages sent from the host. For SNMPv1 and SNMPv2c, the NMS can receive trap messages from all hosts without having securityname configured. securityname is used to distinguish multiple hosts that generate trap messages.	The value is a string of 1 to 32 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
cipher security-name	Indicates the unencrypted or encrypted string of security name.	The value is a string of 1 to 32 case-sensitive characters or a string of 32, 48, 56, or 68 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string. When the community name is a string of 1 to 32 characters, the string is processed as plain text by default and will be encrypted. When the community name is a string of 32 48, 56, or 68 characters, the string is processed as cipher text by default, and the system will determine whether the string can be parsed.
v1 \| v2c \| v3	Specifies the SNMP version. v1: indicates SNMPv1. v2c: indicates SNMPv2c. v3: indicates SNMPv3. If no SNMP version is specified, SNMPv1 is used by default.	-
authentication \| privacy	Specifies the security mode for SNMP trap messages. authentication: indicates that the SNMP trap messages are authenticated but not encrypted. privacy: indicates that SNMP trap messages are authenticated and encrypted.	-
private-netmanager	Indicates that the target host is a Huawei NMS. Specify this parameter when a Huawei NMS is used. This parameter enables trap messages sent to the NMS to contain more information, including types, sequence numbers, and transmission time of trap messages.	-
notify-filter-profile profile-name	Specifies the name of a trap filter profile.	The value is a string of 1 to 32 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.
ext-vb	Indicates that trap messages sent to a target host carry extended bound variables. If alarm objects defined in public MIBs are extended on a Huawei data communication device, you can use ext-vb to determine whether the trap messages sent to the NMS carry extended bound variables. If ext-vb is not specified, trap messages sent from the device do not carry extended bound variables. When a third-party NMS is used, you are advised not to specify the ext-vb parameter so that the third-party NMS can receive trap messages from Huawei data communication devices. By default, trap messages sent from a Huawei data communication device do not carry extended bound variables. If ext-vb is specified, trap messages sent from the device carry extended bound variables. This parameter is recommended when a Huawei NMS is used so that more information can be transmitted in trap messages.	-

Views

System view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

This command is used to configure an IPv6 NMS host so that traps can be sent to the host using the IPv6 protocol.

Precautions

Ensure that the security level of a trap host is not higher than that of the user specified by securityname and not lower than that of the user group. Otherwise, the trap host cannot send trap messages properly. The user security level can be (in descending order):

Level 1: privacy (authentication and encryption)
Level 2: authentication (without encryption)
Level 3: noauthentication (no authentication or encryption)

For SNMPv1 and SNMPv2c, when a user with a level lower than the level configured using this command queries the securityname configured using the display this command, the securityname is displayed as asterisks (******).

Example

# Configure an IPv6 NMS host that uses SNMP v3. Set the security name to Huawei and configure traps to be authenticated and encrypted.

<HUAWEI> system-view
[HUAWEI] snmp-agent trap enable
Warning: All switches of SNMP trap/notification will be open. Continue? [Y/N]:y
[HUAWEI] snmp-agent target-host trap ipv6 address udp-domain FC00::1 params securityname Huawei v3 privacy