fence_kdump (8) - Linux Man Pages

fence_kdump: fencing agent for use with kdump crash recovery service

NAME

fence_kdump - fencing agent for use with kdump crash recovery service

SYNOPSIS

fence_kdump [OPTIONS]...

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.

OPTIONS

-n, --nodename=NODE
Name or IP address of node to be fenced. This option is required for the "off" action. (default: none)
-p, --ipport=PORT
IP port number that the fence_kdump agent will use to listen for messages. (default: 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: auto)
-o, --action=ACTION
Fencing action to perform. The value for ACTION can be either "off" or "metadata". (default: off)
-t, --timeout=TIMEOUT
Numer of seconds to wait for message from failed node. If no message is received within TIMEOUT seconds, the fence_kdump agent returns failure. (default: 60)
-v, --verbose
Print verbose output.
-V, --version
Print version and exit.
-h, --help
Print usage and exit.

STDIN PARAMETERS

These parameters are passed to fence_kdump via standard input if no command-line options are present.

nodename=NODE
Name or IP address of node to be fenced. This option is required for the "off" action. (default: none)
ipport=PORT
IP port number that the fence_kdump agent will use to listen for messages. (default: 7410)
action=ACTION
Fencing action to perform. The value for ACTION can be either "off" or "metadata". (default: off)
timeout=TIMEOUT
Numer of seconds to wait for message from failed node. If no message is received within TIMEOUT seconds, the fence_kdump agent returns failure. (default: 60)

ACTIONS

off
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.
metadata
Print XML metadata to standard output.

AUTHOR

Ryan O'Hara <rohara [at] redhat.com>

SEE ALSO

fence_kdump_send(8), fenced(8), fence_node(8)