fence_xvmd - Libvirt-based, general purpose fencing host for virtual machines.
SYNOPSIS
fence_xvmd
[OPTION]...
DESCRIPTION
fence_xvmd is an I/O Fencing host which resides on bare metal machines
and is used in conjunction with the fence_xvm fencing agent. Together,
these two programs can be used to fence can be used
machines which are part of a cluster.
If the virtual machines are backed by clustered storage or the virtual
machines may be migrated to other physical machines, all physical
machines in question must also be a part of their own CMAN/OpenAIS based
cluster. Furthermore, the bare metal cluster is required to have
fencing configured if virtual machine recovery is expected to be automatic.
fence_xvmd accepts options on the command line and from cluster.conf
OPTIONS
-f
Foreground mode (do not fork)
-d
Enable debugging output. The more times you specify this parameter,
the more debugging output you will receive.
-ifamily
IP family to use (auto, ipv4, or ipv6; default = auto)
-aaddress
Multicast address to listen on (default=225.0.0.12 for ipv4, ff02::3:1
for ipv6)
-pport
Port to use (default=1229)
-Iinterface
Network interface to listen on, e.g. eth0.
-Cauth
Authentication type (none, sha1, sha256, sha512; default=sha256). This
controls the authentication mechanism used to authenticate clients. The
three SHA hashes use a key which must be shared between both the virtual
machines and the host machine or cluster. The three SHA authentication
mechanisms use a simple bidirectional challenge-response based on pseudo-
random number generation and a shared private key.
-chash
Packet hash type (none, sha1, sha256, sha512; default=sha256). This
controls the hashing mechanism used to authenticate fencing requests. The
three SHA hashes use a key which must be shared between both the virtual
machines and the host machine or cluster.
-kkey_file
Use the specified key file for packet hashing / SHA authentication.
When both the hash type and the authentication type are set to "none",
this parameter is ignored.
-u
Fence by UUID instead of virtual machine name.
-?
Print out a help message describing available options, then exit.
-h
Print out a help message describing available options, then exit.
-X
Do not connect to CCS for configuration; only use command line
parameters. CCS configuration parameters override command line
parameters (because they are cluster-wide), so if you need to
override a configuration option contained in CCS, you must specify
this parameter.
-L
Local-only / non-cluster mode. When used with -X, this this option
prevents fence_xvmd from operating as a clustered service, obviating
the need to configure/run CMAN on the host domain.
-Uuri
Force use of the specified URI for connecting to the hypervisor.
-V
Print out a version message, then exit.
CCS PARAMETERS
CCS options are simply attributes of the <fence_xvmd> tag, a
child of the <cluster> tag in /etc/cluster/cluster.conf.
debug="1"
Same as the -d option. Specify numbers >1 for more debugging information.