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

NAME

7       fence_aliyun - Fence agent for Aliyun (Aliyun Web Services)
8

DESCRIPTION

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

PARAMETERS

20
21
22       -o, --action=[action]
23              Fencing action (Default Value: reboot)
24
25       -n, --plug=[id]
26              Physical plug number on device, UUID or  identification  of  ma‐
27              chine This parameter is always required.
28
29       -r, --region=[name]
30              Region.
31
32       -a, --access-key=[name]
33              Access Key.
34
35       -s, --secret-key=[name]
36              Secret Key.
37
38       --ram-role=[name]
39              Ram Role.
40
41       --filter=[key=value]
42              Filter for list-action.
43
44       -q, --quiet
45              Disable logging to stderr. Does not affect --verbose or --debug-
46              file or logging to syslog.
47
48       -v, --verbose
49              Verbose mode. Multiple -v flags can be stacked  on  the  command
50              line (e.g., -vvv) to increase verbosity.
51
52       --verbose-level
53              Level  of  debugging detail in output. Defaults to the number of
54              --verbose flags specified on the command line, or to 1  if  ver‐
55              bose=1  in  a  stonith  device  configuration  (i.e., on stdin).
56
57
58       -D, --debug-file=[debugfile]
59              Write debug information to given file
60
61       -V, --version
62              Display version information and exit
63
64       -h, --help
65              Display help and exit
66
67       --plug-separator=[char]
68              Separator for plug parameter when specifying more  than  1  plug
69              (Default Value: ,)
70
71       -C, --separator=[char]
72              Separator for CSV created by 'list' operation (Default Value: ,)
73
74
75       --delay=[seconds]
76              Wait X seconds before fencing  is  started  (Default  Value:  0)
77
78
79       --disable-timeout=[true/false]
80              Disable  timeout (true/false) (default: true when run from Pace‐
81              maker 2.0+)
82
83       --login-timeout=[seconds]
84              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
85
86
87       --power-timeout=[seconds]
88              Test  X  seconds  for status change after ON/OFF (Default Value:
89              60)
90
91       --power-wait=[seconds]
92              Wait X seconds after issuing ON/OFF (Default Value: 0)
93
94       --shell-timeout=[seconds]
95              Wait X seconds for cmd prompt  after  issuing  command  (Default
96              Value: 3)
97
98       --stonith-status-sleep=[seconds]
99              Sleep  X  seconds  between  status calls during a STONITH action
100              (Default Value: 1)
101
102       --retry-on=[attempts]
103              Count of attempts to retry power on (Default Value: 1)
104
105

ACTIONS

107
108
109       on     Power on machine.
110
111       off    Power off machine.
112
113       reboot Reboot machine.
114
115       status This returns the status of the plug/virtual machine.
116
117       list   List available plugs with aliases/virtual machines if  there  is
118              support for more then one device. Returns N/A otherwise.
119
120       list-status
121              List  available  plugs  with  aliases/virtual machines and their
122              power state if it can be obtained without  additional  commands.
123
124
125       monitor
126              Check the health of fence device
127
128       metadata
129              Display the XML metadata describing this resource.
130
131       manpage
132               The operational behavior of this is not known.
133
134       validate-all
135              Validate if all required parameters are entered.
136
137

STDIN PARAMETERS

139
140
141       action Fencing action (Default Value: reboot)
142
143       plug   Physical  plug  number  on device, UUID or identification of ma‐
144              chine This parameter is always required. Obsoletes:  port
145
146
147       region Region.
148
149       access_key
150              Access Key.
151
152       secret_key
153              Secret Key.
154
155       ram_role
156              Ram Role.
157
158       filter Filter for list-action.
159
160       quiet  Disable logging to stderr. Does not affect --verbose or --debug-
161              file or logging to syslog.
162
163       verbose
164              Verbose mode. Multiple -v flags can be stacked  on  the  command
165              line (e.g., -vvv) to increase verbosity.
166
167       verbose_level
168              Level  of  debugging detail in output. Defaults to the number of
169              --verbose flags specified on the command line, or to 1  if  ver‐
170              bose=1  in  a  stonith  device  configuration  (i.e., on stdin).
171
172
173       debug_file
174              Write debug information to given file Obsoletes: debug
175
176       version
177              Display version information and exit
178
179       help   Display help and exit
180
181       plug_separator
182              Separator for plug parameter when specifying more  than  1  plug
183              (Default Value: ,)
184
185       separator
186              Separator for CSV created by 'list' operation (Default Value: ,)
187
188
189       delay  Wait X seconds before fencing  is  started  (Default  Value:  0)
190
191
192       disable_timeout
193              Disable  timeout (true/false) (default: true when run from Pace‐
194              maker 2.0+)
195
196       login_timeout
197              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
198
199
200       power_timeout
201              Test  X  seconds  for status change after ON/OFF (Default Value:
202              60)
203
204       power_wait
205              Wait X seconds after issuing ON/OFF (Default Value: 0)
206
207       shell_timeout
208              Wait X seconds for cmd prompt  after  issuing  command  (Default
209              Value: 3)
210
211       stonith_status_sleep
212              Sleep  X  seconds  between  status calls during a STONITH action
213              (Default Value: 1)
214
215       retry_on
216              Count of attempts to retry power on (Default Value: 1)
217
218
219
220fence_aliyun (Fence Agent)        2009-10-20                    FENCE_AGENT(8)