snmp-agent inform address

Function

The snmp-agent inform address command sets parameters for sending informs, including the timeout period for waiting for inform ACK messages from the NMS and times to retransmit an inform.

The undo snmp-agent inform address command restores the default setting for a particular inform host.

By default, the timeout waiting period for inform ACK messages is 15 seconds and the number of times to retransmit informs is 3.

Format

snmp-agent inform { timeout seconds | resend-times times } ^* address udp-domain ip-address [ vpn-instance vpn-instance-name ] params securityname { security-name | cipher security-name }

undo snmp-agent inform { timeout [ seconds ] | resend-times [ times ] } ^* address udp-domain ip-address [ vpn-instance vpn-instance-name ] params securityname { security-name | cipher security-name }

Parameters

Parameter	Description	Value
timeout seconds	Specifies the timeout period for waiting for inform ACK messages from the NMS.	The value is an integer ranging from 1 to 1800, in seconds. The default value is 15, which is equal to the global timeout period configured using the snmp-agent inform command.
resend-times times	Specifies the number of times that informs are retransmitted when no inform ACK message is returned from the NMS.	The value is an integer ranging from 0 to 10. The default value is 3, which is equal to the global retransmission times configured using the snmp-agent inform command.
address	Indicates the address of the target host for receiving SNMP traps. NOTE: The IP address specified by address and the security name specified by securityname together identify a host.	The value is dotted decimal notation.
udp-domain ip-address	Specifies the IP address of a specified target host, with the transmission domain based on UDP.	The value is dotted decimal notation.
vpn-instance vpn-instance-name	Specifies the name of a VPN instance.	The value must be an existing VPN instance name. The parameter vpn-instance is optional. On a VPN network, you need to use the VPN instance specified by vpn-instance, IP address, and security name to identify a target host.
params	Indicates information about the target host that generates SNMP notifications.	-
securityname security-name	Displays the name of the target host for receiving informs 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 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.

Views

System view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

You can use both the snmp-agent inform address command and the snmp-agent inform command to set parameters according to the network condition.

When a large number of Inform messages are dropped on the network, you are recommended to run the snmp-agent inform pending number command to lengthen the trap queue and then the snmp-agent inform address command to specify the destination IP address and name of the target host.
When the transmission speed on the network is low, you are recommended to increase the timeout period. Increasing the timeout period will surely increase the waiting time of informs in the trap queue for confirmation. In this case, you are also recommended to run the snmp-agent inform { timeout seconds | pending number } ^* command to lengthen the trap queue and then the snmp-agent inform address command to specify the destination address and the displayed user name.
When the transmission speed on the network is high, you are recommended to run the snmp-agent inform timeout seconds address udp-domain ip-address params securityname security-name command to reduce the timeout period.
When informs are transmitted on an unreliable network, you are recommended to increase the retransmission times. In this case, the informs in the trap queue need to wait for a longer time to be confirmed. This requires you to run the snmp-agent inform { resend-times times | pending number } ^* command to lengthen the trap queue and then the snmp-agent inform address command to specify the destination address and the displayed user name.

Prerequisites

Parameters for sending informs take effect only after the IP address of the target host for receiving informs is configured using the snmp-agent target-host inform command.

Precautions

You need to configure only parameters for sending informs using the snmp-agent inform address command; you do not need to configure parameters for sending traps.
You must set the parameters timeout and resend-times according to the network condition. Otherwise, the SNMP working efficiency is greatly affected.
The priority set for the timeout and resend-times parameters using the snmp-agent inform address command is higher than that set for the timeout and resend-times parameters using the snmp-agent inform command. If both parameters in Inform mode and parameters using the snmp-agent inform address command are configured, parameters using the snmp-agent inform address command take effect for a specified destination host.
For 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

# Set the times to retransmit an inform to the target host (with the IP address of 10.1.1.1 and the security name of ABC) to 10.

<HUAWEI> system-view
[HUAWEI] snmp-agent inform resend-times 10 address udp-domain 10.1.1.1 params securityname ABC