stonith

STONITH(8)               System administration utilitie               STONITH(8)



NAME
       stonith - extensible interface for remotely powering down a node in the
       cluster

SYNOPSIS
       stonith -h

       stonith [-s] [-h] -L

       stonith [-s] [-h] -t stonith-device-type -n

       stonith [-s] [-h] -t stonith-device-type {name=value...  |
               -p stonith-device-parameters | -F stonith-device-parameters-file}
               [-c count] [-l] [-S]

       stonith [-s] [-h] -t stonith-device-type {name=value...  |
               -p stonith-device-parameters | -F stonith-device-parameters-file}
               [-c count] [-T {reset | on | off}] [nodename]

DESCRIPTION
       The STONITH module provides an extensible interface for remotely powering
       down a node in the cluster (STONITH = Shoot The Other Node In The Head).
       The idea is quite simple: when the software running on one machine wants
       to make sure another machine in the cluster is not using a resource, pull
       the plug on the other machine. It's simple and reliable, albeit
       admittedly brutal.

OPTIONS
       The following options are supported:

       -c count
           Perform any actions identified by the -l, -S and -T options count
           times.

       -F stonith-device-parameters-file
           Path of file specifying parameters for a stonith device. To determine
           the syntax of the parameters file for a given device type run:

               # stonith -t stonith-device-type -n

           All of the listed parameters need to appear in order on a single line
           in the parameters file and be delimited by whitespace.

       -h
           Display detailed information about a stonith device including
           description, configuration information, parameters and any other
           related information. When specified without a stonith-device-type,
           detailed information on all stonith devices is displayed.

           If you don't yet own a stonith device and want to know more about the
           ones we support, this information is likely to be helpful.

       -L
           List the valid stonith device types, suitable for passing as an
           argument to the -t option.

       -l
           List the hosts controlled by the stonith device.

       -n
           Output the parameter names of the stonith device.

       name=value
           Parameter, in the form of a name/value pair, to pass directly to the
           stonith device. To determine the syntax of the parameters for a given
           device type run:

               # stonith -t stonith-device-type -n

           All of the listed parameter names need to be passed with their
           corresponding values.

       -p stonith-device-parameters
           Parameters to pass directly to the stonith device. To determine the
           syntax of the parameters for a given device type run:

               # stonith -t stonith-device-type -n

           All of the listed parameter names need to appear in order and be
           delimited by whitespace.

       -S
           Show the status of the stonith device.

       -s
           Silent operation. Suppress logging of error messages to standard
           error.

       -T action
           The stonith action to perform on the node identified by nodename.
           Chosen from reset, on, and off.

               Note
               If a nodename is specified without the -T option, the stonith
               action defaults to reset.

       -t stonith-device-type
           The type of the stonith device to be used to effect stonith. A list
           of supported devices for an installation may be obtained using the -L
           option.

       -v
           Ignored.

EXAMPLES
       To determine which stonith devices are available on your installation,
       use the -L option:

           # stonith -L

       All of the supported devices will be displayed one per line. Choose one
       from this list that is best for your environment - let's use wti_nps for
       the rest of this example. To get detailed information about this device,
       use the -h option:

           # stonith -t wti_nps -h

       Included in the output is the list of valid parameter names for wti_nps.
       To get just the list of valid parameter names, use the -n option instead:

           # stonith -t wti_nps -n

       All of the required parameter names will be displayed one per line. For
       wti_nps the output is:

           ipaddr
           password

       There are three ways to pass these parameters to the device. The first
       (and preferred) way is by passing name/value pairs on the stonith command
       line:

           # stonith -t wti_nps ipaddr=my-dev-ip password=my-dev-pw ...

       The second way, which is maintained only for backward compatibility with
       legacy clusters, is passing the values in order on the stonith command
       line with the -p option:

           # stonith -t wti_nps -p "my-dev-ip my-dev-pw" ...

       The third way, which is also maintained only for backward compatibility
       with legacy clusters, is placing the values in order on a single line in
       a config file:

           my-dev-ip my-dev-pw

       ... and passing the name of the file on the stonith command line with the
       -F option:

           # stonith -t wti_nps -F ~/my-wtinps-config ...

       To make sure you have the configuration set up correctly and that the
       device is available for stonith operations, use the -S option:

           # stonith -t wti_nps ipaddr=my-dev-ip password=my-dev-pw -S

       If all is well at this point, you should see something similar to:

           stonith: wti_nps device OK.

       If you don't, some debugging may be necessary to determine if the config
       info is correct, the device is powered on, etc. The -d option can come in
       handy here - you can add it to any stonith command to cause it to
       generate debug output.

       To get the list of hosts controlled by the device, use the -l option:

           # stonith -t wti_nps ipaddr=my-dev-ip password=my-dev-pw -l

       All of the hosts controlled by the device will be displayed one per line.
       For wti_nps the output could be:

           node1
               node2
               node3

       To power off one of these hosts, use the -T option:

           # stonith -t wti_nps ipaddr=my-dev-ip password=my-dev-pw -T off node

SEE ALSO
       heartbeat(8), meatclient(8)

AUTHORS
       Alan Robertson <alanr@unix.sh>
           stonith

       Simon Horman <horms@vergenet.net>
           man page

       Florian Haas <florian.haas@linbit.com>
           man page



cluster-glue 1.0.12             December 7, 2009                      STONITH(8)