root / lib / rpc_defs.py @ b8c160c1
History | View | Annotate | Download (16.6 kB)
1 | d5a2a550 | Michael Hanselmann | #
|
---|---|---|---|
2 | d5a2a550 | Michael Hanselmann | #
|
3 | d5a2a550 | Michael Hanselmann | |
4 | d5a2a550 | Michael Hanselmann | # Copyright (C) 2006, 2007, 2008, 2009, 2010, 2011 Google Inc.
|
5 | d5a2a550 | Michael Hanselmann | #
|
6 | d5a2a550 | Michael Hanselmann | # This program is free software; you can redistribute it and/or modify
|
7 | d5a2a550 | Michael Hanselmann | # it under the terms of the GNU General Public License as published by
|
8 | d5a2a550 | Michael Hanselmann | # the Free Software Foundation; either version 2 of the License, or
|
9 | d5a2a550 | Michael Hanselmann | # (at your option) any later version.
|
10 | d5a2a550 | Michael Hanselmann | #
|
11 | d5a2a550 | Michael Hanselmann | # This program is distributed in the hope that it will be useful, but
|
12 | d5a2a550 | Michael Hanselmann | # WITHOUT ANY WARRANTY; without even the implied warranty of
|
13 | d5a2a550 | Michael Hanselmann | # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
14 | d5a2a550 | Michael Hanselmann | # General Public License for more details.
|
15 | d5a2a550 | Michael Hanselmann | #
|
16 | d5a2a550 | Michael Hanselmann | # You should have received a copy of the GNU General Public License
|
17 | d5a2a550 | Michael Hanselmann | # along with this program; if not, write to the Free Software
|
18 | d5a2a550 | Michael Hanselmann | # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
|
19 | d5a2a550 | Michael Hanselmann | # 02110-1301, USA.
|
20 | d5a2a550 | Michael Hanselmann | |
21 | d5a2a550 | Michael Hanselmann | """RPC definitions for communication between master and node daemons.
|
22 | d5a2a550 | Michael Hanselmann |
|
23 | 033684dd | Michael Hanselmann | RPC definition fields:
|
24 | 033684dd | Michael Hanselmann |
|
25 | 033684dd | Michael Hanselmann | - Name as string
|
26 | 033684dd | Michael Hanselmann | - L{SINGLE} for single-node calls, L{MULTI} for multi-node
|
27 | 033684dd | Michael Hanselmann | - Timeout (e.g. L{TMO_NORMAL})
|
28 | 033684dd | Michael Hanselmann | - List of arguments as tuples
|
29 | 033684dd | Michael Hanselmann |
|
30 | 033684dd | Michael Hanselmann | - Name as string
|
31 | 033684dd | Michael Hanselmann | - Wrapper code ("%s" is replaced with argument name, see L{OBJECT_TO_DICT})
|
32 | 033684dd | Michael Hanselmann | - Description for docstring (can be C{None})
|
33 | 033684dd | Michael Hanselmann |
|
34 | 033684dd | Michael Hanselmann | - Return value wrapper (e.g. for deserializing into L{objects}-based objects)
|
35 | 033684dd | Michael Hanselmann | - Short call description for docstring
|
36 | 033684dd | Michael Hanselmann |
|
37 | d5a2a550 | Michael Hanselmann | """
|
38 | d5a2a550 | Michael Hanselmann | |
39 | d5a2a550 | Michael Hanselmann | |
40 | 0d1e78dd | Michael Hanselmann | # Guidelines for choosing timeouts:
|
41 | 0d1e78dd | Michael Hanselmann | # - call used during watcher: timeout of 1min, _TMO_URGENT
|
42 | 0d1e78dd | Michael Hanselmann | # - trivial (but be sure it is trivial) (e.g. reading a file): 5min, _TMO_FAST
|
43 | 0d1e78dd | Michael Hanselmann | # - other calls: 15 min, _TMO_NORMAL
|
44 | 0d1e78dd | Michael Hanselmann | # - special calls (instance add, etc.): either _TMO_SLOW (1h) or huge timeouts
|
45 | d5a2a550 | Michael Hanselmann | TMO_URGENT = 60 # one minute |
46 | d5a2a550 | Michael Hanselmann | TMO_FAST = 5 * 60 # five minutes |
47 | d5a2a550 | Michael Hanselmann | TMO_NORMAL = 15 * 60 # 15 minutes |
48 | d5a2a550 | Michael Hanselmann | TMO_SLOW = 3600 # one hour |
49 | d5a2a550 | Michael Hanselmann | TMO_4HRS = 4 * 3600 |
50 | d5a2a550 | Michael Hanselmann | TMO_1DAY = 86400
|
51 | d5a2a550 | Michael Hanselmann | |
52 | d5a2a550 | Michael Hanselmann | SINGLE = "single-node"
|
53 | d5a2a550 | Michael Hanselmann | MULTI = "multi-node"
|
54 | d5a2a550 | Michael Hanselmann | |
55 | d565f83f | Michael Hanselmann | OBJECT_TO_DICT = "%s.ToDict()"
|
56 | d565f83f | Michael Hanselmann | OBJECT_LIST_TO_DICT = "map(lambda d: d.ToDict(), %s)"
|
57 | d565f83f | Michael Hanselmann | INST_TO_DICT = "self._InstDict(%s)"
|
58 | d565f83f | Michael Hanselmann | |
59 | d565f83f | Michael Hanselmann | NODE_TO_DISK_DICT = \ |
60 | d565f83f | Michael Hanselmann | ("dict((name, %s) for name, disks in %%s.items())" %
|
61 | d565f83f | Michael Hanselmann | (OBJECT_LIST_TO_DICT % "disks"))
|
62 | d565f83f | Michael Hanselmann | |
63 | 033684dd | Michael Hanselmann | _FILE_STORAGE_CALLS = [ |
64 | 033684dd | Michael Hanselmann | ("file_storage_dir_create", SINGLE, TMO_FAST, [
|
65 | 033684dd | Michael Hanselmann | ("file_storage_dir", None, "File storage directory"), |
66 | 033684dd | Michael Hanselmann | ], None, "Create the given file storage directory"), |
67 | 033684dd | Michael Hanselmann | ("file_storage_dir_remove", SINGLE, TMO_FAST, [
|
68 | 033684dd | Michael Hanselmann | ("file_storage_dir", None, "File storage directory"), |
69 | 033684dd | Michael Hanselmann | ], None, "Remove the given file storage directory"), |
70 | 033684dd | Michael Hanselmann | ("file_storage_dir_rename", SINGLE, TMO_FAST, [
|
71 | 033684dd | Michael Hanselmann | ("old_file_storage_dir", None, "Old name"), |
72 | 033684dd | Michael Hanselmann | ("new_file_storage_dir", None, "New name"), |
73 | 033684dd | Michael Hanselmann | ], None, "Rename file storage directory"), |
74 | 033684dd | Michael Hanselmann | ] |
75 | 033684dd | Michael Hanselmann | |
76 | 033684dd | Michael Hanselmann | _STORAGE_CALLS = [ |
77 | 033684dd | Michael Hanselmann | ("storage_list", MULTI, TMO_NORMAL, [
|
78 | 033684dd | Michael Hanselmann | ("su_name", None, None), |
79 | 033684dd | Michael Hanselmann | ("su_args", None, None), |
80 | 033684dd | Michael Hanselmann | ("name", None, None), |
81 | 033684dd | Michael Hanselmann | ("fields", None, None), |
82 | 033684dd | Michael Hanselmann | ], None, "Get list of storage units"), |
83 | 033684dd | Michael Hanselmann | ("storage_modify", SINGLE, TMO_NORMAL, [
|
84 | 033684dd | Michael Hanselmann | ("su_name", None, None), |
85 | 033684dd | Michael Hanselmann | ("su_args", None, None), |
86 | 033684dd | Michael Hanselmann | ("name", None, None), |
87 | 033684dd | Michael Hanselmann | ("changes", None, None), |
88 | 033684dd | Michael Hanselmann | ], None, "Modify a storage unit"), |
89 | 033684dd | Michael Hanselmann | ("storage_execute", SINGLE, TMO_NORMAL, [
|
90 | 033684dd | Michael Hanselmann | ("su_name", None, None), |
91 | 033684dd | Michael Hanselmann | ("su_args", None, None), |
92 | 033684dd | Michael Hanselmann | ("name", None, None), |
93 | 033684dd | Michael Hanselmann | ("op", None, None), |
94 | 033684dd | Michael Hanselmann | ], None, "Executes an operation on a storage unit"), |
95 | 033684dd | Michael Hanselmann | ] |
96 | 033684dd | Michael Hanselmann | |
97 | 033684dd | Michael Hanselmann | _INSTANCE_CALLS = [ |
98 | 033684dd | Michael Hanselmann | ("instance_info", SINGLE, TMO_URGENT, [
|
99 | 033684dd | Michael Hanselmann | ("instance", None, "Instance name"), |
100 | 033684dd | Michael Hanselmann | ("hname", None, "Hypervisor type"), |
101 | 033684dd | Michael Hanselmann | ], None, "Returns information about a single instance"), |
102 | 033684dd | Michael Hanselmann | ("all_instances_info", MULTI, TMO_URGENT, [
|
103 | 033684dd | Michael Hanselmann | ("hypervisor_list", None, "Hypervisors to query for instances"), |
104 | 033684dd | Michael Hanselmann | ], None, "Returns information about all instances on the given nodes"), |
105 | 033684dd | Michael Hanselmann | ("instance_list", MULTI, TMO_URGENT, [
|
106 | 033684dd | Michael Hanselmann | ("hypervisor_list", None, "Hypervisors to query for instances"), |
107 | 033684dd | Michael Hanselmann | ], None, "Returns the list of running instances on the given nodes"), |
108 | 033684dd | Michael Hanselmann | ("instance_reboot", SINGLE, TMO_NORMAL, [
|
109 | 033684dd | Michael Hanselmann | ("inst", INST_TO_DICT, "Instance object"), |
110 | 033684dd | Michael Hanselmann | ("reboot_type", None, None), |
111 | 033684dd | Michael Hanselmann | ("shutdown_timeout", None, None), |
112 | 033684dd | Michael Hanselmann | ], None, "Returns the list of running instances on the given nodes"), |
113 | 033684dd | Michael Hanselmann | ("instance_shutdown", SINGLE, TMO_NORMAL, [
|
114 | 033684dd | Michael Hanselmann | ("instance", INST_TO_DICT, "Instance object"), |
115 | 033684dd | Michael Hanselmann | ("timeout", None, None), |
116 | 033684dd | Michael Hanselmann | ], None, "Stops an instance"), |
117 | 033684dd | Michael Hanselmann | ("instance_run_rename", SINGLE, TMO_SLOW, [
|
118 | 033684dd | Michael Hanselmann | ("instance", INST_TO_DICT, "Instance object"), |
119 | 033684dd | Michael Hanselmann | ("old_name", None, None), |
120 | 033684dd | Michael Hanselmann | ("debug", None, None), |
121 | 033684dd | Michael Hanselmann | ], None, "Run the OS rename script for an instance"), |
122 | 033684dd | Michael Hanselmann | ("instance_migratable", SINGLE, TMO_NORMAL, [
|
123 | 033684dd | Michael Hanselmann | ("instance", INST_TO_DICT, "Instance object"), |
124 | 033684dd | Michael Hanselmann | ], None, "Checks whether the given instance can be migrated"), |
125 | 033684dd | Michael Hanselmann | ("migration_info", SINGLE, TMO_NORMAL, [
|
126 | 033684dd | Michael Hanselmann | ("instance", INST_TO_DICT, "Instance object"), |
127 | 033684dd | Michael Hanselmann | ], None,
|
128 | 033684dd | Michael Hanselmann | "Gather the information necessary to prepare an instance migration"),
|
129 | 033684dd | Michael Hanselmann | ("accept_instance", SINGLE, TMO_NORMAL, [
|
130 | 033684dd | Michael Hanselmann | ("instance", INST_TO_DICT, "Instance object"), |
131 | 033684dd | Michael Hanselmann | ("info", None, "Result for the call_migration_info call"), |
132 | 033684dd | Michael Hanselmann | ("target", None, "Target hostname (usually an IP address)"), |
133 | 033684dd | Michael Hanselmann | ], None, "Prepare a node to accept an instance"), |
134 | 033684dd | Michael Hanselmann | ("instance_finalize_migration_dst", SINGLE, TMO_NORMAL, [
|
135 | 033684dd | Michael Hanselmann | ("instance", INST_TO_DICT, "Instance object"), |
136 | 033684dd | Michael Hanselmann | ("info", None, "Result for the call_migration_info call"), |
137 | 033684dd | Michael Hanselmann | ("success", None, "Whether the migration was a success or failure"), |
138 | 033684dd | Michael Hanselmann | ], None, "Finalize any target-node migration specific operation"), |
139 | 033684dd | Michael Hanselmann | ("instance_migrate", SINGLE, TMO_SLOW, [
|
140 | 033684dd | Michael Hanselmann | ("instance", INST_TO_DICT, "Instance object"), |
141 | 033684dd | Michael Hanselmann | ("target", None, "Target node name"), |
142 | 033684dd | Michael Hanselmann | ("live", None, "Whether the migration should be done live or not"), |
143 | 033684dd | Michael Hanselmann | ], None, "Migrate an instance"), |
144 | 033684dd | Michael Hanselmann | ("instance_finalize_migration_src", SINGLE, TMO_SLOW, [
|
145 | 033684dd | Michael Hanselmann | ("instance", INST_TO_DICT, "Instance object"), |
146 | 033684dd | Michael Hanselmann | ("success", None, "Whether the migration succeeded or not"), |
147 | 033684dd | Michael Hanselmann | ("live", None, "Whether the user requested a live migration or not"), |
148 | 033684dd | Michael Hanselmann | ], None, "Finalize the instance migration on the source node"), |
149 | e3ac8406 | Andrea Spadaccini | ("instance_get_migration_status", SINGLE, TMO_SLOW, [
|
150 | e3ac8406 | Andrea Spadaccini | ("instance", INST_TO_DICT, "Instance object"), |
151 | e3ac8406 | Andrea Spadaccini | ], "self._MigrationStatusPostProc", "Report migration status"), |
152 | c4de9b7a | Michael Hanselmann | ("instance_start", SINGLE, TMO_NORMAL, [
|
153 | c4de9b7a | Michael Hanselmann | ("instance_hvp_bep", "self._InstDictHvpBep(%s)", None), |
154 | c4de9b7a | Michael Hanselmann | ("startup_paused", None, None), |
155 | c4de9b7a | Michael Hanselmann | ], None, "Starts an instance"), |
156 | c4de9b7a | Michael Hanselmann | ("instance_os_add", SINGLE, TMO_1DAY, [
|
157 | c4de9b7a | Michael Hanselmann | ("instance_osp", "self._InstDictOsp(%s)", None), |
158 | c4de9b7a | Michael Hanselmann | ("reinstall", None, None), |
159 | c4de9b7a | Michael Hanselmann | ("debug", None, None), |
160 | c4de9b7a | Michael Hanselmann | ], None, "Starts an instance"), |
161 | 033684dd | Michael Hanselmann | ] |
162 | 033684dd | Michael Hanselmann | |
163 | 033684dd | Michael Hanselmann | _IMPEXP_CALLS = [ |
164 | 46c293f0 | Michael Hanselmann | ("import_start", SINGLE, TMO_NORMAL, [
|
165 | 46c293f0 | Michael Hanselmann | ("opts", OBJECT_TO_DICT, None), |
166 | 46c293f0 | Michael Hanselmann | ("instance", INST_TO_DICT, None), |
167 | 46c293f0 | Michael Hanselmann | ("component", None, None), |
168 | b8c160c1 | Michael Hanselmann | ("dest", "self._EncodeImportExportIO(%s)", "Import destination"), |
169 | 46c293f0 | Michael Hanselmann | ], None, "Starts an import daemon"), |
170 | 46c293f0 | Michael Hanselmann | ("export_start", SINGLE, TMO_NORMAL, [
|
171 | 46c293f0 | Michael Hanselmann | ("opts", OBJECT_TO_DICT, None), |
172 | 46c293f0 | Michael Hanselmann | ("host", None, None), |
173 | 46c293f0 | Michael Hanselmann | ("port", None, None), |
174 | 46c293f0 | Michael Hanselmann | ("instance", INST_TO_DICT, None), |
175 | 46c293f0 | Michael Hanselmann | ("component", None, None), |
176 | b8c160c1 | Michael Hanselmann | ("source", "self._EncodeImportExportIO(%s)", "Export source"), |
177 | 46c293f0 | Michael Hanselmann | ], None, "Starts an export daemon"), |
178 | 033684dd | Michael Hanselmann | ("impexp_status", SINGLE, TMO_FAST, [
|
179 | 033684dd | Michael Hanselmann | ("names", None, "Import/export names"), |
180 | 033684dd | Michael Hanselmann | ], "self._ImpExpStatusPostProc", "Gets the status of an import or export"), |
181 | 033684dd | Michael Hanselmann | ("impexp_abort", SINGLE, TMO_NORMAL, [
|
182 | 033684dd | Michael Hanselmann | ("name", None, "Import/export name"), |
183 | 033684dd | Michael Hanselmann | ], None, "Aborts an import or export"), |
184 | 033684dd | Michael Hanselmann | ("impexp_cleanup", SINGLE, TMO_NORMAL, [
|
185 | 033684dd | Michael Hanselmann | ("name", None, "Import/export name"), |
186 | 033684dd | Michael Hanselmann | ], None, "Cleans up after an import or export"), |
187 | 033684dd | Michael Hanselmann | ("export_info", SINGLE, TMO_FAST, [
|
188 | 033684dd | Michael Hanselmann | ("path", None, None), |
189 | 033684dd | Michael Hanselmann | ], None, "Queries the export information in a given path"), |
190 | 033684dd | Michael Hanselmann | ("finalize_export", SINGLE, TMO_NORMAL, [
|
191 | 033684dd | Michael Hanselmann | ("instance", INST_TO_DICT, None), |
192 | 033684dd | Michael Hanselmann | ("snap_disks", "self._PrepareFinalizeExportDisks(%s)", None), |
193 | 033684dd | Michael Hanselmann | ], None, "Request the completion of an export operation"), |
194 | 033684dd | Michael Hanselmann | ("export_list", MULTI, TMO_FAST, [], None, "Gets the stored exports list"), |
195 | 033684dd | Michael Hanselmann | ("export_remove", SINGLE, TMO_FAST, [
|
196 | 033684dd | Michael Hanselmann | ("export", None, None), |
197 | 033684dd | Michael Hanselmann | ], None, "Requests removal of a given export"), |
198 | 033684dd | Michael Hanselmann | ] |
199 | 033684dd | Michael Hanselmann | |
200 | 033684dd | Michael Hanselmann | _X509_CALLS = [ |
201 | 033684dd | Michael Hanselmann | ("x509_cert_create", SINGLE, TMO_NORMAL, [
|
202 | 033684dd | Michael Hanselmann | ("validity", None, "Validity in seconds"), |
203 | 033684dd | Michael Hanselmann | ], None, "Creates a new X509 certificate for SSL/TLS"), |
204 | 033684dd | Michael Hanselmann | ("x509_cert_remove", SINGLE, TMO_NORMAL, [
|
205 | 033684dd | Michael Hanselmann | ("name", None, "Certificate name"), |
206 | 033684dd | Michael Hanselmann | ], None, "Removes a X509 certificate"), |
207 | 033684dd | Michael Hanselmann | ] |
208 | 033684dd | Michael Hanselmann | |
209 | 033684dd | Michael Hanselmann | _BLOCKDEV_CALLS = [ |
210 | 033684dd | Michael Hanselmann | ("bdev_sizes", MULTI, TMO_URGENT, [
|
211 | 033684dd | Michael Hanselmann | ("devices", None, None), |
212 | 033684dd | Michael Hanselmann | ], None, "Gets the sizes of requested block devices present on a node"), |
213 | 033684dd | Michael Hanselmann | ("blockdev_create", SINGLE, TMO_NORMAL, [
|
214 | 033684dd | Michael Hanselmann | ("bdev", OBJECT_TO_DICT, None), |
215 | 033684dd | Michael Hanselmann | ("size", None, None), |
216 | 033684dd | Michael Hanselmann | ("owner", None, None), |
217 | 033684dd | Michael Hanselmann | ("on_primary", None, None), |
218 | 033684dd | Michael Hanselmann | ("info", None, None), |
219 | 033684dd | Michael Hanselmann | ], None, "Request creation of a given block device"), |
220 | 033684dd | Michael Hanselmann | ("blockdev_wipe", SINGLE, TMO_SLOW, [
|
221 | 033684dd | Michael Hanselmann | ("bdev", OBJECT_TO_DICT, None), |
222 | 033684dd | Michael Hanselmann | ("offset", None, None), |
223 | 033684dd | Michael Hanselmann | ("size", None, None), |
224 | 033684dd | Michael Hanselmann | ], None,
|
225 | 033684dd | Michael Hanselmann | "Request wipe at given offset with given size of a block device"),
|
226 | 033684dd | Michael Hanselmann | ("blockdev_remove", SINGLE, TMO_NORMAL, [
|
227 | 033684dd | Michael Hanselmann | ("bdev", OBJECT_TO_DICT, None), |
228 | 033684dd | Michael Hanselmann | ], None, "Request removal of a given block device"), |
229 | 033684dd | Michael Hanselmann | ("blockdev_pause_resume_sync", SINGLE, TMO_NORMAL, [
|
230 | 033684dd | Michael Hanselmann | ("disks", OBJECT_LIST_TO_DICT, None), |
231 | 033684dd | Michael Hanselmann | ("pause", None, None), |
232 | 033684dd | Michael Hanselmann | ], None, "Request a pause/resume of given block device"), |
233 | 033684dd | Michael Hanselmann | ("blockdev_assemble", SINGLE, TMO_NORMAL, [
|
234 | 033684dd | Michael Hanselmann | ("disk", OBJECT_TO_DICT, None), |
235 | 033684dd | Michael Hanselmann | ("owner", None, None), |
236 | 033684dd | Michael Hanselmann | ("on_primary", None, None), |
237 | 033684dd | Michael Hanselmann | ("idx", None, None), |
238 | 033684dd | Michael Hanselmann | ], None, "Request assembling of a given block device"), |
239 | 033684dd | Michael Hanselmann | ("blockdev_shutdown", SINGLE, TMO_NORMAL, [
|
240 | 033684dd | Michael Hanselmann | ("disk", OBJECT_TO_DICT, None), |
241 | 033684dd | Michael Hanselmann | ], None, "Request shutdown of a given block device"), |
242 | 033684dd | Michael Hanselmann | ("blockdev_addchildren", SINGLE, TMO_NORMAL, [
|
243 | 033684dd | Michael Hanselmann | ("bdev", OBJECT_TO_DICT, None), |
244 | 033684dd | Michael Hanselmann | ("ndevs", OBJECT_LIST_TO_DICT, None), |
245 | 033684dd | Michael Hanselmann | ], None, "Request adding a list of children to a (mirroring) device"), |
246 | 033684dd | Michael Hanselmann | ("blockdev_removechildren", SINGLE, TMO_NORMAL, [
|
247 | 033684dd | Michael Hanselmann | ("bdev", OBJECT_TO_DICT, None), |
248 | 033684dd | Michael Hanselmann | ("ndevs", OBJECT_LIST_TO_DICT, None), |
249 | 033684dd | Michael Hanselmann | ], None, "Request removing a list of children from a (mirroring) device"), |
250 | 033684dd | Michael Hanselmann | ("blockdev_close", SINGLE, TMO_NORMAL, [
|
251 | 033684dd | Michael Hanselmann | ("instance_name", None, None), |
252 | 033684dd | Michael Hanselmann | ("disks", OBJECT_LIST_TO_DICT, None), |
253 | 033684dd | Michael Hanselmann | ], None, "Closes the given block devices"), |
254 | 033684dd | Michael Hanselmann | ("blockdev_getsize", SINGLE, TMO_NORMAL, [
|
255 | 033684dd | Michael Hanselmann | ("disks", OBJECT_LIST_TO_DICT, None), |
256 | 033684dd | Michael Hanselmann | ], None, "Returns the size of the given disks"), |
257 | 033684dd | Michael Hanselmann | ("drbd_disconnect_net", MULTI, TMO_NORMAL, [
|
258 | 033684dd | Michael Hanselmann | ("nodes_ip", None, None), |
259 | 033684dd | Michael Hanselmann | ("disks", OBJECT_LIST_TO_DICT, None), |
260 | 033684dd | Michael Hanselmann | ], None, "Disconnects the network of the given drbd devices"), |
261 | 033684dd | Michael Hanselmann | ("drbd_attach_net", MULTI, TMO_NORMAL, [
|
262 | 033684dd | Michael Hanselmann | ("nodes_ip", None, None), |
263 | 033684dd | Michael Hanselmann | ("disks", OBJECT_LIST_TO_DICT, None), |
264 | 033684dd | Michael Hanselmann | ("instance_name", None, None), |
265 | 033684dd | Michael Hanselmann | ("multimaster", None, None), |
266 | 033684dd | Michael Hanselmann | ], None, "Connects the given DRBD devices"), |
267 | 033684dd | Michael Hanselmann | ("drbd_wait_sync", MULTI, TMO_SLOW, [
|
268 | 033684dd | Michael Hanselmann | ("nodes_ip", None, None), |
269 | 033684dd | Michael Hanselmann | ("disks", OBJECT_LIST_TO_DICT, None), |
270 | 033684dd | Michael Hanselmann | ], None, "Waits for the synchronization of drbd devices is complete"), |
271 | 033684dd | Michael Hanselmann | ("blockdev_grow", SINGLE, TMO_NORMAL, [
|
272 | 033684dd | Michael Hanselmann | ("cf_bdev", OBJECT_TO_DICT, None), |
273 | 033684dd | Michael Hanselmann | ("amount", None, None), |
274 | 033684dd | Michael Hanselmann | ("dryrun", None, None), |
275 | 033684dd | Michael Hanselmann | ], None, "Request a snapshot of the given block device"), |
276 | 033684dd | Michael Hanselmann | ("blockdev_export", SINGLE, TMO_1DAY, [
|
277 | 033684dd | Michael Hanselmann | ("cf_bdev", OBJECT_TO_DICT, None), |
278 | 033684dd | Michael Hanselmann | ("dest_node", None, None), |
279 | 033684dd | Michael Hanselmann | ("dest_path", None, None), |
280 | 033684dd | Michael Hanselmann | ("cluster_name", None, None), |
281 | 033684dd | Michael Hanselmann | ], None, "Export a given disk to another node"), |
282 | 033684dd | Michael Hanselmann | ("blockdev_snapshot", SINGLE, TMO_NORMAL, [
|
283 | 033684dd | Michael Hanselmann | ("cf_bdev", OBJECT_TO_DICT, None), |
284 | 033684dd | Michael Hanselmann | ], None, "Export a given disk to another node"), |
285 | 033684dd | Michael Hanselmann | ("blockdev_rename", SINGLE, TMO_NORMAL, [
|
286 | 033684dd | Michael Hanselmann | ("devlist", "[(d.ToDict(), uid) for d, uid in %s]", None), |
287 | 033684dd | Michael Hanselmann | ], None, "Request rename of the given block devices"), |
288 | 033684dd | Michael Hanselmann | ("blockdev_find", SINGLE, TMO_NORMAL, [
|
289 | 033684dd | Michael Hanselmann | ("disk", OBJECT_TO_DICT, None), |
290 | 033684dd | Michael Hanselmann | ], "self._BlockdevFindPostProc",
|
291 | 033684dd | Michael Hanselmann | "Request identification of a given block device"),
|
292 | 033684dd | Michael Hanselmann | ("blockdev_getmirrorstatus", SINGLE, TMO_NORMAL, [
|
293 | 033684dd | Michael Hanselmann | ("disks", OBJECT_LIST_TO_DICT, None), |
294 | 033684dd | Michael Hanselmann | ], "self._BlockdevGetMirrorStatusPostProc",
|
295 | 033684dd | Michael Hanselmann | "Request status of a (mirroring) device"),
|
296 | 033684dd | Michael Hanselmann | ("blockdev_getmirrorstatus_multi", MULTI, TMO_NORMAL, [
|
297 | 033684dd | Michael Hanselmann | ("node_disks", NODE_TO_DISK_DICT, None), |
298 | 033684dd | Michael Hanselmann | ], "self._BlockdevGetMirrorStatusMultiPostProc",
|
299 | 033684dd | Michael Hanselmann | "Request status of (mirroring) devices from multiple nodes"),
|
300 | 033684dd | Michael Hanselmann | ] |
301 | 033684dd | Michael Hanselmann | |
302 | 033684dd | Michael Hanselmann | _OS_CALLS = [ |
303 | 033684dd | Michael Hanselmann | ("os_diagnose", MULTI, TMO_FAST, [], None, |
304 | 033684dd | Michael Hanselmann | "Request a diagnose of OS definitions"),
|
305 | 033684dd | Michael Hanselmann | ("os_validate", MULTI, TMO_FAST, [
|
306 | 033684dd | Michael Hanselmann | ("required", None, None), |
307 | 033684dd | Michael Hanselmann | ("name", None, None), |
308 | 033684dd | Michael Hanselmann | ("checks", None, None), |
309 | 033684dd | Michael Hanselmann | ("params", None, None), |
310 | 033684dd | Michael Hanselmann | ], None, "Run a validation routine for a given OS"), |
311 | 033684dd | Michael Hanselmann | ("os_get", SINGLE, TMO_FAST, [
|
312 | 033684dd | Michael Hanselmann | ("name", None, None), |
313 | 033684dd | Michael Hanselmann | ], "self._OsGetPostProc", "Returns an OS definition"), |
314 | 033684dd | Michael Hanselmann | ] |
315 | 033684dd | Michael Hanselmann | |
316 | 033684dd | Michael Hanselmann | _NODE_CALLS = [ |
317 | 033684dd | Michael Hanselmann | ("node_has_ip_address", SINGLE, TMO_FAST, [
|
318 | 033684dd | Michael Hanselmann | ("address", None, "IP address"), |
319 | 033684dd | Michael Hanselmann | ], None, "Checks if a node has the given IP address"), |
320 | 033684dd | Michael Hanselmann | ("node_info", MULTI, TMO_URGENT, [
|
321 | 033684dd | Michael Hanselmann | ("vg_name", None, |
322 | 033684dd | Michael Hanselmann | "Name of the volume group to ask for disk space information"),
|
323 | 033684dd | Michael Hanselmann | ("hypervisor_type", None, |
324 | 033684dd | Michael Hanselmann | "Name of the hypervisor to ask for memory information"),
|
325 | 033684dd | Michael Hanselmann | ], None, "Return node information"), |
326 | 033684dd | Michael Hanselmann | ("node_verify", MULTI, TMO_NORMAL, [
|
327 | 033684dd | Michael Hanselmann | ("checkdict", None, None), |
328 | 033684dd | Michael Hanselmann | ("cluster_name", None, None), |
329 | 033684dd | Michael Hanselmann | ], None, "Request verification of given parameters"), |
330 | 033684dd | Michael Hanselmann | ("node_volumes", MULTI, TMO_FAST, [], None, "Gets all volumes on node(s)"), |
331 | 033684dd | Michael Hanselmann | ("node_demote_from_mc", SINGLE, TMO_FAST, [], None, |
332 | 033684dd | Michael Hanselmann | "Demote a node from the master candidate role"),
|
333 | 033684dd | Michael Hanselmann | ("node_powercycle", SINGLE, TMO_NORMAL, [
|
334 | 033684dd | Michael Hanselmann | ("hypervisor", None, "Hypervisor type"), |
335 | 033684dd | Michael Hanselmann | ], None, "Tries to powercycle a node"), |
336 | 033684dd | Michael Hanselmann | ] |
337 | 033684dd | Michael Hanselmann | |
338 | 033684dd | Michael Hanselmann | _MISC_CALLS = [ |
339 | 033684dd | Michael Hanselmann | ("lv_list", MULTI, TMO_URGENT, [
|
340 | 033684dd | Michael Hanselmann | ("vg_name", None, None), |
341 | 033684dd | Michael Hanselmann | ], None, "Gets the logical volumes present in a given volume group"), |
342 | 033684dd | Michael Hanselmann | ("vg_list", MULTI, TMO_URGENT, [], None, "Gets the volume group list"), |
343 | 033684dd | Michael Hanselmann | ("bridges_exist", SINGLE, TMO_URGENT, [
|
344 | 033684dd | Michael Hanselmann | ("bridges_list", None, "Bridges which must be present on remote node"), |
345 | 033684dd | Michael Hanselmann | ], None, "Checks if a node has all the bridges given"), |
346 | 033684dd | Michael Hanselmann | ("etc_hosts_modify", SINGLE, TMO_NORMAL, [
|
347 | 033684dd | Michael Hanselmann | ("mode", None, |
348 | 033684dd | Michael Hanselmann | "Mode to operate; currently L{constants.ETC_HOSTS_ADD} or"
|
349 | 033684dd | Michael Hanselmann | " L{constants.ETC_HOSTS_REMOVE}"),
|
350 | 033684dd | Michael Hanselmann | ("name", None, "Hostname to be modified"), |
351 | 033684dd | Michael Hanselmann | ("ip", None, "IP address (L{constants.ETC_HOSTS_ADD} only)"), |
352 | 033684dd | Michael Hanselmann | ], None, "Modify hosts file with name"), |
353 | 033684dd | Michael Hanselmann | ("drbd_helper", MULTI, TMO_URGENT, [], None, "Gets DRBD helper"), |
354 | 033684dd | Michael Hanselmann | ("run_oob", SINGLE, TMO_NORMAL, [
|
355 | 033684dd | Michael Hanselmann | ("oob_program", None, None), |
356 | 033684dd | Michael Hanselmann | ("command", None, None), |
357 | 033684dd | Michael Hanselmann | ("remote_node", None, None), |
358 | 033684dd | Michael Hanselmann | ("timeout", None, None), |
359 | 033684dd | Michael Hanselmann | ], None, "Runs out-of-band command"), |
360 | 033684dd | Michael Hanselmann | ("hooks_runner", MULTI, TMO_NORMAL, [
|
361 | 033684dd | Michael Hanselmann | ("hpath", None, None), |
362 | 033684dd | Michael Hanselmann | ("phase", None, None), |
363 | 033684dd | Michael Hanselmann | ("env", None, None), |
364 | 033684dd | Michael Hanselmann | ], None, "Call the hooks runner"), |
365 | 033684dd | Michael Hanselmann | ("iallocator_runner", SINGLE, TMO_NORMAL, [
|
366 | 033684dd | Michael Hanselmann | ("name", None, "Iallocator name"), |
367 | 033684dd | Michael Hanselmann | ("idata", None, "JSON-encoded input string"), |
368 | 033684dd | Michael Hanselmann | ], None, "Call an iallocator on a remote node"), |
369 | 033684dd | Michael Hanselmann | ("test_delay", MULTI, None, [ |
370 | 033684dd | Michael Hanselmann | ("duration", None, None), |
371 | 033684dd | Michael Hanselmann | ], None, "Sleep for a fixed time on given node(s)"), |
372 | 68959ca5 | Michael Hanselmann | ("hypervisor_validate_params", MULTI, TMO_NORMAL, [
|
373 | 68959ca5 | Michael Hanselmann | ("hvname", None, "Hypervisor name"), |
374 | 68959ca5 | Michael Hanselmann | ("hvfull", None, "Parameters to be validated"), |
375 | 68959ca5 | Michael Hanselmann | ], None, "Validate hypervisor params"), |
376 | 033684dd | Michael Hanselmann | ] |
377 | 033684dd | Michael Hanselmann | |
378 | d5a2a550 | Michael Hanselmann | CALLS = { |
379 | 83816869 | Michael Hanselmann | "RpcClientDefault": (_IMPEXP_CALLS + _X509_CALLS + _OS_CALLS + _NODE_CALLS +
|
380 | f69b367e | Michael Hanselmann | _FILE_STORAGE_CALLS + _MISC_CALLS + _INSTANCE_CALLS + _BLOCKDEV_CALLS + |
381 | f69b367e | Michael Hanselmann | _STORAGE_CALLS), |
382 | fb1ffbca | Michael Hanselmann | "RpcClientJobQueue": [
|
383 | fb1ffbca | Michael Hanselmann | ("jobqueue_update", MULTI, TMO_URGENT, [
|
384 | fb1ffbca | Michael Hanselmann | ("file_name", None, None), |
385 | fb1ffbca | Michael Hanselmann | ("content", "self._Compress(%s)", None), |
386 | fb1ffbca | Michael Hanselmann | ], None, "Update job queue file"), |
387 | fb1ffbca | Michael Hanselmann | ("jobqueue_purge", SINGLE, TMO_NORMAL, [], None, "Purge job queue"), |
388 | fb1ffbca | Michael Hanselmann | ("jobqueue_rename", MULTI, TMO_URGENT, [
|
389 | fb1ffbca | Michael Hanselmann | ("rename", None, None), |
390 | fb1ffbca | Michael Hanselmann | ], None, "Rename job queue file"), |
391 | fb1ffbca | Michael Hanselmann | ], |
392 | db04ce5d | Michael Hanselmann | "RpcClientBootstrap": [
|
393 | db04ce5d | Michael Hanselmann | ("node_start_master_daemons", SINGLE, TMO_FAST, [
|
394 | db04ce5d | Michael Hanselmann | ("no_voting", None, None), |
395 | db04ce5d | Michael Hanselmann | ], None, "Starts master daemons on a node"), |
396 | db04ce5d | Michael Hanselmann | ("node_activate_master_ip", SINGLE, TMO_FAST, [], None, |
397 | db04ce5d | Michael Hanselmann | "Activates master IP on a node"),
|
398 | db04ce5d | Michael Hanselmann | ("node_stop_master", SINGLE, TMO_FAST, [], None, |
399 | db04ce5d | Michael Hanselmann | "Deactivates master IP and stops master daemons on a node"),
|
400 | db04ce5d | Michael Hanselmann | ("node_deactivate_master_ip", SINGLE, TMO_FAST, [], None, |
401 | db04ce5d | Michael Hanselmann | "Deactivates master IP on a node"),
|
402 | db04ce5d | Michael Hanselmann | ("node_change_master_netmask", SINGLE, TMO_FAST, [
|
403 | db04ce5d | Michael Hanselmann | ("netmask", None, None), |
404 | db04ce5d | Michael Hanselmann | ], None, "Change master IP netmask"), |
405 | db04ce5d | Michael Hanselmann | ("node_leave_cluster", SINGLE, TMO_NORMAL, [
|
406 | db04ce5d | Michael Hanselmann | ("modify_ssh_setup", None, None), |
407 | db04ce5d | Michael Hanselmann | ], None, "Requests a node to clean the cluster information it has"), |
408 | db04ce5d | Michael Hanselmann | ("master_info", MULTI, TMO_URGENT, [], None, "Query master info"), |
409 | db04ce5d | Michael Hanselmann | ("version", MULTI, TMO_URGENT, [], None, "Query node version"), |
410 | db04ce5d | Michael Hanselmann | ], |
411 | 415a7304 | Michael Hanselmann | "RpcClientConfig": [
|
412 | 415a7304 | Michael Hanselmann | ("upload_file", MULTI, TMO_NORMAL, [
|
413 | 415a7304 | Michael Hanselmann | ("file_name", "self._PrepareFileUpload(%s)", None), |
414 | 415a7304 | Michael Hanselmann | ], None, "Upload a file"), |
415 | 415a7304 | Michael Hanselmann | ("write_ssconf_files", MULTI, TMO_NORMAL, [
|
416 | 415a7304 | Michael Hanselmann | ("values", None, None), |
417 | 415a7304 | Michael Hanselmann | ], None, "Write ssconf files"), |
418 | 415a7304 | Michael Hanselmann | ], |
419 | d5a2a550 | Michael Hanselmann | } |