NUT-IPMIPSU(8) 
==============

NAME
----

nut-ipmipsu - Driver for IPMI Power Supply Units (PSU)

SYNOPSIS
--------

*nut-ipmipsu* -h

*nut-ipmipsu* -a 'PSU_NAME' ['OPTIONS']

NOTE: This driver is experimental, and still a work-in-progress. Feedback is
encouraged.

NOTE: This man page only documents the hardware-specific features of the
nut-ipmipsu driver.  For information about the core driver, see
linkman:nutupsdrv[8].

SUPPORTED HARDWARE
------------------

This driver should support a wide range of PSUs through local IPMI interface.

nut-ipmipsu currently use the GNU FreeIPMI project, for IPMI implementation.


EXTRA ARGUMENTS
---------------

This driver doesn't support any optional settings.

INSTALLATION
------------

This driver is not built by default.  You can build it by using
"configure --with-ipmi=yes".

You also need to give proper permissions on the local IPMI device file
(/dev/ipmi0 for example) to allow the NUT user to access it.

An udev rules file (nut-ipmipsu.rules) is provided and automatically installed
on udev enabled system. This file is generally installed in /etc/udev/rules.d/
or /lib/udev/rules.d/ on newer systems, to address the permission settings
problem. For more information, refer to nut/scripts/udev/README.

INSTANT COMMANDS
----------------

This driver doesn't support any instant commands.

IMPLEMENTATION
--------------

The "port" value is used to identify the PSU.  For instance, to target
FRU 0x2, use the following in *ups.conf*:

	[pdu]
		driver = nut-ipmipsu
		port = id2

This driver will report various information related to a PSU, including:

 - manufacturer, model, serial and part numbers,
 - nominal voltage and frequency,
 - actual current and voltage,
 - status of the PSU:

   * 'OL' means that the PSU is present and providing power,
   * 'OFF' means that the PSU is present but not providing power (power cable removed),
   * 'stale' (no data) means that the PSU is not present (ie physically removed).

Here is an example output for a Dell r610 server:

	device.mfr: DELL
	device.mfr.date: 01/05/11 - 08:51:00
	device.model: PWR SPLY,717W,RDNT
	device.part: 0RN442A01
	device.serial: CN179721130031
	device.type: psu
	driver.name: nut-ipmipsu
	driver.parameter.pollinterval: 2
	driver.parameter.port: id2
	driver.version: 2.6.1-3139M
	driver.version.data: IPMI PSU driver
	driver.version.internal: 0.01
	input.current: 0.20
	input.frequency.high: 63
	input.frequency.low: 47
	input.voltage: 232.00
	input.voltage.maximum: 264
	input.voltage.minimum: 90
	ups.id: 2
	ups.realpower.nominal: 717
	ups.status: OL
	ups.voltage: 12

AUTHOR
------
Arnaud Quette <arnaud.quette@free.fr>

SEE ALSO
--------
The core driver:
~~~~~~~~~~~~~~~~
linkman:nutupsdrv[8]

Internet resources:
~~~~~~~~~~~~~~~~~~~
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/

GNU FreeIPMI home page: http://www.gnu.org/software/freeipmi/
