1
2FENCE_AGENT(8) System Manager's Manual FENCE_AGENT(8)
3
4
5
7 fence_cdu - Fence agent for a Sentry Switch CDU over telnet
8
10 fence_cdu is an I/O Fencing agent which can be used with the Sentry
11 Switch CDU. It logs into the device via telnet and power's on/off an
12 outlet.
13
14 fence_cdu accepts options on the command line as well as from stdin.
15 Fenced sends parameters through stdin when it execs the agent.
16 fence_cdu can be run by itself with command line options. This is use‐
17 ful for testing and for turning outlets on or off from scripts.
18
19 Vendor URL: http://www.servertech.com
20
22
23
24 -o, --action=[action]
25 Fencing action (Default Value: reboot)
26
27 -a, --ip=[ip]
28 IP address or hostname of fencing device This parameter is al‐
29 ways required.
30
31 -u, --ipport=[port]
32 TCP/UDP port to use for connection with device (Default Value:
33 23)
34
35 -p, --password=[password]
36 Login password or passphrase
37
38 -S, --password-script=[script]
39 Script to run to retrieve password
40
41 -n, --plug=[id]
42 Physical plug number on device, UUID or identification of ma‐
43 chine This parameter is always required.
44
45 -s, --switch=[id]
46 Physical switch number on device
47
48 -l, --username=[name]
49 Login name This parameter is always required.
50
51 -q, --quiet
52 Disable logging to stderr. Does not affect --verbose or --debug-
53 file or logging to syslog.
54
55 -v, --verbose
56 Verbose mode. Multiple -v flags can be stacked on the command
57 line (e.g., -vvv) to increase verbosity.
58
59 --verbose-level
60 Level of debugging detail in output. Defaults to the number of
61 --verbose flags specified on the command line, or to 1 if ver‐
62 bose=1 in a stonith device configuration (i.e., on stdin).
63
64
65 -D, --debug-file=[debugfile]
66 Write debug information to given file
67
68 -V, --version
69 Display version information and exit
70
71 -h, --help
72 Display help and exit
73
74 --plug-separator=[char]
75 Separator for plug parameter when specifying more than 1 plug
76 (Default Value: ,)
77
78 -C, --separator=[char]
79 Separator for CSV created by 'list' operation (Default Value: ,)
80
81
82 --delay=[seconds]
83 Wait X seconds before fencing is started (Default Value: 0)
84
85
86 --disable-timeout=[true/false]
87 Disable timeout (true/false) (default: true when run from Pace‐
88 maker 2.0+)
89
90 --login-timeout=[seconds]
91 Wait X seconds for cmd prompt after login (Default Value: 5)
92
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 --stonith-status-sleep=[seconds]
106 Sleep X seconds between status calls during a STONITH action
107 (Default Value: 1)
108
109 --retry-on=[attempts]
110 Count of attempts to retry power on (Default Value: 1)
111
112 --telnet-path=[path]
113 Path to telnet binary (Default Value: /usr/bin/telnet)
114
115
117
118
119 on Power on machine.
120
121 off Power off machine.
122
123 reboot Reboot machine.
124
125 status This returns the status of the plug/virtual machine.
126
127 list List available plugs with aliases/virtual machines if there is
128 support for more then one device. Returns N/A otherwise.
129
130 list-status
131 List available plugs with aliases/virtual machines and their
132 power state if it can be obtained without additional commands.
133
134
135 monitor
136 Check the health of fence device
137
138 metadata
139 Display the XML metadata describing this resource.
140
141 manpage
142 The operational behavior of this is not known.
143
144 validate-all
145 Validate if all required parameters are entered.
146
147
149
150
151 action Fencing action (Default Value: reboot)
152
153 ip IP address or hostname of fencing device This parameter is al‐
154 ways required. Obsoletes: ipaddr
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 Physical plug number on device, UUID or identification of ma‐
167 chine This parameter is always required. Obsoletes: port
168
169
170 switch Physical switch number on device
171
172 username
173 Login name This parameter is always required. Obsoletes: login
174
175
176 quiet Disable logging to stderr. Does not affect --verbose or --debug-
177 file or logging to syslog.
178
179 verbose
180 Verbose mode. Multiple -v flags can be stacked on the command
181 line (e.g., -vvv) to increase verbosity.
182
183 verbose_level
184 Level of debugging detail in output. Defaults to the number of
185 --verbose flags specified on the command line, or to 1 if ver‐
186 bose=1 in a stonith device configuration (i.e., on stdin).
187
188
189 debug_file
190 Write debug information to given file Obsoletes: debug
191
192 version
193 Display version information and exit
194
195 help Display help and exit
196
197 plug_separator
198 Separator for plug parameter when specifying more than 1 plug
199 (Default Value: ,)
200
201 separator
202 Separator for CSV created by 'list' operation (Default Value: ,)
203
204
205 delay Wait X seconds before fencing is started (Default Value: 0)
206
207
208 disable_timeout
209 Disable timeout (true/false) (default: true when run from Pace‐
210 maker 2.0+)
211
212 login_timeout
213 Wait X seconds for cmd prompt after login (Default Value: 5)
214
215
216 power_timeout
217 Test X seconds for status change after ON/OFF (Default Value:
218 20)
219
220 power_wait
221 Wait X seconds after issuing ON/OFF (Default Value: 0)
222
223 shell_timeout
224 Wait X seconds for cmd prompt after issuing command (Default
225 Value: 3)
226
227 stonith_status_sleep
228 Sleep X seconds between status calls during a STONITH action
229 (Default Value: 1)
230
231 retry_on
232 Count of attempts to retry power on (Default Value: 1)
233
234 telnet_path
235 Path to telnet binary (Default Value: /usr/bin/telnet)
236
237
238
239fence_cdu (Fence Agent) 2009-10-20 FENCE_AGENT(8)