1fence_xvm(8) System Manager's Manual fence_xvm(8)
3
7 fence_xvm - I/O Fencing agent for Xen virtual machines.
8
11 fence_xvm [OPTION]...
12
15 fence_xvm is an I/O Fencing agent which can be used with Xen virtual
16 machines which are part of a cluster. There is a requirement that the
17 parent domain-0s are also a part of a CMAN/OpenAIS based cluster, such
18 as linux-cluster.
19 fence_xvm accepts options on the command line as well as from standard
21 input. If no command line options are present, fence_xvm will automat‐
22 ically use standard input. fenced sends the options through stdin when
23 it execs the agent. fence_xvm can be run by itself with command line
24 options which is useful for testing.
25
28 -d Enable debugging output. The more times you specify this param‐
29 eter, the more debugging output you will receive.
30 -i family
32 IP family to use (auto, ipv4, or ipv6; default = auto)
33 -a address
35 Multicast address to use (default=225.0.0.12 for ipv4, ff02::3:1
36 for ipv6)
37 -p port
39 Port to use for all communications; must match fence_xvmd
40 (default=1229)
41 -r retrans
43 Multicast retransmission time (in 1/10 seconds; default=20).
44 This is used to tune the amount of retransmission which is done
45 on busy networks where multicast traffic is unreliable.
46 -C auth
48 Authentication type (none, sha1, sha256, sha512;
49 default=sha256). This controls the authentication mechanism
50 used to authenticate clients. The three SHA hashes use a key
51 which must be shared between both the Xen virtual machines and
52 the host domain-0 cluster. The three SHA authentication mecha‐
53 nisms use a simple bidirectional challenge-response based on
54 pseudo- random number generation and a shared private key.
55 -c hash
57 Packet hash type (none, sha1, sha256, sha512; default=sha256).
58 This controls the hashing mechanism used to authenticate fencing
59 requests. The three SHA hashes use a key which must be shared
60 between both the Xen virtual machines and the host domain-0
61 cluster.
62 -k key_file
64 Use the specified key file for packet hashing / SHA authentica‐
65 tion. When both the hash type and the authentication type are
66 set to "none", this parameter is ignored.
67 -H domain
69 This specifies unique domain name of the Xen guest which needs
70 to be fenced.
71 -u Fence by UUID instead of Xen Domain name. If specified, the
73 above -H parameter should be the statically-defined 36-character
74 UUID of the Xen domain rather than its human-readable name.
75 -o operation
77 Fencing operation to perform (null, off, reboot; default=off).
78 This specifies the fencing operation to perform. The null oper‐
79 ation does not actually do anything, but allows you to check to
80 see if communication with fence_xvmd is working correctly (note:
81 the result of the null operation is *always* failure!).
82 -t timeout
84 This specifies the amount of time, in seconds, to wait before a
85 response to the multicast request before giving up (default=30).
86 -? Print out a help message describing available options, then
88 exit.
89 -h Print out a help message describing available options, then
91 exit.
92 -V Print out a version message, then exit.
94
97 debug = 1
98 Same as the -d option. Specify numbers >1 for more debugging
99 information.
100 family = < param >
102 Same as the -i option.
103 multicast_address = < param >
105 Same as the -a option.
106 port = < param >
108 Same as the -p option.
109 retrans = < param >
111 Same as the -r option.
112 auth = < param >
114 Same as the -C option.
115 hash = < param >
117 Same as the -c option.
118 key_file = < param >
120 Same as the -k option.
121 retrans = < param >
123 Same as the -r option.
124 domain = < param >
126 Same as the -H option.
127 use_uuid = 1
129 Same as the -u option.
130 option = < param >
132 Same as the -o option.
133 timeout = < param >
135 Same as the -t option.
136 domain = < param >
138 Same as the -H option.
139
142 fence(8), fence_node(8), fence_xvmd(8)
143 fence_xvm(8)