stonithd(7) [debian man page]
STONITHD(7) Pacemaker Configuration STONITHD(7) NAME
stonithd - Options available for all stonith resources SYNOPSIS
[stonith-timeout=time] [priority=integer] [pcmk_host_argument=string] [pcmk_host_map=string] [pcmk_host_list=string] [pcmk_host_check=string] [pcmk_reboot_action=string] [pcmk_poweroff_action=string] [pcmk_list_action=string] [pcmk_monitor_action=string] [pcmk_status_action=string] DESCRIPTION
This is a fake resource that details the instance attributes handled by stonithd. SUPPORTED PARAMETERS
stonith-timeout = time [60s] How long to wait for the STONITH action to complete. Overrides the stonith-timeout cluster property priority = integer [0] The priority of the stonith resource. The lower the number, the higher the priority. pcmk_host_argument = string [port] Advanced use only: An alternate parameter to supply instead of 'port' Some devices do not support the standard 'port' parameter or may provide additional ones. Use this to specify an alternate, device-specific, parameter that should indicate the machine to be fenced. A value of 'none' can be used to tell the cluster not to supply any additional parameters. pcmk_host_map = string [] A mapping of host names to ports numbers for devices that do not support host names. Eg. node1:1;node2:2,3 would tell the cluster to use port 1 for node1 and ports 2 and 3 for node2 pcmk_host_list = string [] A list of machines controlled by this device (Optional unless pcmk_host_check=static-list). pcmk_host_check = string [dynamic-list] How to determin which machines are controlled by the device. Allowed values: dynamic-list (query the device), static-list (check the pcmk_host_list attribute), none (assume every device can fence every machine) pcmk_reboot_action = string [reboot] Advanced use only: An alternate command to run instead of 'reboot' Some devices do not support the standard commands or may provide additional ones. Use this to specify an alternate, device-specific, command that implements the 'reboot' action. pcmk_poweroff_action = string [poweroff] Advanced use only: An alternate command to run instead of 'poweroff' Some devices do not support the standard commands or may provide additional ones. Use this to specify an alternate, device-specific, command that implements the 'poweroff' action. pcmk_list_action = string [list] Advanced use only: An alternate command to run instead of 'list' Some devices do not support the standard commands or may provide additional ones. Use this to specify an alternate, device-specific, command that implements the 'list' action. pcmk_monitor_action = string [monitor] Advanced use only: An alternate command to run instead of 'monitor' Some devices do not support the standard commands or may provide additional ones. Use this to specify an alternate, device-specific, command that implements the 'monitor' action. pcmk_status_action = string [status] Advanced use only: An alternate command to run instead of 'status' Some devices do not support the standard commands or may provide additional ones. Use this to specify an alternate, device-specific, command that implements the 'status' action. AUTHOR
Andrew Beekhof <andrew@beekhof.net> Author. Pacemaker Configuration 04/17/2012 STONITHD(7)
Check Out this Related Man Page
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.9 December 7, 2009 STONITH(8)