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@redhat.com>

SEE ALSO

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

                                                                                   fence_kdump(8)