1STONITH(8)                  System Manager's Manual                 STONITH(8)
2
3
4

NAME

6       stonith - extensible interface for remotely powering down a node in the
7       cluster
8

SYNOPSIS

10       stonith [ -sv ] [ -t type ] [ -p param ] [ -F file ] -S nodename
11       stonith [ -sv ] [ -t type ] [ -p param ] [ -F file ] -l
12       stonith [ -sv ] -L
13       stonith -h
14

DESCRIPTION

16       The STONITH module (a.k.a. STOMITH) provides  an  extensible  interface
17       for remotely powering down a node in the cluster.  (STONITH = Shoot The
18       Other Node In The Head).  The idea is quite simple: When  the  software
19       running  on one machine wants to make sure another machine in the clus‐
20       ter is not using a resource, pull the plug on the other machine.   It's
21       simple and reliable, albiet admittedly brutal.
22

OPTIONS

24       -F options-file:
25              Path  to file specifying option s for a device. To determine the
26              syntax of the options-file for a given device run:
27              stonith -t <devicetype> <dummy-nodename>
28              e.g.
29              stonith -t rps10 test
30
31       -h:    Display command line This provides a detailed list of the device
32              types, descriptions of them and how to configure them, and other
33              related information.  If you don't yet own as STONITH device and
34              want  to know what more about the ones we support, this informa‐
35              tion is likely to be helpful.
36
37
38       -L:    List the valid devicetypes, suitable for passing as an  argument
39              to the -t option.
40
41       -l:    List the configured nodes.
42
43       -t devicetype:
44              The type of device to be used to effect STONITH.  A list of sup‐
45              ported devices for an instalation of  stonith  may  be  obtained
46              using the -L option.
47
48       -p stonith-parameters:
49              Parameters  to  pass  directly  to stonith device. These are the
50              same format as a line in the  options-file  for  a  divice.  See
51              notes  on  determining  the  syntax  for  the options-file for a
52              divice above.
53
54       -S:    Show the status of the STONITH device.
55
56       -s:    Silent operation. Suppress logging of error messages to standard
57              error.
58
59       -v:    Ignored.
60

SEE ALSO

62       heartbeat (8) meatclient (8)
63

AUTHORS

65       stonith - Alan Robertson <alanr@unix.sh> et al.
66       man page - Horms <horms@verge.net.au>
67
68
69
70                                8th August 2003                     STONITH(8)