check_ipmi_sensor version 1.3 20110111
Copyright (C) 2009-2010 Thomas-Krenn.AG (written by Werner Fischer)

Usage: check_ipmi_sensor -H <hostname> [-I lan|lanplus] [-L <privilege level>]
                         -U <username> -P <password>|-f <password_file>
                         -T <sensor type>|-t <SDR type> [-x <sensor name>]
                         [-v 1|2|3] [-h] [-V]

Options:
  -H <hostname>
         hostname or IP of the IPMI interface
         if given as "localhost", username/password are not needed
  [-I lan|lanplus]
         lan ...... uses unencrypted lan interface
         lanplus .. uses encrypted lanplus interface (default)
  [-L CALLBACK|USER|OPERATOR|ADMINISTRATOR]
         force IPMI session privilege level,
         can be CALLBACK, USER, OPERATOR, ADMINISTRATOR,
         default is ADMINISTRATOR,
         for a higher security it is recommended to configure a dedicated IPMI
         user with limited privileges (USER privilege level) and to use this
         option with the parameter '-L USER'
  -U <username>
         IPMI username
  -P <password>
         IPMI password
  -f <password_file>
         file containing the IPMI password,
         in this way the password will not be visible in the process list,
         limit access to this file, e.g. by 'chmod 640', 'chown root.nagios'
  -T <sensor type>
         limit sensors to query based on IPMI sensor type
         examples for IPMI sensor type are 'Fan', 'Temperature', 'Voltage', ...
         see chapter '42.2 Sensor Type Codes and Data' of the IPMI 2.0 spec or
         'ipmitool sdr type list' for a full list of possible sensor types,
         the available types depend on the particular server and the
         available sensors there, see 'ipmitool sdr elist all' for a list
         containing all sensor and locator records of your server;
         if you want to limit sensors to query based on IPMI SDR type,
         use the -t option instead
  -t <SDR type>
         limit sensors to query based on IPMI SDR type
         SDR types can be (taken from 'man ipmitool'):
           all ...... All SDR records (Sensor and Locator)
           full ..... Full Sensor Record
           compact .. Compact Sensor Record
           event .... Event-Only Sensor Record
           mcloc .... Management Controller Locator Record
           fru ...... FRU Locator Record
           generic .. Generic SDR records
         Hint: use 'all' to query all of your sensors with a single query
         For more details see (in German):
           http://www.thomas-krenn.com/de/wiki/Ipmitool_zur_Sensorabfrage_von_Servern_nutzen#ipmitool_sdr_type_TYPE
           http://www.thomas-krenn.com/de/wiki/Ipmitool_zur_Sensorabfrage_von_Servern_nutzen#ipmitool_sdr_list.7Celist
         if you want to limit sensors to query based on IPMI sensor type,
         use the -T option instead
  [-x <sensor name>]
  	 exclude sensor matching <sensor name>. Usefull for cases, where unused
         sensors can't be deleted from SDR and are reported in a non-OK state.
  	 Option can be specified multiple times.
  [-v 1|2|3]
         be verbose
         (no -v) .. single line output
         -v 1 ..... single line output with additional details for warnings
         -v 2 ..... multi line output, also with additional details for warnings
         -v 3 ..... debugging output, followed by normal multi line output
  [-h]
         show this help
  [-V]
         show version information

This plugin checks all IPMI sensors of a given type of a server remotely (or
locally if "-H localhost" is used.
You can use the sensor type (-T) or the SDR type (-t) to limit the sensors you
wand to query. As soon as at least one of the monitored sensors has a status
other than 'ok' or 'ns' the plugin reports a warning.
For a given server the plugin can be used in one of the following ways:
  - one service check for a given server (using '-t all')
  - multiple service checks (configured with an individual service check for
    each sensor type (-T) or SDR type (-t) that you want to monitor)

Examples: the following examples show the use of different sensor types for an
          Intel SR2500 server system. As multiple sensor types are available in
          this server you can configure multiple service checks, executing the
          plugin with the following parameters (in this example 192.168.1.211 is
          the IP of the IPMI BMC of the server, 'monitor' the username, and
          'relation' the password):
check_ipmi_sensor -H 192.168.1.211 -L USER -U monitor -P relation -T Temperature
check_ipmi_sensor -H 192.168.1.211 -L USER -U monitor -P relation -T Voltage
check_ipmi_sensor -H 192.168.1.211 -L USER -U monitor -P relation -T Current
check_ipmi_sensor -H 192.168.1.211 -L USER -U monitor -P relation -T Fan
check_ipmi_sensor -H 192.168.1.211 -L USER -U monitor -P relation -T 'Physical Security'
... and so on.

Further information about this plugin and more example can be found on the
Thomas Krenn Wiki (currently only in German):
http://www.thomas-krenn.com/de/wiki/IPMI_Sensor_Monitoring_Plugin

Send email to the IPMI-plugin-user mailing list if you have questions regarding
use of this software, to submit patches, or suggest improvements.
The mailing list is available at http://lists.thomas-krenn.com/