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

ACTIONS

120
121
122       on     Power on machine.
123
124       off    Power off machine.
125
126       reboot Reboot machine.
127
128       status This returns the status of the plug/virtual machine.
129
130       list   List  available  plugs with aliases/virtual machines if there is
131              support for more then one device. Returns N/A otherwise.
132
133       monitor
134              Check if fencing device is running. List available plugs/virtual
135              machines or get status of machine (if it does not support more).
136
137
138       metadata
139               The operational behavior of this is not known.
140
141

STDIN PARAMETERS

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