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

NAME

7       fence_drac - I/O Fencing agent for Dell DRAC IV
8

DESCRIPTION

10       fence_drac  is an I/O Fencing agent which can be used with the Dell Re‐
11       mote Access Card (DRAC). This card provides remote access  to  control‐
12       ling power to a server. It logs into the DRAC through the telnet inter‐
13       face of the card. By default, the telnet interface is not  enabled.  To
14       enable  the  interface,  you will need to use the racadm command in the
15       racser-devel rpm available from Dell.  To enable telnet  on  the  DRAC:
16       [root]#  racadm  config -g cfgSerial -o cfgSerialTelnetEnable 1 [root]#
17       racadm racreset
18
19       fence_drac accepts options on the command line as well as  from  stdin.
20       Fenced  sends  parameters  through  stdin  when  it  execs  the  agent.
21       fence_drac can be run by itself with command  line  options.   This  is
22       useful for testing and for turning outlets on or off from scripts.
23
24       Vendor URL: http://www.dell.com
25

PARAMETERS

27
28
29       -o, --action=[action]
30              Fencing action (Default Value: reboot)
31
32       -c, --command-prompt=[prompt]
33              Force  Python regex for command prompt (Default Value: ['\[user‐
34              name\]# '])
35
36       -a, --ip=[ip]
37              IP address or hostname of fencing device
38
39       -u, --ipport=[port]
40              TCP/UDP port to use for connection with device  (Default  Value:
41              23)
42
43       -p, --password=[password]
44              Login password or passphrase
45
46       -S, --password-script=[script]
47              Script to run to retrieve password
48
49       -n, --plug=[ip]
50              IP  address or hostname of fencing device (together with --port-
51              as-ip)
52
53       -l, --username=[name]
54              Login name This parameter is always required.
55
56       -q, --quiet
57              Disable logging to stderr. Does not affect --verbose or --debug-
58              file or logging to syslog.
59
60       -v, --verbose
61              Verbose  mode.  Multiple  -v flags can be stacked on the command
62              line (e.g., -vvv) to increase verbosity.
63
64       --verbose-level
65              Level of debugging detail in output. Defaults to the  number  of
66              --verbose  flags  specified on the command line, or to 1 if ver‐
67              bose=1 in a  stonith  device  configuration  (i.e.,  on  stdin).
68
69
70       -D, --debug-file=[debugfile]
71              Write debug information to given file
72
73       -V, --version
74              Display version information and exit
75
76       -h, --help
77              Display help and exit
78
79       --plug-separator=[char]
80              Separator  for  plug  parameter when specifying more than 1 plug
81              (Default Value: ,)
82
83       --delay=[seconds]
84              Wait X seconds before fencing  is  started  (Default  Value:  0)
85
86
87       --disable-timeout=[true/false]
88              Disable  timeout (true/false) (default: true when run from Pace‐
89              maker 2.0+)
90
91       --login-timeout=[seconds]
92              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
93
94
95       --port-as-ip
96              Make "port/plug" to be an alias to IP address
97
98       --power-timeout=[seconds]
99              Test  X  seconds  for status change after ON/OFF (Default Value:
100              20)
101
102       --power-wait=[seconds]
103              Wait X seconds after issuing ON/OFF (Default Value: 0)
104
105       --shell-timeout=[seconds]
106              Wait X seconds for cmd prompt  after  issuing  command  (Default
107              Value: 3)
108
109       --stonith-status-sleep=[seconds]
110              Sleep  X  seconds  between  status calls during a STONITH action
111              (Default Value: 1)
112
113       --retry-on=[attempts]
114              Count of attempts to retry power on (Default Value: 1)
115
116       --telnet-path=[path]
117              Path to telnet binary (Default Value: /usr/bin/telnet)
118
119

ACTIONS

121
122
123       on     Power on machine.
124
125       off    Power off machine.
126
127       reboot Reboot machine.
128
129       status This returns the status of the plug/virtual machine.
130
131       monitor
132              Check the health of fence device
133
134       metadata
135              Display the XML metadata describing this resource.
136
137       manpage
138               The operational behavior of this is not known.
139
140       validate-all
141              Validate if all required parameters are entered.
142
143

STDIN PARAMETERS

145
146
147       action Fencing action (Default Value: reboot)
148
149       command_prompt
150              Force Python regex for command prompt (Default Value:  ['\[user‐
151              name\]# ']) Obsoletes: cmd_prompt
152
153       ip     IP address or hostname of fencing device Obsoletes: ipaddr
154
155
156       ipport TCP/UDP port to use for connection with device  (Default  Value:
157              23)
158
159       password
160              Login password or passphrase Obsoletes: passwd
161
162       password_script
163              Script  to  run  to  retrieve  password Obsoletes: passwd_script
164
165
166       plug   IP address or hostname of fencing device (together with  --port-
167              as-ip) Obsoletes: port
168
169       username
170              Login  name  This parameter is always required. Obsoletes: login
171
172
173       quiet  Disable logging to stderr. Does not affect --verbose or --debug-
174              file or logging to syslog.
175
176       verbose
177              Verbose  mode.  Multiple  -v flags can be stacked on the command
178              line (e.g., -vvv) to increase verbosity.
179
180       verbose_level
181              Level of debugging detail in output. Defaults to the  number  of
182              --verbose  flags  specified on the command line, or to 1 if ver‐
183              bose=1 in a  stonith  device  configuration  (i.e.,  on  stdin).
184
185
186       debug_file
187              Write debug information to given file Obsoletes: debug
188
189       version
190              Display version information and exit
191
192       help   Display help and exit
193
194       plug_separator
195              Separator  for  plug  parameter when specifying more than 1 plug
196              (Default Value: ,)
197
198       delay  Wait X seconds before fencing  is  started  (Default  Value:  0)
199
200
201       disable_timeout
202              Disable  timeout (true/false) (default: true when run from Pace‐
203              maker 2.0+)
204
205       login_timeout
206              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
207
208
209       port_as_ip
210              Make "port/plug" to be an alias to IP address
211
212       power_timeout
213              Test  X  seconds  for status change after ON/OFF (Default Value:
214              20)
215
216       power_wait
217              Wait X seconds after issuing ON/OFF (Default Value: 0)
218
219       shell_timeout
220              Wait X seconds for cmd prompt  after  issuing  command  (Default
221              Value: 3)
222
223       stonith_status_sleep
224              Sleep  X  seconds  between  status calls during a STONITH action
225              (Default Value: 1)
226
227       retry_on
228              Count of attempts to retry power on (Default Value: 1)
229
230       telnet_path
231              Path to telnet binary (Default Value: /usr/bin/telnet)
232
233
234
235fence_drac (Fence Agent)          2009-10-20                    FENCE_AGENT(8)