fence_xvmd(8)fence_xvmd(8)NAMEfence_xvmd - I/O Fencing agent host for Xen virtual machines.
SYNOPSISfence_xvmd [OPTION]...
DESCRIPTIONfence_xvmd is an I/O Fencing host which resides on dom0 and is used in
conjunction with the fence_xvm fencing agent. Together, these two pro‐
grams can be used to fence can be used to fence Xen virtual machines
which are part of a cluster. There is a requirement that the parent
dom0s are also a part of their own CMAN/OpenAIS based cluster, and that
the dom0 cluster does not share any members with the domU cluster.
Furthermore, the dom0 cluster is required to have fencing if domU
recovery is expected to be automatic.
fence_xvmd accepts options on the command line.
OPTIONS-f Foreground mode (do not fork)
-d Enable debugging output. The more times you specify this param‐
eter, the more debugging output you will receive.
-i family
IP family to use (auto, ipv4, or ipv6; default = auto)
-a address
Multicast address to listen on (default=225.0.0.12 for ipv4,
ff02::3:1 for ipv6)
-p port
Port to use (default=1229)
-I interface
Network interface to listen on, e.g. eth0.
-C auth
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 Xen virtual machines and
the host domain-0 cluster. The three SHA authentication mecha‐
nisms use a simple bidirectional challenge-response based on
pseudo- random number generation and a shared private key.
-c hash
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 Xen virtual machines and the host domain-0
cluster.
-k key_file
Use the specified key file for packet hashing / SHA authentica‐
tion. When both the hash type and the authentication type are
set to "none", this parameter is ignored.
-u Fence by UUID instead of Xen Domain 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 spec‐
ify this parameter. -V
-L Local-only / non-cluster mode. When used with -X, this this
option prevents fence_xvmd from operating as a clustered ser‐
vice, obviating the need to configure/run CMAN on the host
domain.
-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.
family="param"
Same as the -i option.
multicast_address="param"
Same as the -a option.
port="param"
Same as the -p option.
auth="param"
Same as the -C option.
hash="param"
Same as the -c option.
key_file="param"
Same as the -k option.
use_uuid="1"
Same as the -u option.
SEE ALSO
fence(8), fence_node(8), fence_xvm(8)fence_xvmd(8)
