bionic (8) fence_docker.8.gz

Provided by: fence-agents_4.0.25-2ubuntu1.3_amd64 bug

NAME

       fence_docker - Fence agent for Docker

DESCRIPTION

       fence_docker  is  I/O fencing agent which can be used with the Docker Engine containers. You can use this
       fence-agent without any authentication, or you can use TLS authentication (use --ssl  option,  more  info
       about TLS authentication in docker: http://docs.docker.com/examples/https/).

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

       Vendor URL: www.docker.io

PARAMETERS

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

       -4, --inet4-only
              Forces agent to use IPv4 addresses only

       -6, --inet6-only
              Forces agent to use IPv6 addresses only

       -a, --ip=[ip]
              IP address or hostname of fencing device This parameter is always required.

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

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

       -n, --plug=[id]
              Physical  plug  number  on  device,  UUID  or  identification  of machine This parameter is always
              required.

       -z, --ssl
              Use SSL connection with verifying certificate

       --ssl-insecure
              Use SSL connection without verifying certificate

       --ssl-secure
              Use SSL connection with verifying certificate

       --api-version
              Version of Docker Remote API (default: 1.11) (Default Value: 1.11)

       --tlscacert
              Path to CA certificate (PEM format) for TLS authentication. Required  if  --ssl  option  is  used.

       --tlscert
              Path  to client certificate (PEM format) for TLS authentication. Required if --ssl option is used.

       --tlskey
              Path to client key (PEM format) for TLS authentication. Required if --ssl option is used.

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

       -v, --verbose
              Verbose mode

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

       -V, --version
              Display version information and exit

       -h, --help
              Display help and exit

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

       --delay=[seconds]
              Wait X seconds before fencing is started (Default Value: 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)

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

       validate-all
              Validate if all required parameters are entered.

STDIN PARAMETERS

       action Fencing action (Default Value: reboot)

       inet4_only
              Forces agent to use IPv4 addresses only

       inet6_only
              Forces agent to use IPv6 addresses only

       ip     IP address or hostname of fencing device This parameter  is  always  required.  Obsoletes:  ipaddr

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

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

       plug   Physical  plug  number  on  device,  UUID  or  identification  of machine This parameter is always
              required. Obsoletes: port

       ssl    Use SSL connection with verifying certificate

       ssl_insecure
              Use SSL connection without verifying certificate

       ssl_secure
              Use SSL connection with verifying certificate

       api_version
              Version of Docker Remote API (default: 1.11) (Default Value: 1.11)

       tlscacert
              Path to CA certificate (PEM format) for TLS authentication. Required  if  --ssl  option  is  used.

       tlscert
              Path  to client certificate (PEM format) for TLS authentication. Required if --ssl option is used.

       tlskey Path to client key (PEM format) for TLS authentication. Required if --ssl option is used.

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

       verbose
              Verbose mode

       debug_file
              Write debug information to given file Obsoletes: debug

       version
              Display version information and exit

       help   Display help and exit

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

       delay  Wait X seconds before fencing is started (Default Value: 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)

       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)