MEATCLIENT(8) System administration utilitie MEATCLIENT(8)NAME
meatclient - Manually confirm that a node has been removed from the cluster
SYNOPSIS
meatclient -c nodename
DESCRIPTION
meatclient confirms that a node has been manually removed from the cluster. It instructs the cluster manager, via the meatware STONITH
plugin, that it is safe to continue cluster operations.
OPTIONS
The following options are supported:
-c nodename
nodename is the name of the cluster node that has been fenced.
SEE ALSO heartbeat(8), stonith(8)AUTHORS
Gregor Binder <gbinder@sysfive.com>
meatclient
Michael Morz <mimem@debian.org>
man page
Simon Horman <horms@vergenet.net>
man page
Florian Haas <florian.haas@linbit.com>
man page
Cluster Glue 1.0.5 December 4, 2009 MEATCLIENT(8)
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.5 December 7, 2009 STONITH(8)