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
11       Remote 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       --delay=[seconds]
80              Wait  X  seconds  before  fencing  is started (Default Value: 0)
81
82
83       --disable-timeout=[true/false]
84              Disable timeout (true/false) (default: true when run from  Pace‐
85              maker 2.0+)
86
87       --login-timeout=[seconds]
88              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
89
90
91       --port-as-ip
92              Make "port/plug" to be an alias to IP address
93
94       --power-timeout=[seconds]
95              Test X seconds for status change after  ON/OFF  (Default  Value:
96              20)
97
98       --power-wait=[seconds]
99              Wait X seconds after issuing ON/OFF (Default Value: 0)
100
101       --shell-timeout=[seconds]
102              Wait  X  seconds  for  cmd prompt after issuing command (Default
103              Value: 3)
104
105       --retry-on=[attempts]
106              Count of attempts to retry power on (Default Value: 1)
107
108       --telnet-path=[path]
109              Path to telnet binary (Default Value: /usr/bin/telnet)
110
111

ACTIONS

113
114
115       on     Power on machine.
116
117       off    Power off machine.
118
119       reboot Reboot machine.
120
121       status This returns the status of the plug/virtual machine.
122
123       monitor
124              Check the health of fence device
125
126       metadata
127              Display the XML metadata describing this resource.
128
129       manpage
130               The operational behavior of this is not known.
131
132       validate-all
133              Validate if all required parameters are entered.
134
135

STDIN PARAMETERS

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