Imported Upstream version 2.6.2
This commit is contained in:
Arnaud Quette
parent
a367d9bc54
commit
45043b58d0
246 changed files with 18228 additions and 1415 deletions
231
docs/man/nut-ipmipsu.8
Normal file
231
docs/man/nut-ipmipsu.8
Normal file
|
|
@ -0,0 +1,231 @@
|
|||
'\" t
|
||||
.\" Title: nut-ipmipsu
|
||||
.\" Author: [see the "AUTHOR" section]
|
||||
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
|
||||
.\" Date: 09/15/2011
|
||||
.\" Manual: NUT Manual
|
||||
.\" Source: Network UPS Tools
|
||||
.\" Language: English
|
||||
.\"
|
||||
.TH "NUT\-IPMIPSU" "8" "09/15/2011" "Network UPS Tools" "NUT Manual"
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * Define some portability stuff
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.\" http://bugs.debian.org/507673
|
||||
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
||||
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
.ie \n(.g .ds Aq \(aq
|
||||
.el .ds Aq '
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * set default formatting
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" disable hyphenation
|
||||
.nh
|
||||
.\" disable justification (adjust text to left margin only)
|
||||
.ad l
|
||||
.\" -----------------------------------------------------------------
|
||||
.\" * MAIN CONTENT STARTS HERE *
|
||||
.\" -----------------------------------------------------------------
|
||||
.SH "NAME"
|
||||
nut-ipmipsu \- Driver for IPMI Power Supply Units (PSU)
|
||||
.SH "SYNOPSIS"
|
||||
.sp
|
||||
\fBnut\-ipmipsu\fR \-h
|
||||
.sp
|
||||
\fBnut\-ipmipsu\fR \-a \fIPSU_NAME\fR [\fIOPTIONS\fR]
|
||||
.if n \{\
|
||||
.sp
|
||||
.\}
|
||||
.RS 4
|
||||
.it 1 an-trap
|
||||
.nr an-no-space-flag 1
|
||||
.nr an-break-flag 1
|
||||
.br
|
||||
.ps +1
|
||||
\fBNote\fR
|
||||
.ps -1
|
||||
.br
|
||||
.sp
|
||||
This driver is experimental, and still a work\-in\-progress\&. Feedback is encouraged\&.
|
||||
.sp .5v
|
||||
.RE
|
||||
.if n \{\
|
||||
.sp
|
||||
.\}
|
||||
.RS 4
|
||||
.it 1 an-trap
|
||||
.nr an-no-space-flag 1
|
||||
.nr an-break-flag 1
|
||||
.br
|
||||
.ps +1
|
||||
\fBNote\fR
|
||||
.ps -1
|
||||
.br
|
||||
.sp
|
||||
This man page only documents the hardware\-specific features of the nut\-ipmipsu driver\&. For information about the core driver, see \fBnutupsdrv\fR(8)\&.
|
||||
.sp .5v
|
||||
.RE
|
||||
.SH "SUPPORTED HARDWARE"
|
||||
.sp
|
||||
This driver should support a wide range of PSUs through local IPMI interface\&.
|
||||
.sp
|
||||
nut\-ipmipsu currently use the GNU FreeIPMI project, for IPMI implementation\&.
|
||||
.SH "EXTRA ARGUMENTS"
|
||||
.sp
|
||||
This driver doesn\(cqt support any optional settings\&.
|
||||
.SH "INSTALLATION"
|
||||
.sp
|
||||
This driver is not built by default\&. You can build it by using "configure \-\-with\-ipmi=yes"\&.
|
||||
.sp
|
||||
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\&.
|
||||
.sp
|
||||
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\&.
|
||||
.SH "INSTANT COMMANDS"
|
||||
.sp
|
||||
This driver doesn\(cqt support any instant commands\&.
|
||||
.SH "IMPLEMENTATION"
|
||||
.sp
|
||||
The "port" value is used to identify the PSU\&. For instance, to target FRU 0x2, use the following in \fBups\&.conf\fR:
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
[pdu]
|
||||
driver = nut\-ipmipsu
|
||||
port = id2
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.sp
|
||||
This driver will report various information related to a PSU, including:
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
manufacturer, model, serial and part numbers,
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
nominal voltage and frequency,
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
actual current and voltage,
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
status of the PSU:
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
|
||||
\fIOL\fR
|
||||
means that the PSU is present and providing power,
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
|
||||
\fIOB\fR
|
||||
means that the PSU is present but not providing power (power cable removed),
|
||||
.RE
|
||||
.sp
|
||||
.RS 4
|
||||
.ie n \{\
|
||||
\h'-04'\(bu\h'+03'\c
|
||||
.\}
|
||||
.el \{\
|
||||
.sp -1
|
||||
.IP \(bu 2.3
|
||||
.\}
|
||||
|
||||
\fIstale\fR
|
||||
means that the PSU is not present (ie physically removed)\&.
|
||||
.RE
|
||||
.RE
|
||||
.sp
|
||||
Here is an example output for a Dell r610 server:
|
||||
.sp
|
||||
.if n \{\
|
||||
.RS 4
|
||||
.\}
|
||||
.nf
|
||||
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
|
||||
.fi
|
||||
.if n \{\
|
||||
.RE
|
||||
.\}
|
||||
.SH "AUTHOR"
|
||||
.sp
|
||||
Arnaud Quette <arnaud\&.quette@free\&.fr>
|
||||
.SH "SEE ALSO"
|
||||
.SS "The core driver:"
|
||||
.sp
|
||||
\fBnutupsdrv\fR(8)
|
||||
.SS "Internet resources:"
|
||||
.sp
|
||||
The NUT (Network UPS Tools) home page: http://www\&.networkupstools\&.org/
|
||||
.sp
|
||||
GNU FreeIPMI home page: http://www\&.gnu\&.org/software/freeipmi/
|
||||
Loading…
Add table
Add a link
Reference in a new issue