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 re‐
11       covery 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 is 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 be‐
17       ing preempted by traditional power fencing methods.
18
19       Note: the "off" action listen for message from  failed  node  that  ac‐
20       knowledges  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. When multiple node names/IP addresses are specified a sin‐
25       gle valid message is sufficient for success. This is useful when single
26       node can send message via several different IP addresses.
27
28
29       fence_kdump  accepts options on the command line as well as from stdin.
30       Fenced  sends  parameters  through  stdin  when  it  execs  the  agent.
31       fence_kdump  can  be  run by itself with command line options.  This is
32       useful for testing and for turning outlets on or off from scripts.
33
34       Vendor URL: http://www.kernel.org/pub/linux/utils/kernel/kexec/
35

PARAMETERS

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

ACTIONS

74
75
76       off    Power off machine.
77
78       monitor
79              Check the health of fence device
80
81       metadata
82              Display the XML metadata describing this resource.
83
84       validate-all
85              Validate if all required parameters are entered.
86
87

STDIN PARAMETERS

89
90
91       nodename
92              List  of names or IP addresses of node to be fenced. This option
93              is required for the "off" action. Multiple values  separated  by
94              commas  can  be specified. All values must be of same IP network
95              family.
96
97       ipport IP port number that the fence_kdump agent will use to listen for
98              messages. (Default Value: 7410)
99
100       family IP network family. Force the fence_kdump agent to use a specific
101              family. The value for FAMILY can be "auto", "ipv4",  or  "ipv6".
102              (Default Value: auto)
103
104       action Fencing  action  to  perform. The value for ACTION can be either
105              "off" or "metadata". (Default Value: off)
106
107       timeout
108              Number of seconds to wait for message from failed  node.  If  no
109              message  is  received  within  TIMEOUT  seconds, the fence_kdump
110              agent returns failure. (Default Value: 60)
111
112       verbose
113              Print verbose output
114
115       version
116              Print version
117
118       usage  Print usage
119
120
121
122fence_kdump (Fence Agent)         2009-10-20                    FENCE_AGENT(8)
Impressum