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

NAME

7       fence_drac5 - Fence agent for Dell DRAC CMC/5
8

DESCRIPTION

10       fence_drac5  is  an  I/O  Fencing agent which can be used with the Dell
11       Remote Access Card v5 or CMC (DRAC). This device provides remote access
12       to  controlling   power  to a server. It logs into the DRAC through the
13       telnet/ssh interface of the card. By default, the telnet  interface  is
14       not  enabled.
15
16       fence_drac5  accepts options on the command line as well as from stdin.
17       Fenced  sends  parameters  through  stdin  when  it  execs  the  agent.
18       fence_drac5  can  be  run by itself with command line options.  This is
19       useful for testing and for turning outlets on or off from scripts.
20
21       Vendor URL: http://www.dell.com
22

PARAMETERS

24
25
26       -o, --action=<action>
27              Fencing Action (Default Value: reboot)
28
29       -a, --ip=<ip>
30              IP Address or Hostname This parameter is always required.
31
32       -l, --username=<name>
33              Login Name This parameter is always required.
34
35       -p, --password=<password>
36              Login password or passphrase
37
38       -S, --password-script=<script>
39              Script to retrieve password
40
41       -c, --command-prompt=<prompt>
42              Force command prompt (Default Value:
43
44       -x, --ssh
45              SSH connection
46
47       -k, --identity-file=<filename>
48              Identity file for ssh
49
50       -d, --drac-version=<version>
51              Force DRAC version to use
52
53       -m, --module-name=<module>
54              DRAC/MC module name
55
56       -4, --inet4-only
57              Forces agent to use IPv4 addresses only
58
59       -6, --inet6-only
60              Forces agent to use IPv6 addresses only
61
62       -u, --ipport=<port>
63              TCP port to use for connection with device
64
65       -v, --verbose
66              Verbose mode
67
68       -D, --debug-file=<debugfile>
69              Write debug information to given file
70
71       -V, --version
72              Display version information and exit
73
74       -h, --help
75              Display help and exit
76
77       -C, --separator=<char>
78              Separator for CSV created by operation list (Default  Value:  ,)
79
80
81       --power-timeout
82              Test  X  seconds  for status change after ON/OFF (Default Value:
83              20)
84
85       --shell-timeout
86              Wait X seconds for cmd prompt  after  issuing  command  (Default
87              Value: 3)
88
89       --login-timeout
90              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
91
92
93       --power-wait
94              Wait X seconds after issuing ON/OFF (Default Value: 0)
95
96       --delay
97              Wait X seconds before fencing  is  started  (Default  Value:  0)
98
99
100       --retry-on
101              Count of attempts to retry power on (Default Value: 1)
102
103

ACTIONS

105
106
107       on     Power on machine.
108
109       off    Power off machine.
110
111       reboot Reboot machine.
112
113       status This returns the status of the plug/virtual machine.
114
115       list   List  available  plugs with aliases/virtual machines if there is
116              support for more then one device. Returns N/A otherwise.
117
118       monitor
119              Check if fencing device is running. List available plugs/virtual
120              machines or get status of machine (if it does not support more).
121
122
123       metadata
124               The operational behavior of this is not known.
125
126

STDIN PARAMETERS

128
129
130       action Fencing Action (Default Value: reboot)
131
132       ipaddr IP Address or Hostname This parameter is always required.
133
134       login  Login Name This parameter is always required.
135
136       passwd Login password or passphrase
137
138       passwd_script
139              Script to retrieve password
140
141       cmd_prompt
142              Force command prompt (Default Value:
143
144       secure SSH connection
145
146       identity_file
147              Identity file for ssh
148
149       drac_version
150              Force DRAC version to use
151
152       module_name
153              DRAC/MC module name
154
155       inet4_only
156              Forces agent to use IPv4 addresses only
157
158       inet6_only
159              Forces agent to use IPv6 addresses only
160
161       ipport TCP port to use for connection with device
162
163       verbose
164              Verbose mode
165
166       debug  Write debug information to given file
167
168       version
169              Display version information and exit
170
171       help   Display help and exit
172
173       separator
174              Separator for CSV created by operation list (Default  Value:  ,)
175
176
177       power_timeout
178              Test  X  seconds  for status change after ON/OFF (Default Value:
179              20)
180
181       shell_timeout
182              Wait X seconds for cmd prompt  after  issuing  command  (Default
183              Value: 3)
184
185       login_timeout
186              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
187
188
189       power_wait
190              Wait X seconds after issuing ON/OFF (Default Value: 0)
191
192       delay  Wait X seconds before fencing  is  started  (Default  Value:  0)
193
194
195       retry_on
196              Count of attempts to retry power on (Default Value: 1)
197
198
199
200fence_drac5 (Fence Agent)         2009-10-20                    FENCE_AGENT(8)