The snmp-agent inform address command sets parameters for sending Inform messages. The parameters include the timeout period for waiting for Inform ACK messages from the NMS and the number of attempts to retransmit an Inform message.
The undo snmp-agent inform address command restores the default settings for a particular inform host.
By default, the timeout waiting period for Inform ACK messages is 15 seconds, and the number of attempts to retransmit an Inform message is 3.
snmp-agent inform { timeout seconds | resend-times times } * { host-name target-host-name | 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 ] } * { host-name target-host-name | address udp-domain ip-address [ vpn-instance vpn-instance-name ] params securityname { security-name | cipher security-name } }
| Parameter | Description | Value |
|---|---|---|
| timeout seconds |
Specified 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 maximum number of attempts to retransmit an Inform message if no Inform ACK message is returned by 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. |
| host-name target-host-name |
Specifies an SNMP target host name. |
The name is a string of 1 to 32 case-sensitive characters, spaces not supported. When quotation marks are used around the string, spaces are allowed in the string. |
| address |
Indicates the IP address of a target host for receiving SNMP trap messages. |
The IP address specified using address and the security name specified using securityname together identify a host. |
| udp-domain ip-address |
Specifies the IP address of a specified target host within a UDP transmission domain. |
The IP address is in dotted decimal notation. |
| vpn-instance vpn-instance-name |
Specifies the name of a VPN instance. |
The value is a string of 1 to 31 case-sensitive characters, spaces not supported. In addition, the VPN instance name must not be _public_. When double quotation marks are used around the string, spaces are allowed in the string. The parameter vpn-instance is optional. On a VPN network, use the VPN instance specified using vpn-instance, IP address, and security name together to identify a target host. |
| params |
Indicates information about a target host that generates SNMP notifications. |
- |
| securityname security-name |
Displays the name of a target host for receiving Inform messages on the NMS. For SNMPv3, securityname must be set to a user name. securityname configured on the host must be the same as that configured on the NMS, or the NMS cannot receive the trap messages sent by 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 quotation marks are used around the string, spaces are allowed in the string. |
| cipher |
Indicates the password in ciphertext. The simple password or the ciphertext password can be entered. The password in the configuration file is displayed in ciphertext. If you do not specify the keyword, enter the simple password only. |
A simple text password is a string of 1 to 32 case-sensitive characters. A ciphertext password is a string of 32, 48, 56 or from 68 to 168 case-sensitive characters. When quotation marks are used around the string, spaces are allowed in the string. Ciphertext passwords with various lengths configured in an earlier version are also supported in the existing version. |
| cipher security-name |
Specifies a ciphertext security name. |
A simple text password is a string of 1 to 32 case-sensitive characters. A ciphertext password is a string of 32, 48, 56 or from 68 to 168 case-sensitive characters. When quotation marks are used around the string, spaces are allowed in the string. Ciphertext passwords with various lengths configured in an earlier version are also supported in the existing version. |
Usage Scenario
If the snmp-agent inform address command is run on the target host after the global Inform parameters are configured, only the parameter configure using the snmp-agent inform address command takes effect.
You can use both the snmp-agent inform address command and the snmp-agent inform command to set parameters based on network conditions.
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.
Precautions
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.
<HUAWEI> system-view [~HUAWEI] snmp-agent inform resend-times 10
<HUAWEI> system-view [~HUAWEI] snmp-agent inform resend-times 10 address udp-domain 10.1.1.1 params securityname ABC