nut-ipmipsu(8)

1NUT-IPMIPSU(8)                    NUT Manual                    NUT-IPMIPSU(8)
2
3
4

NAME

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

SYNOPSIS

9       nut-ipmipsu -h
10
11       nut-ipmipsu -a PSU_NAME [OPTIONS]
12
13           Note
14           This driver is experimental, and still a work-in-progress. Feedback
15           is encouraged.
16
17           Note
18           This man page only documents the hardware-specific features of the
19           nut-ipmipsu driver. For information about the core driver, see
20           nutupsdrv(8).
21

SUPPORTED HARDWARE

23       This driver should support a wide range of PSUs through local IPMI
24       interface.
25
26       nut-ipmipsu currently use the GNU FreeIPMI project, for IPMI
27       implementation.
28

EXTRA ARGUMENTS

30       This driver doesn’t support any optional settings.
31

INSTALLATION

33       This driver is not built by default. You can build it by using
34       "configure --with-ipmi=yes".
35
36       You also need to give proper permissions on the local IPMI device file
37       (/dev/ipmi0 for example) to allow the NUT user to access it.
38
39       An udev rules file (nut-ipmipsu.rules) is provided and automatically
40       installed on udev enabled system. This file is generally installed in
41       /etc/udev/rules.d/ or /lib/udev/rules.d/ on newer systems, to address
42       the permission settings problem. For more information, refer to
43       nut/scripts/udev/README.
44

INSTANT COMMANDS

46       This driver doesn’t support any instant commands.
47

IMPLEMENTATION

49       The "port" value is used to identify the PSU. For instance, to target
50       FRU 0x2, use the following in ups.conf:
51
52           [pdu]
53                   driver = nut-ipmipsu
54                   port = id2
55
56       This driver will report various information related to a PSU,
57       including:
58
59       •   manufacturer, model, serial and part numbers,
60
61       •   nominal voltage and frequency,
62
63       •   actual current and voltage,
64
65       •   status of the PSU:
66
67           •   OL means that the PSU is present and providing power,
68
69           •   OFF means that the PSU is present but not providing power
70               (power cable removed),
71
72           •   stale (no data) means that the PSU is not present (ie
73               physically removed).
74
75       Here is an example output for a Dell r610 server:
76
77           device.mfr: DELL
78           device.mfr.date: 01/05/11 - 08:51:00
79           device.model: PWR SPLY,717W,RDNT
80           device.part: 0RN442A01
81           device.serial: CN179721130031
82           device.type: psu
83           driver.name: nut-ipmipsu
84           driver.parameter.pollinterval: 2
85           driver.parameter.port: id2
86           driver.version: 2.6.1-3139M
87           driver.version.data: IPMI PSU driver
88           driver.version.internal: 0.01
89           input.current: 0.20
90           input.frequency.high: 63
91           input.frequency.low: 47
92           input.voltage: 232.00
93           input.voltage.maximum: 264
94           input.voltage.minimum: 90
95           ups.id: 2
96           ups.realpower.nominal: 717
97           ups.status: OL
98           ups.voltage: 12
99

AUTHOR

101       Arnaud Quette <arnaud.quette@free.fr>
102