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