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

NAME

7       fence_wti - Fence agent for WTI
8

DESCRIPTION

10       fence_wti  is  an I/O Fencing agent which can be used with the WTI Net‐
11       work Power Switch (NPS). It logs into an NPS  via  telnet  or  ssh  and
12       boots a specified plug. Lengthy telnet connections to the NPS should be
13       avoided while a GFS cluster is  running  because  the  connection  will
14       block any necessary fencing actions.
15
16       fence_wti  accepts  options  on the command line as well as from stdin.
17       Fenced  sends  parameters  through  stdin  when  it  execs  the  agent.
18       fence_wti can be run by itself with command line options.  This is use‐
19       ful for testing and for turning outlets on or off from scripts.
20
21       Vendor URL: http://www.wti.com
22

PARAMETERS

24
25
26       -o, --action=[action]
27              Fencing action (Default Value: reboot)
28
29       -c, --command-prompt=[prompt]
30              Force Python regex for command prompt (Default  Value:  ['RSM>',
31              'MPC>', 'IPS>', 'TPS>', 'NBB>', 'NPS>', 'VMR>'])
32
33       -k, --identity-file=[filename]
34              Identity file (private key) for SSH
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 This parameter is al‐
44              ways required.
45
46       -u, --ipport=[port]
47              TCP/UDP port to use for connection with device  (Default  Value:
48              23)
49
50       -p, --password=[password]
51              Login password or passphrase
52
53       -S, --password-script=[script]
54              Script to run to retrieve password
55
56       -n, --plug=[id]
57              Physical  plug  number  on device, UUID or identification of ma‐
58              chine This parameter is always required.
59
60       -x, --ssh
61              Use SSH connection
62
63       --ssh-options=[options]
64              SSH options to use
65
66       -l, --username=[name]
67              Login name
68
69       -q, --quiet
70              Disable logging to stderr. Does not affect --verbose or --debug-
71              file or logging to syslog.
72
73       -v, --verbose
74              Verbose  mode.  Multiple  -v flags can be stacked on the command
75              line (e.g., -vvv) to increase verbosity.
76
77       --verbose-level
78              Level of debugging detail in output. Defaults to the  number  of
79              --verbose  flags  specified on the command line, or to 1 if ver‐
80              bose=1 in a  stonith  device  configuration  (i.e.,  on  stdin).
81
82
83       -D, --debug-file=[debugfile]
84              Write debug information to given file
85
86       -V, --version
87              Display version information and exit
88
89       -h, --help
90              Display help and exit
91
92       --plug-separator=[char]
93              Separator  for  plug  parameter when specifying more than 1 plug
94              (Default Value: ,)
95
96       -C, --separator=[char]
97              Separator for CSV created by 'list' operation (Default Value: ,)
98
99
100       --delay=[seconds]
101              Wait  X  seconds  before  fencing  is started (Default Value: 0)
102
103
104       --disable-timeout=[true/false]
105              Disable timeout (true/false) (default: true when run from  Pace‐
106              maker 2.0+)
107
108       --login-timeout=[seconds]
109              Wait  X  seconds  for cmd prompt after login (Default Value: 10)
110
111
112       --power-timeout=[seconds]
113              Test X seconds for status change after  ON/OFF  (Default  Value:
114              20)
115
116       --power-wait=[seconds]
117              Wait X seconds after issuing ON/OFF (Default Value: 0)
118
119       --shell-timeout=[seconds]
120              Wait  X  seconds  for  cmd prompt after issuing command (Default
121              Value: 3)
122
123       --stonith-status-sleep=[seconds]
124              Sleep X seconds between status calls  during  a  STONITH  action
125              (Default Value: 1)
126
127       --retry-on=[attempts]
128              Count of attempts to retry power on (Default Value: 1)
129
130       --ssh-path=[path]
131              Path to ssh binary (Default Value: /usr/bin/ssh)
132
133       --telnet-path=[path]
134              Path to telnet binary (Default Value: /usr/bin/telnet)
135
136

