From 1b6662448faf84ca5eaa7a6fc689b89f1999efd6 Mon Sep 17 00:00:00 2001 From: awlx Date: Wed, 3 Feb 2016 10:19:07 +0100 Subject: [PATCH 1/3] Added configuration examples and descriptions for mib based poller --- doc/Extensions/MIB-based-polling.md | 53 +++++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) diff --git a/doc/Extensions/MIB-based-polling.md b/doc/Extensions/MIB-based-polling.md index d23d207dd6..5f73ff7485 100644 --- a/doc/Extensions/MIB-based-polling.md +++ b/doc/Extensions/MIB-based-polling.md @@ -144,6 +144,59 @@ graph. can follow the above process, then use the resultant data collected by LibreNMS in the RRD files or the database tables `device_oids` +## Configuration + +### Discovery + +You need to add your desired MIBs to `/opt/librenms/mibs` folder. Afterwards you need to register your MIBs to the discovery function. + +#### Example +`/opt/librenms/includes/discovery/os/f5.inc.php` + +``` + "F5-BIGIP-LOCAL-MIB", + ); + +### Actual registering of the MIB +register_mibs($device, $f5_mibs, "includes/discovery/os/f5.inc.php"); + +``` + +The important thing is the array $f5_mibs where you define which parts (ltmVirtualServStatEntry) of the MIB (F5-BIGIP-LOCAL-MIB) you are going to add. The registering is also important, otherwise poller cannot make use of the MIB. + +### Poller + +Next step is to add the MIBs to the poller. + +#### Example +`/opt/librenms/includes/polling/os/f5.inc.php` + +``` + "F5-BIGIP-LOCAL-MIB", +); + +### Poll those MIBs +poll_mibs($f5_mibs, $device, $graphs); +``` + +You define the MIBs which you want to poll here and start the actual polling with `poll_mibs()`. + ## TODO ## From 2a51cf723cd7fbfeb8051055aa23757c5fc64ad5 Mon Sep 17 00:00:00 2001 From: awlx Date: Wed, 3 Feb 2016 10:24:17 +0100 Subject: [PATCH 2/3] To make it complete added config.php step --- doc/Extensions/MIB-based-polling.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/doc/Extensions/MIB-based-polling.md b/doc/Extensions/MIB-based-polling.md index 5f73ff7485..b59f848883 100644 --- a/doc/Extensions/MIB-based-polling.md +++ b/doc/Extensions/MIB-based-polling.md @@ -145,6 +145,8 @@ graph. LibreNMS in the RRD files or the database tables `device_oids` ## Configuration +### Main Configuration +In `/opt/librenms/config.php` add `$config['poller_modules']['mib'] = 1;` ### Discovery From 45917efd0f5434c4bd4c9ad0597a62694cc45a5e Mon Sep 17 00:00:00 2001 From: awlx Date: Wed, 3 Feb 2016 10:34:07 +0100 Subject: [PATCH 3/3] Removed no longer necessary poller section --- doc/Extensions/MIB-based-polling.md | 23 ----------------------- 1 file changed, 23 deletions(-) diff --git a/doc/Extensions/MIB-based-polling.md b/doc/Extensions/MIB-based-polling.md index b59f848883..cc95151531 100644 --- a/doc/Extensions/MIB-based-polling.md +++ b/doc/Extensions/MIB-based-polling.md @@ -177,29 +177,6 @@ register_mibs($device, $f5_mibs, "includes/discovery/os/f5.inc.php"); The important thing is the array $f5_mibs where you define which parts (ltmVirtualServStatEntry) of the MIB (F5-BIGIP-LOCAL-MIB) you are going to add. The registering is also important, otherwise poller cannot make use of the MIB. -### Poller - -Next step is to add the MIBs to the poller. - -#### Example -`/opt/librenms/includes/polling/os/f5.inc.php` - -``` - "F5-BIGIP-LOCAL-MIB", -); - -### Poll those MIBs -poll_mibs($f5_mibs, $device, $graphs); -``` - -You define the MIBs which you want to poll here and start the actual polling with `poll_mibs()`. - - ## TODO ## What's not included in MIB-based polling at present? These may be present in