snmp-agent target-host trap ipv6

Function

The snmp-agent target-host trap ipv6 command sets the destination that receives the SNMP notification.

The undo snmp-agent target-host ipv6 command removes the host that receives the SNMP messages.

Format

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

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

undo snmp-agent target-host ipv6 ipv6-address securityname [ cipher ] security-string [ 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-string | cipher security-string }

Parameters

Parameter	Description	Value
address	Specifies the address of the destination host that receives the SNMP message.	-
udp-domain	Specifies that packets are sent to the destination host over UDP.	-
ipv6-address	Specifies the IP address of the host.	-
udp-port port-number	Specifies the number of the port that receives the trap packet.	The value is in the range of 0 to 65535. By default, it is 162.
params	Specifies the information about the login host that generates SNMP messages.	-
securityname security-string	Specifies the community name of SNMPv2C or the user name of SNMPv3. 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 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 simple text characters or 48 or 68 ciphertext characters, spaces not supported. A string of 32 or 56 ciphertext characters are also supported. NOTE: When double quotation marks are used around the string, spaces are allowed in the string.
v1 \| v2c \| v3	Specifies the version of trap packets.	By default, it is v1.
authentication	Authenticates but not encrypts the packet.	-
privacy	Authenticates and encrypts the packet.	-
private-netmanager	Specifies Huawei NMS as the target host receiving a trap message. When a Huawei NMS is deployed and this parameter is configured, a trap message sent to the NMS contains more information, such as the trap type, sequence of the trap, and sending time.	-
notify-filter-profile profile-name	Specifies the filter profile name.	It is a string of 1 to 32 characters without spaces.
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 corresponding trap messages sent from the device to an NMS carry extended bound variables. If ext-vb is not specified, the trap message does not carry extended bound variables. This parameter is not recommended when the NMS is a third-party NMS. This ensures that the third-party NMS can receive trap messages from Huawei data communication devices. By default, a trap message sent from a Huawei data communication device does not carry extended bound variables. If ext-vb is specified, the trap message carries extended bound variables. This parameter is recommended when the NMS is a Huawei NMS. This allows more abundant information in trap messages.	-
cipher	Specifies the user name is in cipher.	-

Views

System view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

On an IPv6 network, to help the NMS manage devices efficiently, you can use the snmp-agent target-host trap ipv6 command to set the destination IP address of a trap message and to filter trap messages. The snmp-agent target-host trap ipv6 command configures trap messages to be sent based on the IPv6 protocol.

Precautions

Sending trap messages based on the IPv6 protocol is not supported.

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

Example

# Configure an IPv6 NM which is based on SNMP v3 protocol, named Huawei, and encrypted in authentication and encryption mode.

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