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.