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
27              machine 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       --retry-on=[attempts]
92              Count of attempts to retry power on (Default Value: 1)
93
94

ACTIONS

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

STDIN PARAMETERS

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