_____________________________________________________________________
724-746-5500 | blackbox.com
Page 265
15.9.2 The
pmpower
tool
The
pmpower
utility is a high level tool for manipulating remote preconfigured power devices connected to the
console
server
either via a serial or network connection. The PDU UPS and IPMI power devices are variously controlled using the
open source
PowerMan, IPMItool
or
Network UPS Tools
and Black Box’s
pmpower
utility arches over these tools so the
devices can be controlled through one command line:
pmpower [-‐?h] [-‐l device | -‐r host] [-‐o outlet] [-‐u username] [-‐p password] action
-‐?/-‐h
This help message.
-‐l
The serial port to use.
-‐o
The outlet on the power target to apply to
-‐r
The remote host address for the power target
-‐u
Override the configured username
-‐p
Override the configured password
on
This
action
switches the specified device or outlet(s) on
off
This
action
switches the specified device or outlet(s) off
cycle
This
action
switches the specified device or outlet(s) off and on again
status
This
action
retrieves the current status of the device or outlet
Examples:
To turn outlet 4 of the power device connected to serial port 2 on:
# pmpower -‐l port02 -‐o 4 on
To turn an IPMI device off located at IP address 192.168.1.100 (where username is 'root' and password is
'calvin':
# pmpower -‐r 192.168.1.100 -‐u root -‐p calvin off
Default system Power Device actions are specified in
/etc/powerstrips.xml
. Custom Power Devices can be added in
/etc/config/powerstrips.xml
. If an action is attempted which has not been configured for a specific Power Device,
pmpower
will exit with an error.
15.9.3 Adding new RPC devices
There are a number of simple paths to adding support for new RPC devices.
The first is to have scripts to support the particular RPC included in either the open source
PowerMan
project
(http://sourceforge.net/projects/powerman)
or
the open source
NUT UPS Tools
project. The
PowerMan
device
specifications are rather weird and it is suggested that you leave the actual writing of these scripts to the PowerMan
authors. Documentation on how they work can be found at
http://linux.die.net/man/5/powerman.dev
. The
Network
UPS Tools (NUT)
project has recently moved on from its UPS management origins to also cover SNMP PDUs (and
embrace PowerMan). Black Box progressively includes the updated
PowerMan
and
NUT
build into the
console server
firmware releases.
The second path is to directly add support for the new RPC devices (or to customize the existing RPC device support) on
your particular
console server
. The
Manage: Power
page uses information contained in
/etc/powerstrips.xml
to
configure and control devices attached to a serial port. The configuration also looks for (and loads)
/etc/config/powerstrips.xml
if it exists.
The user can add their own support for more devices by putting definitions for them into
/etc/config/powerstrips.xml
.
This file can be created on a host system and copied to the Management Console device using
scp
. Alternatively, login to
the Management Console and use
ftp
or
wget
to transfer files.
Here is a brief description of the elements of the XML entries in
/etc/config/powerstrips.xml
.