Man Linux: Main Page and Category List

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)