Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
FENCE_AGENT(8)		    System Manager's Manual		FENCE_AGENT(8)

NAME
       fence_pve - Fencing agent for the Proxmox Virtual Environment

DESCRIPTION
       The  fence_pve  agent  can  be used to fence virtual machines acting as
       nodes in	a virtualized cluster.

       fence_pve accepts options on the	command	line as	well  as  from	stdin.
       Fenced  sends  parameters  through  stdin  when	it  execs  the	agent.
       fence_pve can be	run by itself with command line	options.  This is use-
       ful for testing and for turning outlets on or off from scripts.

       Vendor URL: http://www.proxmox.com/

PARAMETERS

       -o, --action=[action]
	      Fencing action (Default Value: reboot)

       -a, --ip=[ip]
	      IP Address or Hostname of	a node	within	the  Proxmox  cluster.
	      This parameter is	always required.

       -u, --ipport=[port]
	      TCP/UDP  port  to	use for	connection with	device (Default	Value:
	      8006)

       -m, --method=[method]
	      Method to	fence (onoff|cycle) (Default Value: onoff)

       -p, --password=[password]
	      Login password or	passphrase

       -S, --password-script=[script]
	      Script to	run to retrieve	password

       -n, --plug=[id]
	      Id of the	virtual	machine. This parameter	 is  always  required.

       -z, --ssl
	      Use SSL connection with verifying	certificate (Default Value: 1)

       --ssl-insecure
	      Use SSL connection without verifying certificate

       --ssl-secure
	      Use SSL connection with verifying	certificate

       -l, --username=[name]
	      Login name (Default Value: root@pam)

       -N, --pve-node=[node_name]
	      Proxmox  node  name on which machine is located. (Must be	speci-
	      fied if not using	--pve-node-auto)

       -A, --pve-node-auto
	      Automatically select proxmox node. (This option overrides	--pve-
	      node)

       --vmtype
	      Virtual machine type  lxc	 or  qemu.  (Default:  qemu)  (Default
	      Value: qemu)

       --nodename
	      Replaced by --pve-node

       -q, --quiet
	      Disable logging to stderr. Does not affect --verbose or --debug-
	      file or logging to syslog.

       -v, --verbose
	      Verbose  mode.  Multiple	-v flags can be	stacked	on the command
	      line (e.g., -vvv)	to increase verbosity.

       --verbose-level
	      Level of debugging detail	in output. Defaults to the  number  of
	      --verbose	 flags	specified on the command line, or to 1 if ver-
	      bose=1 in	a  stonith  device  configuration  (i.e.,  on  stdin).

       -D, --debug-file=[debugfile]
	      Write debug information to given file

       -V, --version
	      Display version information and exit

       -h, --help
	      Display help and exit

       --plug-separator=[char]
	      Separator	 for  plug  parameter when specifying more than	1 plug
	      (Default Value: ,)

       -C, --separator=[char]
	      Separator	for CSV	created	by 'list' operation (Default Value: ,)

       --delay=[seconds]
	      Wait X seconds before fencing  is	 started  (Default  Value:  0)

       --disable-timeout=[true/false]
	      Disable  timeout (true/false) (default: true when	run from Pace-
	      maker 2.0+)

       --login-timeout=[seconds]
	      Wait X seconds for cmd prompt after  login  (Default  Value:  5)

       --power-timeout=[seconds]
	      Test  X  seconds	for status change after	ON/OFF (Default	Value:
	      20)

       --power-wait=[seconds]
	      Wait X seconds after issuing ON/OFF (Default Value: 0)

       --shell-timeout=[seconds]
	      Wait X seconds for cmd prompt  after  issuing  command  (Default
	      Value: 3)

       --stonith-status-sleep=[seconds]
	      Sleep  X	seconds	 between  status calls during a	STONITH	action
	      (Default Value: 1)

       --retry-on=[attempts]
	      Count of attempts	to retry power on (Default Value: 1)

       --gnutlscli-path=[path]
	      Path to gnutls-cli binary	(Default Value:	/usr/bin/gnutls-cli)

