1
2FENCE_AGENT(8)              System Manager's Manual             FENCE_AGENT(8)
3
4
5

NAME

7       fence_intelmodular - Fence agent for Intel Modular
8

DESCRIPTION

10       fence_intelmodular is an I/O Fencing agent which can be used with Intel
11       Modular device (tested on Intel MFSYS25, should work  with  MFSYS35  as
12       well).
13
14       Note:  Since  firmware update version 2.7, SNMP v2 write support is re‐
15       moved, and replaced by SNMP v3 support. So agent now has  default  SNMP
16       version  3.  If you are using older firmware, please supply -d for com‐
17       mand line and snmp_version option for your cluster.conf.
18
19       fence_intelmodular accepts options on the command line as well as  from
20       stdin.  Fenced  sends parameters through stdin when it execs the agent.
21       fence_intelmodular can be run by  itself  with  command  line  options.
22       This  is  useful  for  testing  and  for turning outlets on or off from
23       scripts.
24
25       Vendor URL: http://www.intel.com
26

PARAMETERS

28
29
30       -o, --action=[action]
31              Fencing action (Default Value: reboot)
32
33       -c, --community=[community]
34              Set the community string
35
36       -a, --ip=[ip]
37              IP address or hostname of fencing device This parameter  is  al‐
38              ways required.
39
40       -u, --ipport=[port]
41              TCP/UDP  port  to use for connection with device (Default Value:
42              161)
43
44       -p, --password=[password]
45              Login password or passphrase
46
47       -S, --password-script=[script]
48              Script to run to retrieve password
49
50       -n, --plug=[id]
51              Physical plug number on device, UUID or  identification  of  ma‐
52              chine This parameter is always required.
53
54       -b, --snmp-auth-prot=[prot]
55              Set authentication protocol (MD5|SHA)
56
57       -P, --snmp-priv-passwd=[pass]
58              Set privacy protocol password
59
60       -R, --snmp-priv-passwd-script
61              Script to run to retrieve privacy password
62
63       -B, --snmp-priv-prot=[prot]
64              Set privacy protocol (DES|AES)
65
66       -E, --snmp-sec-level=[level]
67              Set security level (noAuthNoPriv|authNoPriv|authPriv)
68
69       -d, --snmp-version=[version]
70              Specifies SNMP version to use (1|2c|3)
71
72       -l, --username=[name]
73              Login name
74
75       -q, --quiet
76              Disable logging to stderr. Does not affect --verbose or --debug-
77              file or logging to syslog.
78
79       -v, --verbose
80              Verbose mode. Multiple -v flags can be stacked  on  the  command
81              line (e.g., -vvv) to increase verbosity.
82
83       --verbose-level
84              Level  of  debugging detail in output. Defaults to the number of
85              --verbose flags specified on the command line, or to 1  if  ver‐
86              bose=1  in  a  stonith  device  configuration  (i.e., on stdin).
87
88
89       -D, --debug-file=[debugfile]
90              Write debug information to given file
91
92       -V, --version
93              Display version information and exit
94
95       -h, --help
96              Display help and exit
97
98       -C, --separator=[char]
99              Separator for CSV created by 'list' operation (Default Value: ,)
100
101
102       --delay=[seconds]
103              Wait  X  seconds  before  fencing  is started (Default Value: 0)
104
105
106       --disable-timeout=[true/false]
107              Disable timeout (true/false) (default: true when run from  Pace‐
108              maker 2.0+)
109
110       --login-timeout=[seconds]
111              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
112
113
114       --power-timeout=[seconds]
115              Test X seconds for status change after  ON/OFF  (Default  Value:
116              20)
117
118       --power-wait=[seconds]
119              Wait X seconds after issuing ON/OFF (Default Value: 0)
120
121       --shell-timeout=[seconds]
122              Wait  X  seconds  for  cmd prompt after issuing command (Default
123              Value: 3)
124
125       --stonith-status-sleep=[seconds]
126              Sleep X seconds between status calls  during  a  STONITH  action
127              (Default Value: 1)
128
129       --retry-on=[attempts]
130              Count of attempts to retry power on (Default Value: 1)
131
132       --snmpget-path=[path]
133              Path to snmpget binary (Default Value: /usr/bin/snmpget)
134
135       --snmpset-path=[path]
136              Path to snmpset binary (Default Value: /usr/bin/snmpset)
137
138       --snmpwalk-path=[path]
139              Path to snmpwalk binary (Default Value: /usr/bin/snmpwalk)
140
141

