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
15       removed, 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       -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       -l, --username=[name]
46              Login Name
47
48       -p, --password=[password]
49              Login password or passphrase
50
51       -S, --password-script=[script]
52              Script to retrieve password
53
54       -n, --plug=[id]
55              Physical plug number, name  of  virtual  machine  or  UUID  This
56              parameter is always required.
57
58       -b, --snmp-auth-prot=[prot]
59              Set authentication protocol (MD5|SHA)
60
61       -P, --snmp-priv-passwd=[pass]
62              Set privacy protocol password
63
64       -R, --snmp-priv-passwd-script
65              Script to run to retrieve privacy password
66
67       -B, --snmp-priv-prot=[prot]
68              Set privacy protocol (DES|AES)
69
70       -E, --snmp-sec-level=[level]
71              Set security level (noAuthNoPriv|authNoPriv|authPriv)
72
73       -d, --snmp-version=[version]
74              Specifies SNMP version to use (1,2c,3)
75
76       -u, --udpport
77              UDP/TCP port to use for connection with device
78
79       -v, --verbose
80              Verbose mode
81
82       -D, --debug-file=[debugfile]
83              Write debug information to given file
84
85       -V, --version
86              Display version information and exit
87
88       -h, --help
89              Display help and exit
90
91       -C, --separator=[char]
92              Separator  for  CSV created by operation list (Default Value: ,)
93
94
95       --delay=[seconds]
96              Wait X seconds before fencing  is  started  (Default  Value:  0)
97
98
99       --login-timeout=[seconds]
100              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
101
102
103       --power-timeout=[seconds]
104              Test X seconds for status change after  ON/OFF  (Default  Value:
105              20)
106
107       --power-wait=[seconds]
108              Wait X seconds after issuing ON/OFF (Default Value: 0)
109
110       --shell-timeout=[seconds]
111              Wait  X  seconds  for  cmd prompt after issuing command (Default
112              Value: 3)
113
114       --retry-on=[attempts]
115              Count of attempts to retry power on (Default Value: 1)
116
117

ACTIONS

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

STDIN PARAMETERS

145
146
147       action Fencing Action (Default Value: reboot)
148
149       community
150              Set the community string
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       ipaddr IP Address or Hostname This parameter is always required.
159
160       login  Login Name
161
162       passwd Login password or passphrase
163
164       passwd_script
165              Script to retrieve password
166
167       port   Physical  plug  number,  name  of  virtual  machine or UUID This
168              parameter is always required.
169
170       snmp_auth_prot
171              Set authentication protocol (MD5|SHA)
172
173       snmp_priv_passwd
174              Set privacy protocol password
175
176       snmp_priv_passwd_script
177              Script to run to retrieve privacy password
178
179       snmp_priv_prot
180              Set privacy protocol (DES|AES)
181
182       snmp_sec_level
183              Set security level (noAuthNoPriv|authNoPriv|authPriv)
184
185       snmp_version
186              Specifies SNMP version to use (1,2c,3)
187
188       udpport
189              UDP/TCP port to use for connection with device
190
191       verbose
192              Verbose mode
193
194       debug  Write debug information to given file
195
196       version
197              Display version information and exit
198
199       help   Display help and exit
200
201       separator
202              Separator for CSV created by operation list (Default  Value:  ,)
203
204
205       delay  Wait  X  seconds  before  fencing  is started (Default Value: 0)
206
207
208       login_timeout
209              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
210
211
212       power_timeout
213              Test  X  seconds  for status change after ON/OFF (Default Value:
214              20)
215
216       power_wait
217              Wait X seconds after issuing ON/OFF (Default Value: 0)
218
219       shell_timeout
220              Wait X seconds for cmd prompt  after  issuing  command  (Default
221              Value: 3)
222
223       retry_on
224              Count of attempts to retry power on (Default Value: 1)
225
226
227
228fence_intelmodular (Fence Agent)  2009-10-20                    FENCE_AGENT(8)