ACTIONS

       on     Power on machine.

       off    Power off	machine.

       reboot Reboot machine.

       status This returns the status of the plug/virtual machine.

       list   List available plugs with	aliases/virtual	machines if  there  is
	      support for more then one	device.	Returns	N/A otherwise.

       list-status
	      List  available  plugs  with  aliases/virtual machines and their
	      power state if it	can be obtained	without	 additional  commands.

       monitor
	      Check the	health of fence	device

       metadata
	      Display the XML metadata describing this resource.

       manpage
	       The operational behavior	of this	is not known.

       validate-all
	      Validate if all required parameters are entered.

STDIN PARAMETERS

       action Fencing action (Default Value: reboot)

       ip     IP  Address  or  Hostname	 of a node within the Proxmox cluster.
	      This parameter is	always required. Obsoletes: ipaddr

       ipport TCP/UDP port to use for connection with device  (Default	Value:
	      8006)

       method Method to	fence (onoff|cycle) (Default Value: onoff)

       password
	      Login password or	passphrase Obsoletes: passwd

       password_script
	      Script  to  run  to  retrieve  password Obsoletes: passwd_script

       plug   Id of the	virtual	machine. This parameter	 is  always  required.
	      Obsoletes: port

       ssl    Use SSL connection with verifying	certificate (Default Value: 1)

       ssl_insecure
	      Use SSL connection without verifying certificate

       ssl_secure
	      Use SSL connection with verifying	certificate

       username
	      Login name (Default Value: root@pam) Obsoletes: login

       pve_node
	      Proxmox  node  name on which machine is located. (Must be	speci-
	      fied if not using	--pve-node-auto)

       pve_node_auto
	      Automatically select proxmox node. (This option overrides	--pve-
	      node)

       vmtype Virtual machine type  lxc	 or  qemu.  (Default:  qemu)  (Default
	      Value: qemu)

       nodename
	      Replaced by --pve-node Obsoletes:	node_name

       quiet  Disable logging to stderr. Does not affect --verbose or --debug-
	      file or logging to syslog.

       verbose
	      Verbose  mode.  Multiple	-v flags can be	stacked	on the command
	      line (e.g., -vvv)	to increase verbosity.

       verbose_level
	      Level of debugging detail	in output. Defaults to the  number  of
	      --verbose	 flags	specified on the command line, or to 1 if ver-
	      bose=1 in	a  stonith  device  configuration  (i.e.,  on  stdin).

       debug_file
	      Write debug information to given file Obsoletes: debug

       version
	      Display version information and exit

       help   Display help and exit

       plug_separator
	      Separator	 for  plug  parameter when specifying more than	1 plug
	      (Default Value: ,)

       separator
	      Separator	for CSV	created	by 'list' operation (Default Value: ,)

       delay  Wait X seconds before fencing  is	 started  (Default  Value:  0)

       disable_timeout
	      Disable  timeout (true/false) (default: true when	run from Pace-
	      maker 2.0+)

       login_timeout
	      Wait X seconds for cmd prompt after  login  (Default  Value:  5)

       power_timeout
	      Test  X  seconds	for status change after	ON/OFF (Default	Value:
	      20)

       power_wait
	      Wait X seconds after issuing ON/OFF (Default Value: 0)

       shell_timeout
	      Wait X seconds for cmd prompt  after  issuing  command  (Default
	      Value: 3)

       stonith_status_sleep
	      Sleep  X	seconds	 between  status calls during a	STONITH	action
	      (Default Value: 1)

       retry_on
	      Count of attempts	to retry power on (Default Value: 1)

       gnutlscli_path
	      Path to gnutls-cli binary	(Default Value:	/usr/bin/gnutls-cli)

fence_pve (Fence Agent)		  2009-10-20			FENCE_AGENT(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=fence_pve&sektion=8&manpath=FreeBSD+Ports+15.0>

home | help