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
75
76       -D, --debug-file=[debugfile]
77              Write debug information to given file
78
79       -V, --version
80              Display version information and exit
81
82       -h, --help
83              Display help and exit
84
85       -C, --separator=[char]
86              Separator for CSV created by 'list' operation (Default Value: ,)
87
88
89       --delay=[seconds]
90              Wait X seconds before fencing  is  started  (Default  Value:  0)
91
92
93       --login-timeout=[seconds]
94              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
95
96
97       --power-timeout=[seconds]
98              Test X seconds for status change after  ON/OFF  (Default  Value:
99              20)
100
101       --power-wait=[seconds]
102              Wait X seconds after issuing ON/OFF (Default Value: 0)
103
104       --shell-timeout=[seconds]
105              Wait  X  seconds  for  cmd prompt after issuing command (Default
106              Value: 3)
107
108       --retry-on=[attempts]
109              Count of attempts to retry power on (Default Value: 1)
110
111       --ssh-path=[path]
112              Path to ssh binary (Default Value: /usr/bin/ssh)
113
114       --telnet-path=[path]
115              Path to telnet binary (Default Value: /usr/bin/telnet)
116
117

ACTIONS

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

STDIN PARAMETERS

151
152
153       action Fencing action (Default Value: reboot)
154
155       command_prompt
156              Force  Python  regex for command prompt (Default Value: ['RSM>',
157              'MPC>', 'IPS>',  'TPS>',  'NBB>',  'NPS>',  'VMR>'])  Obsoletes:
158              cmd_prompt
159
160       identity_file
161              Identity file (private key) for SSH
162
163       inet4_only
164              Forces agent to use IPv4 addresses only
165
166       inet6_only
167              Forces agent to use IPv6 addresses only
168
169       ip     IP  address  or  hostname  of  fencing  device This parameter is
170              always required. Obsoletes: ipaddr
171
172       ipport TCP/UDP port to use for connection with device  (Default  Value:
173              23)
174
175       password
176              Login password or passphrase Obsoletes: passwd
177
178       password_script
179              Script  to  run  to  retrieve  password Obsoletes: passwd_script
180
181
182       plug   Physical plug  number  on  device,  UUID  or  identification  of
183              machine This parameter is always required. Obsoletes: port
184
185
186       ssh    Use SSH connection Obsoletes: secure
187
188       ssh_options
189              SSH options to use
190
191       username
192              Login name Obsoletes: login
193
194       quiet  Disable logging to stderr. Does not affect --verbose or --debug-
195              file or logging to syslog.
196
197       verbose
198              Verbose mode
199
200       debug_file
201              Write debug information to given file Obsoletes: debug
202
203       version
204              Display version information and exit
205
206       help   Display help and exit
207
208       separator
209              Separator for CSV created by 'list' operation (Default Value: ,)
210
211
212       delay  Wait X seconds before fencing  is  started  (Default  Value:  0)
213
214
215       login_timeout
216              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
217
218
219       power_timeout
220              Test X seconds for status change after  ON/OFF  (Default  Value:
221              20)
222
223       power_wait
224              Wait X seconds after issuing ON/OFF (Default Value: 0)
225
226       shell_timeout
227              Wait  X  seconds  for  cmd prompt after issuing command (Default
228              Value: 3)
229
230       retry_on
231              Count of attempts to retry power on (Default Value: 1)
232
233       ssh_path
234              Path to ssh binary (Default Value: /usr/bin/ssh)
235
236       telnet_path
237              Path to telnet binary (Default Value: /usr/bin/telnet)
238
239
240
241fence_wti (Fence Agent)           2009-10-20                    FENCE_AGENT(8)