The Simple Network Management Protocol (SNMP) can be used to collect and organise information about devices on a network. This includes being able to monitor devices in a network monitoring product.

Each Vivi Boxes support SNMP. Each Box is running an instance of snmpd, an SNMP client server that can be queried for information by an SNMP manager. Vivi Boxes currently provide It is available on the default port 161 UDP and currently provides CPU, network and memory information via SNMP.

The SNMP client responds to UDP requests on port 161 that have authenticated with the correct credentials.

Collecting data

The approach for collecting data will differ depending on the program that you are using, but all approaches will end up sending a single message to each Box with the information that they would like collected.

The following sample commands show the type of information that can be gathered.

On a linux machine, a program like "snmpwalk" can be used to query multiple fields at once, and "snmpget" can be used to query a single field.

For example, run the following command to get all information from the Vivi Box at 192.168.3.54: snmpwalk 192.168.3.54

It will return data that begins with this:

Image Removed

To query only a certain field, you can simply type that field after the IP address:

Image Removed

Authentication

SNMPv2 (community name) authentication is not supported.

SNMPv3 authentication is supported, using authentication protocol MD5 and privacy protocol DES.

Use admin as the security name and your configured webconsole password (default v!v!adm!n) as both the authentication and privacy passwords.

Example

$ snmpwalk -l authPriv -u admin -a MD5 -A 'v!v!adm!n' -x DES -X 'v!v!adm!n' 10.0.3.242 sysUpTimeInstance
DISMAN-EVENT-MIB::sysUpTimeInstance = Timeticks: (42691934) 4 days, 22:35:19.34