|-c count||Perform any actions identified by the -l, -S and -T options count times.|
Path of file specifying parameters for a stonith device. To determine the
syntax of the parameters file for a given device type run:
All of the listed parameters need to appear in order on a single line in the parameters file and be delimited by whitespace.
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 dont 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.|
Parameter, in the form of a name/value pair, to pass directly to the
To determine the syntax of the parameters for a given device type run:
All of the listed parameter names need to be passed with their corresponding values.
Parameters to pass directly to the stonith device. To determine the syntax
of the parameters for a given device type run:
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.|
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.
|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.|
To determine which stonith devices are available on your installation, use the -L option:All of the supported devices will be displayed one per line. Choose one from this list that is best for your environment - lets use wti_nps for the rest of this example. To get detailed information about this device, use the -h option:
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 -h
All of the required parameter names will be displayed one per line. For wti_nps the output is:
stonith -t wti_nps -n
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:
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 ipaddr=my-dev-ip password=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:
stonith -t wti_nps -p "my-dev-ip my-dev-pw" ...
and passing the name of the file on the stonith command line with the -F option:
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 -F ~/my-wtinps-config ...
If all is well at this point, you should see something similar to:
stonith -t wti_nps ipaddr=my-dev-ip password=my-dev-pw -S
If you dont, 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.
stonith: wti_nps device OK.
To get the list of hosts controlled by the device, use the -l option:All of the hosts controlled by the device will be displayed one per line. For wti_nps the output could be:
stonith -t wti_nps ipaddr=my-dev-ip password=my-dev-pw -l
To power off one of these hosts, use the -T option:
node1 node2 node3
stonith -t wti_nps ipaddr=my-dev-ip password=my-dev-pw -T off node2
stonith - Alan Robertson <firstname.lastname@example.org> et al. man page - Horms <email@example.com>
|-->||STONITH (8)||February 2008|