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

-F stonith-device-parameters-file

# stonith -t stonith-device-type -n

-h

-L

-l

-n

name=value

# stonith -t stonith-device-type -n

-p stonith-device-parameters

# stonith -t stonith-device-type -n

-S

-s

-T action

-t stonith-device-type

-v

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>

Simon Horman <horms@vergenet.net>

Florian Haas <florian.haas@linbit.com>