ACTIONS

138
139
140       on     Power on machine.
141
142       off    Power off machine.
143
144       reboot Reboot machine.
145
146       status This returns the status of the plug/virtual machine.
147
148       list   List  available  plugs with aliases/virtual machines if there is
149              support for more then one device. Returns N/A otherwise.
150
151       list-status
152              List available plugs with  aliases/virtual  machines  and  their
153              power  state  if it can be obtained without additional commands.
154
155
156       monitor
157              Check the health of fence device
158
159       metadata
160              Display the XML metadata describing this resource.
161
162       manpage
163               The operational behavior of this is not known.
164
165       validate-all
166              Validate if all required parameters are entered.
167
168

STDIN PARAMETERS

170
171
172       action Fencing action (Default Value: reboot)
173
174       command_prompt
175              Force Python regex for command prompt (Default  Value:  ['RSM>',
176              'MPC>',  'IPS>',  'TPS>',  'NBB>',  'NPS>',  'VMR>']) Obsoletes:
177              cmd_prompt
178
179       identity_file
180              Identity file (private key) for SSH
181
182       inet4_only
183              Forces agent to use IPv4 addresses only
184
185       inet6_only
186              Forces agent to use IPv6 addresses only
187
188       ip     IP address or hostname of fencing device This parameter  is  al‐
189              ways required. Obsoletes: ipaddr
190
191       ipport TCP/UDP  port  to use for connection with device (Default Value:
192              23)
193
194       password
195              Login password or passphrase Obsoletes: passwd
196
197       password_script
198              Script to run  to  retrieve  password  Obsoletes:  passwd_script
199
200
201       plug   Physical  plug  number  on device, UUID or identification of ma‐
202              chine This parameter is always required. Obsoletes:  port
203
204
205       ssh    Use SSH connection Obsoletes: secure
206
207       ssh_options
208              SSH options to use
209
210       username
211              Login name Obsoletes: login
212
213       quiet  Disable logging to stderr. Does not affect --verbose or --debug-
214              file or logging to syslog.
215
216       verbose
217              Verbose mode. Multiple -v flags can be stacked  on  the  command
218              line (e.g., -vvv) to increase verbosity.
219
220       verbose_level
221              Level  of  debugging detail in output. Defaults to the number of
222              --verbose flags specified on the command line, or to 1  if  ver‐
223              bose=1  in  a  stonith  device  configuration  (i.e., on stdin).
224
225
226       debug_file
227              Write debug information to given file Obsoletes: debug
228
229       version
230              Display version information and exit
231
232       help   Display help and exit
233
234       plug_separator
235              Separator for plug parameter when specifying more  than  1  plug
236              (Default Value: ,)
237
238       separator
239              Separator for CSV created by 'list' operation (Default Value: ,)
240
241
242       delay  Wait X seconds before fencing  is  started  (Default  Value:  0)
243
244
245       disable_timeout
246              Disable  timeout (true/false) (default: true when run from Pace‐
247              maker 2.0+)
248
249       login_timeout
250              Wait X seconds for cmd prompt after login  (Default  Value:  10)
251
252
253       power_timeout
254              Test  X  seconds  for status change after ON/OFF (Default Value:
255              20)
256
257       power_wait
258              Wait X seconds after issuing ON/OFF (Default Value: 0)
259
260       shell_timeout
261              Wait X seconds for cmd prompt  after  issuing  command  (Default
262              Value: 3)
263
264       stonith_status_sleep
265              Sleep  X  seconds  between  status calls during a STONITH action
266              (Default Value: 1)
267
268       retry_on
269              Count of attempts to retry power on (Default Value: 1)
270
271       ssh_path
272              Path to ssh binary (Default Value: /usr/bin/ssh)
273
274       telnet_path
275              Path to telnet binary (Default Value: /usr/bin/telnet)
276
277
278
279fence_wti (Fence Agent)           2009-10-20                    FENCE_AGENT(8)