tnmSnmpMonitor

A simple SNMP based system monitoring tool

PreRequisites

• SNMP daemon snmpd should be configured and running in the device
• readonly community "public" should be configured to be accessible via localhost
• Required MIBs have been installed on the device

Please follow the following instructions to set up snmpd correctly in your system

1. Install snmpd on the device. Instructions provided are for ubuntu/debian OS

   sudo apt-get update
   sudo apt-get install snmpd

2. Backup existing snmpd configuration

   mv /etc/snmp/snmpd.conf /etc/snmp/snmpd.conf_original

3. Create the file /etc/snmp/snmp.conf and include the following line:

   rocommunity public

4. Download and install SNMP MIB files

   sudo apt-get install snmp-mibs-downloader
   sudo download-mibs

5. Restart the SNMP service with the following command:

   /etc/init.d/snmpd restart

6. After restarting SNMP service, perform a local test to verify that SNMP is running:

   snmpwalk -v 1 -c public localhost sysname

7. Install whiptail for managing terminal Alerts

   sudo apt-get install whiptail

Instructions for using the App

We developed the app as an executable bash script. No compilation is required.

• Clone the repo and execute the script tnmSnmpMonitor.sh

   git clone https://github.com/abhijeetviswam/tnmSnmpMonitor.git
   cd tnmSnmpMonitor
   ./tnmSnmpMonitor.sh

• Select the necessary option from the menu
  1. Show system details :
  Queries the SNMP agent running on your system and display your systems' details
  Details are fetched from the SNMP system subtree - 1.3.6.1.2.1.1

  2. Monitor Interface statistics :
  Queries the SNMP agent running on your system periodically and display the statistics of the interfaces on your system
  All interfaces available on the device are listed. Choose the interface you're interested in and set the refreshInterval. The values are refreshed every refreshInterval seconds

  3. Setup threshold alert : Allows the user to set thresholds for any statistical parameter. If the threshold is exceeded, the user is provided an Alert regarding this.
  You can list the interfaces available and select the statistic you're interested to monitor
  Alternately, You can monitor any OID with this tool. But please use only numeric type OID's like INTEGER or Counter32. Providing other types like STRING can cause the tool to misbehave.