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

NAME

7       fence_ilo_moonshot - Fence agent for HP Moonshot iLO
8

DESCRIPTION

10       fence_ilo_moonshot  accepts options on the command line as well as from
11       stdin. Fenced sends parameters through stdin when it execs  the  agent.
12       fence_ilo_moonshot  can  be  run  by  itself with command line options.
13       This is useful for testing and for  turning  outlets  on  or  off  from
14       scripts.
15
16       Vendor URL: http://www.hp.com
17

PARAMETERS

19
20
21       -o, --action=[action]
22              Fencing action (Default Value: reboot)
23
24       -c, --command-prompt=[prompt]
25              Force  Python  regex  for command prompt (Default Value: ['MP>',
26              'hpiLO->'])
27
28       -k, --identity-file=[filename]
29              Identity file (private key) for SSH
30
31       -4, --inet4-only
32              Forces agent to use IPv4 addresses only
33
34       -6, --inet6-only
35              Forces agent to use IPv6 addresses only
36
37       -a, --ip=[ip]
38              IP address or hostname of fencing device This parameter  is  al‐
39              ways required.
40
41       -u, --ipport=[port]
42              TCP/UDP  port  to use for connection with device (Default Value:
43              22)
44
45       -p, --password=[password]
46              Login password or passphrase
47
48       -S, --password-script=[script]
49              Script to run to retrieve password
50
51       -n, --plug=[id]
52              Physical plug number on device, UUID or  identification  of  ma‐
53              chine This parameter is always required.
54
55       -x, --ssh
56              Use SSH connection (Default Value: 1)
57
58       --ssh-options=[options]
59              SSH options to use
60
61       -l, --username=[name]
62              Login name This parameter is always required.
63
64       -q, --quiet
65              Disable logging to stderr. Does not affect --verbose or --debug-
66              file or logging to syslog.
67
68       -v, --verbose
69              Verbose mode. Multiple -v flags can be stacked  on  the  command
70              line (e.g., -vvv) to increase verbosity.
71
72       --verbose-level
73              Level  of  debugging detail in output. Defaults to the number of
74              --verbose flags specified on the command line, or to 1  if  ver‐
75              bose=1  in  a  stonith  device  configuration  (i.e., on stdin).
76
77
78       -D, --debug-file=[debugfile]
79              Write debug information to given file
80
81       -V, --version
82              Display version information and exit
83
84       -h, --help
85              Display help and exit
86
87       --plug-separator=[char]
88              Separator for plug parameter when specifying more  than  1  plug
89              (Default Value: ,)
90
91       -C, --separator=[char]
92              Separator for CSV created by 'list' operation (Default Value: ,)
93
94
95       --delay=[seconds]
96              Wait X seconds before fencing  is  started  (Default  Value:  0)
97
98
99       --disable-timeout=[true/false]
100              Disable  timeout (true/false) (default: true when run from Pace‐
101              maker 2.0+)
102
103       --login-timeout=[seconds]
104              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
105
106
107       --power-timeout=[seconds]
108              Test  X  seconds  for status change after ON/OFF (Default Value:
109              20)
110
111       --power-wait=[seconds]
112              Wait X seconds after issuing ON/OFF (Default Value: 0)
113
114       --shell-timeout=[seconds]
115              Wait X seconds for cmd prompt  after  issuing  command  (Default
116              Value: 3)
117
118       --stonith-status-sleep=[seconds]
119              Sleep  X  seconds  between  status calls during a STONITH action
120              (Default Value: 1)
121
122       --retry-on=[attempts]
123              Count of attempts to retry power on (Default Value: 1)
124
125       --ssh-path=[path]
126              Path to ssh binary (Default Value: /usr/bin/ssh)
127
128

ACTIONS

130
131
132       on     Power on machine.
133
134       off    Power off machine.
135
136       reboot Reboot machine.
137
138       status This returns the status of the plug/virtual machine.
139
140       list   List available plugs with aliases/virtual machines if  there  is
141              support for more then one device. Returns N/A otherwise.
142
143       list-status
144              List  available  plugs  with  aliases/virtual machines and their
145              power state if it can be obtained without  additional  commands.
146
147
148       monitor
149              Check the health of fence device
150
151       metadata
152              Display the XML metadata describing this resource.
153
154       manpage
155               The operational behavior of this is not known.
156
157       validate-all
158              Validate if all required parameters are entered.
159
160

STDIN PARAMETERS

162
163
164       action Fencing action (Default Value: reboot)
165
166       command_prompt
167              Force  Python  regex  for command prompt (Default Value: ['MP>',
168              'hpiLO->']) Obsoletes: cmd_prompt
169
170       identity_file
171              Identity file (private key) for SSH
172
173       inet4_only
174              Forces agent to use IPv4 addresses only
175
176       inet6_only
177              Forces agent to use IPv6 addresses only
178
179       ip     IP address or hostname of fencing device This parameter  is  al‐
180              ways required. Obsoletes: ipaddr
181
182       ipport TCP/UDP  port  to use for connection with device (Default Value:
183              22)
184
185       password
186              Login password or passphrase Obsoletes: passwd
187
188       password_script
189              Script to run  to  retrieve  password  Obsoletes:  passwd_script
190
191
192       plug   Physical  plug  number  on device, UUID or identification of ma‐
193              chine This parameter is always required. Obsoletes:  port
194
195
196       ssh    Use SSH connection (Default Value: 1) Obsoletes: secure
197
198       ssh_options
199              SSH options to use
200
201       username
202              Login  name  This parameter is always required. Obsoletes: login
203
204
205       quiet  Disable logging to stderr. Does not affect --verbose or --debug-
206              file or logging to syslog.
207
208       verbose
209              Verbose  mode.  Multiple  -v flags can be stacked on the command
210              line (e.g., -vvv) to increase verbosity.
211
212       verbose_level
213              Level of debugging detail in output. Defaults to the  number  of
214              --verbose  flags  specified on the command line, or to 1 if ver‐
215              bose=1 in a  stonith  device  configuration  (i.e.,  on  stdin).
216
217
218       debug_file
219              Write debug information to given file Obsoletes: debug
220
221       version
222              Display version information and exit
223
224       help   Display help and exit
225
226       plug_separator
227              Separator  for  plug  parameter when specifying more than 1 plug
228              (Default Value: ,)
229
230       separator
231              Separator for CSV created by 'list' operation (Default Value: ,)
232
233
234       delay  Wait  X  seconds  before  fencing  is started (Default Value: 0)
235
236
237       disable_timeout
238              Disable timeout (true/false) (default: true when run from  Pace‐
239              maker 2.0+)
240
241       login_timeout
242              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
243
244
245       power_timeout
246              Test X seconds for status change after  ON/OFF  (Default  Value:
247              20)
248
249       power_wait
250              Wait X seconds after issuing ON/OFF (Default Value: 0)
251
252       shell_timeout
253              Wait  X  seconds  for  cmd prompt after issuing command (Default
254              Value: 3)
255
256       stonith_status_sleep
257              Sleep X seconds between status calls  during  a  STONITH  action
258              (Default Value: 1)
259
260       retry_on
261              Count of attempts to retry power on (Default Value: 1)
262
263       ssh_path
264              Path to ssh binary (Default Value: /usr/bin/ssh)
265
266
267
268fence_ilo_moonshot (Fence Agent)  2009-10-20                    FENCE_AGENT(8)