4 * Added a new option '--hide-servicetag' to censor the servicetag in
5 the plugin output. A corresponding config file option
6 'output_hide_servicetag' was created. Thanks to Sebastian Ahndorf
8 * SNMP: Fixed bug in amperage probes perfdata output when one or more
9 PSUs has lost power, which could cause garbled graphs.
14 * Added new blacklisting keyword 'pdisk_foreign' to suppress warnings
15 about foreign physical disks
16 * SNMP: Get the controller number right when reporting issues with the
17 controller cache battery
18 * Various minor tweaks and bugfixes in the PNP4Nagios template
23 * Major overhaul of the perfdata code. This includes API breakage and
25 - Probes were not sorted correctly
26 - Voltage data was not included
27 * The PNP template check_openmanage.php has been redone to work with
28 the changes in perfdata output from the plugin
29 * A new option '--legacy-perfdata' will make the the plugin output the
30 performance data in the old format
31 * Added support for a configuration file
32 * Added manual page for the configuration file
33 * If using html output, URLs will now open in a new window
34 * Added a compatibility fix for OMSA 6.5.0, related to performance
35 data for amperage probes when the plugin is used in local
36 mode. Thanks to Benedikt Meyer for a patch.
41 * Added workaround for a rare condition in which blade detection fails
42 because the chassis IDs for the blade and interconnect board have
43 switched places in the BaseBoardType SNMP table.
48 * A regression wrt. non-certified drives were fixed. The plugin failed
49 to identify non-certified physical drives via SNMP.
50 * Added the ability to blacklist non-certified drives with the
51 'pdisk_cert' blacklisting keyword.
56 * Fixed typo in help output
57 * SD card check is now included if the parameter '--only chassis' is
59 * The plugin will issue a proper warning if a physical drive is
60 uncertified, instead of an unspecified warning. One or more
61 uncertified drives will make the controller go into a non-critical
63 * Slightly improved reporting of fan status
64 * Exit with value 3 (unknown) if printing debug, help or version
65 info. This is considered best practice for Nagios plugins.
66 * Workaround added for logical SAS connectors to external storage
67 enclosures, when using check_openmanage in local mode with OMSA
68 6.4.0 or later versions. The output from omreport could contain
69 lines that the plugin was unable to parse, which would lead to
75 * Fix counting of components when blacklisting is used. Components
76 should be counted even if blacklisted
77 * Added some unsupported vdisk types to the list. The OMSA MIB
78 identifies these, but lists them as unsupported.
79 * Added option '-B' or '--show-blacklist' to show any blacklistings in
81 * Fixed a bug for checking voltage probes, if the reading is missing
83 * Fixed a regression bug for a power monitoring corner case.
88 * Added more robustness wrt. values from OMSA obtained via SNMP, to
89 avoid internal errors where non-important values are missing.
94 * A few compatibility fixes for OMSA 6.4.0 were added.
99 * Added support for IPv6 when checking via SNMP. IPv6 can be turned on
100 with the option '-6' or '--ipv6'. The default is IPv4 if the option
102 * Added support for TCP when checking vis SNMP. The option '--tcp' can
103 be used to turn on TCP. The default transport protocol is UDP if the
104 option is not present.
105 * The mode of operation (local or SNMP) is shown in the debug
106 output. If SNMP is used, the debug output will also show the SNMP
107 protocol version, IP version and transport protocol (UDP or TCP).
108 * Amperage probe status via SNMP is of type "probe status", not
109 regular status. This has been fixed.
110 * Massive overall robustness improvements to handle OMSA bugs where
111 some information from OMSA is missing.
112 * Memory module enumeration via SNMP changed somewhat to reflect
113 enumeration provided by omreport. This ensures that the plugin's
114 output is identical in SNMP or local mode wrt. dimms IDs.
115 * Fan enumeration via SNMP changed somewhat to reflect enumeration
116 provided by omreport. This ensures that the plugin's output is
117 identical in SNMP or local mode wrt. fan IDs.
122 * Included new check for SD cards. Newer servers such as the R710 can
123 have SD cards installed, these should be monitored. The SD card
124 check is on by default. A new blacklisting keyword 'sd' has been
125 added. The SD card check can be turned off with '--check sdcard=0'.
126 * Handle special cases where power monitoring capability is disabled
127 due to non-redundant and/or non-instrumented power supplies.
128 * For physical disks probed via SNMP, check that values for vendor,
129 product ID and capacity is available before attempting to display
131 * If a physical disk is in sufficiently bad condition, the vendor
132 field reported by OMSA may be empty. The plugin now handles this
133 situation without throwing an internal error.
139 * Storage is no longer allowed to be absent. If the plugin doesn't
140 find a storage controller, it will give an alert. For diskless
141 systems or servers without a Dell controller that OMSA recognizes
142 you will now have to specify '--no-storage' or '--check storage=0'
144 * Report the system revision (if applicable) wherever the model name
145 is printed. E.g. "PowerEdge 2950 III" instead of "PowerEdge 2950".
146 * Small change in search path for omreport: The new location for OMSA
147 6.2.0 and later on Linux will be attempted first.
148 * Small bugfix for the '--check' parameter, if the argument is a
149 filename. The file could not contain a linebreak, this has been
151 * Added an option '--no-storage', which is equivalent to the general
152 option '--check storage=0'.
158 * If a physical disk is a hot spare, display this information in
160 * Report the bus protocol (e.g. SAS, SATA) and media type (e.g. HDD,
161 SDD) for physical disks in the debug output, if applicable
162 * Minor fix for 100GB physical disks, write "100GB" instead of "99GB"
163 * SNMP: Use new features of OMSA 6.3.0 to display occupied and total
164 slots in storage enclosures, if applicable. This information is not
165 available with omreport and check_openmanage will not display this
167 * SNMP: Added new processor IDs from the OMSA 6.3.0 MIBs
168 * SNMP: Use connection tables in a proper way to determine controller
169 and enclosure IDs, for use with physical disks and enclosure
170 components (fan, temp sensors etc.). This fixes a long standing bug
171 for servers with more than one controller, if checked via SNMP.
172 * SNMP: Use the nexus ID as last resort to find the controller for
173 physical disks. Workaround for older, broken OMSA versions.
174 * SNMP: Identify enclosures (e.g. '2:0:0') properly so that the
175 reporting with SNMP corresponds to the same report with omreport.
176 * SNMP: added a couple of workarounds for pre-historic OMSA versions
182 * More fine-grained reporting of temperature warnings for enclosure
184 * Max/min temperature limits for enclosure temp probes are reported in
186 * Report enclosure temperature probes that are "Inactive" as ok
187 * Don't try to print out the reading of enclosure temperature probes
188 if the reading doesn't exist or is not an integer
189 * Report enclosure EMMs that are "Not Installed" as ok, instead of
191 * Corrected typo in the PNP4Nagios template
197 * Remove reporting of which controller a logical drive is "attached"
198 to, since this information can't be reliably extracted via SNMP.
199 * Avoid collecting Lun ID via SNMP for virtual disks, we don't use it
200 * Report total memory and number of dimms in the ok output
201 * Difference in reporting if amperage probes have discrete readings
202 * Workaround for broken amperage probes
203 * Added workaround for bad temperature probes that yields no reading
205 * Get OMSA version via SNMP slightly more efficiently
211 * Added robustness for received SNMP values that are not defined in
212 the MIB. Instead of throwing a perl warning when this happens, the
213 plugin will not report the undefined value.
214 * Defined "Replacing" as a defined state for physical disks in SNMP
215 mode, even though this state is not defined in the MIB. It is
216 reported as such by omreport.
217 * Physical disk brand/model is now reported when the state of the disk
218 is "Rebuilding" or "Replacing".
219 * The state of a physical disk is reported in parentheses when
220 predictive failure is detected. It is useful to know if a disk is
221 online, offline, spare or even failed when predictive failure is
223 * Handling of physical disk predictive failure has been improved
225 * Refactoring of the perfdata code. In conformance with the plugin
226 development guidelines, the UOM (unit of measure) previously
227 reported in the perfdata output has been removed.
228 * The -p or --perfdata option now
229 takes an optional agrument 'minimal', which triggers shorter names
230 for the perfomance data labels. This shortens the output and is a
231 workaround for systems where the amount of output exceeds the 1024
233 * The PNP4Nagios template has been updated. Users of check_openmanage
234 and PNP4Nagios are advised to upgrade. This version of
235 check_openmanage needs the new template.
236 * Lots of other small improvements and updates.
242 * New option '--use-get_table' is added as a workaround for SNMPv3 on
243 Windows using net-snmp. This option will make check_openmanage use
244 the Net::SNMP function get_table() instead of get_entries() to
245 collect information via SNMP.
246 * Include a blacklisting option 'ctrl_pdisk' which takes the
247 controller number as argument. This blacklisting option only works
248 with omreport and is a workaround for broken disk firmwares that
249 contain illegal XML characters. These characters makes openmanage
250 barf and exit with an error. Patch from Bas Couwenberg.
251 * If the blacklisting keyword "all" is supplied for a component type,
252 that component type is not checked at all, i.e. the commands are
253 never executed. This will make check_openmanage execute faster if
254 blacklisting is heavily used.
255 * Option '--htmlinfo' now has a shorter equivalent '-I'
256 * The option '--short-state' now has a shorter equivalent '-S'
262 * Fixed an SNMP bug where the plugin didn't handle OID indexes that
263 were not sequential. Thanks to Gianluca Varenni for reporting.
264 * Fixed an SNMP bug when checking old hardware such as the PE 2650 and
265 PE 750. The controller id for physical drives were collected and
266 displayed incorrectly. This release uses an additional OID to fetch
267 this info, which would otherwise be unavailable. Thanks to Gianluca
268 Varenni for reporting this bug.
269 * Should use %snmp_probestatus, not %snmp_status when checking the
270 status of voltage probes. Thanks to Ken McKinlay for a patch.
271 * Fix when identifying blades via SNMP with very old OMSA
272 versions. Patch from Ken McKinlay.
273 * Better way of finding the ID of physical drives via SNMP
279 * Added support for storport driver version for controllers, only
280 applicable on servers running Windows. A new blacklisting keyword
281 for suppressing storport driver messages was added.
282 * The "all" keyword in blacklisting is now case insensitive.
283 * More fine-grained reporting in the rare case where a controller
284 battery fails during learning and charging states.
285 * New improved way of reporting perl warnings during execution of the
292 * Fix for path to omreport on Linux with OMSA 6.2.0
293 * A couple of other small fixes
299 * Fix for undefined device name for logical drives (thanks to Pontus
301 * Fixed a bug in the PNP4Nagios template, that prevented the template
302 from working with PNP4Nagios 0.6. Thanks to the PNP4Nagios team for
309 * CPU type, family etc. are now reported in case of a CPU failure (and
311 * The debug output now reports Openmanage version and plugin version
317 * New option '-a' or '--all' turns on checking of everything
318 * The manual page (POD info) is removed from the script and is now in
319 a separate file, to make check_openmanage fully ePN compatible
320 * ePN is no longer disabled by default, check_openmanage no longer has
321 an opinion on whether it should run under ePN or not
322 * The '-m' or '--man' option is no longer available
323 * The option '-v' or '--verbose' is renamed to '-d' or '--debug',
324 which makes more sense wrt. its usage
325 * The '-g' or '--global' option is removed. Checking the global health
326 status is now default if applicable
327 * Checking intrusion detection is now turned on by default
328 * The obsolete option '--snmp' is removed
329 * The option '--state' now has a shorter equivalent '-s'
330 * The basename stuff and options '--only-critical' and
331 '--only-warning' are now replaced by an option '--only'
332 * If plugin is run by Nagios, redirect stderr to stdout
333 * Added option '--omreport', that lets the user specify the full path
334 to the omreport binary
335 * Added non-8bit-legacy default search paths for omreport.exe for
337 * Minor changes to the plugin output, for consistency
338 * New blacklisting keyword 'bat_charge' disables warning messages
339 related to controller cache battery charging. Thanks to Robert
340 Heinzmann for a patch.
341 * For blacklisting, the component ID kan now be "ALL", in which all
342 components of that type is blacklisted.
343 * Man page is moved to manual section 8
349 * Fixed a bug that could cause errors and weird results when checking
350 cooling devices (fans) via SNMP. Thanks to Ken McKinlay for spotting
351 this bug and reporting it.
356 * For failed physical drives, check_openmanage will now output the
357 drive's vendor, model and size in GB or TB.
362 * The -s|--snmp option was redundant and no longer does anything. SNMP
363 is triggered automatically if the -H|--hostname option is
364 present. The -s|--snmp option is kept for compatibility, but has no
370 * Added support for performance data (temperatures) from attached
371 storage enclosures such as the MD1000
376 * Fixed a regression in the --htmlinfo option when it is not supplied
382 * New option --htmlinfo adds clickable HTML links in the plugin's
388 * Fixed a regression bug in CPU and power supply reporting that only
389 affects verbose output
390 * If blacklisting is used, the global health check (via the --global
391 option) is now negated. Checking the global health doesn't make
392 sense when one or more components is blacklisted. Thanks to Rene
393 Beaulieu for reporting this bug
394 * The PNP4Nagios template is now included in the tarball and zip
400 * Improved memory error reporting, when using omreport
401 * Collect performance data from pwrmonitoring (amperage probes) that
402 were previously ignored when using omreport
407 * Improved memory error reporting, when using SNMP
408 * Other small ehnancements
413 * The plugin is now compatible with the Nagios embedded Perl
414 interpreter (ePN) in theory. However, the plugin will not not use
415 ePN by default. We don't want any "accidents".
416 * License is now GPLv3, previously only specified as "GPL"
417 * New options --only-critical and --only-warning. With these options
418 the plugin will only print critical or warning alerts, respectively.
419 * Bugfixes and speed enhancements in the storage section, when
420 checking enclosure components via omreport
421 * The --okinfo option is now less verbose and more to the point
422 * Lots of code refactoring for readability, maintainability and
428 * Fixed a bug in the storage section, when checking controllers. This
429 is an obscure bug that only manifests itself in the odd case where a
430 server has multiple controllers, and one of the controllers are
431 missing some of the OIDs, in which case these OIDs will be missing
432 for the other controllers as well. The change is minor and only
433 includes using get_table() instead of get_entries() to collect the
434 SNMP result. Thanks to Stephan Bovet for reporting this bug.
439 * The --perfdata option can now optionally take an argument
440 "multiline", which makes the plugin produce multiline performance
441 data output in a Nagios 3.x way. Not really needed, but the plugin
443 * Added comment within the 10 first lines to disable the nagios
444 embedded perl (ePN) interpreter by default for Nagios 3.x
445 * Improvements in the performance data output. Units are now included
450 * Added --global option, which turns on checking of everything. If
451 used with SNMP, the global system health status is also probed, to
452 protect the user against bugs in the plugin. If used with omreport,
453 the overall chassis health is used.
454 * Support for SNMP version 3
455 * New check added: esmhealth. This checks the overall health of the
456 ESM log, i.e. the fill grade. More than 80% means a warning message
457 * Fixed alert log reporting to use the same format as for the ESM log
458 * Output messages are now sorted by severity
459 * Minor changes in how out-of-date controller firmware/driver is
461 * Code refactoring and cleanup
466 * Use "omreport about" to collect OMSA version. Slightly faster than
467 "omreport system version". This should give a small speedup in
468 certain configurations
469 * Fixed typo in output when a logical drive is rebuilding. Thanks to
470 Andreas Olsson for reporting
471 * Improved reporting of ESM log content
472 * Added omreport.sh as alternate omreport path
473 * Lots of other small fixes and enhancements
475 Plus: A few changes to make the plugin work with old PowerEdge models
476 (e.g. 2550, 2450) and/or old OMSA versions (e.g. version 4.5):
478 * Use the chassisModelName OID to determine if SNMP works (instead of
480 * No longer require a response when checking baseboard type via
481 SNMP. If there is no response, we assume that we're not dealing with
484 Thanks to Christian McHugh for help with testing and debugging this
490 * Use 'omreport system operatingsystem' to collect OS info, instead of
491 'omreport system' version which is incredibly slow. This should speed
492 things up in certain configurations.
493 * A few speedups, don't collect information that isn't needed
499 * New option --linebreak to specify the separator between line in case
501 * Added support for 64bit Windows. Thanks to Patrick Hemmen for a patch
502 * [Patrick Hemmen] Added install.bat for Windows installation
503 * [Patrick Hemmen] Improvements on install.sh. Will now install in
504 /usr/lib64 for x86_64
505 * RPMs are now architecture dependent, because of different libdir
510 * New option -o|--ok-info to display extra information when everything
511 is ok. The plugin can now display storage firmware and driver info,
512 DRAC and BMC firmware, and OMSA version
513 * Support for setting custom minimum temperature thresholds via the
514 -c|--critical and -w|--warning options
515 * Better and more detailed temperature error reporting
516 * Bugfix in the amperage report (including performance data). The
517 plugin now takes into account the correct unit and measurement for
518 amperage probes (other than watts)
519 * New option --port lets the user specify the remote SNMP port number
524 * Regression fix: Use the older Processor Device SNMP OIDs for older
525 PowerEdge models, that don't have the new Processor Device Status
526 OIDs. Thanks to Nicole Hähnel for reporting this bug.
527 * Default output (when there are no alerts) now shows RAC firmware,
528 BMC firmware, info about controllers and enclosures (firmware,
534 * Regression fix: Ignore unoccupied CPU slots with SNMP probing. This
535 fixes a bug introduced in versjon 3.2.1, which would output
536 something like this if one or more CPU slots were empty: CPU 1 needs
542 * Use Processor Device Status Table OIDs instead of Processor Device
543 Table when checking CPUs via SNMP
544 * Bugfix: don't report throttled CPUs as warnings when checking via
545 SNMP (same as for checking locally)
550 * New options --state and --short-state for displaying service state
552 * Lots of small fixes for code readability and maintainability
557 * Support for running natively on Windows (using omreport.exe). Thanks
558 to Peter Jestico for a patch.
559 * Support for compiled Windows version, i.e. check_openmanage.exe is
560 now a legal script name.
561 * Exit with error if script basename is illegal/unknown
562 * Various small fixes
567 * Use of alternate basenames for checking only one class of components
568 * Added support for checking the ESM log via SNMP
569 * Code refactoring for robustness and maintainability
570 * Numerous small fixes and enhancements
571 * Added install script in distribution tarball
576 * The script no longer aborts if it can't get system information via
577 SNMP. Give a warning instead, as this is not a critical error
578 * Increased robustness when checking controllers
583 * Man page fix in the 'check' section. Thanks to Ansgar Dahlen for
585 * Allow invalid command error from 'omreport chassis pwrmonitoring'
586 * Various small fixes
591 * Use unique IDs for storage components with regard to blacklisting,
592 which means that the blacklisting API has changed
593 * Added checks for storage components: connectors (channels),
594 enclosures, enclosure fans, enclosure power supplies, enclosure
595 temperature probes and enclosure management modules (EMMs)
596 * Improved verbose output
597 * New option -t|--timeout for setting the plugin timeout
598 * New option -w|--warning for setting custom temperature warning
600 * New option -c|--critical for setting custom temperature critical
602 * Option --check can no longer be specified in its short form (-c)
603 * Code cleanup and improvements
608 * The workaround for the OMSA bug introduced in OMSA 5.5.0 didn't take
609 multiple controllers into account. This has been fixed.
614 * New option -i|--info prefixes all alerts with the service tag
615 * New option -e|--extinfo gives and extra line of output in case of an
616 alert (model and service tag)
617 * New option --postmsg lets the user specify a post message string,
618 with info such as model, service tag etc.
619 * Options -b|--blacklist and -c|--check can now be specified multiple
620 times (actually quite useful)
625 * Slightly improved output for alerts on logical drives (vdisks)
626 * Now shows a rebuilding physical disk as a warning, as this is
627 usually accompanied by a degraded vdisk. Previous versions didn't
628 show this at all (omreport classifies it as "OK").
633 * Slightly improved output for charging controller batteries
638 * Bugfix for reporting physical drives with predictive failure (both
644 * Fix bug in option handling (ambiguous options)
645 * Slightly improved output if checking the storage subsystem is turned
647 * Don't complain if there are no logical drives. This is OK. Thanks to
648 Jamie Henderson for reporting this
653 * Fix bug in SNMP status level table
658 * Added workaround for a BUG introduced in OpenManage 5.5.0. OM
659 sometimes adds a newline in the controller driver version name,
660 which leads to problems parsing the output. Thanks to Hiren Patel
661 for bringing this to my attention.
666 * (snmp) Improved handling of cases where OM is not working properly
671 * Fixed issue where controller number for physical disks can't be
672 established via SNMP (now identifies as controller no. -1)
677 * Correctly identifies and reports error condition in which OpenManage
678 has stopped working (it happens)
684 * Same options for checking, blacklisting etc. supported with SNMP
685 * Same output with SNMP as with NRPE
690 * Collects performance data if the option '-p' or '--perfdata' is
692 * New blacklisting directives ctrl_fw and ctrl_driver
693 added. Suppresses the "special" warning messages concerning outdated
694 controller firmware and driver. Useful if you can't or won't
700 * Fix getting system model and serial number for newer blades
705 * Three new checks added:
706 - System battery probes (typical CMOS battery). Newer poweredge
708 - Power consumption monitoring (if the server supports it)
709 - ESM log, with same functionality as the alert log check. Disabled
715 * Internal refactoring: use ssv-formatted output from openmanage,
716 resulting in slightly faster execution and increased robustness.
717 * If /usr/bin/omreport doesn't exist, try
718 /opt/dell/srvadmin/oma/bin/omreport.
719 * Allow for no instrumented/redundant power supplies. Needed on
720 low-end poweredge models and blades.
725 * Openmanage reports non-critical warning about throttled CPUs on new
726 hardware models. Most og us use ondemand CPU frequency scaling (with
727 throttled CPUs as a result). This specific non-critical warning (CPU
728 Throttled) is ignored from now on.
729 * Remove superfluous Celcius sign when reporting temperatures.
734 * Accommodate blade systems with no fans or powersupplies, i.e. accept
735 errors from omreport when trying to check fans or powersupplies on
737 * Accommodate newer hardware with slightly different omreport
738 options. Use the newer options if they exist. Not really necessary
739 yet, but deprecated options may be removed in future versions of
745 * When everything is OK, check_openmanage now outputs the same info as
746 Gerhard Lausser's excellent check_hpasm plugin does for HP servers:
748 OK - System: 'poweredge 2850', S/N: 'XXXXXXX', ROM: 'A06
749 10/03/2006', hardware working fine, 2 logical drives, 4 physical