fence_xvmd(8)

NAME
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.

-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 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.

-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 virtual machines and the host machine or 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 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.

-U uri
    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.

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)