Provided by: powerman_2.3.5-1_i386 bug

NAME

       powerman - power on/off nodes

SYNOPSIS

       pm [-options] -action [targets] [-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  (RPC)  devices.   Target
       hostnames are mapped to plugs on RPC devices in powerman.conf(5).

OPTIONS

       -1, --on targets
              Power ON targets.

       -0, --off targets
              Power OFF targets.

       -c, --cycle targets
              Power cycle targets.

       -r, --reset targets
              Assert hardware reset for targets (if implemented by RPC).

       -f, --flash targets
              Turn beacon ON for targets (if implemented by RPC).

       -u, --unflash targets
              Turn beacon OFF for targets (if implemented by RPC).

       -l, --list
              List available targets.  If possible, output will be  compressed
              into a host range (see TARGET SPECIFICATION below).

       -q, --query-all
              Query  plug  status of all targets.  Status is not cached;  each
              time this option is  used,  powermand  queries  the  appropriate
              RPC's.   Targets  connected to RPC's that could not be contacted
              (e.g. due to network failure) are reported as status  "unknown".
              If possible, output will be compressed into host ranges.

       -Q, --query targets
              Query plug status of specific targets.

       -n, --soft-all
              Query  soft power status of all targets (if implemented by RPC).
              In this context, a node in the OFF state could be ON at the plug
              but operating in standby power mode.

       -N, --soft targets
              Query  soft  power status of specific targets (if implemented by
              RPC).

       -b, --beacon-all
              Query beacon status of all targets (if implemented by RPC).

       -B, --beacon targets
              Query beacon status of specific targets (if implemented by RPC).

       -t, --temp-all
              Query node temperature of all targets (if implemented  by  RPC).
              Temperature  information  is  not interpreted by powerman and is
              reported as received from  the  RPC  on  one  line  per  target,
              prefixed by target name.

       -P, --temp targets
              Query  node  temperature  of specific targets (if implemented by
              RPC).

       -h, --help
              Display option summary.

       -L, --license
              Show powerman license information.

       -h, --server-host host[:port]
              Connect to a powerman daemon on non-default host and  optionally
              port.

       -V, --version
              Display the powerman version number and exit.

       -D, --device
              Displays RPC status information.  If targets are specified, only
              RPC's matching the target list are displayed.

       -T, --telemetry
              Causes RPC telemetry information to be displayed as commands are
              processed.  Useful for debugging device scripts.

       -x, --exprange
              Expand host ranges in query responses.

       -g, --genders
              If  configured  with  the  genders(3) package, this option tells
              powerman that targets are genders attributes that  map  to  node
              names rather than the node names themselves.

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), powerman-devices(7).

       http://sourceforge.net/projects/powerman