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.

       validate-all
              Validate if all required parameters are entered.

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