118 lines
2.8 KiB
Text
118 lines
2.8 KiB
Text
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/
|