NAME¶
fence_eps - Fence agent for ePowerSwitch
DESCRIPTION¶
fence_eps is an I/O Fencing agent which can be used with the ePowerSwitch 8M+
power switch to fence connected machines. Fence agent works ONLY on 8M+
device, because this is only one, which has support for hidden page feature.
- Agent basically works by connecting to hidden page and pass appropriate
arguments to GET request. This means, that hidden page feature must be
enabled and properly configured.
fence_eps accepts options on the command line as well as from stdin. Fenced
sends parameters through stdin when it execs the agent. fence_eps 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:
http://www.epowerswitch.com
PARAMETERS¶
- -o, --action=<action>
- Fencing Action (Default Value: reboot)
- -a, --ip=<ip>
- IP Address or Hostname This parameter is always required.
- -l, --username=<name>
- Login Name
- -p, --password=<password>
- Login password or passphrase
- -S, --password-script=<script>
- Script to retrieve password
- -n, --plug=<id>
- Physical plug number or name of virtual machine This parameter is always
required.
- -c, --page=<page>
- Name of hidden page (Default Value: hidden.htm)
- -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 operation list (Default Value: ,)
- --delay
- Wait X seconds before fencing is started (Default Value: 0)
- --retry-on
- Count of attempts to retry power on (Default Value: 1)
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.
- monitor
- Check if fencing device is running. List available plugs/virtual machines
or get status of machine (if it does not support more).
- metadata
-
The operational behavior of this is not known.
STDIN PARAMETERS¶
- action
- Fencing Action (Default Value: reboot)
- ipaddr
- IP Address or Hostname This parameter is always required.
- login
- Login Name
- passwd
- Login password or passphrase
- passwd_script
- Script to retrieve password
- port
- Physical plug number or name of virtual machine This parameter is always
required.
- hidden_page
- Name of hidden page (Default Value: hidden.htm)
- verbose
- Verbose mode
- debug
- Write debug information to given file
- version
- Display version information and exit
- help
- Display help and exit
- separator
- Separator for CSV created by operation list (Default Value: ,)
- delay
- Wait X seconds before fencing is started (Default Value: 0)
- retry_on
- Count of attempts to retry power on (Default Value: 1)