snmp-agent inform

Function

The snmp-agent inform command sets global parameters of informs, including the timeout period for waiting for inform ACK messages, number of times to retransmit informs, and maximum number of informs to be confirmed in the inform buffer.

The undo snmp-agent inform command restores the default setting.

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

Format

snmp-agent inform { timeout seconds | resend-times times | pending number } ^*

undo snmp-agent inform { timeout | resend-times | pending } ^*

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 seconds.
resend-times times	Specifies the times to retransmit informs in the case that no inform ACK message is returned from the NMS.	The value is an integer ranging from 0 to 10. The default value is 3.
pending number	Specifies the maximum number of informs to be confirmed in the inform buffer.	The value is an integer ranging from 1 to 2048. The default value is 39.

Views

System view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

After sending an inform, the SNMP agent waits for an inform ACK message from the NMS. You can run the snmp-agent inform command to set parameters timeout, resend-times, and pending of the inform.

These three parameters mutually affect each other. For example, if the timeout period for waiting for inform ACK messages prolongs or the times to retransmit informs increase, but the maximum number of informs to be confirmed is not changed, the number of informs to be confirmed is increased, causing the inform buffer to be quickly filled up.

Once the inform buffer is filled up, the earliest inform in the inform buffer is deleted each time a new inform enters the queue. The deleted informs are not retransmitted to the NMS. To avoid this problem, you can increase the maximum number of informs to be confirmed in the inform buffer.

You can configure the snmp-agent inform command to contain the parameter timeout, resend-times, or pending according to the network condition.

When a large number of informs are dropped on the network, you can run the snmp-agent inform pending number command to increase the inform buffer.
When the transmission speed on the network is low, you can increase the timeout period. Increasing the timeout period will increase the waiting time of informs in the inform buffer. You can also run the snmp-agent inform { timeout seconds | pending number } ^* command to increase the inform.
When the transmission speed on the network is high, you can run the snmp-agent inform timeout seconds command to reduce the timeout period.
When informs are transmitted on an unreliable network, you can increase the retransmission times. In this case, the informs in the inform buffer need to wait for a longer time to be confirmed. You can run the snmp-agent inform { resend-times times | pending number } ^* command to increase the inform buffer.

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 command; you do not need to configure parameters for sending traps.

You must set the parameters timeout, resend-times, and pending according to the network condition. Otherwise, the SNMP working efficiency is greatly affected.

Example

# Set the times to retransmit an inform to 5 and the maximum number of informs waiting to be confirmed in the inform buffer to 100.

<HUAWEI> system-view
[HUAWEI] snmp-agent inform resend-times 5 pending 100