mirror/librenms-librenms
1
0
Fork 0
mirror of https://github.com/librenms/librenms.git synced 2024-10-07 16:52:45 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Fix setup instructions so they actually work (#9731)

Browse Source 
I'm walking through installing smokeping, and running into some minor issues in the docs.

Basically: 
 1. Smokeping is a `fastcgi` application, and the config in the docs assumes that you have a fastcgi handler installed (`fastcgi_pass unix:/var/run/fcgiwrap.socket;`). I did not, and you get confusing errors.
2. I'm still not sure where the smokeping stuff is supposed to show up in the UI.
This commit is contained in:
Connor Wolf
2019-02-12 19:49:09 -08:00
committed by Tony Murray
parent 67d81e68c9
commit 9766cad5d0
1 changed files with 3 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
doc/Extensions/Smokeping.md
View File

@ -16,6 +16,7 @@ For new installations, we can use the included `scripts/gen_smokeping.php` scrip
This guide assumes you have already [installed librenms](http://docs.librenms.org/Installation/Installing-LibreNMS/), and is working with either **Apache** or **nginx**.
Note: You may need to install `fcgiwrap` as well (at least with `nginx`).
### Install Smokeping
@ -53,7 +54,7 @@ LibreNMS comes equipped with a script which exports our list of nodes from Libre
To generate the config file once:
```bash
php /opt/librenms/scripts/gen_smokeping.php > /opt/smokeping/etc/librenms.conf
(echo "+ LibreNMS"; php -f /opt/librenms/scripts/gen_smokeping.php) | sudo tee /etc/smokeping/config.d/librenms.conf
```
**However**, it is more desirable to set up a cron job which regenerates our list of nodes and adds these into Smokeping. You can add the following to the end of your librenms cron job, e.g. `nano /etc/cron.d/librenms`
@ -79,7 +80,7 @@ menu = Top
title = Network Latency Grapher
```
Which can cause Smokeping to not start. `echo "+ LibreNMS"` appends this in our smokeping config file. We could remove the above from the gen_smokeping script, however this may cause issues with LibreNMS failing to update with `daily.sh` due config files being modified.
Which can cause Smokeping to not start. `echo "+ LibreNMS"` prepends this in our smokeping config file. We could remove the above from the gen_smokeping script, however this may cause issues with LibreNMS failing to update with `daily.sh` due config files being modified.
## Configure LibreNMS