NAME
powerman - power on/off nodes
SYNOPSIS
pm [OPTIONS] [ACTION [TARGETS ...]]
DESCRIPTION
powerman provides power management in a data center or compute cluster environment. It performs operations such as power on, power off, and power cycle via remote power controller devices. Target hostnames are mapped to plugs on devices in powerman.conf(5).
ACTIONS
- -1, --on
-
Power ON targets.
- -0, --off
-
Power OFF targets.
- -c, --cycle
-
Power cycle targets.
- -q, --query
-
Query plug status of targets, if specified, or all targets if not. Status is not cached; each time this option is used, powermand queries the appropriate devices. Targets connected to devices that could not be contacted (e.g. due to network failure) or had some other type of error or are reported as status "unknown". If possible, output will be compressed into host ranges.
- -l, --list
-
List available targets. If possible, output will be compressed into a host range (see TARGET SPECIFICATION below).
- -r, --reset
-
Assert hardware reset for targets.
- -f, --flash
-
Turn beacon ON for targets.
- -u, --unflash
-
Turn beacon OFF for targets.
- -B, --beacon
-
Query beacon status of targets, if specified, or all targets if not.
- -t, --temp
-
Query node temperature of targets, if specified, or all targets if not. Temperature information is not interpreted by powerman and is reported as received from the device on one line per target, prefixed by target name.
OPTIONS
- -h, --server-host host[:port]
-
Connect to a powerman daemon on non-default host and optionally port.
- -x, --exprange
-
Expand host ranges in query responses.
- -V, --version
-
Display the powerman version number and exit.
- -L, --license
-
Show powerman license information.
- -H, --help
-
Show command usage.
- -g, --genders
-
Interpret targets as genders attributes rather than node names. Each attribute is expanded to the list of nodes that have that attribute, then those lists are combined to make a list of target node names.
TEST/DEBUG OPTIONS
The following options may be helpful in the test environment or when debugging device scripts.
- -T, --telemetry
-
Causes device telemetry information to be displayed as commands are processed. Useful for debugging device scripts.
- -R, --retry-connect N
-
Retry connect to server up to N times with a 100ms delay after each failure.
- -d, --device
-
Displays device status information for the device(s) that control the targets, if specified, or all devices if not.
TARGET SPECIFICATION
powerman target hostnames may be specified as comma separated or space separated hostnames or host ranges. Host ranges are of the general form: prefix[n-m,l-k,...], where n < m and l < k, etc., This form should not be confused with regular expression character classes (also denoted by ``[]''). For example, foo[19] does not represent foo1 or foo9, but rather represents a degenerate range: foo19.
This range syntax is meant only as a convenience on clusters with a prefixNN naming convention and specification of ranges should not be considered necessary -- the list foo1,foo9 could be specified as such, or by the range foo[1,9].
Some examples of powerman targets follows:
Power on hosts bar,baz,foo01,foo02,...,foo05
powerman --on bar baz foo[01-05]
Power on hosts bar,foo7,foo9,foo10
powerman --on bar,foo[7,9-10]
Power on foo0,foo4,foo5
powerman --on foo[0,4-5]
As a reminder to the reader, some shells will interpret brackets ([ and ]) for pattern matching. Depending on your shell, it may be necessary to enclose ranged lists within quotes. For example, in tcsh, the last example above should be executed as:
powerman --on "foo[0,4-5]"
FILES
/usr/bin/powerman
/usr/bin/pm
ORIGIN
PowerMan was originally developed by Andrew Uselton on LLNL's Linux clusters. This software is open source and distributed under the terms of the GNU GPL.
SEE ALSO
powerman(1), powermand(8), httppower(8), plmpower(8), vpcd(8), powerman.conf(5), powerman.dev(5).
http://github.com/chaos/powerman