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       -q, --quiet
42              Disable logging to stderr. Does not affect --verbose or --debug-
43              file or logging to syslog.
44
45       -v, --verbose
46              Verbose mode. Multiple -v flags can be stacked  on  the  command
47              line (e.g., -vvv) to increase verbosity.
48
49       --verbose-level
50              Level  of  debugging detail in output. Defaults to the number of
51              --verbose flags specified on the command line, or to 1  if  ver‐
52              bose=1  in  a  stonith  device  configuration  (i.e., on stdin).
53
54
55       -D, --debug-file=[debugfile]
56              Write debug information to given file
57
58       -V, --version
59              Display version information and exit
60
61       -h, --help
62              Display help and exit
63
64       -C, --separator=[char]
65              Separator for CSV created by 'list' operation (Default Value: ,)
66
67
68       --delay=[seconds]
69              Wait  X  seconds  before  fencing  is started (Default Value: 0)
70
71
72       --disable-timeout=[true/false]
73              Disable timeout (true/false) (default: true when run from  Pace‐
74              maker 2.0+)
75
76       --login-timeout=[seconds]
77              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
78
79
80       --power-timeout=[seconds]
81              Test X seconds for status change after  ON/OFF  (Default  Value:
82              60)
83
84       --power-wait=[seconds]
85              Wait X seconds after issuing ON/OFF (Default Value: 0)
86
87       --shell-timeout=[seconds]
88              Wait  X  seconds  for  cmd prompt after issuing command (Default
89              Value: 3)
90
91       --stonith-status-sleep=[seconds]
92              Sleep X seconds between status calls  during  a  STONITH  action
93              (Default Value: 1)
94
95       --retry-on=[attempts]
96              Count of attempts to retry power on (Default Value: 1)
97
98

ACTIONS

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

STDIN PARAMETERS

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