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       --plug-separator=[char]
99              Separator for plug parameter when specifying more  than  1  plug
100              (Default Value: ,)
101
102       -C, --separator=[char]
103              Separator for CSV created by 'list' operation (Default Value: ,)
104
105
106       --delay=[seconds]
107              Wait X seconds before fencing  is  started  (Default  Value:  0)
108
109
110       --disable-timeout=[true/false]
111              Disable  timeout (true/false) (default: true when run from Pace‐
112              maker 2.0+)
113
114       --login-timeout=[seconds]
115              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
116
117
118       --power-timeout=[seconds]
119              Test  X  seconds  for status change after ON/OFF (Default Value:
120              20)
121
122       --power-wait=[seconds]
123              Wait X seconds after issuing ON/OFF (Default Value: 0)
124
125       --shell-timeout=[seconds]
126              Wait X seconds for cmd prompt  after  issuing  command  (Default
127              Value: 3)
128
129       --stonith-status-sleep=[seconds]
130              Sleep  X  seconds  between  status calls during a STONITH action
131              (Default Value: 1)
132
133       --retry-on=[attempts]
134              Count of attempts to retry power on (Default Value: 1)
135
136       --snmpget-path=[path]
137              Path to snmpget binary (Default Value: /usr/bin/snmpget)
138
139       --snmpset-path=[path]
140              Path to snmpset binary (Default Value: /usr/bin/snmpset)
141
142       --snmpwalk-path=[path]
143              Path to snmpwalk binary (Default Value: /usr/bin/snmpwalk)
144
145

ACTIONS

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

STDIN PARAMETERS

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