4.140 chg-snmp-host

Use this command to change an existing entry in the SNMP Host table to re-configure an SNMP northbound interface.

Parameters

host (optional)
Host name. This parameter is used as the search key to locate a specific table entry. Either HOST or IPADDR must be specified, but both cannot be used in the same command.
Range:
zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz

A string of characters, beginning with a letter and comprising up to 32 characters in length. Valid values are a..z, A..Z, 0..9, or .

The hostname cannot be changed with the chg-snmp-host command.

ipaddr (optional)
IP Address. This parameter is used as the search key to locate a specific table entry. Either HOST of IPADDR must be specified, but both cannot be used in the same command.
Range:

4 numbers separated by dots, with each number in the range of 0-255.

The IP address cannot be changed with the chg-snmp-host command.

trapcomm (optional)
The value used in the community name field when SNMP traps are generated.
Range:
zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz

Any string up to 32 characters in length.

If the string contains characters other than alphanumeric characters, the entire string must be enclosed in double quotes (" ").

The string can be entered in upper and lower case; however, the system converts upper case alphabetic characters to lower case.

Default:
No change to the parameter value
System Default:
public
cmdport (optional)
SNMP interface command port ID.
Range:
161, 1024..65535

This is the port that the SNMP agent will monitor for commands such as GET and SET.

Default:
No change to the parameter value
System Default:
161
trapport (optional)
SNMP interface trap port ID.
Range:
162, 1024..65535

This is the port through which the SNMP agent will transmit traps to the Manager.

Default:
No change to the parameter value
System Default:
162
hb (optional)
Heartbeat notification interval
Range
0, 60, 120, 300, 600, 900, 1800, 3600, 5400, 7200
Default:
No change to the parameter value
System Default:
60
version (mandatory) SNMP version
This value is used to associated version with SNMP host.
Range
  • snmpv2c: SNMP version 2
  • snmpv3: SNMP version 3
Default:
snmpv2c
username optional
The value used in the username field when SNMPv3 traps are generated.
Range
zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz

Any string up to 32 characters in length.

If the string contains characters other than alphanumeric characters, the entire string must be enclosed in double quotes (" ").

The string can be entered in upper and lower case; however, the system converts upper case alphabetic characters to lower case.

Default:
No change to the parameter value
System Default:
Off
seclevel optional
This parameter specifies the security level for SNMPv3 host.
Range
  • noauthnopriv: Authentication and Privacy both are disabled
  • authnopriv: Authentication is enabled and Privacy is disabled.
  • authpriv: Authentication and Privacy both are enabled
Default:
No change to the parameter value
System Default:
Off
authprot optional
This parameter specifies the authentication protocol for SNMPv3 host.
Range
  • md5: HMAC-MD5-96
  • sha: HMAC-SHA-96
Default:
No change to the parameter value
System Default:
Off
privprot optional
This parameter specifies the privacy protocol for SNMPv3 host.
Range
  • aes: CFB128-AES-128
  • des: CBC-DES
Default:
No change to the parameter value
System Default:
Off

Example

chg-snmp-host:host=snmpmgr:hb=300:trapcomm="newpwd"

chg-snmp-host:ipaddr=10.25.60.99:hb=300:trapcomm="password":cmdport=2000

Dependencies

The specified HOST or IPADDR must exist in the SNMP Host table.

The specified heartbeat value must be within the range for the HB parameter.

The SNMP feature must be enabled before an SNMP Host can be configured.

To locate a table entry, either the HOST or IPADDR parameters must be specified, but both cannot be used in the same command.

The specified CMDPORT and TRAPPORT values must be within the allowed range.

A separate prompt appears for you to enter the Authentication and privacy password based on value of SECLEVEL that will be used with the SNMP authentication and privacy protocol. You must enter a password that is at least 8 and not more than 16 characters long. If you enter an invalid password (you press the Return key without entering a password, or you enter more than 16 characters), you must enter the entire command again to cause the password prompt to appear again. The password that you enter is not displayed as you enter it.

SNMPv3 mandatory parameters (USERNAME or SECLEVEL) are missing. AUTHPROT must be specified with “SECLEVEL=authpriv” or “SECLEVEL=authnopriv”. PRIVPROT must be specified with “SECLEVEL=authpriv”

USERNAME, SECLEVEL, AUTHPROT, PRIVPROT are not valid parameter for snmpv2c. AUTHPROT and PRIVPROT must not be specified with “SECLEVEL=noauthnopriv”. PRIVPROT must not be specified with “SECLEVEL=authnopriv”

An entry for the specified USERNAME is already exist.

Notes

None.

Output

chg-snmp-host:ipaddr=10.25.55.25:cmdport=2015:hb=60
tekelecstp 12-06-13 10:58:26 EST 45.0.0-64.66.0
chg-snmp-host:ipaddr=10.25.55.25:cmdport=2015:hb=60
Command entered at terminal #4.
CHG-SNMP-HOST: MASP A-COMPLTD
;
ent-snmp-host
dlt-snmp-host
rtrv-snmp-host