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
44              always 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
58              machine 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       --retry-on=[attempts]
120              Count of attempts to retry power on (Default Value: 1)
121
122       --ssh-path=[path]
123              Path to ssh binary (Default Value: /usr/bin/ssh)
124
125       --telnet-path=[path]
126              Path to telnet binary (Default Value: /usr/bin/telnet)
127
128

ACTIONS

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

STDIN PARAMETERS

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