2017-10-25 08:10:59 -05:00
|
|
|
source: Extensions/Weathermap.md
|
|
|
|
|
|
2017-10-26 15:35:03 -05:00
|
|
|
# Network-WeatherMap with LibreNMS
|
2017-10-27 15:55:38 -05:00
|
|
|
Integrating LibreNMS with Network-Weathermap, allows you to build network maps to help visulaize network traffic flow rates.
|
2017-10-26 15:35:03 -05:00
|
|
|
[Link](https://network-weathermap.com/) to Network-Wearthermap Offical Website
|
2017-10-25 08:10:59 -05:00
|
|
|
|
2017-10-26 15:35:03 -05:00
|
|
|
### Installing Network-WeatherMap
|
2017-10-25 08:10:59 -05:00
|
|
|
|
|
|
|
|
### Step 1.
|
2017-10-27 15:55:38 -05:00
|
|
|
Extract to your LibreNMS plugins directory `/opt/librenms/html/plugins` so you should see something like `/opt/librenms/html/plugins/Weathermap/`
|
|
|
|
|
The best way to do this is via git. Go to your install directory and then `/opt/librenms/html/plugins`
|
2017-10-25 08:10:59 -05:00
|
|
|
Enter:
|
|
|
|
|
`git clone https://github.com/librenms-plugins/Weathermap.git`
|
2017-10-26 15:35:03 -05:00
|
|
|
### Step 2.
|
2017-10-27 15:55:38 -05:00
|
|
|
Inside the html/plugins directory, change the ownership of the Weathermap directory by typing `chown -R librenms:librenms Weathermap/`
|
|
|
|
|
Make the configs directory writeable `chmod 775 /opt/librenms/html/plugins/Weathermap/configs`
|
2017-10-25 08:10:59 -05:00
|
|
|
### Step 3.
|
2017-10-26 15:35:03 -05:00
|
|
|
Enable the cron process by editing your current LibreNMS cron file (typically /etc/cron.d/librenms) and add the following:
|
|
|
|
|
LibreNMS: `*/5 * * * * librenms /opt/librenms/html/plugins/Weathermap/map-poller.php >> /dev/null 2>&1`
|
2017-10-25 08:10:59 -05:00
|
|
|
### Step 4.
|
2017-10-26 15:35:03 -05:00
|
|
|
Enable the plugin from LibreNMS Web UI in OverView ->Plugins -> Plugin Admin menu.
|
|
|
|
|
|
2017-10-25 08:10:59 -05:00
|
|
|
### Step 5.
|
2017-10-26 15:35:03 -05:00
|
|
|
Now you should see Weathermap Overview -> Plugins -> Weathermap
|
|
|
|
|
Create your maps, please note when you create a MAP, please click Map Style, ensure Overlib is selected for HTML Style and click submit.
|
2017-10-25 08:10:59 -05:00
|
|
|
Also, ensure you set an output image filename and output HTML filename in Map Properties.
|
|
|
|
|
I'd recommend you use the output folder as this is excluded from git updates (i.e enter output/mymap.png and output/mymap.html).
|
|
|
|
|
|
|
|
|
|
Optional: If your install is in another directory than standard, set `$basehref` within `map-poller.php`.
|
|
|
|
|
|
2017-10-27 15:55:38 -05:00
|
|
|
Automatically generate weathermaps from a LibreNMS database using WeatherMapper [Link](https://github.com/pblasquez/weathermapper)
|
2017-10-26 15:35:03 -05:00
|
|
|
|
|
|
|
|
|
