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       -a, --ip=<ip>
30              IP Address or Hostname This parameter is always required.
31
32       -l, --username=<name>
33              Login Name
34
35       -p, --password=<password>
36              Login password or passphrase
37
38       -S, --password-script=<script>
39              Script to retrieve password
40
41       -c, --command-prompt=<prompt>
42              Force command prompt (Default Value:  ['RSM>',  'MPC>',  'IPS>',
43              'TPS>', 'NBB>', 'NPS>', 'VMR>'])
44
45       -x, --ssh
46              SSH connection
47
48       -k, --identity-file=<filename>
49              Identity file for ssh
50
51       -n, --plug=<id>
52              Physical  plug  number or name of virtual machine This parameter
53              is always required.
54
55       -4, --inet4-only
56              Forces agent to use IPv4 addresses only
57
58       -6, --inet6-only
59              Forces agent to use IPv6 addresses only
60
61       -u, --ipport=<port>
62              TCP port to use for connection with device
63
64       -v, --verbose
65              Verbose mode
66
67       -D, --debug-file=<debugfile>
68              Write debug information to given file
69
70       -V, --version
71              Display version information and exit
72
73       -h, --help
74              Display help and exit
75
76       -C, --separator=<char>
77              Separator for CSV created by operation list (Default  Value:  ,)
78
79
80       --power-timeout
81              Test  X  seconds  for status change after ON/OFF (Default Value:
82              20)
83
84       --shell-timeout
85              Wait X seconds for cmd prompt  after  issuing  command  (Default
86              Value: 3)
87
88       --login-timeout
89              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
90
91
92       --power-wait
93              Wait X seconds after issuing ON/OFF (Default Value: 0)
94
95       --delay
96              Wait X seconds before fencing  is  started  (Default  Value:  0)
97
98
99       --retry-on
100              Count of attempts to retry power on (Default Value: 1)
101
102

ACTIONS

104
105
106       on     Power on machine.
107
108       off    Power off machine.
109
110       reboot Reboot machine.
111
112       status This returns the status of the plug/virtual machine.
113
114       list   List  available  plugs with aliases/virtual machines if there is
115              support for more then one device. Returns N/A otherwise.
116
117       monitor
118              Check if fencing device is running. List available plugs/virtual
119              machines or get status of machine (if it does not support more).
120
121
122       metadata
123               The operational behavior of this is not known.
124
125

STDIN PARAMETERS

127
128
129       action Fencing Action (Default Value: reboot)
130
131       ipaddr IP Address or Hostname This parameter is always required.
132
133       login  Login Name
134
135       passwd Login password or passphrase
136
137       passwd_script
138              Script to retrieve password
139
140       cmd_prompt
141              Force command prompt (Default Value:  ['RSM>',  'MPC>',  'IPS>',
142              'TPS>', 'NBB>', 'NPS>', 'VMR>'])
143
144       secure SSH connection
145
146       identity_file
147              Identity file for ssh
148
149       port   Physical  plug  number or name of virtual machine This parameter
150              is always required.
151
152       inet4_only
153              Forces agent to use IPv4 addresses only
154
155       inet6_only
156              Forces agent to use IPv6 addresses only
157
158       ipport TCP port to use for connection with device
159
160       verbose
161              Verbose mode
162
163       debug  Write debug information to given file
164
165       version
166              Display version information and exit
167
168       help   Display help and exit
169
170       separator
171              Separator for CSV created by operation list (Default  Value:  ,)
172
173
174       power_timeout
175              Test  X  seconds  for status change after ON/OFF (Default Value:
176              20)
177
178       shell_timeout
179              Wait X seconds for cmd prompt  after  issuing  command  (Default
180              Value: 3)
181
182       login_timeout
183              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
184
185
186       power_wait
187              Wait X seconds after issuing ON/OFF (Default Value: 0)
188
189       delay  Wait X seconds before fencing  is  started  (Default  Value:  0)
190
191
192       retry_on
193              Count of attempts to retry power on (Default Value: 1)
194
195
196
197fence_wti (Fence Agent)           2009-10-20                    FENCE_AGENT(8)
Impressum