ent-snmp-host

Use this command to write an entry into the SNMP Host table to configure an SNMP northbound interface.

Parameters

host (mandatory)

Host name. This parameter specifies the logical name of the device associated with the specified IP address.

Special characters, such as hyphens, can be used in the host name if the host name is enclosed in double quotes (" ").

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 .

ipaddr (mandatory)

The IP address associated with the host name. This is a TCP/IP address expressed in standard dot notation.

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

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:: 161

hb (optional)

Heartbeat notification interval

Range:: 0, 60, 120, 300, 600, 900, 1800, 3600, 5400, 7200
Default:: 60

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:

public

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:: 162

version (mandatory) SNMP version

This value is used to associate 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 current value

System Default:: off

seclevel optional

This parameter specifies 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 current value

System Default:: off

authprot: optional

This parameter specifies authentication protocol for SNMPv3 host.

Range:

md5: HMAC-MD5-96
sha: HMAC-SHA-96

Default:: No change to the current value

System Default:: off

privprot: optional

This parameter specifies privacy protocol for SNMPv3 host.

Range:

aes: CFB128-AES-128
des: CBC-DES

Default:: No change to the current value

System Default:: off

Example

ent-snmp-host:host=snmpmgr:ipaddr=192.168.54.100

ent-snmp-host:host="linux-server":

ipaddr=10.25.60.99:hb=300:trapcomm="password"

Dependencies

An entry for the specified IPADDR cannot already exist.

An entry for the specified HOST cannot already exist.

A maximum of two SNMP Hosts can be configured.

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.

The specified PORT value 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

ent-snmp-host:host=snmphost1:ipaddr=192.168.54.100

tekelecstp 12-06-13 10:31:11 EST 45.0.0-64.66.0
ent-snmp-host:host=snmphost1:ipaddr=192.168.54.100
Command entered at terminal #4.
SNMP HOST table is (1 of 2) 50% full
ENT-SNMP-HOST: MASP A-COMPLTD
;

ent-snmp-host:host="snmp-srvr":ipaddr=10.25.55.25:hb=300:trapcomm="passwd"

tekelecstp 12-06-13 10:33:31 EST 45.0.0-64.66.0
ent-snmp-host:host="snmp-srvr":ipaddr=10.25.55.25:hb=300:trapcomm="passwd"
Command entered at terminal #4
SNMP HOST table is (2 of 2) 100% full
ENT-SNMP-HOST: MASP A - COMPLTD
;

ent-snmp-host:host=snmphost1:ipaddr=10.75.136.129:version=snmpv3:seclevel=auth
priv:authprot=md5:privprot=des:username=pvtest

Enter Auth Password :
Enter Priv Password :
Command Accepted - Processing

    e1121002 22-12-08 04:44:47 EST  EAGLE 47.1.0.0.0-79.16.0
    ent-snmp-host:host=snmphost1:ipaddr=10.75.136.129:version=snmpv3:seclevel=au
thpriv:authprot=md5:privprot=des:username=pvtest
    Command entered at terminal #2.
;
    e1121002 22-12-08 04:44:53 EST  EAGLE 47.1.0.0.0-79.16.0
    SNMP HOST table is (2  of 2 ) 100% full
    ENT-SNMP-HOST: MASP B - COMPLTD

4.353 ent-snmp-host