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