ACTIONS

143
144
145       on     Power on machine.
146
147       off    Power off machine.
148
149       reboot Reboot machine.
150
151       status This returns the status of the plug/virtual machine.
152
153       list   List  available  plugs with aliases/virtual machines if there is
154              support for more then one device. Returns N/A otherwise.
155
156       list-status
157              List available plugs with  aliases/virtual  machines  and  their
158              power  state  if it can be obtained without additional commands.
159
160
161       monitor
162              Check the health of fence device
163
164       metadata
165              Display the XML metadata describing this resource.
166
167       manpage
168               The operational behavior of this is not known.
169
170       validate-all
171              Validate if all required parameters are entered.
172
173

STDIN PARAMETERS

175
176
177       action Fencing action (Default Value: reboot)
178
179       community
180              Set the community string
181
182       ip     IP address or hostname of fencing device This parameter  is  al‐
183              ways required. Obsoletes: ipaddr
184
185       ipport TCP/UDP  port  to use for connection with device (Default Value:
186              161)
187
188       password
189              Login password or passphrase Obsoletes: passwd
190
191       password_script
192              Script to run  to  retrieve  password  Obsoletes:  passwd_script
193
194
195       plug   Physical  plug  number  on device, UUID or identification of ma‐
196              chine This parameter is always required. Obsoletes:  port
197
198
199       snmp_auth_prot
200              Set authentication protocol (MD5|SHA)
201
202       snmp_priv_passwd
203              Set privacy protocol password
204
205       snmp_priv_passwd_script
206              Script to run to retrieve privacy password
207
208       snmp_priv_prot
209              Set privacy protocol (DES|AES)
210
211       snmp_sec_level
212              Set security level (noAuthNoPriv|authNoPriv|authPriv)
213
214       snmp_version
215              Specifies SNMP version to use (1|2c|3)
216
217       username
218              Login name Obsoletes: login
219
220       quiet  Disable logging to stderr. Does not affect --verbose or --debug-
221              file or logging to syslog.
222
223       verbose
224              Verbose mode. Multiple -v flags can be stacked  on  the  command
225              line (e.g., -vvv) to increase verbosity.
226
227       verbose_level
228              Level  of  debugging detail in output. Defaults to the number of
229              --verbose flags specified on the command line, or to 1  if  ver‐
230              bose=1  in  a  stonith  device  configuration  (i.e., on stdin).
231
232
233       debug_file
234              Write debug information to given file Obsoletes: debug
235
236       version
237              Display version information and exit
238
239       help   Display help and exit
240
241       separator
242              Separator for CSV created by 'list' operation (Default Value: ,)
243
244
245       delay  Wait  X  seconds  before  fencing  is started (Default Value: 0)
246
247
248       disable_timeout
249              Disable timeout (true/false) (default: true when run from  Pace‐
250              maker 2.0+)
251
252       login_timeout
253              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
254
255
256       power_timeout
257              Test X seconds for status change after  ON/OFF  (Default  Value:
258              20)
259
260       power_wait
261              Wait X seconds after issuing ON/OFF (Default Value: 0)
262
263       shell_timeout
264              Wait  X  seconds  for  cmd prompt after issuing command (Default
265              Value: 3)
266
267       stonith_status_sleep
268              Sleep X seconds between status calls  during  a  STONITH  action
269              (Default Value: 1)
270
271       retry_on
272              Count of attempts to retry power on (Default Value: 1)
273
274       snmpget_path
275              Path to snmpget binary (Default Value: /usr/bin/snmpget)
276
277       snmpset_path
278              Path to snmpset binary (Default Value: /usr/bin/snmpset)
279
280       snmpwalk_path
281              Path to snmpwalk binary (Default Value: /usr/bin/snmpwalk)
282
283
284
285fence_intelmodular (Fence Agent)  2009-10-20                    FENCE_AGENT(8)