5.5 KiB
source: Extensions/Smokeping.md
Smokeping integration
We currently have two ways to use Smokeping with LibreNMS, the first is using the included script generator to generate the config for Smokeping. The second is to utilise an existing Smokeping setup.
Included Smokeping script
To use this, please add something similar to your smokeping config file:
@include /opt/smokeping/etc/librenms.conf
Then you need to generate the config file (maybe even add a cron to schedule this in and reload smokeping). We've assumed a few locations for smokeping, the config file you want to call it and where LibreNMS is:
cd /opt/librenms/scripts/
php ./gen_smokeping.php > /opt/smokeping/etc/librenms.conf
/opt/smokeping/bin/smokeping --reload
Sample cron:
15 0 * * * root cd /opt/librenms/scripts && php ./gen_smokeping.php > /opt/smokeping/etc/librenms.conf && /opt/smokeping/bin/smokeping --reload >> /dev/null 2>&1
Now configure LibreNMS (make sure you point dir to your smokeping data directory:
$config['smokeping']['dir'] = '/opt/smokeping/data';
$config['smokeping']['pings'] = 20; // should be equal to "pings" in your smokeping config
$config['smokeping']['integration'] = true;
Standard Smokeping
This is quite simple, just point your dir at the smokeping data directory - please be aware that all RRD files need to be within this dir and NOT sub dirs:
$config['smokeping']['dir'] = '/opt/smokeping/data';
$config['smokeping']['pings'] = 20; // should be equal to "pings" in your smokeping config
$config['own_hostname']
You should now see a new tab in your device page called ping.
Install and integrate Smokeping [Debian/Ubuntu]
This guide assumes you have already installed librenms, and you installed apache2 in the process. Tested with Ubuntu 14.04 and Apache 2.4.
Nearly everything we do will require root, and at one point we'll encounter a problem if we just use sudo, so we'll just switch to root at the beginning...
sudo su -
Install Smokeping
apt-get install smokeping
At the end of installation, you may have gotten this error: ERROR: /etc/smokeping/config.d/pathnames, line 1: File '/usr/sbin/sendmail' does not exist
If so, just edit smokeping's pathnames.
nano /etc/smokeping/config.d/pathnames
Comment out the first line:
#sendmail = /usr/sbin/sendmail
Exit and save.
Check if the smokeping config file was created for apache2:
ls /etc/apache2/conf-available/
If you don't see smokeping.conf listed, you'll need to create a symlink for it:
ln -s /etc/smokeping/apache2.conf /etc/apache2/conf-available/smokeping.conf
Edit the smokeping config so smokeping knows the hostname it's running on:
nano /etc/smokeping/config.d/General
Change the cgiurl value to http://yourhost/cgi-bin/smokeping.cgi
Modify any other values you wish, then exit and save.
LibreNMS integration
So far this is a relatively normal Smokeping installation; next we'll set up the LibreNMS integration.
Generate the configuration file so Smokeping knows the hosts you have set up for monitoring in LibreNMS.
cd /opt/librenms/scripts/
(echo "+ LibreNMS"; php ./gen_smokeping.php) > /etc/smokeping/config.d/librenms.conf
Add a cron job so as you add or remove hosts in librenms they'll get updated with Smokeping.
crontab -e
Add the example cron below; it's set to run daily at 02:05
05 02 * * * root cd /opt/librenms/scripts && (echo "+ LibreNMS"; php ./gen_smokeping.php) > /etc/smokeping/config.d/librenms.conf && service smokeping reload >> /dev/null
Exit and save.
Include librenms.conf in smokeping's config:
nano /etc/smokeping/config
Add the following line at the end:
@include /etc/smokeping/config.d/librenms.conf
Exit and save.
Smokeping and RRDCached
If you are using the standard smokeping data dir (/opt/smokeping/data) then you may need to alter the rrdcached config slightly.
In the standard configuration the -B argument may have been used to restrict rrdcached to read only from a single base dir.
If this is true, when you try an open one of the smokeping graphs from within LibreNMS you will see something like this error at the end of the rrdcached command:
ERROR: rrdcached: /var/lib/smokeping/<device name>.rrd: Permission denied
So you will need to either change the dir in which smokeping saves its rrd files to be the same as the main librenms dir or you can remove the -B argument from the rrdcached config to allow it to read from more than one dir.
To remove the -B switch:
sudo nano /etc/default/rrdcached
then find:
BASE_OPTIONS=
If -B is in the list of arguments delete it.
Configure LibreNMS
nano /opt/librenms/config.php
Scroll to the bottom, and paste in the following:
$config['smokeping']['dir'] = '/var/lib/smokeping';
$config['smokeping']['pings'] = 20; // should be equal to "pings" in your smokeping config
$config['smokeping']['integration'] = true;
Exit and save.
Run the following commands:
a2enconf smokeping
a2enmod cgid
service apache2 restart
service smokeping restart
Return to your normal user shell
exit
Done! You should be able to load the Smokeping web interface at http://yourhost/cgi-bin/smokeping.cgi
In LibreNMS, a Ping tab should also appear.