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

NAME

7       fence_cdu - Fence agent for a Sentry Switch CDU over telnet
8

DESCRIPTION

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

PARAMETERS

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

ACTIONS

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

STDIN PARAMETERS

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)
Impressum