NAME

       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=[tenant]
              Keystone Admin Tenant (Default Value: )

       -l, --username=[name]
              Login name

       --insecure
              Allow Insecure TLS Requests (Default Value: False)

       -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 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 (Default Value: )

       username
              Login name Obsoletes: login

       insecure
              Allow Insecure TLS Requests (Default Value: False)

       domain 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)

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

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

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