Scroll to navigation

FENCE_AGENT(8) System Manager's Manual FENCE_AGENT(8)

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
2009-10-20 fence_kdump (Fence Agent)