1PowerMan(1) PowerMan PowerMan(1)
2
6 powerman - power on/off nodes
7
9 powerman [-option] [targets]
10 pm [-option] [targets]
11
13 powerman provides power management in a data center or compute cluster
14 environment. It performs operations such as power on, power off, and
15 power cycle via remote power controller (RPC) devices. Target host‐
16 names are mapped to plugs on RPC devices in powerman.conf(5).
17
19 -1, --on
20 Power ON targets.
21 -0, --off
23 Power OFF targets.
24 -c, --cycle
26 Power cycle targets.
27 -r, --reset
29 Assert hardware reset for targets (if implemented by RPC).
30 -f, --flash
32 Turn beacon ON for targets (if implemented by RPC).
33 -u, --unflash
35 Turn beacon OFF for targets (if implemented by RPC).
36 -l, --list
38 List available targets. If possible, output will be compressed
39 into a host range (see TARGET SPECIFICATION below).
40 -q, --query
42 Query plug status of targets. If none specified, query all tar‐
43 gets. Status is not cached; each time this option is used,
44 powermand queries the appropriate RPC's. Targets connected to
45 RPC's that could not be contacted (e.g. due to network failure)
46 are reported as status "unknown". If possible, output will be
47 compressed into host ranges.
48 -n, --node
50 Query node power status of targets (if implemented by RPC). If
51 no targets specified, query all targets. In this context, a
52 node in the OFF state could be ON at the plug but operating in
53 standby power mode.
54 -b, --beacon
56 Query beacon status (if implemented by RPC). If no targets are
57 specified, query all targets.
58 -t, --temp
60 Query node temperature (if implemented by RPC). If no targets
61 are specified, query all targets. Temperature information is
62 not interpreted by powerman and is reported as received from the
63 RPC on one line per target, prefixed by target name.
64 -h, --help
66 Display option summary.
67 -L, --license
69 Show powerman license information.
70 -d, --destination host[:port]
72 Connect to a powerman daemon on non-default host and optionally
73 port.
74 -V, --version
76 Display the powerman version number and exit.
77 -D, --device
79 Displays RPC status information. If targets are specified, only
80 RPC's matching the target list are displayed.
81 -T, --telemetry
83 Causes RPC telemetry information to be displayed as commands are
84 processed. Useful for debugging device scripts.
85 -x, --exprange
87 Expand host ranges in query responses.
88
91 powerman target hostnames may be specified as comma separated or space
92 separated hostnames or host ranges. Host ranges are of the general
93 form: prefix[n-m,l-k,...], where n < m and l < k, etc., This form
94 should not be confused with regular expression character classes (also
95 denoted by ``[]''). For example, foo[19] does not represent foo1 or
96 foo9, but rather represents a degenerate range: foo19.
97 This range syntax is meant only as a convenience on clusters with a
99 prefixNN naming convention and specification of ranges should not be
100 considered necessary -- the list foo1,foo9 could be specified as such,
101 or by the range foo[1,9].
102 Some examples of powerman targets follows:
104 Power on hosts bar,baz,foo01,foo02,...,foo05
106 powerman --on bar baz foo[01-05]
107 Power on hosts bar,foo7,foo9,foo10
109 powerman --on bar,foo[7,9-10]
110 Power on foo0,foo4,foo5
112 powerman --on foo[0,4-5]
113 As a reminder to the reader, some shells will interpret brackets ([ and
115 ]) for pattern matching. Depending on your shell, it may be necessary
116 to enclose ranged lists within quotes. For example, in tcsh, the last
117 example above should be executed as:
118 powerman --on "foo[0,4-5]"
119
121 /usr/sbin/powermand
122 /usr/bin/powerman
123 /usr/bin/pm
124 /etc/powerman/powerman.conf
125 /etc/powerman/*.dev
126
128 Developed by Andrew Uselton <useton2@llnl.gov> on LLNL's Linux clus‐
129 ters. This software is open source and distributed under the terms of
130 the Gnu GPL.
131
133 powermand(1) powerman.conf(5)
134LLNL Release 1.0 PowerMan(1)