[BACK]Return to check_bioctl.html CVS log [TXT][DIR] Up to [local] / nagios / check_bioctl

Diff for /nagios/check_bioctl/check_bioctl.html between version 1.3 and 1.7

version 1.3, 2006/07/31 21:48:27 version 1.7, 2017/02/08 17:36:04
Line 4 
Line 4 
         </head>          </head>
         <body>          <body>
                 <h1>Nagios Check - check_bioctl</h1>                  <h1>Nagios Check - check_bioctl</h1>
                 <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>                  <h3>check_bioctl - checks status of a RAID array using bioctl</h3>
                 <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>  
                 <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>                  <p>This check is for OpenBSD machines with bioctl(8) supported RAID cards.
                 <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>  
                 <p>TODO:                  <p>
                 <ul>                  The only real caveat with it is that bioctl needs rw permission to
                         <li>real documentation.</li>                  /dev/bio. One way to allow for that is by adding an entry to
                 </ul>                  /etc/doas.conf.
                 </p>                  </p>
                 <p><center><b><a href='check_bioctl-1.4.tar.gz'>Download the current version here</a></b></center></p>  
                 <h4>  
                         Please be sure to support the <a href="http://www.openbsd.org">OpenBSD</a>  
                         project by purchasing  
                         <a href="http://www.openbsd.org/items.html">CDs</a>,  
                         <a href="http://www.openbsd.org/tshirts.html">T-shirts</a>, or making a  
                         <a href="http://www.openbsd.org/donations.html">donation</a>.  
                         <br />  
                         These finances ensure that OpenBSD will continue to exist, and  
                         will remain <a href="http://www.openbsd.org/policy.html">free</a>  
                         for everyone to use and reuse as they see fit.  
                 </h4>  
                 <pre>  
 check_bioctl plugin for Nagios monitors bioctl on OpenBSD  
         check_bioctl -d &lt;device&gt; [ -d &lt;device2&gt; [ -d ... ] ]  
   
 Usage:                  <p>
         -d, --device=DEVICE                  This is an example of a setup for NRPE. For checks on the machine running
                 DEVICE to check.  Can be any device that bioctl(8) accepts                  Nagios, use the _nagios user in /etc/doas.conf instead of _nrpe, and of course,
         -h, --help       usage help                  no ${SYSCONFDIR}/nrpe.cfg. check_bioctl runs bioctl once for each device, so
         -V, --version    version information                  you will need a doas.conf entry that matches each device you wish to check. If
                   you have multiple RAID volumes, you'll need one permit rules per volume.
                   </p>
   
 check_bioctl (nagios-plugins 1.4.2) 1.4  <pre>
 The nagios plugins come with ABSOLUTELY NO WARRANTY. You may redistribute  /etc/doas.conf:
 copies of the plugins under the terms of the GNU General Public License.  permit nopass _nrpe as root cmd /sbin/bioctl args ami0
 For more information about these matters, see the file named COPYING.  permit nopass _nrpe as root cmd /sbin/bioctl args ami1
                 </pre>  </pre>
                 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.  
                 <pre>  <pre>
 $ grep check_bioctl /etc/sudoers /etc/nrpe.cfg  ${SYSCONFDIR}/nrpe.cfg:
 /etc/sudoers:_nrpe   ALL = NOPASSWD:/usr/local/libexec/nagios/check_bioctl -d ami0 -d ami1  command[check_bioctl]=${PREFIX}/libexec/nagios/check_bioctl -d ami0 -d ami1
 /etc/nrpe.cfg:command[check_bioctl]=/usr/bin/sudo /usr/local/libexec/nagios/check_bioctl -d ami0 -d ami1  </pre>
                 </pre>  
                   <p>
                   For more information on
                   <a href="http://man.openbsd.org/bioctl.8">bioctl(8) see the OpenBSD man page</a>.
                 </p>                  </p>
                 <p>Andrew Fresh &lt;<a href='mailto:andrew@mad-techies.org'>andrew@mad-techies.org</a>&gt;</p>  
                 <p><small>$RedRiver: check_bioctl.html,v 1.2 2006/07/29 00:05:24 andrew Exp $</small></p>                  <p>
                   <a href="check_bioctl-1.22.tar.gz">Download v1.22</a>
                   </p>
         </body>          </body>
 </head>  </head>
Legend:
Removed from v.1.3  
changed lines
  Added in v.1.7
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>