NAME¶
fence_ipmilan - Fence agent for IPMI over LAN
DESCRIPTION¶
fence_ipmilan is an I/O Fencing agent which can be used with machines controlled
by IPMI. This agent calls support software using ipmitool
(
http://ipmitool.sf.net/).
To use fence_ipmilan with HP iLO 3 you have to enable lanplus option (lanplus /
-P) and increase wait after operation to 4 seconds (power_wait=4 / -T 4)
fence_ipmilan accepts options on the command line as well as from stdin. Fenced
sends parameters through stdin when it execs the agent. fence_ipmilan can be
run by itself with command line options. This is useful for testing and for
turning outlets on or off from scripts.
PARAMETERS¶
- -A
- IPMI Lan Auth type (md5, password, or none)
- -a
- IPMI Lan IP to talk to
- -p
- Password (if required) to control power on IPMI device
- -S
- Script to retrieve password (if required)
- -P
- Use Lanplus
- -l
- Username/Login (if required) to control power on IPMI device
- -o
- Operation to perform. Valid operations: on, off, reboot, status, list,
diag, monitor or metadata (Default Value: reboot)
- -t
- Timeout (sec) for IPMI operation
- -C
- Ciphersuite to use (same as ipmitool -C parameter)
- -M
- Method to fence (onoff or cycle) (Default Value: onoff)
- -T
- Wait X seconds after on/off operation (Default Value: 2)
- -f
- Wait X seconds before fencing is started
- -v
- Verbose mode
ACTIONS¶
- on
- Power on machine.
- off
- Power off machine.
- reboot
- Reboot machine.
- status
- This returns the status of the plug/virtual machine.
- diag
-
The operational behavior of this is not known.
- 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¶
- auth
- IPMI Lan Auth type (md5, password, or none)
- ipaddr
- IPMI Lan IP to talk to
- passwd
- Password (if required) to control power on IPMI device
- passwd_script
- Script to retrieve password (if required)
- lanplus
- Use Lanplus
- login
- Username/Login (if required) to control power on IPMI device
- action
- Operation to perform. Valid operations: on, off, reboot, status, list,
diag, monitor or metadata (Default Value: reboot)
- timeout
- Timeout (sec) for IPMI operation
- cipher
- Ciphersuite to use (same as ipmitool -C parameter)
- method
- Method to fence (onoff or cycle) (Default Value: onoff)
- power_wait
- Wait X seconds after on/off operation (Default Value: 2)
- delay
- Wait X seconds before fencing is started
- verbose
- Verbose mode