fence_kdump(8)

1fence_kdump(8)              System Manager's Manual             fence_kdump(8)
2
3
4

NAME

6       fence_kdump - fencing agent for use with kdump crash recovery service
7

SYNOPSIS

9       fence_kdump [OPTIONS]...
10

DESCRIPTION

12       fence_kdump  is  an  I/O  fencing agent to be used with the kdump crash
13       recovery service. When the fence_kdump agent is invoked, it will listen
14       for  a  message  from the failed node that acknowledges that the failed
15       node it executing the kdump crash kernel.  Note that fence_kdump is not
16       a  replacement  for  traditional fencing methods. The fence_kdump agent
17       can only detect that a node has entered the kdump crash  recovery  ser‐
18       vice.  This  allows  the  kdump crash recovery service complete without
19       being preempted by traditional power fencing methods.
20

OPTIONS

22       -n, --nodename=NODE
23              Name or IP address of node to be fenced. This option is required
24              for the "off" action. (default: none)
25
26       -p, --ipport=PORT
27              IP port number that the fence_kdump agent will use to listen for
28              messages. (default: 7410)
29
30       -f, --family=FAMILY
31              IP network family. Force the fence_kdump agent to use a specific
32              family.  The  value for FAMILY can be "auto", "ipv4", or "ipv6".
33              (default: auto)
34
35       -o, --action=ACTION
36              Fencing action to perform. The value for ACTION  can  be  either
37              "off" or "metadata". (default: off)
38
39       -t, --timeout=TIMEOUT
40              Numer  of  seconds  to  wait for message from failed node. If no
41              message is received  within  TIMEOUT  seconds,  the  fence_kdump
42              agent returns failure. (default: 60)
43
44       -v, --verbose
45              Print verbose output.
46
47       -V, --version
48              Print version and exit.
49
50       -h, --help
51              Print usage and exit.
52

STDIN PARAMETERS

54       These  parameters  are  passed  to fence_kdump via standard input if no
55       command-line options are present.
56
57       nodename=NODE
58              Name or IP address of node to be fenced. This option is required
59              for the "off" action. (default: none)
60
61       ipport=PORT
62              IP port number that the fence_kdump agent will use to listen for
63              messages. (default: 7410)
64
65       action=ACTION
66              Fencing action to perform. The value for ACTION  can  be  either
67              "off" or "metadata". (default: off)
68
69       timeout=TIMEOUT
70              Numer  of  seconds  to  wait for message from failed node. If no
71              message is received  within  TIMEOUT  seconds,  the  fence_kdump
72              agent returns failure. (default: 60)
73

ACTIONS

75       off    Listen  for  message from failed node that acknowledges node has
76              entered kdump crash recovery service.  If  a  valid  message  is
77              received  from  the  failed  node,  the node is considered to be
78              fenced and the agent returns success. Failure to receive a valid
79              message from the failed node in the given timeout period results
80              in fencing failure.
81
82       metadata
83              Print XML metadata to standard output.
84

AUTHOR

86       Ryan O'Hara <rohara@redhat.com>
87