$OpenBSD: README,v 1.2 2013/01/06 07:54:13 ajacoutot Exp $
+-----------------------------------------------------------------------
| Running ${FULLPKGNAME} on OpenBSD
+-----------------------------------------------------------------------
Basic configuration
===================
Symlink the sample apache config file into the modules directory:
# ln -s ../modules.sample/smokeping.conf /var/www/conf/modules/
Edit ${SYSCONFDIR}/smokeping/config (at least add some hosts to
monitor).
To have smokeping start at boot time, add "smokeping" to rc_scripts
in /etc/rc.conf.local, e.g.:
rc_scripts="${rc_scripts} smokeping"
To use probes other than the most common fping probe, you may need to
install additional packages:
RADIUS: p5-Authen-Radius
TelnetIOSPing: p5-Net-Telnet
OpenSSHJunOSPing: p5-Net-OpenSSH
AnotherDNS: p5-Net-DNS
LDAP: p5-ldap (and p5-IO-Socket-SSL for starttls)
chroot considerations
=====================
By default OpenBSD's httpd uses chroot(2) so that only files
within /var/www are accessible; this doesn't work with smokeping's
CGI scripts (at least without major work copying large parts of
Perl and Smokeping into the chroot jail). Simpler options are:
- Disable chroot by setting httpd_flags="-u" in /etc/rc.conf.local
- Create static HTML and images rather than allowing them to be
viewed/zoomed; do this by running 'smokeping --static=/path/to/html-dir'
from cron.
Alternatively, Smokeping now uses FastCGI, so it would be possible
to pass the requests across from a jailed httpd to a copy of Smokeping
running outside the jail. Please contact the port maintainer if you
have a working configuration for this which you would be willing to
share.
Remote sensors
==============
This feature requires that the userid running the webserver is
able to create new .cache files and write to existing .rrd files
under /var/db/smokeping. After adjusting the configuration file
and starting smokeping to generate the rrd files, adjust the
group ownership and permissions accordingly, e.g.
# chgrp -R www /var/db/smokeping/*
# chmod -R g+rwX /var/db/smokeping/*
This will need to be repeated if additional hosts are monitored
via remote sensors.
