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       -4, --inet4-only
37              Forces agent to use IPv4 addresses only
38
39       -6, --inet6-only
40              Forces agent to use IPv6 addresses only
41
42       -a, --ip=[ip]
43              IP address or hostname of fencing device
44
45       -u, --ipport=[port]
46              TCP/UDP port to use for connection with device  (Default  Value:
47              23)
48
49       -p, --password=[password]
50              Login password or passphrase
51
52       -S, --password-script=[script]
53              Script to run to retrieve password
54
55       -n, --plug=[ip]
56              IP  address or hostname of fencing device (together with --port-
57              as-ip)
58
59       -l, --username=[name]
60              Login name This parameter is always required.
61
62       -q, --quiet
63              Disable logging to stderr. Does not affect --verbose or --debug-
64              file or logging to syslog.
65
66       -v, --verbose
67              Verbose mode
68
69       -D, --debug-file=[debugfile]
70              Write debug information to given file
71
72       -V, --version
73              Display version information and exit
74
75       -h, --help
76              Display help and exit
77
78       --delay=[seconds]
79              Wait  X  seconds  before  fencing  is started (Default Value: 0)
80
81
82       --login-timeout=[seconds]
83              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
84
85
86       --port-as-ip
87              Make "port/plug" to be an alias to IP address
88
89       --power-timeout=[seconds]
90              Test  X  seconds  for status change after ON/OFF (Default Value:
91              20)
92
93       --power-wait=[seconds]
94              Wait X seconds after issuing ON/OFF (Default Value: 0)
95
96       --shell-timeout=[seconds]
97              Wait X seconds for cmd prompt  after  issuing  command  (Default
98              Value: 3)
99
100       --retry-on=[attempts]
101              Count of attempts to retry power on (Default Value: 1)
102
103       --telnet-path=[path]
104              Path to telnet binary (Default Value: /usr/bin/telnet)
105
106

ACTIONS

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

STDIN PARAMETERS

132
133
134       action Fencing action (Default Value: reboot)
135
136       command_prompt
137              Force  Python regex for command prompt (Default Value: ['\[user‐
138              name\]# ']) Obsoletes: cmd_prompt
139
140       inet4_only
141              Forces agent to use IPv4 addresses only
142
143       inet6_only
144              Forces agent to use IPv6 addresses only
145
146       ip     IP address or hostname of fencing device Obsoletes: ipaddr
147
148
149       ipport TCP/UDP  port  to use for connection with device (Default Value:
150              23)
151
152       password
153              Login password or passphrase Obsoletes: passwd
154
155       password_script
156              Script to run  to  retrieve  password  Obsoletes:  passwd_script
157
158
159       plug   IP  address or hostname of fencing device (together with --port-
160              as-ip) Obsoletes: port
161
162       username
163              Login name This parameter is always required.  Obsoletes:  login
164
165
166       quiet  Disable logging to stderr. Does not affect --verbose or --debug-
167              file or logging to syslog.
168
169       verbose
170              Verbose mode
171
172       debug_file
173              Write debug information to given file Obsoletes: debug
174
175       version
176              Display version information and exit
177
178       help   Display help and exit
179
180       delay  Wait X seconds before fencing  is  started  (Default  Value:  0)
181
182
183       login_timeout
184              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
185
186
187       port_as_ip
188              Make "port/plug" to be an alias to IP address
189
190       power_timeout
191              Test X seconds for status change after  ON/OFF  (Default  Value:
192              20)
193
194       power_wait
195              Wait X seconds after issuing ON/OFF (Default Value: 0)
196
197       shell_timeout
198              Wait  X  seconds  for  cmd prompt after issuing command (Default
199              Value: 3)
200
201       retry_on
202              Count of attempts to retry power on (Default Value: 1)
203
204       telnet_path
205              Path to telnet binary (Default Value: /usr/bin/telnet)
206
207
208
209fence_drac (Fence Agent)          2009-10-20                    FENCE_AGENT(8)
Impressum