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 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 This parameter is always required.
44
45       -u, --ipport=[port]
46              TCP/UDP  port  to use for connection with device (Default Value:
47              23)
48
49       -l, --username=[name]
50              Login Name
51
52       -p, --password=[password]
53              Login password or passphrase
54
55       -S, --password-script=[script]
56              Script to retrieve password
57
58       -n, --plug=[id]
59              Physical plug number, name  of  virtual  machine  or  UUID  This
60              parameter is always required.
61
62       -x, --ssh
63              SSH connection
64
65       --ssh-options=[options]
66              SSH options to use
67
68       -v, --verbose
69              Verbose mode
70
71       -D, --debug-file=[debugfile]
72              Write debug information to given file
73
74       -V, --version
75              Display version information and exit
76
77       -h, --help
78              Display help and exit
79
80       -C, --separator=[char]
81              Separator  for  CSV created by operation list (Default Value: ,)
82
83
84       --delay=[seconds]
85              Wait X seconds before fencing  is  started  (Default  Value:  0)
86
87
88       --login-timeout=[seconds]
89              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
90
91
92       --power-timeout=[seconds]
93              Test X seconds for status change after  ON/OFF  (Default  Value:
94              20)
95
96       --power-wait=[seconds]
97              Wait X seconds after issuing ON/OFF (Default Value: 0)
98
99       --shell-timeout=[seconds]
100              Wait  X  seconds  for  cmd prompt after issuing command (Default
101              Value: 3)
102
103       --retry-on=[attempts]
104              Count of attempts to retry power on (Default Value: 1)
105
106       --ssh-path=[path]
107              Path to ssh binary (Default Value: /usr/bin/ssh)
108
109       --telnet-path=[path]
110              Path to telnet binary (Default Value: /usr/bin/telnet)
111
112

ACTIONS

114
115
116       on     Power on machine.
117
118       off    Power off machine.
119
120       reboot Reboot machine.
121
122       status This returns the status of the plug/virtual machine.
123
124       list   List available plugs with aliases/virtual machines if  there  is
125              support for more then one device. Returns N/A otherwise.
126
127       list-status
128              List  available  plugs  with  aliases/virtual machines and their
129              power state if it can be obtained without  additional  commands.
130
131
132       monitor
133              Check the health of fence device
134
135       metadata
136              Display the XML metadata describing this resource.
137
138

STDIN PARAMETERS

140
141
142       action Fencing Action (Default Value: reboot)
143
144       cmd_prompt
145              Force  Python  regex for command prompt (Default Value: ['RSM>',
146              'MPC>', 'IPS>', 'TPS>', 'NBB>', 'NPS>', 'VMR>'])
147
148       identity_file
149              Identity file for ssh
150
151       inet4_only
152              Forces agent to use IPv4 addresses only
153
154       inet6_only
155              Forces agent to use IPv6 addresses only
156
157       ipaddr IP Address or Hostname This parameter is always required.
158
159       ipport TCP/UDP port to use for connection with device  (Default  Value:
160              23)
161
162       login  Login Name
163
164       passwd Login password or passphrase
165
166       passwd_script
167              Script to retrieve password
168
169       port   Physical  plug  number,  name  of  virtual  machine or UUID This
170              parameter is always required.
171
172       secure SSH connection
173
174       ssh_options
175              SSH options to use
176
177       verbose
178              Verbose mode
179
180       debug  Write debug information to given file
181
182       version
183              Display version information and exit
184
185       help   Display help and exit
186
187       separator
188              Separator for CSV created by operation list (Default  Value:  ,)
189
190
191       delay  Wait  X  seconds  before  fencing  is started (Default Value: 0)
192
193
194       login_timeout
195              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
196
197
198       power_timeout
199              Test  X  seconds  for status change after ON/OFF (Default Value:
200              20)
201
202       power_wait
203              Wait X seconds after issuing ON/OFF (Default Value: 0)
204
205       shell_timeout
206              Wait X seconds for cmd prompt  after  issuing  command  (Default
207              Value: 3)
208
209       retry_on
210              Count of attempts to retry power on (Default Value: 1)
211
212       ssh_path
213              Path to ssh binary (Default Value: /usr/bin/ssh)
214
215       telnet_path
216              Path to telnet binary (Default Value: /usr/bin/telnet)
217
218
219
220fence_wti (Fence Agent)           2009-10-20                    FENCE_AGENT(8)