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

NAME

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

DESCRIPTION

10       fence_kdump  is  an  I/O  fencing agent to be used with the kdump crash
11       recovery service. When the fence_kdump agent is invoked, it will listen
12       for  a  message  from the failed node that acknowledges that the failed
13       node it executing the kdump crash kernel.  Note that fence_kdump is not
14       a  replacement  for  traditional fencing methods. The fence_kdump agent
15       can only detect that a node has entered the kdump crash  recovery  ser‐
16       vice.  This  allows  the  kdump crash recovery service complete without
17       being preempted by traditional power fencing methods.
18
19       Note: the "off"  action  listen  for  message  from  failed  node  that
20       acknowledges  node has entered kdump crash recovery service. If a valid
21       message is received from the failed node, the node is considered to  be
22       fenced  and  the agent returns success. Failure to receive a valid mes‐
23       sage from the failed node in the given timeout period results in  fenc‐
24       ing failure.
25
26       fence_kdump  accepts options on the command line as well as from stdin.
27       Fenced  sends  parameters  through  stdin  when  it  execs  the  agent.
28       fence_kdump  can  be  run by itself with command line options.  This is
29       useful for testing and for turning outlets on or off from scripts.
30
31       Vendor URL: http://www.kernel.org/pub/linux/utils/kernel/kexec/
32

PARAMETERS

34
35
36       -n, --nodename=NODE
37              Name or IP address of node to be fenced. This option is required
38              for the "off" action.
39
40       -p, --ipport=PORT
41              IP port number that the fence_kdump agent will use to listen for
42              messages. (Default Value: 7410)
43
44       -f, --family=FAMILY
45              IP network family. Force the fence_kdump agent to use a specific
46              family.  The  value for FAMILY can be "auto", "ipv4", or "ipv6".
47              (Default Value: auto)
48
49       -o, --action=ACTION
50              Fencing action to perform. The value for ACTION  can  be  either
51              "off" or "metadata". (Default Value: off)
52
53       -t, --timeout=TIMEOUT
54              Number  of  seconds  to wait for message from failed node. If no
55              message is received  within  TIMEOUT  seconds,  the  fence_kdump
56              agent returns failure. (Default Value: 60)
57
58       -v, --verbose
59              Print verbose output
60
61       -V, --version
62              Print version
63
64       -h, --help
65              Print usage
66
67

ACTIONS

69
70
71       off    Power off machine.
72
73       monitor
74              Check the health of fence device
75
76       metadata
77              Display the XML metadata describing this resource.
78
79

STDIN PARAMETERS

81
82
83       nodename
84              Name or IP address of node to be fenced. This option is required
85              for the "off" action.
86
87       ipport IP port number that the fence_kdump agent will use to listen for
88              messages. (Default Value: 7410)
89
90       family IP network family. Force the fence_kdump agent to use a specific
91              family. The value for FAMILY can be "auto", "ipv4",  or  "ipv6".
92              (Default Value: auto)
93
94       action Fencing  action  to  perform. The value for ACTION can be either
95              "off" or "metadata". (Default Value: off)
96
97       timeout
98              Number of seconds to wait for message from failed  node.  If  no
99              message  is  received  within  TIMEOUT  seconds, the fence_kdump
100              agent returns failure. (Default Value: 60)
101
102       verbose
103              Print verbose output
104
105       version
106              Print version
107
108       usage  Print usage
109
110
111
112fence_kdump (Fence Agent)         2009-10-20                    FENCE_AGENT(8)