SNMP-NMS
Contents
Introduction
Simple Network Management Protocol (SNMP) is an Internet Standard protocol for collecting and organizing information about managed devices on IP networks and for modifying that information to change device behavior. Devices that typically support SNMP include cable modems, routers, switches, servers, workstations, printers, and more.
An SNMP-managed network consists of three key components:
- Managed devices
- Agent – software which runs on managed devices
- Network management station (NMS) – software which runs on the manager
EdgeSense SNMP-NMS
EdgeSense SNMP-NMS is a plug-in of RMM agent, aim to collect object data from SNMP managed device.
Feature:
- Support SNMPv1, SNMPv2c.
- support object type: OCTET STRING, Integer32
How to
Turn MIBs file into JSON documentation
Because MIBS file is not good to load in application, EdgeSense SNMP-NMS use a tools from PySMI to turn MIBS file into json file.
About installing PySMI or more detailed, please refer to this.
Usage:
mibdump.py --generate-mib-texts --destination-format json YOUR_MIB_FILE
example:
mibdump.py --generate-mib-texts --destination-format json ./ADAM-6017.mib
Then a json file will be generated. You can edit this json file to add/remove object you want to poll from several SNMP agents.
Software Requirements
Software Installation for Ubuntu 16.04
Install Steps:
1. Install OS - Ubuntu 16.04 (ex: ubuntu-16.04.5-desktop-amd64.iso)
2. Install MQTT Broker
- Copy MQTT Broker install package (ex: MQTTBrokerSetup-1.0.4-Ubuntu_16.04-x86_64.run) to gateway.
- Execute "sudo chmod +x MQTTBrokerSetup-1.0.4-Ubuntu_16.04-x86_64.run".
- Execute "sudo ./MQTTBrokerSetup-1.0.4-Ubuntu_16.04-x86_64.run" to install.
3. Install EdgeSense SNMP-NMS
- Copy SNMP-NMS install package (ex: SNMP-NMS-1.0.0-Ubuntu_16.04-x86_64.run) to gateway.
- Execute "sudo chmod +x SNMP-NMS-1.0.0-Ubuntu_16.04-x86_64.run".
- Execute "sudo ./SNMP-NMS-1.0.0-Ubuntu_16.04-x86_64.run" to install.
After installation, service will be autorun.
NOTE: Please wire the gateway to Internet with Network cable before install, it is necessary to install the dependencies.
Uninstall Steps:
1. Execute "sudo /usr/local/EdgeSense/SNMP-NMS/uninstall.bash" in terminal.
Configuration
In Ubuntu 16.04
- You can edit /usr/local/EdgeSense/SNMP-NMS/config/snmp_config.json to change setting.
- You can execute "sudo vi /usr/local/EdgeSense/SNMP-NMS/config/snmp_config.json" command in Ubuntu terminal to modify config.
- Also you can use gedit to edit file, command is "sudo gedit /usr/local/EdgeSense/SNMP-NMS/config/snmp_config.json"
- Once config is changed , please execute "sudo systemctl restart SNMP-NMS.service" to restart service in order to apply new setting.
Setting File as:
|
{ "devicelist" : [ { ] |
interval
- default value is 20 second
- If setting is greater than maximum value or is less than minimum value, it will use default value.
Service control
In Ubuntu
Check if service is running:
$ sudo systemctl status SNMP-NMS.service
Restart service:
$ sudo systemctl restart SNMP-NMS.service
Start service:
$ sudo systemctl start SNMP-NMS.service
Stop service:
$ sudo systemctl stop SNMP-NMS.service
Tools
PySMI
PySMI is a open source tool, we use it to turns MIBs into JSON documents.
For more detailed information, please refer to PySMI official website.