fence_docker man page

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-file or 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-file or 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)

Info

2009-10-20 fence_docker (Fence Agent)