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 -C, --separator=[char]
75 Separator for CSV created by 'list' operation (Default Value: ,)
76
77
78 --delay=[seconds]
79 Wait X seconds before fencing is started (Default Value: 0)
80
81
82 --disable-timeout=[true/false]
83 Disable timeout (true/false) (default: true when run from Pace‐
84 maker 2.0+)
85
86 --login-timeout=[seconds]
87 Wait X seconds for cmd prompt after login (Default Value: 5)
88
89
90 --power-timeout=[seconds]
91 Test X seconds for status change after ON/OFF (Default Value:
92 20)
93
94 --power-wait=[seconds]
95 Wait X seconds after issuing ON/OFF (Default Value: 0)
96
97 --shell-timeout=[seconds]
98 Wait X seconds for cmd prompt after issuing command (Default
99 Value: 3)
100
101 --stonith-status-sleep=[seconds]
102 Sleep X seconds between status calls during a STONITH action
103 (Default Value: 1)
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
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 list List available plugs with aliases/virtual machines if there is
124 support for more then one device. Returns N/A otherwise.
125
126 list-status
127 List available plugs with aliases/virtual machines and their
128 power state if it can be obtained without additional commands.
129
130
131 monitor
132 Check the health of fence device
133
134 metadata
135 Display the XML metadata describing this resource.
136
137 manpage
138 The operational behavior of this is not known.
139
140 validate-all
141 Validate if all required parameters are entered.
142
143
145
146
147 action Fencing action (Default Value: reboot)
148
149 ip IP address or hostname of fencing device This parameter is al‐
150 ways required. Obsoletes: ipaddr
151
152 ipport TCP/UDP port to use for connection with device (Default Value:
153 23)
154
155 password
156 Login password or passphrase Obsoletes: passwd
157
158 password_script
159 Script to run to retrieve password Obsoletes: passwd_script
160
161
162 plug Physical plug number on device, UUID or identification of ma‐
163 chine This parameter is always required. Obsoletes: port
164
165
166 switch Physical switch number on device
167
168 username
169 Login name This parameter is always required. Obsoletes: login
170
171
172 quiet Disable logging to stderr. Does not affect --verbose or --debug-
173 file or logging to syslog.
174
175 verbose
176 Verbose mode. Multiple -v flags can be stacked on the command
177 line (e.g., -vvv) to increase verbosity.
178
179 verbose_level
180 Level of debugging detail in output. Defaults to the number of
181 --verbose flags specified on the command line, or to 1 if ver‐
182 bose=1 in a stonith device configuration (i.e., on stdin).
183
184
185 debug_file
186 Write debug information to given file Obsoletes: debug
187
188 version
189 Display version information and exit
190
191 help Display help and exit
192
193 separator
194 Separator for CSV created by 'list' operation (Default Value: ,)
195
196
197 delay Wait X seconds before fencing is started (Default Value: 0)
198
199
200 disable_timeout
201 Disable timeout (true/false) (default: true when run from Pace‐
202 maker 2.0+)
203
204 login_timeout
205 Wait X seconds for cmd prompt after login (Default Value: 5)
206
207
208 power_timeout
209 Test X seconds for status change after ON/OFF (Default Value:
210 20)
211
212 power_wait
213 Wait X seconds after issuing ON/OFF (Default Value: 0)
214
215 shell_timeout
216 Wait X seconds for cmd prompt after issuing command (Default
217 Value: 3)
218
219 stonith_status_sleep
220 Sleep X seconds between status calls during a STONITH action
221 (Default Value: 1)
222
223 retry_on
224 Count of attempts to retry power on (Default Value: 1)
225
226 telnet_path
227 Path to telnet binary (Default Value: /usr/bin/telnet)
228
229
230
231fence_cdu (Fence Agent) 2009-10-20 FENCE_AGENT(8)