fence_xvmd(8)

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)