root / lib / opcodes.py @ 2d48a3a2
History | View | Annotate | Download (21.5 kB)
1 | 2f31098c | Iustin Pop | #
|
---|---|---|---|
2 | a8083063 | Iustin Pop | #
|
3 | a8083063 | Iustin Pop | |
4 | 8c35561f | Iustin Pop | # Copyright (C) 2006, 2007, 2008, 2009, 2010 Google Inc.
|
5 | a8083063 | Iustin Pop | #
|
6 | a8083063 | Iustin Pop | # This program is free software; you can redistribute it and/or modify
|
7 | a8083063 | Iustin Pop | # it under the terms of the GNU General Public License as published by
|
8 | a8083063 | Iustin Pop | # the Free Software Foundation; either version 2 of the License, or
|
9 | a8083063 | Iustin Pop | # (at your option) any later version.
|
10 | a8083063 | Iustin Pop | #
|
11 | a8083063 | Iustin Pop | # This program is distributed in the hope that it will be useful, but
|
12 | a8083063 | Iustin Pop | # WITHOUT ANY WARRANTY; without even the implied warranty of
|
13 | a8083063 | Iustin Pop | # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
14 | a8083063 | Iustin Pop | # General Public License for more details.
|
15 | a8083063 | Iustin Pop | #
|
16 | a8083063 | Iustin Pop | # You should have received a copy of the GNU General Public License
|
17 | a8083063 | Iustin Pop | # along with this program; if not, write to the Free Software
|
18 | a8083063 | Iustin Pop | # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
|
19 | a8083063 | Iustin Pop | # 02110-1301, USA.
|
20 | a8083063 | Iustin Pop | |
21 | a8083063 | Iustin Pop | |
22 | a8083063 | Iustin Pop | """OpCodes module
|
23 | a8083063 | Iustin Pop |
|
24 | a8083063 | Iustin Pop | This module implements the data structures which define the cluster
|
25 | a8083063 | Iustin Pop | operations - the so-called opcodes.
|
26 | a8083063 | Iustin Pop |
|
27 | 0e46916d | Iustin Pop | Every operation which modifies the cluster state is expressed via
|
28 | 0e46916d | Iustin Pop | opcodes.
|
29 | a8083063 | Iustin Pop |
|
30 | a8083063 | Iustin Pop | """
|
31 | a8083063 | Iustin Pop | |
32 | a8083063 | Iustin Pop | # this are practically structures, so disable the message about too
|
33 | a8083063 | Iustin Pop | # few public methods:
|
34 | a8083063 | Iustin Pop | # pylint: disable-msg=R0903
|
35 | a8083063 | Iustin Pop | |
36 | df458e0b | Iustin Pop | |
37 | 0e46916d | Iustin Pop | class BaseOpCode(object): |
38 | df458e0b | Iustin Pop | """A simple serializable object.
|
39 | df458e0b | Iustin Pop |
|
40 | 0e46916d | Iustin Pop | This object serves as a parent class for OpCode without any custom
|
41 | 0e46916d | Iustin Pop | field handling.
|
42 | 0e46916d | Iustin Pop |
|
43 | df458e0b | Iustin Pop | """
|
44 | a8083063 | Iustin Pop | __slots__ = [] |
45 | a8083063 | Iustin Pop | |
46 | a8083063 | Iustin Pop | def __init__(self, **kwargs): |
47 | a7399f66 | Iustin Pop | """Constructor for BaseOpCode.
|
48 | a7399f66 | Iustin Pop |
|
49 | a7399f66 | Iustin Pop | The constructor takes only keyword arguments and will set
|
50 | a7399f66 | Iustin Pop | attributes on this object based on the passed arguments. As such,
|
51 | a7399f66 | Iustin Pop | it means that you should not pass arguments which are not in the
|
52 | a7399f66 | Iustin Pop | __slots__ attribute for this class.
|
53 | a7399f66 | Iustin Pop |
|
54 | a7399f66 | Iustin Pop | """
|
55 | adf385c7 | Iustin Pop | slots = self._all_slots()
|
56 | a8083063 | Iustin Pop | for key in kwargs: |
57 | adf385c7 | Iustin Pop | if key not in slots: |
58 | df458e0b | Iustin Pop | raise TypeError("Object %s doesn't support the parameter '%s'" % |
59 | 3ecf6786 | Iustin Pop | (self.__class__.__name__, key))
|
60 | a8083063 | Iustin Pop | setattr(self, key, kwargs[key]) |
61 | a8083063 | Iustin Pop | |
62 | df458e0b | Iustin Pop | def __getstate__(self): |
63 | a7399f66 | Iustin Pop | """Generic serializer.
|
64 | a7399f66 | Iustin Pop |
|
65 | a7399f66 | Iustin Pop | This method just returns the contents of the instance as a
|
66 | a7399f66 | Iustin Pop | dictionary.
|
67 | a7399f66 | Iustin Pop |
|
68 | a7399f66 | Iustin Pop | @rtype: C{dict}
|
69 | a7399f66 | Iustin Pop | @return: the instance attributes and their values
|
70 | a7399f66 | Iustin Pop |
|
71 | a7399f66 | Iustin Pop | """
|
72 | df458e0b | Iustin Pop | state = {} |
73 | adf385c7 | Iustin Pop | for name in self._all_slots(): |
74 | df458e0b | Iustin Pop | if hasattr(self, name): |
75 | df458e0b | Iustin Pop | state[name] = getattr(self, name) |
76 | df458e0b | Iustin Pop | return state
|
77 | df458e0b | Iustin Pop | |
78 | df458e0b | Iustin Pop | def __setstate__(self, state): |
79 | a7399f66 | Iustin Pop | """Generic unserializer.
|
80 | a7399f66 | Iustin Pop |
|
81 | a7399f66 | Iustin Pop | This method just restores from the serialized state the attributes
|
82 | a7399f66 | Iustin Pop | of the current instance.
|
83 | a7399f66 | Iustin Pop |
|
84 | a7399f66 | Iustin Pop | @param state: the serialized opcode data
|
85 | a7399f66 | Iustin Pop | @type state: C{dict}
|
86 | a7399f66 | Iustin Pop |
|
87 | a7399f66 | Iustin Pop | """
|
88 | df458e0b | Iustin Pop | if not isinstance(state, dict): |
89 | df458e0b | Iustin Pop | raise ValueError("Invalid data to __setstate__: expected dict, got %s" % |
90 | df458e0b | Iustin Pop | type(state))
|
91 | df458e0b | Iustin Pop | |
92 | adf385c7 | Iustin Pop | for name in self._all_slots(): |
93 | 44db3a6f | Iustin Pop | if name not in state and hasattr(self, name): |
94 | df458e0b | Iustin Pop | delattr(self, name) |
95 | df458e0b | Iustin Pop | |
96 | df458e0b | Iustin Pop | for name in state: |
97 | df458e0b | Iustin Pop | setattr(self, name, state[name]) |
98 | df458e0b | Iustin Pop | |
99 | adf385c7 | Iustin Pop | @classmethod
|
100 | adf385c7 | Iustin Pop | def _all_slots(cls): |
101 | adf385c7 | Iustin Pop | """Compute the list of all declared slots for a class.
|
102 | adf385c7 | Iustin Pop |
|
103 | adf385c7 | Iustin Pop | """
|
104 | adf385c7 | Iustin Pop | slots = [] |
105 | adf385c7 | Iustin Pop | for parent in cls.__mro__: |
106 | adf385c7 | Iustin Pop | slots.extend(getattr(parent, "__slots__", [])) |
107 | adf385c7 | Iustin Pop | return slots
|
108 | adf385c7 | Iustin Pop | |
109 | df458e0b | Iustin Pop | |
110 | 0e46916d | Iustin Pop | class OpCode(BaseOpCode): |
111 | a7399f66 | Iustin Pop | """Abstract OpCode.
|
112 | a7399f66 | Iustin Pop |
|
113 | a7399f66 | Iustin Pop | This is the root of the actual OpCode hierarchy. All clases derived
|
114 | a7399f66 | Iustin Pop | from this class should override OP_ID.
|
115 | a7399f66 | Iustin Pop |
|
116 | a7399f66 | Iustin Pop | @cvar OP_ID: The ID of this opcode. This should be unique amongst all
|
117 | 20777413 | Iustin Pop | children of this class.
|
118 | 20777413 | Iustin Pop | @ivar dry_run: Whether the LU should be run in dry-run mode, i.e. just
|
119 | 20777413 | Iustin Pop | the check steps
|
120 | 8f5c488d | Michael Hanselmann | @ivar priority: Opcode priority for queue
|
121 | a7399f66 | Iustin Pop |
|
122 | a7399f66 | Iustin Pop | """
|
123 | df458e0b | Iustin Pop | OP_ID = "OP_ABSTRACT"
|
124 | 8f5c488d | Michael Hanselmann | __slots__ = ["dry_run", "debug_level", "priority"] |
125 | df458e0b | Iustin Pop | |
126 | df458e0b | Iustin Pop | def __getstate__(self): |
127 | df458e0b | Iustin Pop | """Specialized getstate for opcodes.
|
128 | df458e0b | Iustin Pop |
|
129 | a7399f66 | Iustin Pop | This method adds to the state dictionary the OP_ID of the class,
|
130 | a7399f66 | Iustin Pop | so that on unload we can identify the correct class for
|
131 | a7399f66 | Iustin Pop | instantiating the opcode.
|
132 | a7399f66 | Iustin Pop |
|
133 | a7399f66 | Iustin Pop | @rtype: C{dict}
|
134 | a7399f66 | Iustin Pop | @return: the state as a dictionary
|
135 | a7399f66 | Iustin Pop |
|
136 | df458e0b | Iustin Pop | """
|
137 | 0e46916d | Iustin Pop | data = BaseOpCode.__getstate__(self)
|
138 | df458e0b | Iustin Pop | data["OP_ID"] = self.OP_ID |
139 | df458e0b | Iustin Pop | return data
|
140 | df458e0b | Iustin Pop | |
141 | df458e0b | Iustin Pop | @classmethod
|
142 | 00abdc96 | Iustin Pop | def LoadOpCode(cls, data): |
143 | df458e0b | Iustin Pop | """Generic load opcode method.
|
144 | df458e0b | Iustin Pop |
|
145 | a7399f66 | Iustin Pop | The method identifies the correct opcode class from the dict-form
|
146 | a7399f66 | Iustin Pop | by looking for a OP_ID key, if this is not found, or its value is
|
147 | a7399f66 | Iustin Pop | not available in this module as a child of this class, we fail.
|
148 | a7399f66 | Iustin Pop |
|
149 | a7399f66 | Iustin Pop | @type data: C{dict}
|
150 | a7399f66 | Iustin Pop | @param data: the serialized opcode
|
151 | a7399f66 | Iustin Pop |
|
152 | df458e0b | Iustin Pop | """
|
153 | df458e0b | Iustin Pop | if not isinstance(data, dict): |
154 | df458e0b | Iustin Pop | raise ValueError("Invalid data to LoadOpCode (%s)" % type(data)) |
155 | df458e0b | Iustin Pop | if "OP_ID" not in data: |
156 | df458e0b | Iustin Pop | raise ValueError("Invalid data to LoadOpcode, missing OP_ID") |
157 | df458e0b | Iustin Pop | op_id = data["OP_ID"]
|
158 | df458e0b | Iustin Pop | op_class = None
|
159 | 363acb1e | Iustin Pop | if op_id in OP_MAPPING: |
160 | 363acb1e | Iustin Pop | op_class = OP_MAPPING[op_id] |
161 | 363acb1e | Iustin Pop | else:
|
162 | df458e0b | Iustin Pop | raise ValueError("Invalid data to LoadOpCode: OP_ID %s unsupported" % |
163 | df458e0b | Iustin Pop | op_id) |
164 | df458e0b | Iustin Pop | op = op_class() |
165 | df458e0b | Iustin Pop | new_data = data.copy() |
166 | df458e0b | Iustin Pop | del new_data["OP_ID"] |
167 | df458e0b | Iustin Pop | op.__setstate__(new_data) |
168 | df458e0b | Iustin Pop | return op
|
169 | df458e0b | Iustin Pop | |
170 | 60dd1473 | Iustin Pop | def Summary(self): |
171 | 60dd1473 | Iustin Pop | """Generates a summary description of this opcode.
|
172 | 60dd1473 | Iustin Pop |
|
173 | 60dd1473 | Iustin Pop | """
|
174 | 60dd1473 | Iustin Pop | # all OP_ID start with OP_, we remove that
|
175 | 60dd1473 | Iustin Pop | txt = self.OP_ID[3:] |
176 | 60dd1473 | Iustin Pop | field_name = getattr(self, "OP_DSC_FIELD", None) |
177 | 60dd1473 | Iustin Pop | if field_name:
|
178 | 60dd1473 | Iustin Pop | field_value = getattr(self, field_name, None) |
179 | bc8bbda1 | Iustin Pop | if isinstance(field_value, (list, tuple)): |
180 | bc8bbda1 | Iustin Pop | field_value = ",".join(str(i) for i in field_value) |
181 | 60dd1473 | Iustin Pop | txt = "%s(%s)" % (txt, field_value)
|
182 | 60dd1473 | Iustin Pop | return txt
|
183 | 60dd1473 | Iustin Pop | |
184 | a8083063 | Iustin Pop | |
185 | afee0879 | Iustin Pop | # cluster opcodes
|
186 | afee0879 | Iustin Pop | |
187 | b5f5fae9 | Luca Bigliardi | class OpPostInitCluster(OpCode): |
188 | b5f5fae9 | Luca Bigliardi | """Post cluster initialization.
|
189 | b5f5fae9 | Luca Bigliardi |
|
190 | b5f5fae9 | Luca Bigliardi | This opcode does not touch the cluster at all. Its purpose is to run hooks
|
191 | b5f5fae9 | Luca Bigliardi | after the cluster has been initialized.
|
192 | b5f5fae9 | Luca Bigliardi |
|
193 | b5f5fae9 | Luca Bigliardi | """
|
194 | b5f5fae9 | Luca Bigliardi | OP_ID = "OP_CLUSTER_POST_INIT"
|
195 | 154b9580 | Balazs Lecz | __slots__ = [] |
196 | b5f5fae9 | Luca Bigliardi | |
197 | b5f5fae9 | Luca Bigliardi | |
198 | a8083063 | Iustin Pop | class OpDestroyCluster(OpCode): |
199 | a7399f66 | Iustin Pop | """Destroy the cluster.
|
200 | a7399f66 | Iustin Pop |
|
201 | a7399f66 | Iustin Pop | This opcode has no other parameters. All the state is irreversibly
|
202 | a7399f66 | Iustin Pop | lost after the execution of this opcode.
|
203 | a7399f66 | Iustin Pop |
|
204 | a7399f66 | Iustin Pop | """
|
205 | a8083063 | Iustin Pop | OP_ID = "OP_CLUSTER_DESTROY"
|
206 | 154b9580 | Balazs Lecz | __slots__ = [] |
207 | a8083063 | Iustin Pop | |
208 | a8083063 | Iustin Pop | |
209 | a8083063 | Iustin Pop | class OpQueryClusterInfo(OpCode): |
210 | fdc267f4 | Iustin Pop | """Query cluster information."""
|
211 | a8083063 | Iustin Pop | OP_ID = "OP_CLUSTER_QUERY"
|
212 | 154b9580 | Balazs Lecz | __slots__ = [] |
213 | a8083063 | Iustin Pop | |
214 | a8083063 | Iustin Pop | |
215 | a8083063 | Iustin Pop | class OpVerifyCluster(OpCode): |
216 | a7399f66 | Iustin Pop | """Verify the cluster state.
|
217 | a7399f66 | Iustin Pop |
|
218 | a7399f66 | Iustin Pop | @type skip_checks: C{list}
|
219 | a7399f66 | Iustin Pop | @ivar skip_checks: steps to be skipped from the verify process; this
|
220 | a7399f66 | Iustin Pop | needs to be a subset of
|
221 | a7399f66 | Iustin Pop | L{constants.VERIFY_OPTIONAL_CHECKS}; currently
|
222 | a7399f66 | Iustin Pop | only L{constants.VERIFY_NPLUSONE_MEM} can be passed
|
223 | a7399f66 | Iustin Pop |
|
224 | a7399f66 | Iustin Pop | """
|
225 | a8083063 | Iustin Pop | OP_ID = "OP_CLUSTER_VERIFY"
|
226 | 154b9580 | Balazs Lecz | __slots__ = ["skip_checks", "verbose", "error_codes", |
227 | 154b9580 | Balazs Lecz | "debug_simulate_errors"]
|
228 | a8083063 | Iustin Pop | |
229 | a8083063 | Iustin Pop | |
230 | 150e978f | Iustin Pop | class OpVerifyDisks(OpCode): |
231 | 150e978f | Iustin Pop | """Verify the cluster disks.
|
232 | 150e978f | Iustin Pop |
|
233 | 150e978f | Iustin Pop | Parameters: none
|
234 | 150e978f | Iustin Pop |
|
235 | 5188ab37 | Iustin Pop | Result: a tuple of four elements:
|
236 | 150e978f | Iustin Pop | - list of node names with bad data returned (unreachable, etc.)
|
237 | a7399f66 | Iustin Pop | - dict of node names with broken volume groups (values: error msg)
|
238 | 150e978f | Iustin Pop | - list of instances with degraded disks (that should be activated)
|
239 | b63ed789 | Iustin Pop | - dict of instances with missing logical volumes (values: (node, vol)
|
240 | b63ed789 | Iustin Pop | pairs with details about the missing volumes)
|
241 | 150e978f | Iustin Pop |
|
242 | b63ed789 | Iustin Pop | In normal operation, all lists should be empty. A non-empty instance
|
243 | b63ed789 | Iustin Pop | list (3rd element of the result) is still ok (errors were fixed) but
|
244 | b63ed789 | Iustin Pop | non-empty node list means some node is down, and probably there are
|
245 | b63ed789 | Iustin Pop | unfixable drbd errors.
|
246 | 150e978f | Iustin Pop |
|
247 | 150e978f | Iustin Pop | Note that only instances that are drbd-based are taken into
|
248 | 150e978f | Iustin Pop | consideration. This might need to be revisited in the future.
|
249 | 150e978f | Iustin Pop |
|
250 | 150e978f | Iustin Pop | """
|
251 | 150e978f | Iustin Pop | OP_ID = "OP_CLUSTER_VERIFY_DISKS"
|
252 | 154b9580 | Balazs Lecz | __slots__ = [] |
253 | 150e978f | Iustin Pop | |
254 | 150e978f | Iustin Pop | |
255 | 60975797 | Iustin Pop | class OpRepairDiskSizes(OpCode): |
256 | 60975797 | Iustin Pop | """Verify the disk sizes of the instances and fixes configuration
|
257 | 60975797 | Iustin Pop | mimatches.
|
258 | 60975797 | Iustin Pop |
|
259 | 60975797 | Iustin Pop | Parameters: optional instances list, in case we want to restrict the
|
260 | 60975797 | Iustin Pop | checks to only a subset of the instances.
|
261 | 60975797 | Iustin Pop |
|
262 | 60975797 | Iustin Pop | Result: a list of tuples, (instance, disk, new-size) for changed
|
263 | 60975797 | Iustin Pop | configurations.
|
264 | 60975797 | Iustin Pop |
|
265 | 60975797 | Iustin Pop | In normal operation, the list should be empty.
|
266 | 60975797 | Iustin Pop |
|
267 | 60975797 | Iustin Pop | @type instances: list
|
268 | 60975797 | Iustin Pop | @ivar instances: the list of instances to check, or empty for all instances
|
269 | 60975797 | Iustin Pop |
|
270 | 60975797 | Iustin Pop | """
|
271 | 60975797 | Iustin Pop | OP_ID = "OP_CLUSTER_REPAIR_DISK_SIZES"
|
272 | 60975797 | Iustin Pop | __slots__ = ["instances"]
|
273 | 60975797 | Iustin Pop | |
274 | 60975797 | Iustin Pop | |
275 | ae5849b5 | Michael Hanselmann | class OpQueryConfigValues(OpCode): |
276 | ae5849b5 | Michael Hanselmann | """Query cluster configuration values."""
|
277 | ae5849b5 | Michael Hanselmann | OP_ID = "OP_CLUSTER_CONFIG_QUERY"
|
278 | 154b9580 | Balazs Lecz | __slots__ = ["output_fields"]
|
279 | a8083063 | Iustin Pop | |
280 | a8083063 | Iustin Pop | |
281 | 07bd8a51 | Iustin Pop | class OpRenameCluster(OpCode): |
282 | a7399f66 | Iustin Pop | """Rename the cluster.
|
283 | a7399f66 | Iustin Pop |
|
284 | a7399f66 | Iustin Pop | @type name: C{str}
|
285 | a7399f66 | Iustin Pop | @ivar name: The new name of the cluster. The name and/or the master IP
|
286 | a7399f66 | Iustin Pop | address will be changed to match the new name and its IP
|
287 | a7399f66 | Iustin Pop | address.
|
288 | a7399f66 | Iustin Pop |
|
289 | a7399f66 | Iustin Pop | """
|
290 | 07bd8a51 | Iustin Pop | OP_ID = "OP_CLUSTER_RENAME"
|
291 | 60dd1473 | Iustin Pop | OP_DSC_FIELD = "name"
|
292 | 154b9580 | Balazs Lecz | __slots__ = ["name"]
|
293 | 07bd8a51 | Iustin Pop | |
294 | 07bd8a51 | Iustin Pop | |
295 | 12515db7 | Manuel Franceschini | class OpSetClusterParams(OpCode): |
296 | a7399f66 | Iustin Pop | """Change the parameters of the cluster.
|
297 | a7399f66 | Iustin Pop |
|
298 | a7399f66 | Iustin Pop | @type vg_name: C{str} or C{None}
|
299 | a7399f66 | Iustin Pop | @ivar vg_name: The new volume group name or None to disable LVM usage.
|
300 | a7399f66 | Iustin Pop |
|
301 | a7399f66 | Iustin Pop | """
|
302 | 12515db7 | Manuel Franceschini | OP_ID = "OP_CLUSTER_SET_PARAMS"
|
303 | 154b9580 | Balazs Lecz | __slots__ = [ |
304 | 4b7735f9 | Iustin Pop | "vg_name",
|
305 | 7b2cd2b4 | Luca Bigliardi | "drbd_helper",
|
306 | 4b7735f9 | Iustin Pop | "enabled_hypervisors",
|
307 | 4b7735f9 | Iustin Pop | "hvparams",
|
308 | 17463d22 | Renรฉ Nussbaumer | "os_hvp",
|
309 | 4b7735f9 | Iustin Pop | "beparams",
|
310 | 625ac113 | Iustin Pop | "osparams",
|
311 | 5af3da74 | Guido Trotter | "nicparams",
|
312 | 4b7735f9 | Iustin Pop | "candidate_pool_size",
|
313 | 3953242f | Iustin Pop | "maintain_node_health",
|
314 | 1338f2b4 | Balazs Lecz | "uid_pool",
|
315 | fdad8c4d | Balazs Lecz | "add_uids",
|
316 | fdad8c4d | Balazs Lecz | "remove_uids",
|
317 | bf4af505 | Apollon Oikonomopoulos | "default_iallocator",
|
318 | f38ea602 | Iustin Pop | "reserved_lvs",
|
319 | 87b2cd45 | Iustin Pop | "hidden_os",
|
320 | 87b2cd45 | Iustin Pop | "blacklisted_os",
|
321 | b883637f | Renรฉ Nussbaumer | "prealloc_wipe_disks",
|
322 | 4b7735f9 | Iustin Pop | ] |
323 | 12515db7 | Manuel Franceschini | |
324 | 12515db7 | Manuel Franceschini | |
325 | afee0879 | Iustin Pop | class OpRedistributeConfig(OpCode): |
326 | afee0879 | Iustin Pop | """Force a full push of the cluster configuration.
|
327 | afee0879 | Iustin Pop |
|
328 | afee0879 | Iustin Pop | """
|
329 | afee0879 | Iustin Pop | OP_ID = "OP_CLUSTER_REDIST_CONF"
|
330 | 154b9580 | Balazs Lecz | __slots__ = [] |
331 | afee0879 | Iustin Pop | |
332 | 07bd8a51 | Iustin Pop | # node opcodes
|
333 | 07bd8a51 | Iustin Pop | |
334 | a8083063 | Iustin Pop | class OpRemoveNode(OpCode): |
335 | a7399f66 | Iustin Pop | """Remove a node.
|
336 | a7399f66 | Iustin Pop |
|
337 | a7399f66 | Iustin Pop | @type node_name: C{str}
|
338 | a7399f66 | Iustin Pop | @ivar node_name: The name of the node to remove. If the node still has
|
339 | a7399f66 | Iustin Pop | instances on it, the operation will fail.
|
340 | a7399f66 | Iustin Pop |
|
341 | a7399f66 | Iustin Pop | """
|
342 | a8083063 | Iustin Pop | OP_ID = "OP_NODE_REMOVE"
|
343 | 60dd1473 | Iustin Pop | OP_DSC_FIELD = "node_name"
|
344 | 154b9580 | Balazs Lecz | __slots__ = ["node_name"]
|
345 | a8083063 | Iustin Pop | |
346 | a8083063 | Iustin Pop | |
347 | a8083063 | Iustin Pop | class OpAddNode(OpCode): |
348 | a7399f66 | Iustin Pop | """Add a node to the cluster.
|
349 | a7399f66 | Iustin Pop |
|
350 | a7399f66 | Iustin Pop | @type node_name: C{str}
|
351 | a7399f66 | Iustin Pop | @ivar node_name: The name of the node to add. This can be a short name,
|
352 | a7399f66 | Iustin Pop | but it will be expanded to the FQDN.
|
353 | a7399f66 | Iustin Pop | @type primary_ip: IP address
|
354 | a7399f66 | Iustin Pop | @ivar primary_ip: The primary IP of the node. This will be ignored when the
|
355 | a7399f66 | Iustin Pop | opcode is submitted, but will be filled during the node
|
356 | a7399f66 | Iustin Pop | add (so it will be visible in the job query).
|
357 | a7399f66 | Iustin Pop | @type secondary_ip: IP address
|
358 | a7399f66 | Iustin Pop | @ivar secondary_ip: The secondary IP of the node. This needs to be passed
|
359 | a7399f66 | Iustin Pop | if the cluster has been initialized in 'dual-network'
|
360 | a7399f66 | Iustin Pop | mode, otherwise it must not be given.
|
361 | a7399f66 | Iustin Pop | @type readd: C{bool}
|
362 | a7399f66 | Iustin Pop | @ivar readd: Whether to re-add an existing node to the cluster. If
|
363 | a7399f66 | Iustin Pop | this is not passed, then the operation will abort if the node
|
364 | a7399f66 | Iustin Pop | name is already in the cluster; use this parameter to 'repair'
|
365 | a7399f66 | Iustin Pop | a node that had its configuration broken, or was reinstalled
|
366 | a7399f66 | Iustin Pop | without removal from the cluster.
|
367 | f936c153 | Iustin Pop | @type group: C{str}
|
368 | f936c153 | Iustin Pop | @ivar group: The node group to which this node will belong.
|
369 | a7399f66 | Iustin Pop |
|
370 | a7399f66 | Iustin Pop | """
|
371 | a8083063 | Iustin Pop | OP_ID = "OP_NODE_ADD"
|
372 | 60dd1473 | Iustin Pop | OP_DSC_FIELD = "node_name"
|
373 | f936c153 | Iustin Pop | __slots__ = ["node_name", "primary_ip", "secondary_ip", "readd", "group"] |
374 | a8083063 | Iustin Pop | |
375 | a8083063 | Iustin Pop | |
376 | a8083063 | Iustin Pop | class OpQueryNodes(OpCode): |
377 | a8083063 | Iustin Pop | """Compute the list of nodes."""
|
378 | a8083063 | Iustin Pop | OP_ID = "OP_NODE_QUERY"
|
379 | 154b9580 | Balazs Lecz | __slots__ = ["output_fields", "names", "use_locking"] |
380 | a8083063 | Iustin Pop | |
381 | a8083063 | Iustin Pop | |
382 | dcb93971 | Michael Hanselmann | class OpQueryNodeVolumes(OpCode): |
383 | dcb93971 | Michael Hanselmann | """Get list of volumes on node."""
|
384 | dcb93971 | Michael Hanselmann | OP_ID = "OP_NODE_QUERYVOLS"
|
385 | 154b9580 | Balazs Lecz | __slots__ = ["nodes", "output_fields"] |
386 | dcb93971 | Michael Hanselmann | |
387 | dcb93971 | Michael Hanselmann | |
388 | 9e5442ce | Michael Hanselmann | class OpQueryNodeStorage(OpCode): |
389 | 9e5442ce | Michael Hanselmann | """Get information on storage for node(s)."""
|
390 | 9e5442ce | Michael Hanselmann | OP_ID = "OP_NODE_QUERY_STORAGE"
|
391 | 154b9580 | Balazs Lecz | __slots__ = [ |
392 | 9e5442ce | Michael Hanselmann | "nodes",
|
393 | 9e5442ce | Michael Hanselmann | "storage_type",
|
394 | 9e5442ce | Michael Hanselmann | "name",
|
395 | 9e5442ce | Michael Hanselmann | "output_fields",
|
396 | 9e5442ce | Michael Hanselmann | ] |
397 | 9e5442ce | Michael Hanselmann | |
398 | 9e5442ce | Michael Hanselmann | |
399 | efb8da02 | Michael Hanselmann | class OpModifyNodeStorage(OpCode): |
400 | 099c52ad | Iustin Pop | """Modifies the properies of a storage unit"""
|
401 | efb8da02 | Michael Hanselmann | OP_ID = "OP_NODE_MODIFY_STORAGE"
|
402 | 154b9580 | Balazs Lecz | __slots__ = [ |
403 | efb8da02 | Michael Hanselmann | "node_name",
|
404 | efb8da02 | Michael Hanselmann | "storage_type",
|
405 | efb8da02 | Michael Hanselmann | "name",
|
406 | efb8da02 | Michael Hanselmann | "changes",
|
407 | efb8da02 | Michael Hanselmann | ] |
408 | efb8da02 | Michael Hanselmann | |
409 | efb8da02 | Michael Hanselmann | |
410 | 76aef8fc | Michael Hanselmann | class OpRepairNodeStorage(OpCode): |
411 | 76aef8fc | Michael Hanselmann | """Repairs the volume group on a node."""
|
412 | 76aef8fc | Michael Hanselmann | OP_ID = "OP_REPAIR_NODE_STORAGE"
|
413 | 76aef8fc | Michael Hanselmann | OP_DSC_FIELD = "node_name"
|
414 | 154b9580 | Balazs Lecz | __slots__ = [ |
415 | 76aef8fc | Michael Hanselmann | "node_name",
|
416 | 76aef8fc | Michael Hanselmann | "storage_type",
|
417 | 76aef8fc | Michael Hanselmann | "name",
|
418 | 7e9c6a78 | Iustin Pop | "ignore_consistency",
|
419 | 76aef8fc | Michael Hanselmann | ] |
420 | 76aef8fc | Michael Hanselmann | |
421 | 76aef8fc | Michael Hanselmann | |
422 | b31c8676 | Iustin Pop | class OpSetNodeParams(OpCode): |
423 | b31c8676 | Iustin Pop | """Change the parameters of a node."""
|
424 | b31c8676 | Iustin Pop | OP_ID = "OP_NODE_SET_PARAMS"
|
425 | b31c8676 | Iustin Pop | OP_DSC_FIELD = "node_name"
|
426 | 154b9580 | Balazs Lecz | __slots__ = [ |
427 | b31c8676 | Iustin Pop | "node_name",
|
428 | b31c8676 | Iustin Pop | "force",
|
429 | b31c8676 | Iustin Pop | "master_candidate",
|
430 | 3a5ba66a | Iustin Pop | "offline",
|
431 | c9d443ea | Iustin Pop | "drained",
|
432 | 601908d0 | Iustin Pop | "auto_promote",
|
433 | 197e3bb2 | Iustin Pop | "master_capable",
|
434 | b31c8676 | Iustin Pop | ] |
435 | b31c8676 | Iustin Pop | |
436 | f5118ade | Iustin Pop | |
437 | f5118ade | Iustin Pop | class OpPowercycleNode(OpCode): |
438 | f5118ade | Iustin Pop | """Tries to powercycle a node."""
|
439 | f5118ade | Iustin Pop | OP_ID = "OP_NODE_POWERCYCLE"
|
440 | f5118ade | Iustin Pop | OP_DSC_FIELD = "node_name"
|
441 | 154b9580 | Balazs Lecz | __slots__ = [ |
442 | f5118ade | Iustin Pop | "node_name",
|
443 | f5118ade | Iustin Pop | "force",
|
444 | f5118ade | Iustin Pop | ] |
445 | f5118ade | Iustin Pop | |
446 | 7ffc5a86 | Michael Hanselmann | |
447 | 80cb875c | Michael Hanselmann | class OpMigrateNode(OpCode): |
448 | 80cb875c | Michael Hanselmann | """Migrate all instances from a node."""
|
449 | 80cb875c | Michael Hanselmann | OP_ID = "OP_NODE_MIGRATE"
|
450 | 80cb875c | Michael Hanselmann | OP_DSC_FIELD = "node_name"
|
451 | 154b9580 | Balazs Lecz | __slots__ = [ |
452 | 80cb875c | Michael Hanselmann | "node_name",
|
453 | 8c35561f | Iustin Pop | "mode",
|
454 | 46d2d8a2 | Iustin Pop | "live",
|
455 | 80cb875c | Michael Hanselmann | ] |
456 | 80cb875c | Michael Hanselmann | |
457 | 80cb875c | Michael Hanselmann | |
458 | d6aaa598 | Iustin Pop | class OpNodeEvacuationStrategy(OpCode): |
459 | d6aaa598 | Iustin Pop | """Compute the evacuation strategy for a list of nodes."""
|
460 | d6aaa598 | Iustin Pop | OP_ID = "OP_NODE_EVAC_STRATEGY"
|
461 | d6aaa598 | Iustin Pop | OP_DSC_FIELD = "nodes"
|
462 | d6aaa598 | Iustin Pop | __slots__ = ["nodes", "iallocator", "remote_node"] |
463 | d6aaa598 | Iustin Pop | |
464 | d6aaa598 | Iustin Pop | |
465 | a8083063 | Iustin Pop | # instance opcodes
|
466 | a8083063 | Iustin Pop | |
467 | a8083063 | Iustin Pop | class OpCreateInstance(OpCode): |
468 | 9bf56d77 | Michael Hanselmann | """Create an instance.
|
469 | 9bf56d77 | Michael Hanselmann |
|
470 | 9bf56d77 | Michael Hanselmann | @ivar instance_name: Instance name
|
471 | 9bf56d77 | Michael Hanselmann | @ivar mode: Instance creation mode (one of L{constants.INSTANCE_CREATE_MODES})
|
472 | 9bf56d77 | Michael Hanselmann | @ivar source_handshake: Signed handshake from source (remote import only)
|
473 | 9bf56d77 | Michael Hanselmann | @ivar source_x509_ca: Source X509 CA in PEM format (remote import only)
|
474 | 9bf56d77 | Michael Hanselmann | @ivar source_instance_name: Previous name of instance (remote import only)
|
475 | 9bf56d77 | Michael Hanselmann |
|
476 | 9bf56d77 | Michael Hanselmann | """
|
477 | a8083063 | Iustin Pop | OP_ID = "OP_INSTANCE_CREATE"
|
478 | 60dd1473 | Iustin Pop | OP_DSC_FIELD = "instance_name"
|
479 | 154b9580 | Balazs Lecz | __slots__ = [ |
480 | 25a8792c | Iustin Pop | "instance_name",
|
481 | 25a8792c | Iustin Pop | "os_type", "force_variant", "no_install", |
482 | 47804ec9 | Guido Trotter | "pnode", "disk_template", "snode", "mode", |
483 | 08db7c5c | Iustin Pop | "disks", "nics", |
484 | e588764d | Iustin Pop | "src_node", "src_path", "start", "identify_defaults", |
485 | 5f23e043 | Iustin Pop | "wait_for_sync", "ip_check", "name_check", |
486 | dc936b49 | Manuel Franceschini | "file_storage_dir", "file_driver", |
487 | 6785674e | Iustin Pop | "iallocator",
|
488 | 062a7100 | Iustin Pop | "hypervisor", "hvparams", "beparams", "osparams", |
489 | 9bf56d77 | Michael Hanselmann | "source_handshake",
|
490 | 9bf56d77 | Michael Hanselmann | "source_x509_ca",
|
491 | 9bf56d77 | Michael Hanselmann | "source_instance_name",
|
492 | 3b6d8c9b | Iustin Pop | ] |
493 | a8083063 | Iustin Pop | |
494 | a8083063 | Iustin Pop | |
495 | fe7b0351 | Michael Hanselmann | class OpReinstallInstance(OpCode): |
496 | fdc267f4 | Iustin Pop | """Reinstall an instance's OS."""
|
497 | fe7b0351 | Michael Hanselmann | OP_ID = "OP_INSTANCE_REINSTALL"
|
498 | 60dd1473 | Iustin Pop | OP_DSC_FIELD = "instance_name"
|
499 | 8d8c4eff | Michael Hanselmann | __slots__ = ["instance_name", "os_type", "force_variant", "osparams"] |
500 | fe7b0351 | Michael Hanselmann | |
501 | fe7b0351 | Michael Hanselmann | |
502 | a8083063 | Iustin Pop | class OpRemoveInstance(OpCode): |
503 | a8083063 | Iustin Pop | """Remove an instance."""
|
504 | a8083063 | Iustin Pop | OP_ID = "OP_INSTANCE_REMOVE"
|
505 | 60dd1473 | Iustin Pop | OP_DSC_FIELD = "instance_name"
|
506 | 154b9580 | Balazs Lecz | __slots__ = [ |
507 | fc1baca9 | Michael Hanselmann | "instance_name",
|
508 | fc1baca9 | Michael Hanselmann | "ignore_failures",
|
509 | fc1baca9 | Michael Hanselmann | "shutdown_timeout",
|
510 | fc1baca9 | Michael Hanselmann | ] |
511 | a8083063 | Iustin Pop | |
512 | a8083063 | Iustin Pop | |
513 | decd5f45 | Iustin Pop | class OpRenameInstance(OpCode): |
514 | decd5f45 | Iustin Pop | """Rename an instance."""
|
515 | decd5f45 | Iustin Pop | OP_ID = "OP_INSTANCE_RENAME"
|
516 | 154b9580 | Balazs Lecz | __slots__ = [ |
517 | 3fe11ba3 | Manuel Franceschini | "instance_name", "ip_check", "new_name", "name_check", |
518 | 4f05fd3b | Iustin Pop | ] |
519 | decd5f45 | Iustin Pop | |
520 | decd5f45 | Iustin Pop | |
521 | a8083063 | Iustin Pop | class OpStartupInstance(OpCode): |
522 | fdc267f4 | Iustin Pop | """Startup an instance."""
|
523 | a8083063 | Iustin Pop | OP_ID = "OP_INSTANCE_STARTUP"
|
524 | 60dd1473 | Iustin Pop | OP_DSC_FIELD = "instance_name"
|
525 | 154b9580 | Balazs Lecz | __slots__ = [ |
526 | b44bd844 | Michael Hanselmann | "instance_name", "force", "hvparams", "beparams", "ignore_offline_nodes", |
527 | 4f05fd3b | Iustin Pop | ] |
528 | a8083063 | Iustin Pop | |
529 | a8083063 | Iustin Pop | |
530 | a8083063 | Iustin Pop | class OpShutdownInstance(OpCode): |
531 | fdc267f4 | Iustin Pop | """Shutdown an instance."""
|
532 | a8083063 | Iustin Pop | OP_ID = "OP_INSTANCE_SHUTDOWN"
|
533 | 60dd1473 | Iustin Pop | OP_DSC_FIELD = "instance_name"
|
534 | b44bd844 | Michael Hanselmann | __slots__ = [ |
535 | b44bd844 | Michael Hanselmann | "instance_name", "timeout", "ignore_offline_nodes", |
536 | b44bd844 | Michael Hanselmann | ] |
537 | a8083063 | Iustin Pop | |
538 | a8083063 | Iustin Pop | |
539 | bf6929a2 | Alexander Schreiber | class OpRebootInstance(OpCode): |
540 | bf6929a2 | Alexander Schreiber | """Reboot an instance."""
|
541 | eeb3a5f9 | Iustin Pop | OP_ID = "OP_INSTANCE_REBOOT"
|
542 | 60dd1473 | Iustin Pop | OP_DSC_FIELD = "instance_name"
|
543 | 154b9580 | Balazs Lecz | __slots__ = [ |
544 | 17c3f802 | Guido Trotter | "instance_name", "reboot_type", "ignore_secondaries", "shutdown_timeout", |
545 | 4f05fd3b | Iustin Pop | ] |
546 | bf6929a2 | Alexander Schreiber | |
547 | bf6929a2 | Alexander Schreiber | |
548 | a8083063 | Iustin Pop | class OpReplaceDisks(OpCode): |
549 | fdc267f4 | Iustin Pop | """Replace the disks of an instance."""
|
550 | a8083063 | Iustin Pop | OP_ID = "OP_INSTANCE_REPLACE_DISKS"
|
551 | 60dd1473 | Iustin Pop | OP_DSC_FIELD = "instance_name"
|
552 | 154b9580 | Balazs Lecz | __slots__ = [ |
553 | 4f05fd3b | Iustin Pop | "instance_name", "remote_node", "mode", "disks", "iallocator", |
554 | 7ea7bcf6 | Iustin Pop | "early_release",
|
555 | 4f05fd3b | Iustin Pop | ] |
556 | a8083063 | Iustin Pop | |
557 | a8083063 | Iustin Pop | |
558 | a8083063 | Iustin Pop | class OpFailoverInstance(OpCode): |
559 | a8083063 | Iustin Pop | """Failover an instance."""
|
560 | a8083063 | Iustin Pop | OP_ID = "OP_INSTANCE_FAILOVER"
|
561 | 60dd1473 | Iustin Pop | OP_DSC_FIELD = "instance_name"
|
562 | 154b9580 | Balazs Lecz | __slots__ = [ |
563 | 17c3f802 | Guido Trotter | "instance_name", "ignore_consistency", "shutdown_timeout", |
564 | 17c3f802 | Guido Trotter | ] |
565 | a8083063 | Iustin Pop | |
566 | a8083063 | Iustin Pop | |
567 | 53c776b5 | Iustin Pop | class OpMigrateInstance(OpCode): |
568 | 53c776b5 | Iustin Pop | """Migrate an instance.
|
569 | 53c776b5 | Iustin Pop |
|
570 | 53c776b5 | Iustin Pop | This migrates (without shutting down an instance) to its secondary
|
571 | 53c776b5 | Iustin Pop | node.
|
572 | 53c776b5 | Iustin Pop |
|
573 | 2f907a8c | Iustin Pop | @ivar instance_name: the name of the instance
|
574 | 8c35561f | Iustin Pop | @ivar mode: the migration mode (live, non-live or None for auto)
|
575 | 53c776b5 | Iustin Pop |
|
576 | 53c776b5 | Iustin Pop | """
|
577 | 53c776b5 | Iustin Pop | OP_ID = "OP_INSTANCE_MIGRATE"
|
578 | ee69c97f | Iustin Pop | OP_DSC_FIELD = "instance_name"
|
579 | 46d2d8a2 | Iustin Pop | __slots__ = ["instance_name", "mode", "cleanup", "live"] |
580 | 53c776b5 | Iustin Pop | |
581 | 53c776b5 | Iustin Pop | |
582 | 313bcead | Iustin Pop | class OpMoveInstance(OpCode): |
583 | 313bcead | Iustin Pop | """Move an instance.
|
584 | 313bcead | Iustin Pop |
|
585 | 313bcead | Iustin Pop | This move (with shutting down an instance and data copying) to an
|
586 | 313bcead | Iustin Pop | arbitrary node.
|
587 | 313bcead | Iustin Pop |
|
588 | 313bcead | Iustin Pop | @ivar instance_name: the name of the instance
|
589 | 313bcead | Iustin Pop | @ivar target_node: the destination node
|
590 | 313bcead | Iustin Pop |
|
591 | 313bcead | Iustin Pop | """
|
592 | 313bcead | Iustin Pop | OP_ID = "OP_INSTANCE_MOVE"
|
593 | 313bcead | Iustin Pop | OP_DSC_FIELD = "instance_name"
|
594 | 154b9580 | Balazs Lecz | __slots__ = [ |
595 | 17c3f802 | Guido Trotter | "instance_name", "target_node", "shutdown_timeout", |
596 | 154b9580 | Balazs Lecz | ] |
597 | 313bcead | Iustin Pop | |
598 | 313bcead | Iustin Pop | |
599 | a8083063 | Iustin Pop | class OpConnectConsole(OpCode): |
600 | fdc267f4 | Iustin Pop | """Connect to an instance's console."""
|
601 | a8083063 | Iustin Pop | OP_ID = "OP_INSTANCE_CONSOLE"
|
602 | 60dd1473 | Iustin Pop | OP_DSC_FIELD = "instance_name"
|
603 | 154b9580 | Balazs Lecz | __slots__ = ["instance_name"]
|
604 | a8083063 | Iustin Pop | |
605 | a8083063 | Iustin Pop | |
606 | a8083063 | Iustin Pop | class OpActivateInstanceDisks(OpCode): |
607 | fdc267f4 | Iustin Pop | """Activate an instance's disks."""
|
608 | a8083063 | Iustin Pop | OP_ID = "OP_INSTANCE_ACTIVATE_DISKS"
|
609 | 60dd1473 | Iustin Pop | OP_DSC_FIELD = "instance_name"
|
610 | 154b9580 | Balazs Lecz | __slots__ = ["instance_name", "ignore_size"] |
611 | a8083063 | Iustin Pop | |
612 | a8083063 | Iustin Pop | |
613 | a8083063 | Iustin Pop | class OpDeactivateInstanceDisks(OpCode): |
614 | fdc267f4 | Iustin Pop | """Deactivate an instance's disks."""
|
615 | a8083063 | Iustin Pop | OP_ID = "OP_INSTANCE_DEACTIVATE_DISKS"
|
616 | 60dd1473 | Iustin Pop | OP_DSC_FIELD = "instance_name"
|
617 | 154b9580 | Balazs Lecz | __slots__ = ["instance_name"]
|
618 | a8083063 | Iustin Pop | |
619 | a8083063 | Iustin Pop | |
620 | bd315bfa | Iustin Pop | class OpRecreateInstanceDisks(OpCode): |
621 | bd315bfa | Iustin Pop | """Deactivate an instance's disks."""
|
622 | bd315bfa | Iustin Pop | OP_ID = "OP_INSTANCE_RECREATE_DISKS"
|
623 | bd315bfa | Iustin Pop | OP_DSC_FIELD = "instance_name"
|
624 | 154b9580 | Balazs Lecz | __slots__ = ["instance_name", "disks"] |
625 | bd315bfa | Iustin Pop | |
626 | bd315bfa | Iustin Pop | |
627 | a8083063 | Iustin Pop | class OpQueryInstances(OpCode): |
628 | a8083063 | Iustin Pop | """Compute the list of instances."""
|
629 | a8083063 | Iustin Pop | OP_ID = "OP_INSTANCE_QUERY"
|
630 | 154b9580 | Balazs Lecz | __slots__ = ["output_fields", "names", "use_locking"] |
631 | a8083063 | Iustin Pop | |
632 | a8083063 | Iustin Pop | |
633 | a8083063 | Iustin Pop | class OpQueryInstanceData(OpCode): |
634 | a8083063 | Iustin Pop | """Compute the run-time status of instances."""
|
635 | a8083063 | Iustin Pop | OP_ID = "OP_INSTANCE_QUERY_DATA"
|
636 | 154b9580 | Balazs Lecz | __slots__ = ["instances", "static"] |
637 | a8083063 | Iustin Pop | |
638 | a8083063 | Iustin Pop | |
639 | 7767bbf5 | Manuel Franceschini | class OpSetInstanceParams(OpCode): |
640 | a8083063 | Iustin Pop | """Change the parameters of an instance."""
|
641 | 7767bbf5 | Manuel Franceschini | OP_ID = "OP_INSTANCE_SET_PARAMS"
|
642 | 60dd1473 | Iustin Pop | OP_DSC_FIELD = "instance_name"
|
643 | 154b9580 | Balazs Lecz | __slots__ = [ |
644 | 24991749 | Iustin Pop | "instance_name",
|
645 | 1052d622 | Iustin Pop | "hvparams", "beparams", "osparams", "force", |
646 | e29e9550 | Iustin Pop | "nics", "disks", "disk_template", |
647 | 96b39bcc | Iustin Pop | "remote_node", "os_name", "force_variant", |
648 | 973d7867 | Iustin Pop | ] |
649 | a8083063 | Iustin Pop | |
650 | a8083063 | Iustin Pop | |
651 | 8729e0d7 | Iustin Pop | class OpGrowDisk(OpCode): |
652 | 8729e0d7 | Iustin Pop | """Grow a disk of an instance."""
|
653 | 8729e0d7 | Iustin Pop | OP_ID = "OP_INSTANCE_GROW_DISK"
|
654 | 60dd1473 | Iustin Pop | OP_DSC_FIELD = "instance_name"
|
655 | 154b9580 | Balazs Lecz | __slots__ = [ |
656 | 4f05fd3b | Iustin Pop | "instance_name", "disk", "amount", "wait_for_sync", |
657 | 4f05fd3b | Iustin Pop | ] |
658 | 8729e0d7 | Iustin Pop | |
659 | 8729e0d7 | Iustin Pop | |
660 | a8083063 | Iustin Pop | # OS opcodes
|
661 | a8083063 | Iustin Pop | class OpDiagnoseOS(OpCode): |
662 | a8083063 | Iustin Pop | """Compute the list of guest operating systems."""
|
663 | a8083063 | Iustin Pop | OP_ID = "OP_OS_DIAGNOSE"
|
664 | 154b9580 | Balazs Lecz | __slots__ = ["output_fields", "names"] |
665 | a8083063 | Iustin Pop | |
666 | 7c0d6283 | Michael Hanselmann | |
667 | a8083063 | Iustin Pop | # Exports opcodes
|
668 | a8083063 | Iustin Pop | class OpQueryExports(OpCode): |
669 | a8083063 | Iustin Pop | """Compute the list of exported images."""
|
670 | a8083063 | Iustin Pop | OP_ID = "OP_BACKUP_QUERY"
|
671 | 154b9580 | Balazs Lecz | __slots__ = ["nodes", "use_locking"] |
672 | a8083063 | Iustin Pop | |
673 | 7c0d6283 | Michael Hanselmann | |
674 | 1410fa8d | Michael Hanselmann | class OpPrepareExport(OpCode): |
675 | 1410fa8d | Michael Hanselmann | """Prepares an instance export.
|
676 | 1410fa8d | Michael Hanselmann |
|
677 | 1410fa8d | Michael Hanselmann | @ivar instance_name: Instance name
|
678 | 1410fa8d | Michael Hanselmann | @ivar mode: Export mode (one of L{constants.EXPORT_MODES})
|
679 | 1410fa8d | Michael Hanselmann |
|
680 | 1410fa8d | Michael Hanselmann | """
|
681 | 1410fa8d | Michael Hanselmann | OP_ID = "OP_BACKUP_PREPARE"
|
682 | 1410fa8d | Michael Hanselmann | OP_DSC_FIELD = "instance_name"
|
683 | 1410fa8d | Michael Hanselmann | __slots__ = [ |
684 | 1410fa8d | Michael Hanselmann | "instance_name", "mode", |
685 | 1410fa8d | Michael Hanselmann | ] |
686 | 1410fa8d | Michael Hanselmann | |
687 | 1410fa8d | Michael Hanselmann | |
688 | a8083063 | Iustin Pop | class OpExportInstance(OpCode): |
689 | 4a96f1d1 | Michael Hanselmann | """Export an instance.
|
690 | 4a96f1d1 | Michael Hanselmann |
|
691 | 4a96f1d1 | Michael Hanselmann | For local exports, the export destination is the node name. For remote
|
692 | 4a96f1d1 | Michael Hanselmann | exports, the export destination is a list of tuples, each consisting of
|
693 | 4a96f1d1 | Michael Hanselmann | hostname/IP address, port, HMAC and HMAC salt. The HMAC is calculated using
|
694 | 4a96f1d1 | Michael Hanselmann | the cluster domain secret over the value "${index}:${hostname}:${port}". The
|
695 | 4a96f1d1 | Michael Hanselmann | destination X509 CA must be a signed certificate.
|
696 | 4a96f1d1 | Michael Hanselmann |
|
697 | 4a96f1d1 | Michael Hanselmann | @ivar mode: Export mode (one of L{constants.EXPORT_MODES})
|
698 | 4a96f1d1 | Michael Hanselmann | @ivar target_node: Export destination
|
699 | 4a96f1d1 | Michael Hanselmann | @ivar x509_key_name: X509 key to use (remote export only)
|
700 | 4a96f1d1 | Michael Hanselmann | @ivar destination_x509_ca: Destination X509 CA in PEM format (remote export
|
701 | 4a96f1d1 | Michael Hanselmann | only)
|
702 | 4a96f1d1 | Michael Hanselmann |
|
703 | 4a96f1d1 | Michael Hanselmann | """
|
704 | a8083063 | Iustin Pop | OP_ID = "OP_BACKUP_EXPORT"
|
705 | 60dd1473 | Iustin Pop | OP_DSC_FIELD = "instance_name"
|
706 | 154b9580 | Balazs Lecz | __slots__ = [ |
707 | 4a96f1d1 | Michael Hanselmann | # TODO: Rename target_node as it changes meaning for different export modes
|
708 | 4a96f1d1 | Michael Hanselmann | # (e.g. "destination")
|
709 | 17c3f802 | Guido Trotter | "instance_name", "target_node", "shutdown", "shutdown_timeout", |
710 | faba00cb | Michael Hanselmann | "remove_instance",
|
711 | faba00cb | Michael Hanselmann | "ignore_remove_failures",
|
712 | 4a96f1d1 | Michael Hanselmann | "mode",
|
713 | 4a96f1d1 | Michael Hanselmann | "x509_key_name",
|
714 | 4a96f1d1 | Michael Hanselmann | "destination_x509_ca",
|
715 | 17c3f802 | Guido Trotter | ] |
716 | 5c947f38 | Iustin Pop | |
717 | 0a7bed64 | Michael Hanselmann | |
718 | 9ac99fda | Guido Trotter | class OpRemoveExport(OpCode): |
719 | 9ac99fda | Guido Trotter | """Remove an instance's export."""
|
720 | 9ac99fda | Guido Trotter | OP_ID = "OP_BACKUP_REMOVE"
|
721 | 60dd1473 | Iustin Pop | OP_DSC_FIELD = "instance_name"
|
722 | 154b9580 | Balazs Lecz | __slots__ = ["instance_name"]
|
723 | 5c947f38 | Iustin Pop | |
724 | 0a7bed64 | Michael Hanselmann | |
725 | 5c947f38 | Iustin Pop | # Tags opcodes
|
726 | 5c947f38 | Iustin Pop | class OpGetTags(OpCode): |
727 | 5c947f38 | Iustin Pop | """Returns the tags of the given object."""
|
728 | 5c947f38 | Iustin Pop | OP_ID = "OP_TAGS_GET"
|
729 | 60dd1473 | Iustin Pop | OP_DSC_FIELD = "name"
|
730 | 154b9580 | Balazs Lecz | __slots__ = ["kind", "name"] |
731 | 5c947f38 | Iustin Pop | |
732 | 5c947f38 | Iustin Pop | |
733 | 73415719 | Iustin Pop | class OpSearchTags(OpCode): |
734 | 73415719 | Iustin Pop | """Searches the tags in the cluster for a given pattern."""
|
735 | 73415719 | Iustin Pop | OP_ID = "OP_TAGS_SEARCH"
|
736 | 60dd1473 | Iustin Pop | OP_DSC_FIELD = "pattern"
|
737 | 154b9580 | Balazs Lecz | __slots__ = ["pattern"]
|
738 | 73415719 | Iustin Pop | |
739 | 73415719 | Iustin Pop | |
740 | f27302fa | Iustin Pop | class OpAddTags(OpCode): |
741 | f27302fa | Iustin Pop | """Add a list of tags on a given object."""
|
742 | 5c947f38 | Iustin Pop | OP_ID = "OP_TAGS_SET"
|
743 | 154b9580 | Balazs Lecz | __slots__ = ["kind", "name", "tags"] |
744 | 5c947f38 | Iustin Pop | |
745 | 5c947f38 | Iustin Pop | |
746 | f27302fa | Iustin Pop | class OpDelTags(OpCode): |
747 | f27302fa | Iustin Pop | """Remove a list of tags from a given object."""
|
748 | 5c947f38 | Iustin Pop | OP_ID = "OP_TAGS_DEL"
|
749 | 154b9580 | Balazs Lecz | __slots__ = ["kind", "name", "tags"] |
750 | 06009e27 | Iustin Pop | |
751 | 06009e27 | Iustin Pop | |
752 | 06009e27 | Iustin Pop | # Test opcodes
|
753 | 06009e27 | Iustin Pop | class OpTestDelay(OpCode): |
754 | 06009e27 | Iustin Pop | """Sleeps for a configured amount of time.
|
755 | 06009e27 | Iustin Pop |
|
756 | 06009e27 | Iustin Pop | This is used just for debugging and testing.
|
757 | 06009e27 | Iustin Pop |
|
758 | 06009e27 | Iustin Pop | Parameters:
|
759 | 06009e27 | Iustin Pop | - duration: the time to sleep
|
760 | 06009e27 | Iustin Pop | - on_master: if true, sleep on the master
|
761 | 06009e27 | Iustin Pop | - on_nodes: list of nodes in which to sleep
|
762 | 06009e27 | Iustin Pop |
|
763 | 06009e27 | Iustin Pop | If the on_master parameter is true, it will execute a sleep on the
|
764 | 06009e27 | Iustin Pop | master (before any node sleep).
|
765 | 06009e27 | Iustin Pop |
|
766 | 06009e27 | Iustin Pop | If the on_nodes list is not empty, it will sleep on those nodes
|
767 | 06009e27 | Iustin Pop | (after the sleep on the master, if that is enabled).
|
768 | 06009e27 | Iustin Pop |
|
769 | 06009e27 | Iustin Pop | As an additional feature, the case of duration < 0 will be reported
|
770 | 06009e27 | Iustin Pop | as an execution error, so this opcode can be used as a failure
|
771 | 06009e27 | Iustin Pop | generator. The case of duration == 0 will not be treated specially.
|
772 | 06009e27 | Iustin Pop |
|
773 | 06009e27 | Iustin Pop | """
|
774 | 06009e27 | Iustin Pop | OP_ID = "OP_TEST_DELAY"
|
775 | 60dd1473 | Iustin Pop | OP_DSC_FIELD = "duration"
|
776 | 85a87e21 | Guido Trotter | __slots__ = ["duration", "on_master", "on_nodes", "repeat"] |
777 | d61df03e | Iustin Pop | |
778 | d61df03e | Iustin Pop | |
779 | d61df03e | Iustin Pop | class OpTestAllocator(OpCode): |
780 | d61df03e | Iustin Pop | """Allocator framework testing.
|
781 | d61df03e | Iustin Pop |
|
782 | d61df03e | Iustin Pop | This opcode has two modes:
|
783 | d61df03e | Iustin Pop | - gather and return allocator input for a given mode (allocate new
|
784 | d61df03e | Iustin Pop | or replace secondary) and a given instance definition (direction
|
785 | d61df03e | Iustin Pop | 'in')
|
786 | d61df03e | Iustin Pop | - run a selected allocator for a given operation (as above) and
|
787 | d61df03e | Iustin Pop | return the allocator output (direction 'out')
|
788 | d61df03e | Iustin Pop |
|
789 | d61df03e | Iustin Pop | """
|
790 | d61df03e | Iustin Pop | OP_ID = "OP_TEST_ALLOCATOR"
|
791 | 60dd1473 | Iustin Pop | OP_DSC_FIELD = "allocator"
|
792 | 154b9580 | Balazs Lecz | __slots__ = [ |
793 | d61df03e | Iustin Pop | "direction", "mode", "allocator", "name", |
794 | d61df03e | Iustin Pop | "mem_size", "disks", "disk_template", |
795 | 8cc7e742 | Guido Trotter | "os", "tags", "nics", "vcpus", "hypervisor", |
796 | 823a72bc | Iustin Pop | "evac_nodes",
|
797 | d61df03e | Iustin Pop | ] |
798 | 363acb1e | Iustin Pop | |
799 | 76aef8fc | Michael Hanselmann | |
800 | e58f87a9 | Michael Hanselmann | class OpTestJobqueue(OpCode): |
801 | e58f87a9 | Michael Hanselmann | """Utility opcode to test some aspects of the job queue.
|
802 | e58f87a9 | Michael Hanselmann |
|
803 | e58f87a9 | Michael Hanselmann | """
|
804 | e58f87a9 | Michael Hanselmann | OP_ID = "OP_TEST_JQUEUE"
|
805 | e58f87a9 | Michael Hanselmann | __slots__ = [ |
806 | e58f87a9 | Michael Hanselmann | "notify_waitlock",
|
807 | e58f87a9 | Michael Hanselmann | "notify_exec",
|
808 | e58f87a9 | Michael Hanselmann | "log_messages",
|
809 | e58f87a9 | Michael Hanselmann | "fail",
|
810 | e58f87a9 | Michael Hanselmann | ] |
811 | e58f87a9 | Michael Hanselmann | |
812 | e58f87a9 | Michael Hanselmann | |
813 | be760ba8 | Michael Hanselmann | class OpTestDummy(OpCode): |
814 | be760ba8 | Michael Hanselmann | """Utility opcode used by unittests.
|
815 | be760ba8 | Michael Hanselmann |
|
816 | be760ba8 | Michael Hanselmann | """
|
817 | be760ba8 | Michael Hanselmann | OP_ID = "OP_TEST_DUMMY"
|
818 | be760ba8 | Michael Hanselmann | __slots__ = [ |
819 | be760ba8 | Michael Hanselmann | "result",
|
820 | be760ba8 | Michael Hanselmann | "messages",
|
821 | be760ba8 | Michael Hanselmann | "fail",
|
822 | be760ba8 | Michael Hanselmann | ] |
823 | be760ba8 | Michael Hanselmann | |
824 | be760ba8 | Michael Hanselmann | |
825 | 363acb1e | Iustin Pop | OP_MAPPING = dict([(v.OP_ID, v) for v in globals().values() |
826 | 363acb1e | Iustin Pop | if (isinstance(v, type) and issubclass(v, OpCode) and |
827 | 363acb1e | Iustin Pop | hasattr(v, "OP_ID"))]) |