packages: nagios-plugin-check_ipmi/check_ipmi, nagios-plugin-check_ipmi/nag...

[glen]

Author: glen                         Date: Thu Jan 13 14:39:46 2011 GMT
Module: packages                      Tag: HEAD
---- Log message:
- add README

---- Files affected:
packages/nagios-plugin-check_ipmi:
   check_ipmi (1.9 -> 1.10) , nagios-plugin-check_ipmi.spec (1.9 -> 1.10) , README (NONE -> 1.1)  (NEW)

---- Diffs:

================================================================
Index: packages/nagios-plugin-check_ipmi/check_ipmi
diff -u packages/nagios-plugin-check_ipmi/check_ipmi:1.9 packages/nagios-plugin-check_ipmi/check_ipmi:1.10
--- packages/nagios-plugin-check_ipmi/check_ipmi:1.9	Thu Jan 13 14:18:00 2011
+++ packages/nagios-plugin-check_ipmi/check_ipmi	Thu Jan 13 15:39:41 2011
@@ -49,7 +49,8 @@
 usage() {
 	cat >&2 <<EOF
 Usage: check_ipmi <filename>
-       check_ipmi -S <filename>
+       check_ipmi -i 'FAN.*' <filename>
+       check_ipmi -S
        check_ipmi -c
 
      <filename> indicates the cache file for speeding up sensor readings.
@@ -58,6 +59,8 @@
        Checks if ipmitool can be used on this system
     -S
        Install sudo rules
+    -i
+       grep extended regexp which sensors to ignore
 EOF
 }
 

================================================================
Index: packages/nagios-plugin-check_ipmi/nagios-plugin-check_ipmi.spec
diff -u packages/nagios-plugin-check_ipmi/nagios-plugin-check_ipmi.spec:1.9 packages/nagios-plugin-check_ipmi/nagios-plugin-check_ipmi.spec:1.10
--- packages/nagios-plugin-check_ipmi/nagios-plugin-check_ipmi.spec:1.9	Thu Jan 13 14:18:34 2011
+++ packages/nagios-plugin-check_ipmi/nagios-plugin-check_ipmi.spec	Thu Jan 13 15:39:41 2011
@@ -8,11 +8,13 @@
 Group:		Networking
 Source0:	%{plugin}
 Source1:	%{plugin}.cfg
+Source2:	README
 BuildRequires:	rpmbuild(macros) >= 1.552
 Requires:	grep
 Requires:	ipmitool
 Requires:	nagios-common >= 3.2.3-3
 Requires:	nagios-plugins-libs
+Requires:	sed
 Requires:	sudo
 BuildArch:	noarch
 BuildRoot:	%{tmpdir}/%{name}-%{version}-root-%(id -u -n)
@@ -28,6 +30,7 @@
 %prep
 %setup -qcT
 cp -p %{SOURCE0} %{plugin}
+cp -p %{SOURCE2} .
 
 ver=$(awk '/REVISION=/{print $3}' %{plugin})
 if [ "$ver" != %{version} ]; then
@@ -64,6 +67,7 @@
 
 %files
 %defattr(644,root,root,755)
+%doc README
 %attr(640,root,nagios) %config(noreplace) %verify(not md5 mtime size) %{_sysconfdir}/%{plugin}.cfg
 %attr(755,root,root) %{plugindir}/%{plugin}
 %ghost %{cachefile}
@@ -74,6 +78,9 @@
 All persons listed below can be reached at <cvs_login>@pld-linux.org
 
 $Log$
+Revision 1.10  2011/01/13 14:39:41  glen
+- add README
+
 Revision 1.9  2011/01/13 13:18:34  glen
 - requires grep
 

================================================================
Index: packages/nagios-plugin-check_ipmi/README
diff -u /dev/null packages/nagios-plugin-check_ipmi/README:1.1
--- /dev/null	Thu Jan 13 15:39:46 2011
+++ packages/nagios-plugin-check_ipmi/README	Thu Jan 13 15:39:41 2011
@@ -0,0 +1,56 @@
+check_ipmi
+
+Nagios plugin for locally checking hardware status (fans, voltage) via ipmi.
+It utilizes ipmitool to get results from kernel.
+
+Usage: check_ipmi <filename>
+       check_ipmi -i REGEXP <filename>
+       check_ipmi -S
+       check_ipmi -c
+
+<filename> points to a file which is used as a cache for speeding up the check.
+on first run the sdr cache is saved and UNKNOWN state is returned, not to lock
+up Nagios process.
+
+Option -c checks if ipmitool can be used on this system, tries to load kernel
+modules, make device nodes if missing.
+
+Option -S installs sudo rules so you could invoke the check from Nagios Nrpe.
+
+Option -i allows you to skip sensors which are not interesting to you, or who
+report bad status and you can't change tresholds.
+
+For example:
+# ipmitool  sdr get "Fan Block 3"
+Sensor ID              : Fan Block 3 (0xb)
+ Entity ID             : 3.2 (Processor)
+ Sensor Type (Analog)  : Fan
+ Sensor Reading        : 34.888 (+/- 0) unspecified
+ Status                : Lower Non-Critical
+ Positive Hysteresis   : Unspecified
+ Negative Hysteresis   : Unspecified
+ Minimum sensor range  : Unspecified
+ Maximum sensor range  : Unspecified
+ Event Message Control : Entire Sensor Only
+ Readable Thresholds   : No Thresholds
+ Settable Thresholds   : No Thresholds
+
+# ipmitool sensor thresh 'Fan Block 3' lower 1 20 30
+Locating sensor record 'Fan Block 3'...
+Setting sensor "Fan Block 3" Lower Non-Recoverable threshold to 1.000
+Error setting threshold: Invalid command
+Setting sensor "Fan Block 3" Lower Critical threshold to 20.000
+Error setting threshold: Invalid command
+Setting sensor "Fan Block 3" Lower Non-Critical threshold to 30.000
+Error setting threshold: Invalid command
+
+You would invoke check_ipmi as to exclude "Fan Block 1", "Fan Block 2", "Fan Block 3":
+check_ipmi check_ipmi.sdr -i 'Fan Block [123]'
+
+License: GPL v2
+Copyright (c) 2010, 2011 Elan Ruusamäe <glen at delfi.ee>
+
+Ported to POSIX shell by Elan Ruusamäe
+Original PHP version:
+http://git.op5.org/git/?p=nagios/op5plugins.git;a=blob_plain;f=check_ipmi.php;hb=HEAD
+Author: Hugo Hallqvist <dev at op5.com>
================================================================

---- CVS-web:
    http://cvs.pld-linux.org/cgi-bin/cvsweb.cgi/packages/nagios-plugin-check_ipmi/check_ipmi?r1=1.9&r2=1.10&f=u
    http://cvs.pld-linux.org/cgi-bin/cvsweb.cgi/packages/nagios-plugin-check_ipmi/nagios-plugin-check_ipmi.spec?r1=1.9&r2=1.10&f=u