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 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 (i.e. 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:
       nutupsdrv(8)

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

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