66 lines
2.1 KiB
Plaintext
66 lines
2.1 KiB
Plaintext
$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.
|