SNMP Configuration and Queries#

This topic covers configurations for various versions.

SNMP Configuration#

SNMP must be configured under the SNMP menu and the SNMP URI needs to be configured for all the notify severity levels(info|warn|error]).

Note

  • Characters used in the SNMP URI can include uppercase and lowercase letters, decimal digits, hyphen, period, underscore, and tilde:

    `` ALPHA / DIGIT / “-” / “.” / “_” / “~” ``

  • The SNMP host should be an IP address, not a host name.

SNMP URI usage:

  • snmpv2: snmp://community@host[:port]

  • snmpv3: snmp://user:auth:password]@host[:port] … minimum auth/password length is 8 characters.

For example:

  • snmpv2: notify add info snmp://public@1.2.3.4

  • snmpv3: notify add error snmp://public:publicauth:password@1.2.3.4

The following options can be configured under the SNMP menu in the CLI.

  • Enabled -Enable or disable SNMP Queries

  • Community- SNMP v2c Community String used to query this server

  • Authorized Username - SNMP v3 Username to query this server

  • Password - SNMP v3 Password to query this server

  • Query - IP address that is allowed to query this server

  • Sysname - Name of this server, as it will appear when queried via SNMP

  • Syslocation - Location of this server

  • Syscontact - Contact person(s) for this server (email address)

  • Load1 - 1 Minute load average alarm value

  • Load5 - 5 Minute load average alarm value

  • Load15 - 15 Minute load average alarm value

The following options can be configured in the CLI:

  • Hostname - Server name to send SNMP traps to.

  • Version - Version of SNMP to use for sending trap, version 2c or 3.

  • Community - refer to the SNMP-URI command usage.

SNMP Queries#

The VOSS Automate server permits multiple remote query sources to perform SNMP queries against.

The following commands are available to set SNMP details:

  • snmp contact <system contact>

  • snmp name <system name>

  • snmp location <system location>

SNMP query sources can be added with

snmp query add <uri>

SNMP v2 can be set with:

snmp query add snmp://<community string>@<ip>

SNMP v3 username and password can be set with:

snmp query add snmp://user:auth:password@<ip>:<port>

Where:

  • user: the username for the SNMPv3 server

  • auth: the SNMPv3 authKey, with a minimum length of 8 characters (SHA authentication)

  • password: the SNMPv3 privKey, with a minimum length of 8 characters (AES encryption)

  • To see the list of added query sources, run snmp query list.

  • To remove a query source, run snmp query del <uri>.

The screen console output below are example of the use of add, list, and del parameters with SNMPv2:

platform@host:~$ snmp query add snmp://[email protected]
You are about to restart the SNMP service. Do you wish to continue? y
Please update notify to reflect your latest changes.
You have new mail in /var/mail/platform
platform@host:~$

platform@host:~$ snmp list
    load1: 4
    load15: 1
    load5: 2
    query:
        snmp://[email protected]
        snmp://[email protected]
    syscontact: Robert Frame
    syslocation: Dublin
    sysname: host

platform@host:~$ snmp query del snmp://[email protected]
You are about to restart the SNMP service. Do you wish to continue? y

Application services:firewall processes stopped.
Application snmp processes stopped.
Application snmp processes started.
Please update notify to reflect your latest changes.
You have new mail in /var/mail/platform
platform@host:~$

SNMP CPU load notifications are set using:

snmp load <1min load> <5min load> <15min load>

This results in notifications being sent should the threshold be exceeded. For a server with 2 CPUs, it is recommended that this setting be:

snmp load 8 4 2

This means that notifications are sent if the 2-CPU system load averages over the last 1, 5, and 15 minutes reach these values.