Console Server & Router User Manual 297
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 Opengear’s pmpower utility arches over these tools so the
devices can be controlled through the 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. However 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). Opengear 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.
<powerstrip>
<id>Name or ID of the device support</id>
<outlet port="port-id-1">Display Port 1 in menu</outlet>
<outlet port="port-id-2">Display Port 2 in menu</outlet>
...
<on>script to turn power on</on>
<off>script to power off</off>
To Next Page
Loading...
Need help?
General
