NAME¶
fence_kdump - fencing agent for use with kdump crash recovery service
DESCRIPTION¶
fence_kdump is an I/O fencing agent to be used with the kdump crash
recovery service. When the
fence_kdump agent is invoked, it will listen
for a message from the failed node that acknowledges that the failed node it
executing the kdump crash kernel. Note that
fence_kdump is not a
replacement for traditional fencing methods. The
fence_kdump agent can
only detect that a node has entered the kdump crash recovery service. This
allows the kdump crash recovery service complete without being preempted by
traditional power fencing methods.
Note: the "off" action listen for message from failed node that
acknowledges node has entered kdump crash recovery service. If a valid message
is received from the failed node, the node is considered to be fenced and the
agent returns success. Failure to receive a valid message from the failed node
in the given timeout period results in fencing failure.
fence_kdump accepts options on the command line as well as from stdin. Fenced
sends parameters through stdin when it execs the agent. fence_kdump can be run
by itself with command line options. This is useful for testing and for
turning outlets on or off from scripts.
Vendor URL:
http://www.kernel.org/pub/linux/utils/kernel/kexec/
PARAMETERS¶
- -n, --nodename=NODE
- Name or IP address of node to be fenced. This option is required for the
"off" action.
- -p, --ipport=PORT
- IP port number that the fence_kdump agent will use to listen for
messages. (Default Value: 7410)
- -f, --family=FAMILY
- IP network family. Force the fence_kdump agent to use a specific
family. The value for FAMILY can be "auto",
"ipv4", or "ipv6". (Default Value: auto)
- -o, --action=ACTION
- Fencing action to perform. The value for ACTION can be either
"off" or "metadata". (Default Value: off)
- -t, --timeout=TIMEOUT
- Number of seconds to wait for message from failed node. If no message is
received within TIMEOUT seconds, the fence_kdump agent
returns failure. (Default Value: 60)
- -v, --verbose
- Print verbose output
- -V, --version
- Print version
- -h, --help
- Print usage
ACTIONS¶
- off
- Power off machine.
- monitor
- Check the health of fence device
- metadata
- Display the XML metadata describing this resource.
STDIN PARAMETERS¶
- nodename
- Name or IP address of node to be fenced. This option is required for the
"off" action.
- ipport
- IP port number that the fence_kdump agent will use to listen for
messages. (Default Value: 7410)
- family
- IP network family. Force the fence_kdump agent to use a specific
family. The value for FAMILY can be "auto",
"ipv4", or "ipv6". (Default Value: auto)
- action
- Fencing action to perform. The value for ACTION can be either
"off" or "metadata". (Default Value: off)
- timeout
- Number of seconds to wait for message from failed node. If no message is
received within TIMEOUT seconds, the fence_kdump agent
returns failure. (Default Value: 60)
- verbose
- Print verbose output
- version
- Print version
- usage
- Print usage