NAME
fence_virsh - I/O Fencing agent for libvirt virtual machines using
SYNOPSIS
fence_virsh [OPTION]...
DESCRIPTION
fence_virsh is an I/O Fencing agent which can be used with the virtual
machines managed by libvirt. It logs via ssh to a dom0 and there run
virsh command, which does all work.
By default, virsh needs root account to do properly work. So you must
allow ssh login in your sshd_config.
fence_virsh accepts options on the command line as well as from stdin.
Fenced sends parameters through stdin when it execs the agent.
fence_virsh can be run by itself with command line options. This is
useful for testing and for turning outlets on or off from scripts.
OPTIONS
-a IPaddress
IP address or hostname of dom0.
-h Print out a help message describing available options, then
exit.
-l login
Login name of user root in dom0.
-o action
The action required. This can be reboot (default), status, off,
on, list or monitor.
-p password
Password for login or for passphrase for dom0 machine.
-B script
Script to run to retrieve password for dom0 machine.
-n name
Name of virtual machine to fence
-x Use secure connection over ssh (this is default, and can’t be
disabled)
-k filename
Identity file (private key) for ssh
-T Test only. Answer NO to the confirmation prompt instead of YES.
-v Verbose. Record session to stdout, or debug file if specified
(see -D).
-D Specifies file, where will be written debug messages from
session.
-V Print out a version message, then exit.
STDIN PARAMETERS
agent = < param >
This option is used by fence_node(8) and is ignored by
fence_virsh.
ipaddr = < hostname | ip >
IP address or hostname of dom0.
login = < param >
Login name of user root in dom0.
option = < param >
The action required. This can be reboot (default), status, off
or on.
passwd = < param >
Password for login or for passphrase for dom0 machine.
passwd_script = < param >
Script to run to retrieve password for dom0 machine.
port = < param >
Name of virtual machine to fence.
secure = < param >
Use secure connection over ssh (this is default, and can’t be
disabled)
identity_file = < param >
Identity file (private key) for ssh
test = < param >
Test only. Answer NO to the confirmation prompt instead of YES.
verbose = < param >
Verbose. Record session to stdout, or debug file if specified
(see debug).
debug = < param >
Specifies file, where will be written debug messages from
session.
SEE ALSO
fence(8), fence_node(8)
fence_virsh(8)