logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

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

Author

       Arnaud Quette <arnaud.quette@free.fr>

Extra Arguments

       This driver doesn’t support any optional settings.

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

Installation

       This driver may be not built by default. You can build it by installing the libfreeipmi-dev dependencies
       and 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 an 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 scripts/udev/README.adoc in NUT sources.

Instant Commands

       This driver doesn’t support any instant commands.

Name

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

See Also

Thecoredriver:nutupsdrv(8)

   Internetresources:
       •   The NUT (Network UPS Tools) home page: https://www.networkupstools.org/historic/v2.8.3/

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

Network UPS Tools 2.8.3                            07/08/2025                                     NUT-IPMIPSU(8)

Supported Hardware

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

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

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).

See Also