1FENCE_AGENT(8) System Manager's Manual FENCE_AGENT(8)
3
7 fence_netio - I/O Fencing agent for Koukaam NETIO-230B
8
10 fence_netio is an I/O Fencing agent which can be used with the Koukaam
11 NETIO-230B Power Distribution Unit. It logs into device via telnet and
12 reboots a specified outlet. Lengthy telnet connections should be
13 avoided while a GFS cluster is running because the connection will
14 block any necessary fencing actions.
15 fence_netio accepts options on the command line as well as from stdin.
17 Fenced sends parameters through stdin when it execs the agent.
18 fence_netio can be run by itself with command line options. This is
19 useful for testing and for turning outlets on or off from scripts.
20 Vendor URL: http://www.koukaam.se/
22
24 -o, --action=[action]
27 Fencing action (Default Value: reboot)
28 -a, --ip=[ip]
30 IP address or hostname of fencing device This parameter is al‐
31 ways required.
32 -u, --ipport=[port]
34 TCP/UDP port to use for connection with device (Default Value:
35 1234)
36 -p, --password=[password]
38 Login password or passphrase
39 -S, --password-script=[script]
41 Script to run to retrieve password
42 -n, --plug=[id]
44 Physical plug number on device, UUID or identification of ma‐
45 chine This parameter is always required.
46 -l, --username=[name]
48 Login name This parameter is always required.
49 -q, --quiet
51 Disable logging to stderr. Does not affect --verbose or --debug-
52 file or logging to syslog.
53 -v, --verbose
55 Verbose mode. Multiple -v flags can be stacked on the command
56 line (e.g., -vvv) to increase verbosity.
57 --verbose-level
59 Level of debugging detail in output. Defaults to the number of
60 --verbose flags specified on the command line, or to 1 if ver‐
61 bose=1 in a stonith device configuration (i.e., on stdin).
62 -D, --debug-file=[debugfile]
65 Write debug information to given file
66 -V, --version
68 Display version information and exit
69 -h, --help
71 Display help and exit
72 --plug-separator=[char]
74 Separator for plug parameter when specifying more than 1 plug
75 (Default Value: ,)
76 -C, --separator=[char]
78 Separator for CSV created by 'list' operation (Default Value: ,)
79 --delay=[seconds]
82 Wait X seconds before fencing is started (Default Value: 0)
83 --disable-timeout=[true/false]
86 Disable timeout (true/false) (default: true when run from Pace‐
87 maker 2.0+)
88 --login-timeout=[seconds]
90 Wait X seconds for cmd prompt after login (Default Value: 5)
91 --power-timeout=[seconds]
94 Test X seconds for status change after ON/OFF (Default Value:
95 20)
96 --power-wait=[seconds]
98 Wait X seconds after issuing ON/OFF (Default Value: 0)
99 --shell-timeout=[seconds]
101 Wait X seconds for cmd prompt after issuing command (Default
102 Value: 3)
103 --stonith-status-sleep=[seconds]
105 Sleep X seconds between status calls during a STONITH action
106 (Default Value: 1)
107 --retry-on=[attempts]
109 Count of attempts to retry power on (Default Value: 1)
110 --telnet-path=[path]
112 Path to telnet binary (Default Value: /usr/bin/telnet)
113
116 on Power on machine.
119 off Power off machine.
121 reboot Reboot machine.
123 status This returns the status of the plug/virtual machine.
125 list List available plugs with aliases/virtual machines if there is
127 support for more then one device. Returns N/A otherwise.
128 list-status
130 List available plugs with aliases/virtual machines and their
131 power state if it can be obtained without additional commands.
132 monitor
135 Check the health of fence device
136 metadata
138 Display the XML metadata describing this resource.
139 manpage
141 The operational behavior of this is not known.
142 validate-all
144 Validate if all required parameters are entered.
145
148 action Fencing action (Default Value: reboot)
151 ip IP address or hostname of fencing device This parameter is al‐
153 ways required. Obsoletes: ipaddr
154 ipport TCP/UDP port to use for connection with device (Default Value:
156 1234)
157 password
159 Login password or passphrase Obsoletes: passwd
160 password_script
162 Script to run to retrieve password Obsoletes: passwd_script
163 plug Physical plug number on device, UUID or identification of ma‐
166 chine This parameter is always required. Obsoletes: port
167 username
170 Login name This parameter is always required. Obsoletes: login
171 quiet Disable logging to stderr. Does not affect --verbose or --debug-
174 file or logging to syslog.
175 verbose
177 Verbose mode. Multiple -v flags can be stacked on the command
178 line (e.g., -vvv) to increase verbosity.
179 verbose_level
181 Level of debugging detail in output. Defaults to the number of
182 --verbose flags specified on the command line, or to 1 if ver‐
183 bose=1 in a stonith device configuration (i.e., on stdin).
184 debug_file
187 Write debug information to given file Obsoletes: debug
188 version
190 Display version information and exit
191 help Display help and exit
193 plug_separator
195 Separator for plug parameter when specifying more than 1 plug
196 (Default Value: ,)
197 separator
199 Separator for CSV created by 'list' operation (Default Value: ,)
200 delay Wait X seconds before fencing is started (Default Value: 0)
203 disable_timeout
206 Disable timeout (true/false) (default: true when run from Pace‐
207 maker 2.0+)
208 login_timeout
210 Wait X seconds for cmd prompt after login (Default Value: 5)
211 power_timeout
214 Test X seconds for status change after ON/OFF (Default Value:
215 20)
216 power_wait
218 Wait X seconds after issuing ON/OFF (Default Value: 0)
219 shell_timeout
221 Wait X seconds for cmd prompt after issuing command (Default
222 Value: 3)
223 stonith_status_sleep
225 Sleep X seconds between status calls during a STONITH action
226 (Default Value: 1)
227 retry_on
229 Count of attempts to retry power on (Default Value: 1)
230 telnet_path
232 Path to telnet binary (Default Value: /usr/bin/telnet)
233fence_netio (Fence Agent) 2009-10-20 FENCE_AGENT(8)