set snmp

Purpose

Configures the Simple Network Management Protocol (SNMP) agent, or displays current SNMP settings. Digi devices support SNMP Versions 1 and 2.

Required permissions

For Digi products with two or more users, permissions must be set to set permissions s-snmp=read to display settings, and set permissions s‑snmp=rw to display and configure settings. See set permissions for details on setting user permissions for commands.

Syntax

Set SNMP settings

set snmp [[trapdestip={ipaddress|FQDN}
  [trapsecdest={ipaddress|FQDN}]]
  [publiccommunity=string]
  [privatecommunity=string]
  [setsenabled={on|off}] 
  [authfailtrap={on|off}]
  [coldstarttrap={on|off}]
  [linkuptrap={on|off}]
  [logintrap={on|off}]

Display SNMP settings

set snmp

Options

trapdestip={ipaddress|FQDN}

Configures the IP address or, if IPV6 is supported on the device, the fully qualified domain name (FQDN) of the system to which the agent should send traps. To enable any of the traps, specify a non-zero value.

The trapdestip option is required in order for alarms to be sent in the form of SNMP traps. See send.

trapsecdest= {ipaddress|FQDN}

Configures the IP address or, if IPV6 is supported on the device, the fully qualified domain name (FQDN) of an additional system to which the agent should send traps. To enable the secondary trap destination, a non-zero value for trapsecdest must be specified. trapsecdest is optional and can be specified only if trapdestip is specified.

publiccommunity=string

The password required to get SNMP-managed objects. The default is public.

privatecommunity=string

The password required to set SNMP-managed objects. The default is private.

setsenabled={on|off}

Enables or disables sets of SNMP-managed objects.

on

Enables sets if the specified private community matches the current private community.

off

Disables sets even if the specified private community matches the current private community.

The default is off.

authfailtrap={on|off}

Enables or disables the sending of authentication failure traps.

on

Enables the sending of authentication failure traps.

off

Disables the sending of authentication failure traps.

The default is off.

coldstarttrap={on|off}

Enables or disables the sending of cold start traps.

on

Enables the sending of cold start traps.

off

Disables the sending of cold start traps.

The default is off.

linkuptrap={on|off}

Enables or disables the sending of link up traps.

on

Enables the sending of link up traps.

off

Disables the sending of link up traps.

The default is off.

logintrap={on|off}

Enables or disables the sending of login traps.

on

Enables the sending of login traps.

off

Disables the sending of login traps.

The default is off.

Examples

Enable authentication failure traps

#> set snmp trapdestip=10.0.0.1 authfailtrap=on

Specify a new private community string

#> set snmp privatecommunity=”StLucia72!”

See also