fence_compute man page

fence_compute — Fence agent for the automatic resurrection of OpenStack compute instances

Description

Used to tell Nova that compute nodes are down and to reschedule flagged instances

fence_compute accepts options on the command line as well as from stdin. Fenced sends parameters through stdin when it execs the agent. fence_compute 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:

Parameters

-o, --action=[action]

Fencing action (Default Value: off)

-k, --auth-url=[url]

Keystone Admin Auth URL (Default Value: )

-e, --endpoint-type=[endpoint]

Nova Endpoint type (Default Value: internalURL)

-p, --password=[password]

Login password or passphrase

-S, --password-script=[script]

Script to run to retrieve password

-n, --plug=[id]

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

--region-name=[region]

Region Name (Default Value: )

-t, --tenant-name=[name]

Keystone Admin Tenant or v3 Project (Default Value: )

-l, --username=[name]

Login name

--insecure

Allow Insecure TLS Requests (Default Value: False)

-d, --project-domain=[name]

Keystone v3 Project Domain (Default Value: Default)

-u, --user-domain=[name]

Keystone v3 User Domain (Default Value: Default)

-d, --domain=[string]

DNS domain in which hosts live

--instance-filtering

Allow instances to be evacuated (Default Value: True)

--no-shared-storage

Disable functionality for dealing with shared storage (Default Value: False)

--record-only

Only record the target as needing evacuation (Default Value: False)

-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: 180)

--retry-on=[attempts]

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

Actions

on

Power on machine.

off

Power off 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: off)

auth_url

Keystone Admin Auth URL (Default Value: )

endpoint_type

Nova Endpoint type (Default Value: internalURL)

password

Login password or passphrase Obsoletes: passwd

password_script

Script to run to retrieve password Obsoletes: passwd_script

plug

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

region_name

Region Name (Default Value: )

tenant_name

Keystone Admin Tenant or v3 Project (Default Value: )

username

Login name Obsoletes: login

insecure

Allow Insecure TLS Requests (Default Value: False)

project_domain

Keystone v3 Project Domain (Default Value: Default) Obsoletes: project-domain

user_domain

Keystone v3 User Domain (Default Value: Default) Obsoletes: user-domain

domain

DNS domain in which hosts live Obsoletes: compute-domain

instance_filtering

Allow instances to be evacuated (Default Value: True)

no_shared_storage

Disable functionality for dealing with shared storage (Default Value: False)

record_only

Only record the target as needing evacuation (Default Value: False)

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: 180)

retry_on

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

Info

2009-10-20 fence_compute (Fence Agent)