1FENCE_AGENT(8) System Manager's Manual FENCE_AGENT(8)
3
7 fence_drac - I/O Fencing agent for Dell DRAC IV
8
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 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 Vendor URL: http://www.dell.com
25
27 -o, --action=[action]
30 Fencing action (Default Value: reboot)
31 -c, --command-prompt=[prompt]
33 Force Python regex for command prompt (Default Value: ['\[user‐
34 name\]# '])
35 -a, --ip=[ip]
37 IP address or hostname of fencing device
38 -u, --ipport=[port]
40 TCP/UDP port to use for connection with device (Default Value:
41 23)
42 -p, --password=[password]
44 Login password or passphrase
45 -S, --password-script=[script]
47 Script to run to retrieve password
48 -n, --plug=[ip]
50 IP address or hostname of fencing device (together with --port-
51 as-ip)
52 -l, --username=[name]
54 Login name This parameter is always required.
55 -q, --quiet
57 Disable logging to stderr. Does not affect --verbose or --debug-
58 file or logging to syslog.
59 -v, --verbose
61 Verbose mode. Multiple -v flags can be stacked on the command
62 line (e.g., -vvv) to increase verbosity.
63 --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 -D, --debug-file=[debugfile]
71 Write debug information to given file
72 -V, --version
74 Display version information and exit
75 -h, --help
77 Display help and exit
78 --delay=[seconds]
80 Wait X seconds before fencing is started (Default Value: 0)
81 --disable-timeout=[true/false]
84 Disable timeout (true/false) (default: true when run from Pace‐
85 maker 2.0+)
86 --login-timeout=[seconds]
88 Wait X seconds for cmd prompt after login (Default Value: 5)
89 --port-as-ip
92 Make "port/plug" to be an alias to IP address
93 --power-timeout=[seconds]
95 Test X seconds for status change after ON/OFF (Default Value:
96 20)
97 --power-wait=[seconds]
99 Wait X seconds after issuing ON/OFF (Default Value: 0)
100 --shell-timeout=[seconds]
102 Wait X seconds for cmd prompt after issuing command (Default
103 Value: 3)
104 --stonith-status-sleep=[seconds]
106 Sleep X seconds between status calls during a STONITH action
107 (Default Value: 1)
108 --retry-on=[attempts]
110 Count of attempts to retry power on (Default Value: 1)
111 --telnet-path=[path]
113 Path to telnet binary (Default Value: /usr/bin/telnet)
114
117 on Power on machine.
120 off Power off machine.
122 reboot Reboot machine.
124 status This returns the status of the plug/virtual machine.
126 monitor
128 Check the health of fence device
129 metadata
131 Display the XML metadata describing this resource.
132 manpage
134 The operational behavior of this is not known.
135 validate-all
137 Validate if all required parameters are entered.
138
141 action Fencing action (Default Value: reboot)
144 command_prompt
146 Force Python regex for command prompt (Default Value: ['\[user‐
147 name\]# ']) Obsoletes: cmd_prompt
148 ip IP address or hostname of fencing device Obsoletes: ipaddr
150 ipport TCP/UDP port to use for connection with device (Default Value:
153 23)
154 password
156 Login password or passphrase Obsoletes: passwd
157 password_script
159 Script to run to retrieve password Obsoletes: passwd_script
160 plug IP address or hostname of fencing device (together with --port-
163 as-ip) Obsoletes: port
164 username
166 Login name This parameter is always required. Obsoletes: login
167 quiet Disable logging to stderr. Does not affect --verbose or --debug-
170 file or logging to syslog.
171 verbose
173 Verbose mode. Multiple -v flags can be stacked on the command
174 line (e.g., -vvv) to increase verbosity.
175 verbose_level
177 Level of debugging detail in output. Defaults to the number of
178 --verbose flags specified on the command line, or to 1 if ver‐
179 bose=1 in a stonith device configuration (i.e., on stdin).
180 debug_file
183 Write debug information to given file Obsoletes: debug
184 version
186 Display version information and exit
187 help Display help and exit
189 delay Wait X seconds before fencing is started (Default Value: 0)
191 disable_timeout
194 Disable timeout (true/false) (default: true when run from Pace‐
195 maker 2.0+)
196 login_timeout
198 Wait X seconds for cmd prompt after login (Default Value: 5)
199 port_as_ip
202 Make "port/plug" to be an alias to IP address
203 power_timeout
205 Test X seconds for status change after ON/OFF (Default Value:
206 20)
207 power_wait
209 Wait X seconds after issuing ON/OFF (Default Value: 0)
210 shell_timeout
212 Wait X seconds for cmd prompt after issuing command (Default
213 Value: 3)
214 stonith_status_sleep
216 Sleep X seconds between status calls during a STONITH action
217 (Default Value: 1)
218 retry_on
220 Count of attempts to retry power on (Default Value: 1)
221 telnet_path
223 Path to telnet binary (Default Value: /usr/bin/telnet)
224fence_drac (Fence Agent) 2009-10-20 FENCE_AGENT(8)