fence_virt(8)

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

NAME

6       fence_virt - Fencing agent for virtual machines using VM Channel
7
8       fence_xvm - Fencing agent for virtual machines using multicast
9

DESCRIPTION

11       fence_virt  and  fence_xvm  are an I/O Fencing agents which can be used
12       with  virtual  machines.   Fence_xvm  is   backward   compatible   with
13       fence_xvmd.
14
15       Fence_virt  and  fence_xvm talk to fence_virtd, which supports multiple
16       backend plugins, including:
17        - libvirt for single-node operation
18        - Cluster Checkpoints when using Linux-cluster release 3.0.0 or later
19        - libvirt-qpid for multi-node, non-cluster operation
20
21       For compatibility, fence_xvm may talk to fence_xvmd from  linux-cluster
22       release 2 or later.
23
24
25       fence_virt  and fence_xvm accept options on the command line as well as
26       from stdin.  The fencing daemon sends parameters through stdin when  it
27       execs  the  agent.   The  agent  may be run by itself with command line
28       options, which is useful for testing  or  turning  on  or  off  virtual
29       machines from scripts.
30
31

GENERAL PARAMETERS

33
34
35       -d     Increment (command line) debug level
36
37       -H     Virtual machine (domain UUID or name) to fence
38
39
40       -o     Fencing action (null, off, on, reboot, status, monitor, list, or
41              metadata) (Default Value: reboot).  See the FENCING ACTIONS sec‐
42              tion.
43
44
45       -t     Fencing timeout (in seconds) (Default Value: 30)
46
47
48       -w     Fencing delay (in seconds). The fence agent will wait the speci‐
49              fied number of seconds before attempting  a  fencing  operation.
50              (Default Value: 0)
51
52

MULTICAST PARAMETERS

54       These  parameters are used only when using fence_virt in multicast mode
55       (e.g. by running fence_xvm).
56
57
58       -i     IP Family (auto, ipv4, ipv6) (Default Value: auto)
59
60       -a     Multicast address (Default Values: 225.0.0.12 / ff02::3:1)
61
62       -p     IP port (Default Value: 1229)
63
64       -T     Multicast time-to-live (in hops) (Default Value: 2)
65
66       -r     Multicast retransmit time (in 1/10sec) (Default Value: 20)
67
68       -C     Authentication (none,  sha1,  sha256,  sha512)  (Default  Value:
69              sha256)
70
71       -c     Packet  hash  strength  (none,  sha1,  sha256,  sha512) (Default
72              Value: sha256)
73
74       -k     Shared key file (Default Value: /etc/cluster/fence_xvm.key)
75
76
77       -u     Specify if using fence_virt with older fence_xvmd  installations
78              which are using UUIDs.  Fence_virtd ignores this parameter.
79
80

SERIAL/VMCHANNEL PARAMETERS

82       These  parameters  are  used  only when using fence_virt in serial mode
83       (e.g. by running fence_virt).
84
85
86       -D     Serial device (fence_virt mode). On the host, the serial  device
87              must  be  mapped  in  each  domain's  configuration  file.   See
88              fence_virt.conf(5) for more information.   Specifying  a  serial
89              device  causes  fence_virt  to  use  serial  mode (as opposed to
90              VMChannel mode).
91
92
93       -P     Serial parameters. (Default Value: 115200,8N1)
94
95
96       -A     VMChannel IP address (Default Value: 10.0.2.179)
97
98
99       -p     VMChannel IP port (Default Value: 1229)
100
101

GENERAL STDIN PARAMETERS

103       These parameters are passed to fence_virt via standard input if no com‐
104       mand line options are present.  They are presented to fence_virt in the
105       form:
106
107         name=value
108
109       debug  Specify debugging level
110
111
112       port   Virtual machine (domain UUID or name) to fence
113
114
115       action Fencing action (null, off, on, reboot,  status,  monitor,  list,
116              list-status, validate-all, or metadata) (Default Value: reboot).
117              See the FENCING ACTIONS section.
118
119       timeout
120              Fencing timeout (in seconds) (Default Value: 30)
121
122

MULTICAST STDIN PARAMETERS

124       ip_family
125              IP Family ([auto], ipv4, ipv6) (Default Value: auto)
126
127       multicast_address
128              Multicast address (Defaults: 225.0.0.12 / ff02::3:1)
129
130       port   IP port (Default Value: 1229)
131
132       multicast_ttl
133              Multicast time-to-live (in hops) (Default Value: 2)
134
135       retrans
136              Multicast retransmit time (in 1/10sec) (Default Value: 20)
137
138       auth   Authentication (none,  sha1,  sha256,  sha512)  (Default  Value:
139              sha256)
140
141       hash   Packet  hash  strength  (none,  sha1,  sha256,  sha512) (Default
142              Value: sha256)
143
144       key_file
145              Shared key file (Default Value: /etc/cluster/fence_xvm.key)
146
147
148       use_uuid
149              Specify if using fence_virt with older fence_xvmd  installations
150              which are using UUIDs.  Fence_virtd ignores this parameter.
151
152

SERIAL/VMCHANNEL STDIN PARAMETERS

154       serial_device
155              Serial device.  On the host, the serial device must be mapped in
156              each domain's configuration file.   See  fence_virt.conf(5)  for
157              more information.  If specified, causes fence_virt to operate in
158              serial mode (not specifying causes fence_virt to operate  in  VM
159              Channel mode).
160
161
162       serial_params
163              Serial parameters.  Default=115200,8N1.
164
165
166       channel_ip
167              Channel IP.  Default=10.0.2.179
168
169
170       ipport Channel port.  Default=1229
171
172
173

FENCING ACTIONS

175
176
177       off
178               Destroy or turn off virtual machine.
179
180       reboot Reboot  virtual machine; i.e. restart the virtual machine on the
181              same host where it is currently running.
182
183       on     Turn on a virtual machine.  Note: Turning on a  virtual  machine
184              only works with some fence_virt backends.
185
186
187       status Check whether a virtual machine is running or not.
188
189
190       monitor
191              Check the health of fence_virtd's backend plugin.
192
193
194       list   List  virtual  machines  which may be fenced by fence_virtd (not
195              supported on all backends).
196
197
198       validate-all
199              Validate arguments given on either the command line or  standard
200              input.  If validation fails, the fence agent will exit with code
201              1, otherwise it will exit with code 0.
202
203
204       metadata
205              Print XML metadata to standard output.
206
207