Annotation of nagios/check_bioctl/check_bioctl.html, Revision 1.4
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>
1.4 ! andrew 10: <p>check_bioctl also uses utils.pm from the Nagios Plugins package, so that needs to be installed.</p>
! 11: <p><center><b><a href='check_bioctl-1.9.tar.gz'>Download the current version here</a></b></center></p>
1.1 andrew 12: <h4>
13: Please be sure to support the <a href="http://www.openbsd.org">OpenBSD</a>
14: project by purchasing
15: <a href="http://www.openbsd.org/items.html">CDs</a>,
16: <a href="http://www.openbsd.org/tshirts.html">T-shirts</a>, or making a
17: <a href="http://www.openbsd.org/donations.html">donation</a>.
18: <br />
19: These finances ensure that OpenBSD will continue to exist, and
20: will remain <a href="http://www.openbsd.org/policy.html">free</a>
21: for everyone to use and reuse as they see fit.
22: </h4>
1.2 andrew 23: <pre>
1.1 andrew 24: check_bioctl plugin for Nagios monitors bioctl on OpenBSD
1.4 ! andrew 25: check_bioctl -d <device> [ -d <device2> [ -d ... ] ]
1.1 andrew 26:
27: Usage:
1.4 ! andrew 28: -d, --device=DEVICE
! 29: DEVICE to check. Can be any device that bioctl(8) accepts
! 30: -h (--help) usage help
! 31: -V (--version) version information
! 32:
! 33: check_bioctl v1.9
! 34: Copyright (c) 2009 Andrew Fresh <andrew@afresh1.com>
! 35: Permission to use, copy, modify, and distribute this software for any
! 36: purpose with or without fee is hereby granted, provided that the above
! 37: copyright notice and this permission notice appear in all copies.
1.1 andrew 38:
1.4 ! andrew 39: THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
! 40: WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
! 41: MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
! 42: ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
! 43: WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
! 44: ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
! 45: OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
1.2 andrew 46: </pre>
1.4 ! andrew 47: This is an example of what I have set up for NRPE. For checks on the machine running Nagios, use the _nagios user in /etc/sudoers instead of _nrpe, and of course, no /etc/nrpe.cfg.
1.2 andrew 48: <pre>
49: $ grep check_bioctl /etc/sudoers /etc/nrpe.cfg
50: /etc/sudoers:_nrpe ALL = NOPASSWD:/usr/local/libexec/nagios/check_bioctl -d ami0 -d ami1
51: /etc/nrpe.cfg:command[check_bioctl]=/usr/bin/sudo /usr/local/libexec/nagios/check_bioctl -d ami0 -d ami1
52: </pre>
1.1 andrew 53: </p>
1.4 ! andrew 54: <p>Andrew Fresh <<a href='mailto:andrew@afresh1.com'>andrew@afresh1.com</a>></p>
! 55: <p><small>$RedRiver: check_bioctl.html,v 1.3 2006/07/31 20:48:27 andrew Exp $</small></p>
1.1 andrew 56: </body>
57: </head>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>