undo snmp-agent inform

Function

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

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

Format

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

Parameters

Parameter	Description	Value
timeout	Set the timeout period for SNMP informs.	-
resend-times	Set the number of times an SNMP inform is retransmitted.	-
pending	Set the number of SNMP inform that are waiting for the acknowledgement from the NMS.	-

Parameter

Description

Value

timeout

Set the timeout period for SNMP informs.

resend-times

Set the number of times an SNMP inform is retransmitted.

pending

Set the number of SNMP inform that are waiting for the acknowledgement from the NMS.

Views

System view

Default Level

3: Management level

Task Name and Operations

Task Name	Operations
snmp	write

Usage Guidelines

Usage Scenario

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

These three parameters affect one another. For example, if the timeout period for waiting for Inform ACK messages prolongs or the number of attempts to retransmit Inform messages increases, but the maximum number of Inform messages to be confirmed is not changed, the number of Inform messages to be confirmed increases, causing the inform buffer to be quickly filled up.

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

You can configure the snmp-agent inform command to contain the parameter timeout, resend-times, or pending as needed.

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

Prerequisites

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

The IP address of the target host for receiving Inform messages has been configured using the snmp-agent target-host inform command.

Configuration Impact

You must set suitable parameters timeout, resend-times, and pending. Setting an inappropriate parameter deteriorates SNMP working efficiency.

Precautions

Only parameters for sending Inform messages need to be configured using the snmp-agent inform command. Parameters for sending trap messages do not need to be configured.

You must set the parameters timeout and resend-times based on network conditions. Setting an inappropriate parameter deteriorates the transmission efficiency of SNMP messages. If the parameters timeout and resend-times are already configured using the snmp-agent inform command, after the snmp-agent inform address command is run on a specified target host, the earlier configure is overwritten.

Only parameters for sending Inform messages need to be configured using the snmp-agent inform address command. Parameters for sending trap messages do not need to be configured.

Example

# Restores the default parameters of informs that are waiting for the acknowledgement from the NMS, inform retransmitted times and timeout period for informs.

<HUAWEI> system-view
[~HUAWEI] undo snmp-agent inform pending resend-times timeout