NAME
fence_xvmd - I/O Fencing agent host for Xen virtual machines.
SYNOPSIS
fence_xvmd
[OPTION]...
DESCRIPTION
fence_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 programs
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 parameter,
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)
-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
mechanisms 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 authentication.
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 specify
this parameter.
-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)