Annotation of nagios/check_bioctl/check_bioctl.html, Revision 1.2
1.1 andrew 1: <html>
2: <head>
3: <title>Nagio Check - check_bioctl</title>
4: </head>
5: <body>
6: <h1>Nagios Check - check_bioctl</h1>
1.2 ! andrew 7: <p>The check_bioctl plugin for <a href="http://www.nagios.org">Nagios</a> monitors RAID arrays on <a href="http://www.openbsd.org">OpenBSD</a> using <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=bioctl">bioctl</a>.</p>
! 8: <p>The only real caveat with it is that bioctl needs rw permission to /dev/bio. The way I allow for that is by adding an entry to /etc/sudoers and then making the check run <code>sudo check_bioctl</code>. </p>
! 9: <p>I wrote this on OpenBSD 3.9 and tested on Dell PERC 3/DC controllers using the ami driver. It should work just fine on other versions of OpenBSD as well as with other cards and drivers. If you do run into trouble, send me the output from bioctl on the system you are having trouble with and I can try to help. Patches to fix problems would be even better.</p>
! 10: <p>check_bioctl also uses utils.pm from the <a href="http://www.openbsd.org/3.9_packages/i386/nagios-plugins-1.4.2.tgz-long.html">Nagios Plugins</a> package, so that needs to be installed.</p>
1.1 andrew 11: <p>TODO:
12: <ul>
1.2 ! andrew 13: <li>real documentation.</li>
1.1 andrew 14: </ul>
15: </p>
16: <p><center><b><a href='check_bioctl-1.3.tar.gz'>Download the current version here</a></b></center></p>
17: <h4>
18: Please be sure to support the <a href="http://www.openbsd.org">OpenBSD</a>
19: project by purchasing
20: <a href="http://www.openbsd.org/items.html">CDs</a>,
21: <a href="http://www.openbsd.org/tshirts.html">T-shirts</a>, or making a
22: <a href="http://www.openbsd.org/donations.html">donation</a>.
23: <br />
24: These finances ensure that OpenBSD will continue to exist, and
25: will remain <a href="http://www.openbsd.org/policy.html">free</a>
26: for everyone to use and reuse as they see fit.
27: </h4>
1.2 ! andrew 28: <pre>
1.1 andrew 29: check_bioctl plugin for Nagios monitors bioctl on OpenBSD
30: check_bioctl -d <device> [ -d <device2> [ -d ... ] ]
31:
32: Usage:
33: -d, --device=DEVICE
34: DEVICE to check. Can be any device that bioctl(8) accepts
35: -h, --help usage help
36: -V, --version version information
37:
38: check_bioctl (nagios-plugins 1.4.2) 1.3
39: The nagios plugins come with ABSOLUTELY NO WARRANTY. You may redistribute
40: copies of the plugins under the terms of the GNU General Public License.
41: For more information about these matters, see the file named COPYING.
1.2 ! andrew 42: </pre>
! 43: This is an example of what I have set up for <a href="http://www.openbsd.org/3.9_packages/i386/nrpe-2.3.tgz-long.html">NRPE</a>. For checks on the machine running Nagios, use the _nagios user in /etc/sudoers instead of _nrpe, and of course, no /etc/nrpe.cfg.
! 44: <pre>
! 45: $ grep check_bioctl /etc/sudoers /etc/nrpe.cfg
! 46: /etc/sudoers:_nrpe ALL = NOPASSWD:/usr/local/libexec/nagios/check_bioctl -d ami0 -d ami1
! 47: /etc/nrpe.cfg:command[check_bioctl]=/usr/bin/sudo /usr/local/libexec/nagios/check_bioctl -d ami0 -d ami1
! 48: </pre>
1.1 andrew 49: </p>
1.2 ! andrew 50: <p>Andrew Fresh <<a href='mailto:andrew@mad-techies.org'>andrew@mad-techies.org</a>></p>
! 51: <p><small>$RedRiver: check_bioctl.html,v 1.1 2006/07/28 00:04:33 andrew Exp $</small></p>
1.1 andrew 52: </body>
53: </head>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>