1
2FENCE_AGENT(8)              System Manager's Manual             FENCE_AGENT(8)
3
4
5

NAME

7       fence_ipmilan - Fence agent for IPMI over LAN
8

DESCRIPTION

10       fence_ipmilan  is  an I/O Fencing agent which can be used with machines
11       controlled by IPMI. This agent calls support  software  using  ipmitool
12       (http://ipmitool.sf.net/).
13
14       To  use  fence_ipmilan  with HP iLO 3 you have to enable lanplus option
15       (lanplus  /  -P)  and  increase  wait  after  operation  to  4  seconds
16       (power_wait=4 / -T 4)
17
18       fence_ipmilan  accepts  options  on  the  command  line as well as from
19       stdin. Fenced sends parameters through stdin when it execs  the  agent.
20       fence_ipmilan  can be run by itself with command line options.  This is
21       useful for testing and for turning outlets on or off from scripts.
22
23

PARAMETERS

25
26
27       -A     IPMI Lan Auth type (md5, password, or none)
28
29       -a     IPMI Lan IP to talk to
30
31       -p     Password (if required) to control power on IPMI device
32
33       -S     Script to retrieve password (if required)
34
35       -P     Use Lanplus
36
37       -l     Username/Login (if required) to control  power  on  IPMI  device
38
39
40       -o     Operation to perform. Valid operations: on, off, reboot, status,
41              list, diag, monitor or metadata (Default Value: reboot)
42
43       -t     Timeout (sec) for IPMI operation
44
45       -C     Ciphersuite to use (same as ipmitool -C parameter)
46
47       -M     Method to fence (onoff or cycle) (Default Value: onoff)
48
49       -T     Wait X seconds after on/off operation (Default Value: 2)
50
51       -f     Wait X seconds before fencing is started
52
53       -L     Privilege level on IPMI device
54
55       -v     Verbose mode
56
57

ACTIONS

59
60
61       on     Power on machine.
62
63       off    Power off machine.
64
65       reboot Reboot machine.
66
67       status This returns the status of the plug/virtual machine.
68
69       diag
70               The operational behavior of this is not known.
71
72       list   List available plugs with aliases/virtual machines if  there  is
73              support for more then one device. Returns N/A otherwise.
74
75       monitor
76              Check if fencing device is running. List available plugs/virtual
77              machines or get status of machine (if it does not support more).
78
79
80       metadata
81               The operational behavior of this is not known.
82
83

STDIN PARAMETERS

85
86
87       auth   IPMI Lan Auth type (md5, password, or none)
88
89       ipaddr IPMI Lan IP to talk to
90
91       passwd Password (if required) to control power on IPMI device
92
93       passwd_script
94              Script to retrieve password (if required)
95
96       lanplus
97              Use Lanplus
98
99       login  Username/Login  (if  required)  to  control power on IPMI device
100
101
102       action Operation to perform. Valid operations: on, off, reboot, status,
103              list, diag, monitor or metadata (Default Value: reboot)
104
105       timeout
106              Timeout (sec) for IPMI operation
107
108       cipher Ciphersuite to use (same as ipmitool -C parameter)
109
110       method Method to fence (onoff or cycle) (Default Value: onoff)
111
112       power_wait
113              Wait X seconds after on/off operation (Default Value: 2)
114
115       delay  Wait X seconds before fencing is started
116
117       privlvl
118              Privilege level on IPMI device
119
120       verbose
121              Verbose mode
122
123
124
125fence_ipmilan (Fence Agent)       2009-10-20                    FENCE_AGENT(8)