From db2827f542e9bc9a23ffed4707be038c0b1fb478 Mon Sep 17 00:00:00 2001 From: M.Gergő Date: Fri, 28 Sep 2018 16:32:53 +0200 Subject: Readme update --- README.md | 35 +++++++++++++++++++++-------------- ubnt_unifi.php | 4 ++-- 2 files changed, 23 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index 2f69e65..c77a80b 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ This is a [Munin](http://munin-monitoring.org/) plugin to monitor your [Ubiquiti Unifi](https://www.ubnt.com/products/#unifi) wireless network status. It uses SNMPv2 to get network data. -### The original version of this repo is aviable here: [http://git.bmrg.hu/unifi-munin.git](http://git.bmrg.hu/unifi-munin.git/) +### The original version of code is aviable here: [http://git.bmrg.hu/unifi-munin.git](http://git.bmrg.hu/unifi-munin.git/) @@ -21,21 +21,29 @@ Network Usage ## Installing on Debian -1) Copy the **ubnt_unifi.php** into the **/usr/share/munin/plugins/** folder. -2) Set the rights: +1. Copy the **ubnt_unifi.php** into the **/usr/share/munin/plugins/** folder. +2. Set the rights: +`chmod 755 /usr/share/munin/plugins/ubnt_unifi.php` +3. Create a symlink to this file: +`ln -s /usr/share/munin/plugins/ubnt_unifi.php /etc/munin/plugins/ubnt_unifi` - chmod 755 /usr/share/munin/plugins/ubnt_unifi.php - -3) Create a symlink to this file: +4. Edit the **/etc/munin/munin.conf** and **/etc/munin/plugin-conf.d/munin-node** files, add the following configuration lines. +5. Restart the munin, and munin-node with `/etc/init.d/munin restart` and `/etc/init.d/munin-node restart` commands. +6. Test the plugin with the `munin-run ubnt_unifi` command. + - ln -s /usr/share/munin/plugins/ubnt_unifi.php /etc/munin/plugins/ubnt_unifi - -4) Edit the **/etc/munin/plugin-conf.d/munin-node** file, and add the following configuration lines. -5) Test the plugin with the `munin-run ubnt_unifi` command. ## CONFIGURATION -The following environment variables are used: +Edit the **/etc/munin/munin.conf** with the following options: + + [unifi.company.com] #Unifi Controller hostname + address 127.0.0.1 #This plugin uses a wirtual munin node on localhost, + use_node_name no #but don't need to use the node name. + timeout 240 #Timeout, while this plugin can be running. + + +Edit the **/etc/munin/plugin-conf.d/munin-node**, and use the following configurations: [ubnt_unifi] timeout - Munin-update timeout for this plugin. @@ -46,12 +54,11 @@ The following environment variables are used: env.devnetw - The network of the APs. (It is expreimental yet.) -Configuration example for Munin: - +For example: [ubnt_unifi] timeout 240 - env.controller unifi.company.hu + env.controller unifi.company.com env.devices ap01.wl.company.lan ap02.wl.company.lan ap03.wl.company.lan 10.10.1.6 10.10.1.7 10.10.1.8 env.devnetw 10.10.1.10/24 env.timeout 70 diff --git a/ubnt_unifi.php b/ubnt_unifi.php index 12ba5f1..4491a38 100644 --- a/ubnt_unifi.php +++ b/ubnt_unifi.php @@ -184,8 +184,8 @@ function collect_netw_summary($inp,$host){ //network information $multiplier = 8; $divider = 1; } else { //because the normal INTEGER(32) would be overflowed - $multiplier = 8192; // When showing the controller's summary - $divider = 1024; + $multiplier = 8*1024*1024; // When showing the controller's summary + $divider = 1024*1024; } -- cgit v1.2.3