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       -C, --separator=[char]
93              Separator for CSV created by 'list' operation (Default Value: ,)
94
95
96       --delay=[seconds]
97              Wait X seconds before fencing  is  started  (Default  Value:  0)
98
99
100       --disable-timeout=[true/false]
101              Disable  timeout (true/false) (default: true when run from Pace‐
102              maker 2.0+)
103
104       --login-timeout=[seconds]
105              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
106
107
108       --power-timeout=[seconds]
109              Test  X  seconds  for status change after ON/OFF (Default Value:
110              20)
111
112       --power-wait=[seconds]
113              Wait X seconds after issuing ON/OFF (Default Value: 0)
114
115       --shell-timeout=[seconds]
116              Wait X seconds for cmd prompt  after  issuing  command  (Default
117              Value: 3)
118
119       --stonith-status-sleep=[seconds]
120              Sleep  X  seconds  between  status calls during a STONITH action
121              (Default Value: 1)
122
123       --retry-on=[attempts]
124              Count of attempts to retry power on (Default Value: 1)
125
126       --ssh-path=[path]
127              Path to ssh binary (Default Value: /usr/bin/ssh)
128
129       --telnet-path=[path]
130              Path to telnet binary (Default Value: /usr/bin/telnet)
131
132

ACTIONS

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

STDIN PARAMETERS

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