root / lib / rpc.py @ 29b8eaee
History | View | Annotate | Download (46.4 kB)
1 | 2f31098c | Iustin Pop | #
|
---|---|---|---|
2 | a8083063 | Iustin Pop | #
|
3 | a8083063 | Iustin Pop | |
4 | d2cd6944 | Iustin Pop | # Copyright (C) 2006, 2007, 2008, 2009, 2010, 2011 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 | 3ef3c771 | Iustin Pop | """Inter-node RPC library.
|
23 | a8083063 | Iustin Pop |
|
24 | a8083063 | Iustin Pop | """
|
25 | a8083063 | Iustin Pop | |
26 | 72737a7f | Iustin Pop | # pylint: disable-msg=C0103,R0201,R0904
|
27 | 72737a7f | Iustin Pop | # C0103: Invalid name, since call_ are not valid
|
28 | 72737a7f | Iustin Pop | # R0201: Method could be a function, we keep all rpcs instance methods
|
29 | 72737a7f | Iustin Pop | # as not to change them back and forth between static/instance methods
|
30 | 72737a7f | Iustin Pop | # if they need to start using instance attributes
|
31 | 72737a7f | Iustin Pop | # R0904: Too many public methods
|
32 | a8083063 | Iustin Pop | |
33 | a8083063 | Iustin Pop | import os |
34 | 58b311ca | Iustin Pop | import logging |
35 | 12bce260 | Michael Hanselmann | import zlib |
36 | 12bce260 | Michael Hanselmann | import base64 |
37 | 33231500 | Michael Hanselmann | import pycurl |
38 | 33231500 | Michael Hanselmann | import threading |
39 | a8083063 | Iustin Pop | |
40 | a8083063 | Iustin Pop | from ganeti import utils |
41 | a8083063 | Iustin Pop | from ganeti import objects |
42 | ecfe9491 | Michael Hanselmann | from ganeti import http |
43 | 7c28c575 | Michael Hanselmann | from ganeti import serializer |
44 | eafd8762 | Michael Hanselmann | from ganeti import constants |
45 | 781de953 | Iustin Pop | from ganeti import errors |
46 | a744b676 | Manuel Franceschini | from ganeti import netutils |
47 | eb202c13 | Manuel Franceschini | from ganeti import ssconf |
48 | a8083063 | Iustin Pop | |
49 | fe267188 | Iustin Pop | # pylint has a bug here, doesn't see this import
|
50 | fe267188 | Iustin Pop | import ganeti.http.client # pylint: disable-msg=W0611 |
51 | ae88ef45 | Michael Hanselmann | |
52 | a8083063 | Iustin Pop | |
53 | 33231500 | Michael Hanselmann | # Timeout for connecting to nodes (seconds)
|
54 | 33231500 | Michael Hanselmann | _RPC_CONNECT_TIMEOUT = 5
|
55 | 33231500 | Michael Hanselmann | |
56 | 33231500 | Michael Hanselmann | _RPC_CLIENT_HEADERS = [ |
57 | 33231500 | Michael Hanselmann | "Content-type: %s" % http.HTTP_APP_JSON,
|
58 | 8e29563f | Iustin Pop | "Expect:",
|
59 | 33231500 | Michael Hanselmann | ] |
60 | 4331f6cd | Michael Hanselmann | |
61 | 92fd2250 | Iustin Pop | # Various time constants for the timeout table
|
62 | 92fd2250 | Iustin Pop | _TMO_URGENT = 60 # one minute |
63 | 92fd2250 | Iustin Pop | _TMO_FAST = 5 * 60 # five minutes |
64 | 92fd2250 | Iustin Pop | _TMO_NORMAL = 15 * 60 # 15 minutes |
65 | 92fd2250 | Iustin Pop | _TMO_SLOW = 3600 # one hour |
66 | 92fd2250 | Iustin Pop | _TMO_4HRS = 4 * 3600 |
67 | 92fd2250 | Iustin Pop | _TMO_1DAY = 86400
|
68 | 92fd2250 | Iustin Pop | |
69 | 92fd2250 | Iustin Pop | # Timeout table that will be built later by decorators
|
70 | 92fd2250 | Iustin Pop | # Guidelines for choosing timeouts:
|
71 | 92fd2250 | Iustin Pop | # - call used during watcher: timeout -> 1min, _TMO_URGENT
|
72 | 92fd2250 | Iustin Pop | # - trivial (but be sure it is trivial) (e.g. reading a file): 5min, _TMO_FAST
|
73 | 92fd2250 | Iustin Pop | # - other calls: 15 min, _TMO_NORMAL
|
74 | 92fd2250 | Iustin Pop | # - special calls (instance add, etc.): either _TMO_SLOW (1h) or huge timeouts
|
75 | 92fd2250 | Iustin Pop | |
76 | 92fd2250 | Iustin Pop | _TIMEOUTS = { |
77 | 92fd2250 | Iustin Pop | } |
78 | 92fd2250 | Iustin Pop | |
79 | 4331f6cd | Michael Hanselmann | |
80 | 4331f6cd | Michael Hanselmann | def Init(): |
81 | 4331f6cd | Michael Hanselmann | """Initializes the module-global HTTP client manager.
|
82 | 4331f6cd | Michael Hanselmann |
|
83 | 33231500 | Michael Hanselmann | Must be called before using any RPC function and while exactly one thread is
|
84 | 33231500 | Michael Hanselmann | running.
|
85 | 4331f6cd | Michael Hanselmann |
|
86 | 4331f6cd | Michael Hanselmann | """
|
87 | 33231500 | Michael Hanselmann | # curl_global_init(3) and curl_global_cleanup(3) must be called with only
|
88 | 33231500 | Michael Hanselmann | # one thread running. This check is just a safety measure -- it doesn't
|
89 | 33231500 | Michael Hanselmann | # cover all cases.
|
90 | 33231500 | Michael Hanselmann | assert threading.activeCount() == 1, \ |
91 | 33231500 | Michael Hanselmann | "Found more than one active thread when initializing pycURL"
|
92 | 4331f6cd | Michael Hanselmann | |
93 | 33231500 | Michael Hanselmann | logging.info("Using PycURL %s", pycurl.version)
|
94 | 8d0a4f99 | Michael Hanselmann | |
95 | 33231500 | Michael Hanselmann | pycurl.global_init(pycurl.GLOBAL_ALL) |
96 | 4331f6cd | Michael Hanselmann | |
97 | 4331f6cd | Michael Hanselmann | |
98 | 4331f6cd | Michael Hanselmann | def Shutdown(): |
99 | 4331f6cd | Michael Hanselmann | """Stops the module-global HTTP client manager.
|
100 | 4331f6cd | Michael Hanselmann |
|
101 | 33231500 | Michael Hanselmann | Must be called before quitting the program and while exactly one thread is
|
102 | 33231500 | Michael Hanselmann | running.
|
103 | 4331f6cd | Michael Hanselmann |
|
104 | 4331f6cd | Michael Hanselmann | """
|
105 | 33231500 | Michael Hanselmann | pycurl.global_cleanup() |
106 | 33231500 | Michael Hanselmann | |
107 | 33231500 | Michael Hanselmann | |
108 | 33231500 | Michael Hanselmann | def _ConfigRpcCurl(curl): |
109 | 33231500 | Michael Hanselmann | noded_cert = str(constants.NODED_CERT_FILE)
|
110 | 4331f6cd | Michael Hanselmann | |
111 | 33231500 | Michael Hanselmann | curl.setopt(pycurl.FOLLOWLOCATION, False)
|
112 | 33231500 | Michael Hanselmann | curl.setopt(pycurl.CAINFO, noded_cert) |
113 | 33231500 | Michael Hanselmann | curl.setopt(pycurl.SSL_VERIFYHOST, 0)
|
114 | 33231500 | Michael Hanselmann | curl.setopt(pycurl.SSL_VERIFYPEER, True)
|
115 | 33231500 | Michael Hanselmann | curl.setopt(pycurl.SSLCERTTYPE, "PEM")
|
116 | 33231500 | Michael Hanselmann | curl.setopt(pycurl.SSLCERT, noded_cert) |
117 | 33231500 | Michael Hanselmann | curl.setopt(pycurl.SSLKEYTYPE, "PEM")
|
118 | 33231500 | Michael Hanselmann | curl.setopt(pycurl.SSLKEY, noded_cert) |
119 | 33231500 | Michael Hanselmann | curl.setopt(pycurl.CONNECTTIMEOUT, _RPC_CONNECT_TIMEOUT) |
120 | 33231500 | Michael Hanselmann | |
121 | 33231500 | Michael Hanselmann | |
122 | c29e35fe | Michael Hanselmann | # Aliasing this module avoids the following warning by epydoc: "Warning: No
|
123 | c29e35fe | Michael Hanselmann | # information available for ganeti.rpc._RpcThreadLocal's base threading.local"
|
124 | c29e35fe | Michael Hanselmann | _threading = threading |
125 | c29e35fe | Michael Hanselmann | |
126 | c29e35fe | Michael Hanselmann | |
127 | c29e35fe | Michael Hanselmann | class _RpcThreadLocal(_threading.local): |
128 | 33231500 | Michael Hanselmann | def GetHttpClientPool(self): |
129 | 33231500 | Michael Hanselmann | """Returns a per-thread HTTP client pool.
|
130 | 33231500 | Michael Hanselmann |
|
131 | 33231500 | Michael Hanselmann | @rtype: L{http.client.HttpClientPool}
|
132 | 33231500 | Michael Hanselmann |
|
133 | 33231500 | Michael Hanselmann | """
|
134 | 33231500 | Michael Hanselmann | try:
|
135 | 33231500 | Michael Hanselmann | pool = self.hcp
|
136 | 33231500 | Michael Hanselmann | except AttributeError: |
137 | 33231500 | Michael Hanselmann | pool = http.client.HttpClientPool(_ConfigRpcCurl) |
138 | 33231500 | Michael Hanselmann | self.hcp = pool
|
139 | 33231500 | Michael Hanselmann | |
140 | 33231500 | Michael Hanselmann | return pool
|
141 | 33231500 | Michael Hanselmann | |
142 | 33231500 | Michael Hanselmann | |
143 | c29e35fe | Michael Hanselmann | # Remove module alias (see above)
|
144 | c29e35fe | Michael Hanselmann | del _threading
|
145 | c29e35fe | Michael Hanselmann | |
146 | c29e35fe | Michael Hanselmann | |
147 | 33231500 | Michael Hanselmann | _thread_local = _RpcThreadLocal() |
148 | 4331f6cd | Michael Hanselmann | |
149 | 4331f6cd | Michael Hanselmann | |
150 | 92fd2250 | Iustin Pop | def _RpcTimeout(secs): |
151 | 92fd2250 | Iustin Pop | """Timeout decorator.
|
152 | 92fd2250 | Iustin Pop |
|
153 | 92fd2250 | Iustin Pop | When applied to a rpc call_* function, it updates the global timeout
|
154 | 92fd2250 | Iustin Pop | table with the given function/timeout.
|
155 | 92fd2250 | Iustin Pop |
|
156 | 92fd2250 | Iustin Pop | """
|
157 | 92fd2250 | Iustin Pop | def decorator(f): |
158 | 92fd2250 | Iustin Pop | name = f.__name__ |
159 | 92fd2250 | Iustin Pop | assert name.startswith("call_") |
160 | 92fd2250 | Iustin Pop | _TIMEOUTS[name[len("call_"):]] = secs |
161 | 92fd2250 | Iustin Pop | return f
|
162 | 92fd2250 | Iustin Pop | return decorator
|
163 | 92fd2250 | Iustin Pop | |
164 | 92fd2250 | Iustin Pop | |
165 | e0e916fe | Iustin Pop | def RunWithRPC(fn): |
166 | e0e916fe | Iustin Pop | """RPC-wrapper decorator.
|
167 | e0e916fe | Iustin Pop |
|
168 | e0e916fe | Iustin Pop | When applied to a function, it runs it with the RPC system
|
169 | e0e916fe | Iustin Pop | initialized, and it shutsdown the system afterwards. This means the
|
170 | e0e916fe | Iustin Pop | function must be called without RPC being initialized.
|
171 | e0e916fe | Iustin Pop |
|
172 | e0e916fe | Iustin Pop | """
|
173 | e0e916fe | Iustin Pop | def wrapper(*args, **kwargs): |
174 | e0e916fe | Iustin Pop | Init() |
175 | e0e916fe | Iustin Pop | try:
|
176 | e0e916fe | Iustin Pop | return fn(*args, **kwargs)
|
177 | e0e916fe | Iustin Pop | finally:
|
178 | e0e916fe | Iustin Pop | Shutdown() |
179 | e0e916fe | Iustin Pop | return wrapper
|
180 | e0e916fe | Iustin Pop | |
181 | e0e916fe | Iustin Pop | |
182 | 781de953 | Iustin Pop | class RpcResult(object): |
183 | 781de953 | Iustin Pop | """RPC Result class.
|
184 | 781de953 | Iustin Pop |
|
185 | 781de953 | Iustin Pop | This class holds an RPC result. It is needed since in multi-node
|
186 | 781de953 | Iustin Pop | calls we can't raise an exception just because one one out of many
|
187 | 781de953 | Iustin Pop | failed, and therefore we use this class to encapsulate the result.
|
188 | 781de953 | Iustin Pop |
|
189 | 5bbd3f7f | Michael Hanselmann | @ivar data: the data payload, for successful results, or None
|
190 | ed83f5cc | Iustin Pop | @ivar call: the name of the RPC call
|
191 | ed83f5cc | Iustin Pop | @ivar node: the name of the node to which we made the call
|
192 | ed83f5cc | Iustin Pop | @ivar offline: whether the operation failed because the node was
|
193 | ed83f5cc | Iustin Pop | offline, as opposed to actual failure; offline=True will always
|
194 | ed83f5cc | Iustin Pop | imply failed=True, in order to allow simpler checking if
|
195 | ed83f5cc | Iustin Pop | the user doesn't care about the exact failure mode
|
196 | 4c4e4e1e | Iustin Pop | @ivar fail_msg: the error message if the call failed
|
197 | ed83f5cc | Iustin Pop |
|
198 | 781de953 | Iustin Pop | """
|
199 | ed83f5cc | Iustin Pop | def __init__(self, data=None, failed=False, offline=False, |
200 | ed83f5cc | Iustin Pop | call=None, node=None): |
201 | ed83f5cc | Iustin Pop | self.offline = offline
|
202 | ed83f5cc | Iustin Pop | self.call = call
|
203 | ed83f5cc | Iustin Pop | self.node = node
|
204 | 1645d22d | Michael Hanselmann | |
205 | ed83f5cc | Iustin Pop | if offline:
|
206 | 4c4e4e1e | Iustin Pop | self.fail_msg = "Node is marked offline" |
207 | f2def43a | Iustin Pop | self.data = self.payload = None |
208 | ed83f5cc | Iustin Pop | elif failed:
|
209 | 4c4e4e1e | Iustin Pop | self.fail_msg = self._EnsureErr(data) |
210 | f2def43a | Iustin Pop | self.data = self.payload = None |
211 | 781de953 | Iustin Pop | else:
|
212 | 781de953 | Iustin Pop | self.data = data
|
213 | d3c8b360 | Iustin Pop | if not isinstance(self.data, (tuple, list)): |
214 | 4c4e4e1e | Iustin Pop | self.fail_msg = ("RPC layer error: invalid result type (%s)" % |
215 | 4c4e4e1e | Iustin Pop | type(self.data)) |
216 | 1645d22d | Michael Hanselmann | self.payload = None |
217 | d3c8b360 | Iustin Pop | elif len(data) != 2: |
218 | 4c4e4e1e | Iustin Pop | self.fail_msg = ("RPC layer error: invalid result length (%d), " |
219 | 4c4e4e1e | Iustin Pop | "expected 2" % len(self.data)) |
220 | 1645d22d | Michael Hanselmann | self.payload = None |
221 | d3c8b360 | Iustin Pop | elif not self.data[0]: |
222 | 4c4e4e1e | Iustin Pop | self.fail_msg = self._EnsureErr(self.data[1]) |
223 | 1645d22d | Michael Hanselmann | self.payload = None |
224 | f2def43a | Iustin Pop | else:
|
225 | d3c8b360 | Iustin Pop | # finally success
|
226 | 4c4e4e1e | Iustin Pop | self.fail_msg = None |
227 | d3c8b360 | Iustin Pop | self.payload = data[1] |
228 | d3c8b360 | Iustin Pop | |
229 | 2c0f74f2 | Iustin Pop | for attr_name in ["call", "data", "fail_msg", |
230 | 2c0f74f2 | Iustin Pop | "node", "offline", "payload"]: |
231 | 2c0f74f2 | Iustin Pop | assert hasattr(self, attr_name), "Missing attribute %s" % attr_name |
232 | 1645d22d | Michael Hanselmann | |
233 | d3c8b360 | Iustin Pop | @staticmethod
|
234 | d3c8b360 | Iustin Pop | def _EnsureErr(val): |
235 | d3c8b360 | Iustin Pop | """Helper to ensure we return a 'True' value for error."""
|
236 | d3c8b360 | Iustin Pop | if val:
|
237 | d3c8b360 | Iustin Pop | return val
|
238 | d3c8b360 | Iustin Pop | else:
|
239 | d3c8b360 | Iustin Pop | return "No error information" |
240 | 781de953 | Iustin Pop | |
241 | 045dd6d9 | Iustin Pop | def Raise(self, msg, prereq=False, ecode=None): |
242 | 781de953 | Iustin Pop | """If the result has failed, raise an OpExecError.
|
243 | 781de953 | Iustin Pop |
|
244 | 781de953 | Iustin Pop | This is used so that LU code doesn't have to check for each
|
245 | 781de953 | Iustin Pop | result, but instead can call this function.
|
246 | 781de953 | Iustin Pop |
|
247 | 781de953 | Iustin Pop | """
|
248 | 4c4e4e1e | Iustin Pop | if not self.fail_msg: |
249 | 4c4e4e1e | Iustin Pop | return
|
250 | 4c4e4e1e | Iustin Pop | |
251 | 4c4e4e1e | Iustin Pop | if not msg: # one could pass None for default message |
252 | 4c4e4e1e | Iustin Pop | msg = ("Call '%s' to node '%s' has failed: %s" %
|
253 | 4c4e4e1e | Iustin Pop | (self.call, self.node, self.fail_msg)) |
254 | 4c4e4e1e | Iustin Pop | else:
|
255 | 4c4e4e1e | Iustin Pop | msg = "%s: %s" % (msg, self.fail_msg) |
256 | 4c4e4e1e | Iustin Pop | if prereq:
|
257 | 4c4e4e1e | Iustin Pop | ec = errors.OpPrereqError |
258 | 4c4e4e1e | Iustin Pop | else:
|
259 | 4c4e4e1e | Iustin Pop | ec = errors.OpExecError |
260 | 045dd6d9 | Iustin Pop | if ecode is not None: |
261 | 27137e55 | Iustin Pop | args = (msg, ecode) |
262 | 045dd6d9 | Iustin Pop | else:
|
263 | 045dd6d9 | Iustin Pop | args = (msg, ) |
264 | 7260cfbe | Iustin Pop | raise ec(*args) # pylint: disable-msg=W0142 |
265 | 781de953 | Iustin Pop | |
266 | 781de953 | Iustin Pop | |
267 | eb202c13 | Manuel Franceschini | def _AddressLookup(node_list, |
268 | eb202c13 | Manuel Franceschini | ssc=ssconf.SimpleStore, |
269 | b705c7a6 | Manuel Franceschini | nslookup_fn=netutils.Hostname.GetIP): |
270 | eb202c13 | Manuel Franceschini | """Return addresses for given node names.
|
271 | eb202c13 | Manuel Franceschini |
|
272 | eb202c13 | Manuel Franceschini | @type node_list: list
|
273 | eb202c13 | Manuel Franceschini | @param node_list: List of node names
|
274 | eb202c13 | Manuel Franceschini | @type ssc: class
|
275 | eb202c13 | Manuel Franceschini | @param ssc: SimpleStore class that is used to obtain node->ip mappings
|
276 | 17f7fd27 | Manuel Franceschini | @type nslookup_fn: callable
|
277 | 17f7fd27 | Manuel Franceschini | @param nslookup_fn: function use to do NS lookup
|
278 | eb202c13 | Manuel Franceschini | @rtype: list of addresses and/or None's
|
279 | eb202c13 | Manuel Franceschini | @returns: List of corresponding addresses, if found
|
280 | eb202c13 | Manuel Franceschini |
|
281 | eb202c13 | Manuel Franceschini | """
|
282 | b43dcc5a | Manuel Franceschini | ss = ssc() |
283 | b43dcc5a | Manuel Franceschini | iplist = ss.GetNodePrimaryIPList() |
284 | b43dcc5a | Manuel Franceschini | family = ss.GetPrimaryIPFamily() |
285 | eb202c13 | Manuel Franceschini | addresses = [] |
286 | b705c7a6 | Manuel Franceschini | ipmap = dict(entry.split() for entry in iplist) |
287 | b705c7a6 | Manuel Franceschini | for node in node_list: |
288 | b705c7a6 | Manuel Franceschini | address = ipmap.get(node) |
289 | b705c7a6 | Manuel Franceschini | if address is None: |
290 | b43dcc5a | Manuel Franceschini | address = nslookup_fn(node, family=family) |
291 | b705c7a6 | Manuel Franceschini | addresses.append(address) |
292 | eb202c13 | Manuel Franceschini | |
293 | eb202c13 | Manuel Franceschini | return addresses
|
294 | eb202c13 | Manuel Franceschini | |
295 | eb202c13 | Manuel Franceschini | |
296 | a8083063 | Iustin Pop | class Client: |
297 | a8083063 | Iustin Pop | """RPC Client class.
|
298 | a8083063 | Iustin Pop |
|
299 | 2f8598a5 | Alexander Schreiber | This class, given a (remote) method name, a list of parameters and a
|
300 | a8083063 | Iustin Pop | list of nodes, will contact (in parallel) all nodes, and return a
|
301 | a8083063 | Iustin Pop | dict of results (key: node name, value: result).
|
302 | a8083063 | Iustin Pop |
|
303 | 5bbd3f7f | Michael Hanselmann | One current bug is that generic failure is still signaled by
|
304 | a8083063 | Iustin Pop | 'False' result, which is not good. This overloading of values can
|
305 | a8083063 | Iustin Pop | cause bugs.
|
306 | a8083063 | Iustin Pop |
|
307 | a8083063 | Iustin Pop | """
|
308 | eb202c13 | Manuel Franceschini | def __init__(self, procedure, body, port, address_lookup_fn=_AddressLookup): |
309 | 92fd2250 | Iustin Pop | assert procedure in _TIMEOUTS, ("New RPC call not declared in the" |
310 | 92fd2250 | Iustin Pop | " timeouts table")
|
311 | a8083063 | Iustin Pop | self.procedure = procedure
|
312 | 160e2921 | Iustin Pop | self.body = body
|
313 | 160e2921 | Iustin Pop | self.port = port
|
314 | 33231500 | Michael Hanselmann | self._request = {}
|
315 | eb202c13 | Manuel Franceschini | self._address_lookup_fn = address_lookup_fn
|
316 | d57ae7f7 | Michael Hanselmann | |
317 | e0036155 | Iustin Pop | def ConnectList(self, node_list, address_list=None, read_timeout=None): |
318 | a8083063 | Iustin Pop | """Add a list of nodes to the target nodes.
|
319 | a8083063 | Iustin Pop |
|
320 | 3ef3c771 | Iustin Pop | @type node_list: list
|
321 | 3ef3c771 | Iustin Pop | @param node_list: the list of node names to connect
|
322 | bdf7d8c0 | Iustin Pop | @type address_list: list or None
|
323 | bdf7d8c0 | Iustin Pop | @keyword address_list: either None or a list with node addresses,
|
324 | bdf7d8c0 | Iustin Pop | which must have the same length as the node list
|
325 | e0036155 | Iustin Pop | @type read_timeout: int
|
326 | eb202c13 | Manuel Franceschini | @param read_timeout: overwrites default timeout for operation
|
327 | 3ef3c771 | Iustin Pop |
|
328 | a8083063 | Iustin Pop | """
|
329 | bdf7d8c0 | Iustin Pop | if address_list is None: |
330 | eb202c13 | Manuel Franceschini | # Always use IP address instead of node name
|
331 | eb202c13 | Manuel Franceschini | address_list = self._address_lookup_fn(node_list)
|
332 | eb202c13 | Manuel Franceschini | |
333 | eb202c13 | Manuel Franceschini | assert len(node_list) == len(address_list), \ |
334 | eb202c13 | Manuel Franceschini | "Name and address lists must have the same length"
|
335 | eb202c13 | Manuel Franceschini | |
336 | bdf7d8c0 | Iustin Pop | for node, address in zip(node_list, address_list): |
337 | e0036155 | Iustin Pop | self.ConnectNode(node, address, read_timeout=read_timeout)
|
338 | bdf7d8c0 | Iustin Pop | |
339 | e0036155 | Iustin Pop | def ConnectNode(self, name, address=None, read_timeout=None): |
340 | a8083063 | Iustin Pop | """Add a node to the target list.
|
341 | a8083063 | Iustin Pop |
|
342 | bdf7d8c0 | Iustin Pop | @type name: str
|
343 | bdf7d8c0 | Iustin Pop | @param name: the node name
|
344 | bdf7d8c0 | Iustin Pop | @type address: str
|
345 | eb202c13 | Manuel Franceschini | @param address: the node address, if known
|
346 | eb202c13 | Manuel Franceschini | @type read_timeout: int
|
347 | eb202c13 | Manuel Franceschini | @param read_timeout: overwrites default timeout for operation
|
348 | bdf7d8c0 | Iustin Pop |
|
349 | a8083063 | Iustin Pop | """
|
350 | ecfe9491 | Michael Hanselmann | if address is None: |
351 | eb202c13 | Manuel Franceschini | # Always use IP address instead of node name
|
352 | eb202c13 | Manuel Franceschini | address = self._address_lookup_fn([name])[0] |
353 | eb202c13 | Manuel Franceschini | |
354 | eb202c13 | Manuel Franceschini | assert(address is not None) |
355 | ecfe9491 | Michael Hanselmann | |
356 | 92fd2250 | Iustin Pop | if read_timeout is None: |
357 | 92fd2250 | Iustin Pop | read_timeout = _TIMEOUTS[self.procedure]
|
358 | 92fd2250 | Iustin Pop | |
359 | 33231500 | Michael Hanselmann | self._request[name] = \
|
360 | 33231500 | Michael Hanselmann | http.client.HttpClientRequest(str(address), self.port, |
361 | 33231500 | Michael Hanselmann | http.HTTP_PUT, str("/%s" % self.procedure), |
362 | 33231500 | Michael Hanselmann | headers=_RPC_CLIENT_HEADERS, |
363 | 33231500 | Michael Hanselmann | post_data=str(self.body), |
364 | e0036155 | Iustin Pop | read_timeout=read_timeout) |
365 | a8083063 | Iustin Pop | |
366 | 33231500 | Michael Hanselmann | def GetResults(self, http_pool=None): |
367 | ecfe9491 | Michael Hanselmann | """Call nodes and return results.
|
368 | ecfe9491 | Michael Hanselmann |
|
369 | ecfe9491 | Michael Hanselmann | @rtype: list
|
370 | 5fcc718f | Iustin Pop | @return: List of RPC results
|
371 | a8083063 | Iustin Pop |
|
372 | a8083063 | Iustin Pop | """
|
373 | 33231500 | Michael Hanselmann | if not http_pool: |
374 | 33231500 | Michael Hanselmann | http_pool = _thread_local.GetHttpClientPool() |
375 | 4331f6cd | Michael Hanselmann | |
376 | 33231500 | Michael Hanselmann | http_pool.ProcessRequests(self._request.values())
|
377 | a8083063 | Iustin Pop | |
378 | ecfe9491 | Michael Hanselmann | results = {} |
379 | a8083063 | Iustin Pop | |
380 | 33231500 | Michael Hanselmann | for name, req in self._request.iteritems(): |
381 | ae88ef45 | Michael Hanselmann | if req.success and req.resp_status_code == http.HTTP_OK: |
382 | 781de953 | Iustin Pop | results[name] = RpcResult(data=serializer.LoadJson(req.resp_body), |
383 | 781de953 | Iustin Pop | node=name, call=self.procedure)
|
384 | ecfe9491 | Michael Hanselmann | continue
|
385 | a8083063 | Iustin Pop | |
386 | d57ae7f7 | Michael Hanselmann | # TODO: Better error reporting
|
387 | ecfe9491 | Michael Hanselmann | if req.error:
|
388 | ecfe9491 | Michael Hanselmann | msg = req.error |
389 | ecfe9491 | Michael Hanselmann | else:
|
390 | ecfe9491 | Michael Hanselmann | msg = req.resp_body |
391 | ecfe9491 | Michael Hanselmann | |
392 | 1b8acf70 | Iustin Pop | logging.error("RPC error in %s from node %s: %s",
|
393 | 1b8acf70 | Iustin Pop | self.procedure, name, msg)
|
394 | 781de953 | Iustin Pop | results[name] = RpcResult(data=msg, failed=True, node=name,
|
395 | 781de953 | Iustin Pop | call=self.procedure)
|
396 | ecfe9491 | Michael Hanselmann | |
397 | ecfe9491 | Michael Hanselmann | return results
|
398 | a8083063 | Iustin Pop | |
399 | a8083063 | Iustin Pop | |
400 | 1651d116 | Michael Hanselmann | def _EncodeImportExportIO(ieio, ieioargs): |
401 | 1651d116 | Michael Hanselmann | """Encodes import/export I/O information.
|
402 | 1651d116 | Michael Hanselmann |
|
403 | 1651d116 | Michael Hanselmann | """
|
404 | 1651d116 | Michael Hanselmann | if ieio == constants.IEIO_RAW_DISK:
|
405 | 1651d116 | Michael Hanselmann | assert len(ieioargs) == 1 |
406 | 1651d116 | Michael Hanselmann | return (ieioargs[0].ToDict(), ) |
407 | 1651d116 | Michael Hanselmann | |
408 | 1651d116 | Michael Hanselmann | if ieio == constants.IEIO_SCRIPT:
|
409 | 1651d116 | Michael Hanselmann | assert len(ieioargs) == 2 |
410 | 1651d116 | Michael Hanselmann | return (ieioargs[0].ToDict(), ieioargs[1]) |
411 | 1651d116 | Michael Hanselmann | |
412 | 1651d116 | Michael Hanselmann | return ieioargs
|
413 | 1651d116 | Michael Hanselmann | |
414 | 1651d116 | Michael Hanselmann | |
415 | 72737a7f | Iustin Pop | class RpcRunner(object): |
416 | 72737a7f | Iustin Pop | """RPC runner class"""
|
417 | a8083063 | Iustin Pop | |
418 | 72737a7f | Iustin Pop | def __init__(self, cfg): |
419 | 72737a7f | Iustin Pop | """Initialized the rpc runner.
|
420 | a8083063 | Iustin Pop |
|
421 | 72737a7f | Iustin Pop | @type cfg: C{config.ConfigWriter}
|
422 | 72737a7f | Iustin Pop | @param cfg: the configuration object that will be used to get data
|
423 | 72737a7f | Iustin Pop | about the cluster
|
424 | a8083063 | Iustin Pop |
|
425 | 72737a7f | Iustin Pop | """
|
426 | 72737a7f | Iustin Pop | self._cfg = cfg
|
427 | a744b676 | Manuel Franceschini | self.port = netutils.GetDaemonPort(constants.NODED)
|
428 | a8083063 | Iustin Pop | |
429 | 1bdcbbab | Iustin Pop | def _InstDict(self, instance, hvp=None, bep=None, osp=None): |
430 | 26ba2bd8 | Iustin Pop | """Convert the given instance to a dict.
|
431 | 26ba2bd8 | Iustin Pop |
|
432 | 26ba2bd8 | Iustin Pop | This is done via the instance's ToDict() method and additionally
|
433 | 26ba2bd8 | Iustin Pop | we fill the hvparams with the cluster defaults.
|
434 | 26ba2bd8 | Iustin Pop |
|
435 | 26ba2bd8 | Iustin Pop | @type instance: L{objects.Instance}
|
436 | 26ba2bd8 | Iustin Pop | @param instance: an Instance object
|
437 | 0eca8e0c | Iustin Pop | @type hvp: dict or None
|
438 | 5bbd3f7f | Michael Hanselmann | @param hvp: a dictionary with overridden hypervisor parameters
|
439 | 0eca8e0c | Iustin Pop | @type bep: dict or None
|
440 | 5bbd3f7f | Michael Hanselmann | @param bep: a dictionary with overridden backend parameters
|
441 | 1bdcbbab | Iustin Pop | @type osp: dict or None
|
442 | 8d8c4eff | Michael Hanselmann | @param osp: a dictionary with overridden os parameters
|
443 | 26ba2bd8 | Iustin Pop | @rtype: dict
|
444 | 26ba2bd8 | Iustin Pop | @return: the instance dict, with the hvparams filled with the
|
445 | 26ba2bd8 | Iustin Pop | cluster defaults
|
446 | 26ba2bd8 | Iustin Pop |
|
447 | 26ba2bd8 | Iustin Pop | """
|
448 | 26ba2bd8 | Iustin Pop | idict = instance.ToDict() |
449 | 5b442704 | Iustin Pop | cluster = self._cfg.GetClusterInfo()
|
450 | 5b442704 | Iustin Pop | idict["hvparams"] = cluster.FillHV(instance)
|
451 | 0eca8e0c | Iustin Pop | if hvp is not None: |
452 | 0eca8e0c | Iustin Pop | idict["hvparams"].update(hvp)
|
453 | 5b442704 | Iustin Pop | idict["beparams"] = cluster.FillBE(instance)
|
454 | 0eca8e0c | Iustin Pop | if bep is not None: |
455 | 0eca8e0c | Iustin Pop | idict["beparams"].update(bep)
|
456 | 1bdcbbab | Iustin Pop | idict["osparams"] = cluster.SimpleFillOS(instance.os, instance.osparams)
|
457 | 1bdcbbab | Iustin Pop | if osp is not None: |
458 | 1bdcbbab | Iustin Pop | idict["osparams"].update(osp)
|
459 | b848ce79 | Guido Trotter | for nic in idict["nics"]: |
460 | b848ce79 | Guido Trotter | nic['nicparams'] = objects.FillDict(
|
461 | b848ce79 | Guido Trotter | cluster.nicparams[constants.PP_DEFAULT], |
462 | b848ce79 | Guido Trotter | nic['nicparams'])
|
463 | 26ba2bd8 | Iustin Pop | return idict
|
464 | 26ba2bd8 | Iustin Pop | |
465 | e0036155 | Iustin Pop | def _ConnectList(self, client, node_list, call, read_timeout=None): |
466 | 25348212 | Iustin Pop | """Helper for computing node addresses.
|
467 | 25348212 | Iustin Pop |
|
468 | 6af6270a | Iustin Pop | @type client: L{ganeti.rpc.Client}
|
469 | 25348212 | Iustin Pop | @param client: a C{Client} instance
|
470 | 25348212 | Iustin Pop | @type node_list: list
|
471 | 25348212 | Iustin Pop | @param node_list: the node list we should connect
|
472 | 84b45587 | Iustin Pop | @type call: string
|
473 | 84b45587 | Iustin Pop | @param call: the name of the remote procedure call, for filling in
|
474 | 84b45587 | Iustin Pop | correctly any eventual offline nodes' results
|
475 | e0036155 | Iustin Pop | @type read_timeout: int
|
476 | e0036155 | Iustin Pop | @param read_timeout: overwrites the default read timeout for the
|
477 | e0036155 | Iustin Pop | given operation
|
478 | 25348212 | Iustin Pop |
|
479 | 25348212 | Iustin Pop | """
|
480 | 25348212 | Iustin Pop | all_nodes = self._cfg.GetAllNodesInfo()
|
481 | ed83f5cc | Iustin Pop | name_list = [] |
482 | 25348212 | Iustin Pop | addr_list = [] |
483 | ed83f5cc | Iustin Pop | skip_dict = {} |
484 | 25348212 | Iustin Pop | for node in node_list: |
485 | 25348212 | Iustin Pop | if node in all_nodes: |
486 | ed83f5cc | Iustin Pop | if all_nodes[node].offline:
|
487 | 84b45587 | Iustin Pop | skip_dict[node] = RpcResult(node=node, offline=True, call=call)
|
488 | ed83f5cc | Iustin Pop | continue
|
489 | 25348212 | Iustin Pop | val = all_nodes[node].primary_ip |
490 | 25348212 | Iustin Pop | else:
|
491 | 25348212 | Iustin Pop | val = None
|
492 | 25348212 | Iustin Pop | addr_list.append(val) |
493 | ed83f5cc | Iustin Pop | name_list.append(node) |
494 | ed83f5cc | Iustin Pop | if name_list:
|
495 | e0036155 | Iustin Pop | client.ConnectList(name_list, address_list=addr_list, |
496 | e0036155 | Iustin Pop | read_timeout=read_timeout) |
497 | ed83f5cc | Iustin Pop | return skip_dict
|
498 | 25348212 | Iustin Pop | |
499 | e0036155 | Iustin Pop | def _ConnectNode(self, client, node, call, read_timeout=None): |
500 | 25348212 | Iustin Pop | """Helper for computing one node's address.
|
501 | 25348212 | Iustin Pop |
|
502 | 6af6270a | Iustin Pop | @type client: L{ganeti.rpc.Client}
|
503 | 25348212 | Iustin Pop | @param client: a C{Client} instance
|
504 | 25348212 | Iustin Pop | @type node: str
|
505 | 25348212 | Iustin Pop | @param node: the node we should connect
|
506 | 84b45587 | Iustin Pop | @type call: string
|
507 | 84b45587 | Iustin Pop | @param call: the name of the remote procedure call, for filling in
|
508 | 84b45587 | Iustin Pop | correctly any eventual offline nodes' results
|
509 | e0036155 | Iustin Pop | @type read_timeout: int
|
510 | e0036155 | Iustin Pop | @param read_timeout: overwrites the default read timeout for the
|
511 | e0036155 | Iustin Pop | given operation
|
512 | 25348212 | Iustin Pop |
|
513 | 25348212 | Iustin Pop | """
|
514 | 25348212 | Iustin Pop | node_info = self._cfg.GetNodeInfo(node)
|
515 | 25348212 | Iustin Pop | if node_info is not None: |
516 | ed83f5cc | Iustin Pop | if node_info.offline:
|
517 | 84b45587 | Iustin Pop | return RpcResult(node=node, offline=True, call=call) |
518 | 25348212 | Iustin Pop | addr = node_info.primary_ip |
519 | 25348212 | Iustin Pop | else:
|
520 | 25348212 | Iustin Pop | addr = None
|
521 | e0036155 | Iustin Pop | client.ConnectNode(node, address=addr, read_timeout=read_timeout) |
522 | 25348212 | Iustin Pop | |
523 | e0036155 | Iustin Pop | def _MultiNodeCall(self, node_list, procedure, args, read_timeout=None): |
524 | 160e2921 | Iustin Pop | """Helper for making a multi-node call
|
525 | 160e2921 | Iustin Pop |
|
526 | 160e2921 | Iustin Pop | """
|
527 | 160e2921 | Iustin Pop | body = serializer.DumpJson(args, indent=False)
|
528 | 160e2921 | Iustin Pop | c = Client(procedure, body, self.port)
|
529 | e0036155 | Iustin Pop | skip_dict = self._ConnectList(c, node_list, procedure,
|
530 | e0036155 | Iustin Pop | read_timeout=read_timeout) |
531 | ed83f5cc | Iustin Pop | skip_dict.update(c.GetResults()) |
532 | ed83f5cc | Iustin Pop | return skip_dict
|
533 | 9a525d83 | Michael Hanselmann | |
534 | 9a525d83 | Michael Hanselmann | @classmethod
|
535 | 9a525d83 | Michael Hanselmann | def _StaticMultiNodeCall(cls, node_list, procedure, args, |
536 | e0036155 | Iustin Pop | address_list=None, read_timeout=None): |
537 | 160e2921 | Iustin Pop | """Helper for making a multi-node static call
|
538 | 160e2921 | Iustin Pop |
|
539 | 160e2921 | Iustin Pop | """
|
540 | 160e2921 | Iustin Pop | body = serializer.DumpJson(args, indent=False)
|
541 | a744b676 | Manuel Franceschini | c = Client(procedure, body, netutils.GetDaemonPort(constants.NODED)) |
542 | e0036155 | Iustin Pop | c.ConnectList(node_list, address_list=address_list, |
543 | e0036155 | Iustin Pop | read_timeout=read_timeout) |
544 | 9a525d83 | Michael Hanselmann | return c.GetResults()
|
545 | 9a525d83 | Michael Hanselmann | |
546 | e0036155 | Iustin Pop | def _SingleNodeCall(self, node, procedure, args, read_timeout=None): |
547 | 160e2921 | Iustin Pop | """Helper for making a single-node call
|
548 | 9a525d83 | Michael Hanselmann |
|
549 | 9a525d83 | Michael Hanselmann | """
|
550 | 160e2921 | Iustin Pop | body = serializer.DumpJson(args, indent=False)
|
551 | 160e2921 | Iustin Pop | c = Client(procedure, body, self.port)
|
552 | e0036155 | Iustin Pop | result = self._ConnectNode(c, node, procedure, read_timeout=read_timeout)
|
553 | ed83f5cc | Iustin Pop | if result is None: |
554 | ed83f5cc | Iustin Pop | # we did connect, node is not offline
|
555 | ed83f5cc | Iustin Pop | result = c.GetResults()[node] |
556 | ed83f5cc | Iustin Pop | return result
|
557 | 9a525d83 | Michael Hanselmann | |
558 | 9a525d83 | Michael Hanselmann | @classmethod
|
559 | e0036155 | Iustin Pop | def _StaticSingleNodeCall(cls, node, procedure, args, read_timeout=None): |
560 | 160e2921 | Iustin Pop | """Helper for making a single-node static call
|
561 | 9a525d83 | Michael Hanselmann |
|
562 | 9a525d83 | Michael Hanselmann | """
|
563 | 160e2921 | Iustin Pop | body = serializer.DumpJson(args, indent=False)
|
564 | a744b676 | Manuel Franceschini | c = Client(procedure, body, netutils.GetDaemonPort(constants.NODED)) |
565 | e0036155 | Iustin Pop | c.ConnectNode(node, read_timeout=read_timeout) |
566 | ed83f5cc | Iustin Pop | return c.GetResults()[node]
|
567 | 9a525d83 | Michael Hanselmann | |
568 | 12bce260 | Michael Hanselmann | @staticmethod
|
569 | 12bce260 | Michael Hanselmann | def _Compress(data): |
570 | 12bce260 | Michael Hanselmann | """Compresses a string for transport over RPC.
|
571 | 12bce260 | Michael Hanselmann |
|
572 | 12bce260 | Michael Hanselmann | Small amounts of data are not compressed.
|
573 | 12bce260 | Michael Hanselmann |
|
574 | 12bce260 | Michael Hanselmann | @type data: str
|
575 | 12bce260 | Michael Hanselmann | @param data: Data
|
576 | 12bce260 | Michael Hanselmann | @rtype: tuple
|
577 | 12bce260 | Michael Hanselmann | @return: Encoded data to send
|
578 | 12bce260 | Michael Hanselmann |
|
579 | 12bce260 | Michael Hanselmann | """
|
580 | 12bce260 | Michael Hanselmann | # Small amounts of data are not compressed
|
581 | 12bce260 | Michael Hanselmann | if len(data) < 512: |
582 | 12bce260 | Michael Hanselmann | return (constants.RPC_ENCODING_NONE, data)
|
583 | 12bce260 | Michael Hanselmann | |
584 | 12bce260 | Michael Hanselmann | # Compress with zlib and encode in base64
|
585 | 12bce260 | Michael Hanselmann | return (constants.RPC_ENCODING_ZLIB_BASE64,
|
586 | 12bce260 | Michael Hanselmann | base64.b64encode(zlib.compress(data, 3)))
|
587 | 12bce260 | Michael Hanselmann | |
588 | 781de953 | Iustin Pop | #
|
589 | 781de953 | Iustin Pop | # Begin RPC calls
|
590 | 781de953 | Iustin Pop | #
|
591 | 781de953 | Iustin Pop | |
592 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_URGENT)
|
593 | b2a6ccd4 | Iustin Pop | def call_lv_list(self, node_list, vg_name): |
594 | 72737a7f | Iustin Pop | """Gets the logical volumes present in a given volume group.
|
595 | a8083063 | Iustin Pop |
|
596 | 72737a7f | Iustin Pop | This is a multi-node call.
|
597 | a8083063 | Iustin Pop |
|
598 | 72737a7f | Iustin Pop | """
|
599 | b2a6ccd4 | Iustin Pop | return self._MultiNodeCall(node_list, "lv_list", [vg_name]) |
600 | a8083063 | Iustin Pop | |
601 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_URGENT)
|
602 | 72737a7f | Iustin Pop | def call_vg_list(self, node_list): |
603 | 72737a7f | Iustin Pop | """Gets the volume group list.
|
604 | a8083063 | Iustin Pop |
|
605 | 72737a7f | Iustin Pop | This is a multi-node call.
|
606 | a8083063 | Iustin Pop |
|
607 | 72737a7f | Iustin Pop | """
|
608 | 9a525d83 | Michael Hanselmann | return self._MultiNodeCall(node_list, "vg_list", []) |
609 | a8083063 | Iustin Pop | |
610 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
611 | e337de97 | Michael Hanselmann | def call_storage_list(self, node_list, su_name, su_args, name, fields): |
612 | 8979196a | Michael Hanselmann | """Get list of storage units.
|
613 | e337de97 | Michael Hanselmann |
|
614 | e337de97 | Michael Hanselmann | This is a multi-node call.
|
615 | e337de97 | Michael Hanselmann |
|
616 | e337de97 | Michael Hanselmann | """
|
617 | e337de97 | Michael Hanselmann | return self._MultiNodeCall(node_list, "storage_list", |
618 | e337de97 | Michael Hanselmann | [su_name, su_args, name, fields]) |
619 | e337de97 | Michael Hanselmann | |
620 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
621 | 8979196a | Michael Hanselmann | def call_storage_modify(self, node, su_name, su_args, name, changes): |
622 | 8979196a | Michael Hanselmann | """Modify a storage unit.
|
623 | 8979196a | Michael Hanselmann |
|
624 | 8979196a | Michael Hanselmann | This is a single-node call.
|
625 | 8979196a | Michael Hanselmann |
|
626 | 8979196a | Michael Hanselmann | """
|
627 | 8979196a | Michael Hanselmann | return self._SingleNodeCall(node, "storage_modify", |
628 | 8979196a | Michael Hanselmann | [su_name, su_args, name, changes]) |
629 | 8979196a | Michael Hanselmann | |
630 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
631 | 637b8d7e | Michael Hanselmann | def call_storage_execute(self, node, su_name, su_args, name, op): |
632 | 637b8d7e | Michael Hanselmann | """Executes an operation on a storage unit.
|
633 | 637b8d7e | Michael Hanselmann |
|
634 | 637b8d7e | Michael Hanselmann | This is a single-node call.
|
635 | 637b8d7e | Michael Hanselmann |
|
636 | 637b8d7e | Michael Hanselmann | """
|
637 | 637b8d7e | Michael Hanselmann | return self._SingleNodeCall(node, "storage_execute", |
638 | 637b8d7e | Michael Hanselmann | [su_name, su_args, name, op]) |
639 | 637b8d7e | Michael Hanselmann | |
640 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_URGENT)
|
641 | 72737a7f | Iustin Pop | def call_bridges_exist(self, node, bridges_list): |
642 | 72737a7f | Iustin Pop | """Checks if a node has all the bridges given.
|
643 | a8083063 | Iustin Pop |
|
644 | 72737a7f | Iustin Pop | This method checks if all bridges given in the bridges_list are
|
645 | 72737a7f | Iustin Pop | present on the remote node, so that an instance that uses interfaces
|
646 | 72737a7f | Iustin Pop | on those bridges can be started.
|
647 | a8083063 | Iustin Pop |
|
648 | 72737a7f | Iustin Pop | This is a single-node call.
|
649 | a8083063 | Iustin Pop |
|
650 | 72737a7f | Iustin Pop | """
|
651 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "bridges_exist", [bridges_list]) |
652 | a8083063 | Iustin Pop | |
653 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
654 | 0eca8e0c | Iustin Pop | def call_instance_start(self, node, instance, hvp, bep): |
655 | 72737a7f | Iustin Pop | """Starts an instance.
|
656 | a8083063 | Iustin Pop |
|
657 | 72737a7f | Iustin Pop | This is a single-node call.
|
658 | a8083063 | Iustin Pop |
|
659 | 72737a7f | Iustin Pop | """
|
660 | 0eca8e0c | Iustin Pop | idict = self._InstDict(instance, hvp=hvp, bep=bep)
|
661 | 0eca8e0c | Iustin Pop | return self._SingleNodeCall(node, "instance_start", [idict]) |
662 | a8083063 | Iustin Pop | |
663 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
664 | 6263189c | Guido Trotter | def call_instance_shutdown(self, node, instance, timeout): |
665 | 72737a7f | Iustin Pop | """Stops an instance.
|
666 | a8083063 | Iustin Pop |
|
667 | 72737a7f | Iustin Pop | This is a single-node call.
|
668 | 2a10865c | Iustin Pop |
|
669 | 72737a7f | Iustin Pop | """
|
670 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "instance_shutdown", |
671 | 6263189c | Guido Trotter | [self._InstDict(instance), timeout])
|
672 | 2a10865c | Iustin Pop | |
673 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
674 | 6906a9d8 | Guido Trotter | def call_migration_info(self, node, instance): |
675 | 6906a9d8 | Guido Trotter | """Gather the information necessary to prepare an instance migration.
|
676 | 6906a9d8 | Guido Trotter |
|
677 | 6906a9d8 | Guido Trotter | This is a single-node call.
|
678 | 6906a9d8 | Guido Trotter |
|
679 | 6906a9d8 | Guido Trotter | @type node: string
|
680 | 6906a9d8 | Guido Trotter | @param node: the node on which the instance is currently running
|
681 | 6906a9d8 | Guido Trotter | @type instance: C{objects.Instance}
|
682 | 6906a9d8 | Guido Trotter | @param instance: the instance definition
|
683 | 6906a9d8 | Guido Trotter |
|
684 | 6906a9d8 | Guido Trotter | """
|
685 | 6906a9d8 | Guido Trotter | return self._SingleNodeCall(node, "migration_info", |
686 | 6906a9d8 | Guido Trotter | [self._InstDict(instance)])
|
687 | 6906a9d8 | Guido Trotter | |
688 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
689 | 6906a9d8 | Guido Trotter | def call_accept_instance(self, node, instance, info, target): |
690 | 6906a9d8 | Guido Trotter | """Prepare a node to accept an instance.
|
691 | 6906a9d8 | Guido Trotter |
|
692 | 6906a9d8 | Guido Trotter | This is a single-node call.
|
693 | 6906a9d8 | Guido Trotter |
|
694 | 6906a9d8 | Guido Trotter | @type node: string
|
695 | 6906a9d8 | Guido Trotter | @param node: the target node for the migration
|
696 | 6906a9d8 | Guido Trotter | @type instance: C{objects.Instance}
|
697 | 6906a9d8 | Guido Trotter | @param instance: the instance definition
|
698 | 6906a9d8 | Guido Trotter | @type info: opaque/hypervisor specific (string/data)
|
699 | 6906a9d8 | Guido Trotter | @param info: result for the call_migration_info call
|
700 | 6906a9d8 | Guido Trotter | @type target: string
|
701 | 6906a9d8 | Guido Trotter | @param target: target hostname (usually ip address) (on the node itself)
|
702 | 6906a9d8 | Guido Trotter |
|
703 | 6906a9d8 | Guido Trotter | """
|
704 | 6906a9d8 | Guido Trotter | return self._SingleNodeCall(node, "accept_instance", |
705 | 6906a9d8 | Guido Trotter | [self._InstDict(instance), info, target])
|
706 | 6906a9d8 | Guido Trotter | |
707 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
708 | 6906a9d8 | Guido Trotter | def call_finalize_migration(self, node, instance, info, success): |
709 | 6906a9d8 | Guido Trotter | """Finalize any target-node migration specific operation.
|
710 | 6906a9d8 | Guido Trotter |
|
711 | 6906a9d8 | Guido Trotter | This is called both in case of a successful migration and in case of error
|
712 | 6906a9d8 | Guido Trotter | (in which case it should abort the migration).
|
713 | 6906a9d8 | Guido Trotter |
|
714 | 6906a9d8 | Guido Trotter | This is a single-node call.
|
715 | 6906a9d8 | Guido Trotter |
|
716 | 6906a9d8 | Guido Trotter | @type node: string
|
717 | 6906a9d8 | Guido Trotter | @param node: the target node for the migration
|
718 | 6906a9d8 | Guido Trotter | @type instance: C{objects.Instance}
|
719 | 6906a9d8 | Guido Trotter | @param instance: the instance definition
|
720 | 6906a9d8 | Guido Trotter | @type info: opaque/hypervisor specific (string/data)
|
721 | 6906a9d8 | Guido Trotter | @param info: result for the call_migration_info call
|
722 | 6906a9d8 | Guido Trotter | @type success: boolean
|
723 | 6906a9d8 | Guido Trotter | @param success: whether the migration was a success or a failure
|
724 | 6906a9d8 | Guido Trotter |
|
725 | 6906a9d8 | Guido Trotter | """
|
726 | 6906a9d8 | Guido Trotter | return self._SingleNodeCall(node, "finalize_migration", |
727 | 6906a9d8 | Guido Trotter | [self._InstDict(instance), info, success])
|
728 | 6906a9d8 | Guido Trotter | |
729 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_SLOW)
|
730 | 72737a7f | Iustin Pop | def call_instance_migrate(self, node, instance, target, live): |
731 | 72737a7f | Iustin Pop | """Migrate an instance.
|
732 | 2a10865c | Iustin Pop |
|
733 | 72737a7f | Iustin Pop | This is a single-node call.
|
734 | 2a10865c | Iustin Pop |
|
735 | 72737a7f | Iustin Pop | @type node: string
|
736 | 72737a7f | Iustin Pop | @param node: the node on which the instance is currently running
|
737 | 72737a7f | Iustin Pop | @type instance: C{objects.Instance}
|
738 | 72737a7f | Iustin Pop | @param instance: the instance definition
|
739 | 72737a7f | Iustin Pop | @type target: string
|
740 | 72737a7f | Iustin Pop | @param target: the target node name
|
741 | 72737a7f | Iustin Pop | @type live: boolean
|
742 | 72737a7f | Iustin Pop | @param live: whether the migration should be done live or not (the
|
743 | 72737a7f | Iustin Pop | interpretation of this parameter is left to the hypervisor)
|
744 | 007a2f3e | Alexander Schreiber |
|
745 | 72737a7f | Iustin Pop | """
|
746 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "instance_migrate", |
747 | 9a525d83 | Michael Hanselmann | [self._InstDict(instance), target, live])
|
748 | 007a2f3e | Alexander Schreiber | |
749 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
750 | 17c3f802 | Guido Trotter | def call_instance_reboot(self, node, inst, reboot_type, shutdown_timeout): |
751 | 72737a7f | Iustin Pop | """Reboots an instance.
|
752 | 007a2f3e | Alexander Schreiber |
|
753 | 72737a7f | Iustin Pop | This is a single-node call.
|
754 | a8083063 | Iustin Pop |
|
755 | 72737a7f | Iustin Pop | """
|
756 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "instance_reboot", |
757 | 17c3f802 | Guido Trotter | [self._InstDict(inst), reboot_type,
|
758 | 17c3f802 | Guido Trotter | shutdown_timeout]) |
759 | a8083063 | Iustin Pop | |
760 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_1DAY)
|
761 | 8d8c4eff | Michael Hanselmann | def call_instance_os_add(self, node, inst, reinstall, debug, osparams=None): |
762 | 72737a7f | Iustin Pop | """Installs an OS on the given instance.
|
763 | a8083063 | Iustin Pop |
|
764 | 72737a7f | Iustin Pop | This is a single-node call.
|
765 | decd5f45 | Iustin Pop |
|
766 | 72737a7f | Iustin Pop | """
|
767 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "instance_os_add", |
768 | 8d8c4eff | Michael Hanselmann | [self._InstDict(inst, osp=osparams),
|
769 | 8d8c4eff | Michael Hanselmann | reinstall, debug]) |
770 | decd5f45 | Iustin Pop | |
771 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_SLOW)
|
772 | 4a0e011f | Iustin Pop | def call_instance_run_rename(self, node, inst, old_name, debug): |
773 | 72737a7f | Iustin Pop | """Run the OS rename script for an instance.
|
774 | decd5f45 | Iustin Pop |
|
775 | 72737a7f | Iustin Pop | This is a single-node call.
|
776 | a8083063 | Iustin Pop |
|
777 | 72737a7f | Iustin Pop | """
|
778 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "instance_run_rename", |
779 | 4a0e011f | Iustin Pop | [self._InstDict(inst), old_name, debug])
|
780 | a8083063 | Iustin Pop | |
781 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_URGENT)
|
782 | 72737a7f | Iustin Pop | def call_instance_info(self, node, instance, hname): |
783 | 72737a7f | Iustin Pop | """Returns information about a single instance.
|
784 | a8083063 | Iustin Pop |
|
785 | 72737a7f | Iustin Pop | This is a single-node call.
|
786 | a8083063 | Iustin Pop |
|
787 | 9a525d83 | Michael Hanselmann | @type node: list
|
788 | 9a525d83 | Michael Hanselmann | @param node: the list of nodes to query
|
789 | 72737a7f | Iustin Pop | @type instance: string
|
790 | 72737a7f | Iustin Pop | @param instance: the instance name
|
791 | 72737a7f | Iustin Pop | @type hname: string
|
792 | 72737a7f | Iustin Pop | @param hname: the hypervisor type of the instance
|
793 | a8083063 | Iustin Pop |
|
794 | 72737a7f | Iustin Pop | """
|
795 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "instance_info", [instance, hname]) |
796 | e69d05fd | Iustin Pop | |
797 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
798 | 56e7640c | Iustin Pop | def call_instance_migratable(self, node, instance): |
799 | 56e7640c | Iustin Pop | """Checks whether the given instance can be migrated.
|
800 | 56e7640c | Iustin Pop |
|
801 | 56e7640c | Iustin Pop | This is a single-node call.
|
802 | 56e7640c | Iustin Pop |
|
803 | 56e7640c | Iustin Pop | @param node: the node to query
|
804 | 56e7640c | Iustin Pop | @type instance: L{objects.Instance}
|
805 | 56e7640c | Iustin Pop | @param instance: the instance to check
|
806 | 56e7640c | Iustin Pop |
|
807 | 56e7640c | Iustin Pop |
|
808 | 56e7640c | Iustin Pop | """
|
809 | 56e7640c | Iustin Pop | return self._SingleNodeCall(node, "instance_migratable", |
810 | 56e7640c | Iustin Pop | [self._InstDict(instance)])
|
811 | 56e7640c | Iustin Pop | |
812 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_URGENT)
|
813 | 72737a7f | Iustin Pop | def call_all_instances_info(self, node_list, hypervisor_list): |
814 | 72737a7f | Iustin Pop | """Returns information about all instances on the given nodes.
|
815 | a8083063 | Iustin Pop |
|
816 | 72737a7f | Iustin Pop | This is a multi-node call.
|
817 | a8083063 | Iustin Pop |
|
818 | 72737a7f | Iustin Pop | @type node_list: list
|
819 | 72737a7f | Iustin Pop | @param node_list: the list of nodes to query
|
820 | 72737a7f | Iustin Pop | @type hypervisor_list: list
|
821 | 72737a7f | Iustin Pop | @param hypervisor_list: the hypervisors to query for instances
|
822 | a8083063 | Iustin Pop |
|
823 | 72737a7f | Iustin Pop | """
|
824 | 9a525d83 | Michael Hanselmann | return self._MultiNodeCall(node_list, "all_instances_info", |
825 | 9a525d83 | Michael Hanselmann | [hypervisor_list]) |
826 | e69d05fd | Iustin Pop | |
827 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_URGENT)
|
828 | 72737a7f | Iustin Pop | def call_instance_list(self, node_list, hypervisor_list): |
829 | 72737a7f | Iustin Pop | """Returns the list of running instances on a given node.
|
830 | a8083063 | Iustin Pop |
|
831 | 72737a7f | Iustin Pop | This is a multi-node call.
|
832 | a8083063 | Iustin Pop |
|
833 | 72737a7f | Iustin Pop | @type node_list: list
|
834 | 72737a7f | Iustin Pop | @param node_list: the list of nodes to query
|
835 | 72737a7f | Iustin Pop | @type hypervisor_list: list
|
836 | 72737a7f | Iustin Pop | @param hypervisor_list: the hypervisors to query for instances
|
837 | 16abfbc2 | Alexander Schreiber |
|
838 | 72737a7f | Iustin Pop | """
|
839 | 9a525d83 | Michael Hanselmann | return self._MultiNodeCall(node_list, "instance_list", [hypervisor_list]) |
840 | 16abfbc2 | Alexander Schreiber | |
841 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_FAST)
|
842 | 72737a7f | Iustin Pop | def call_node_tcp_ping(self, node, source, target, port, timeout, |
843 | 72737a7f | Iustin Pop | live_port_needed): |
844 | 72737a7f | Iustin Pop | """Do a TcpPing on the remote node
|
845 | a8083063 | Iustin Pop |
|
846 | 72737a7f | Iustin Pop | This is a single-node call.
|
847 | caad16e2 | Iustin Pop |
|
848 | 72737a7f | Iustin Pop | """
|
849 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "node_tcp_ping", |
850 | 9a525d83 | Michael Hanselmann | [source, target, port, timeout, |
851 | 72737a7f | Iustin Pop | live_port_needed]) |
852 | a8083063 | Iustin Pop | |
853 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_FAST)
|
854 | caad16e2 | Iustin Pop | def call_node_has_ip_address(self, node, address): |
855 | caad16e2 | Iustin Pop | """Checks if a node has the given IP address.
|
856 | caad16e2 | Iustin Pop |
|
857 | caad16e2 | Iustin Pop | This is a single-node call.
|
858 | caad16e2 | Iustin Pop |
|
859 | caad16e2 | Iustin Pop | """
|
860 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "node_has_ip_address", [address]) |
861 | a8083063 | Iustin Pop | |
862 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_URGENT)
|
863 | 72737a7f | Iustin Pop | def call_node_info(self, node_list, vg_name, hypervisor_type): |
864 | 72737a7f | Iustin Pop | """Return node information.
|
865 | e69d05fd | Iustin Pop |
|
866 | 72737a7f | Iustin Pop | This will return memory information and volume group size and free
|
867 | 72737a7f | Iustin Pop | space.
|
868 | a8083063 | Iustin Pop |
|
869 | 72737a7f | Iustin Pop | This is a multi-node call.
|
870 | a8083063 | Iustin Pop |
|
871 | 72737a7f | Iustin Pop | @type node_list: list
|
872 | 72737a7f | Iustin Pop | @param node_list: the list of nodes to query
|
873 | c41eea6e | Iustin Pop | @type vg_name: C{string}
|
874 | c41eea6e | Iustin Pop | @param vg_name: the name of the volume group to ask for disk space
|
875 | 72737a7f | Iustin Pop | information
|
876 | 72737a7f | Iustin Pop | @type hypervisor_type: C{str}
|
877 | 72737a7f | Iustin Pop | @param hypervisor_type: the name of the hypervisor to ask for
|
878 | 72737a7f | Iustin Pop | memory information
|
879 | a8083063 | Iustin Pop |
|
880 | 72737a7f | Iustin Pop | """
|
881 | 070e998b | Iustin Pop | return self._MultiNodeCall(node_list, "node_info", |
882 | 070e998b | Iustin Pop | [vg_name, hypervisor_type]) |
883 | a8083063 | Iustin Pop | |
884 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
885 | 19ddc57a | René Nussbaumer | def call_etc_hosts_modify(self, node, mode, name, ip): |
886 | 19ddc57a | René Nussbaumer | """Modify hosts file with name
|
887 | 19ddc57a | René Nussbaumer |
|
888 | 19ddc57a | René Nussbaumer | @type node: string
|
889 | 19ddc57a | René Nussbaumer | @param node: The node to call
|
890 | 19ddc57a | René Nussbaumer | @type mode: string
|
891 | 19ddc57a | René Nussbaumer | @param mode: The mode to operate. Currently "add" or "remove"
|
892 | 19ddc57a | René Nussbaumer | @type name: string
|
893 | 19ddc57a | René Nussbaumer | @param name: The host name to be modified
|
894 | 19ddc57a | René Nussbaumer | @type ip: string
|
895 | 19ddc57a | René Nussbaumer | @param ip: The ip of the entry (just valid if mode is "add")
|
896 | 19ddc57a | René Nussbaumer |
|
897 | 19ddc57a | René Nussbaumer | """
|
898 | 19ddc57a | René Nussbaumer | return self._SingleNodeCall(node, "etc_hosts_modify", [mode, name, ip]) |
899 | 19ddc57a | René Nussbaumer | |
900 | 19ddc57a | René Nussbaumer | @_RpcTimeout(_TMO_NORMAL)
|
901 | 72737a7f | Iustin Pop | def call_node_verify(self, node_list, checkdict, cluster_name): |
902 | 72737a7f | Iustin Pop | """Request verification of given parameters.
|
903 | a8083063 | Iustin Pop |
|
904 | 72737a7f | Iustin Pop | This is a multi-node call.
|
905 | a8083063 | Iustin Pop |
|
906 | 72737a7f | Iustin Pop | """
|
907 | 9a525d83 | Michael Hanselmann | return self._MultiNodeCall(node_list, "node_verify", |
908 | 9a525d83 | Michael Hanselmann | [checkdict, cluster_name]) |
909 | a8083063 | Iustin Pop | |
910 | 9a525d83 | Michael Hanselmann | @classmethod
|
911 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_FAST)
|
912 | 3583908a | Guido Trotter | def call_node_start_master(cls, node, start_daemons, no_voting): |
913 | 72737a7f | Iustin Pop | """Tells a node to activate itself as a master.
|
914 | a8083063 | Iustin Pop |
|
915 | 72737a7f | Iustin Pop | This is a single-node call.
|
916 | a8083063 | Iustin Pop |
|
917 | 72737a7f | Iustin Pop | """
|
918 | 9a525d83 | Michael Hanselmann | return cls._StaticSingleNodeCall(node, "node_start_master", |
919 | 3583908a | Guido Trotter | [start_daemons, no_voting]) |
920 | a8083063 | Iustin Pop | |
921 | 9a525d83 | Michael Hanselmann | @classmethod
|
922 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_FAST)
|
923 | 9a525d83 | Michael Hanselmann | def call_node_stop_master(cls, node, stop_daemons): |
924 | 72737a7f | Iustin Pop | """Tells a node to demote itself from master status.
|
925 | a8083063 | Iustin Pop |
|
926 | 72737a7f | Iustin Pop | This is a single-node call.
|
927 | 4e071d3b | Iustin Pop |
|
928 | 72737a7f | Iustin Pop | """
|
929 | 9a525d83 | Michael Hanselmann | return cls._StaticSingleNodeCall(node, "node_stop_master", [stop_daemons]) |
930 | 4e071d3b | Iustin Pop | |
931 | 9a525d83 | Michael Hanselmann | @classmethod
|
932 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_URGENT)
|
933 | 9a525d83 | Michael Hanselmann | def call_master_info(cls, node_list): |
934 | 72737a7f | Iustin Pop | """Query master info.
|
935 | 4e071d3b | Iustin Pop |
|
936 | 72737a7f | Iustin Pop | This is a multi-node call.
|
937 | a8083063 | Iustin Pop |
|
938 | 72737a7f | Iustin Pop | """
|
939 | 72737a7f | Iustin Pop | # TODO: should this method query down nodes?
|
940 | 9a525d83 | Michael Hanselmann | return cls._StaticMultiNodeCall(node_list, "master_info", []) |
941 | a8083063 | Iustin Pop | |
942 | 8f215968 | Michael Hanselmann | @classmethod
|
943 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_URGENT)
|
944 | 8f215968 | Michael Hanselmann | def call_version(cls, node_list): |
945 | 72737a7f | Iustin Pop | """Query node version.
|
946 | a8083063 | Iustin Pop |
|
947 | 72737a7f | Iustin Pop | This is a multi-node call.
|
948 | a8083063 | Iustin Pop |
|
949 | 72737a7f | Iustin Pop | """
|
950 | 8f215968 | Michael Hanselmann | return cls._StaticMultiNodeCall(node_list, "version", []) |
951 | a8083063 | Iustin Pop | |
952 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
953 | 72737a7f | Iustin Pop | def call_blockdev_create(self, node, bdev, size, owner, on_primary, info): |
954 | 72737a7f | Iustin Pop | """Request creation of a given block device.
|
955 | a8083063 | Iustin Pop |
|
956 | 72737a7f | Iustin Pop | This is a single-node call.
|
957 | a8083063 | Iustin Pop |
|
958 | 72737a7f | Iustin Pop | """
|
959 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "blockdev_create", |
960 | 9a525d83 | Michael Hanselmann | [bdev.ToDict(), size, owner, on_primary, info]) |
961 | a8083063 | Iustin Pop | |
962 | 271b7cf9 | René Nussbaumer | @_RpcTimeout(_TMO_SLOW)
|
963 | 271b7cf9 | René Nussbaumer | def call_blockdev_wipe(self, node, bdev, offset, size): |
964 | 271b7cf9 | René Nussbaumer | """Request wipe at given offset with given size of a block device.
|
965 | 271b7cf9 | René Nussbaumer |
|
966 | 271b7cf9 | René Nussbaumer | This is a single-node call.
|
967 | 271b7cf9 | René Nussbaumer |
|
968 | 271b7cf9 | René Nussbaumer | """
|
969 | 271b7cf9 | René Nussbaumer | return self._SingleNodeCall(node, "blockdev_wipe", |
970 | 271b7cf9 | René Nussbaumer | [bdev.ToDict(), offset, size]) |
971 | 271b7cf9 | René Nussbaumer | |
972 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
973 | 72737a7f | Iustin Pop | def call_blockdev_remove(self, node, bdev): |
974 | 72737a7f | Iustin Pop | """Request removal of a given block device.
|
975 | a8083063 | Iustin Pop |
|
976 | 72737a7f | Iustin Pop | This is a single-node call.
|
977 | f3e513ad | Iustin Pop |
|
978 | 72737a7f | Iustin Pop | """
|
979 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "blockdev_remove", [bdev.ToDict()]) |
980 | f3e513ad | Iustin Pop | |
981 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
982 | 72737a7f | Iustin Pop | def call_blockdev_rename(self, node, devlist): |
983 | 72737a7f | Iustin Pop | """Request rename of the given block devices.
|
984 | f3e513ad | Iustin Pop |
|
985 | 72737a7f | Iustin Pop | This is a single-node call.
|
986 | a8083063 | Iustin Pop |
|
987 | 72737a7f | Iustin Pop | """
|
988 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "blockdev_rename", |
989 | 9a525d83 | Michael Hanselmann | [(d.ToDict(), uid) for d, uid in devlist]) |
990 | a8083063 | Iustin Pop | |
991 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
992 | 9c007da8 | René Nussbaumer | def call_blockdev_pause_resume_sync(self, node, disks, pause): |
993 | 9c007da8 | René Nussbaumer | """Request a pause/resume of given block device.
|
994 | 9c007da8 | René Nussbaumer |
|
995 | 9c007da8 | René Nussbaumer | This is a single-node call.
|
996 | 9c007da8 | René Nussbaumer |
|
997 | 9c007da8 | René Nussbaumer | """
|
998 | 9c007da8 | René Nussbaumer | return self._SingleNodeCall(node, "blockdev_pause_resume_sync", |
999 | 9c007da8 | René Nussbaumer | [[bdev.ToDict() for bdev in disks], pause]) |
1000 | 9c007da8 | René Nussbaumer | |
1001 | 9c007da8 | René Nussbaumer | @_RpcTimeout(_TMO_NORMAL)
|
1002 | c417e115 | Iustin Pop | def call_blockdev_assemble(self, node, disk, owner, on_primary, idx): |
1003 | 72737a7f | Iustin Pop | """Request assembling of a given block device.
|
1004 | a8083063 | Iustin Pop |
|
1005 | 72737a7f | Iustin Pop | This is a single-node call.
|
1006 | a8083063 | Iustin Pop |
|
1007 | 72737a7f | Iustin Pop | """
|
1008 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "blockdev_assemble", |
1009 | c417e115 | Iustin Pop | [disk.ToDict(), owner, on_primary, idx]) |
1010 | a8083063 | Iustin Pop | |
1011 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1012 | 72737a7f | Iustin Pop | def call_blockdev_shutdown(self, node, disk): |
1013 | 72737a7f | Iustin Pop | """Request shutdown of a given block device.
|
1014 | a8083063 | Iustin Pop |
|
1015 | 72737a7f | Iustin Pop | This is a single-node call.
|
1016 | a8083063 | Iustin Pop |
|
1017 | 72737a7f | Iustin Pop | """
|
1018 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "blockdev_shutdown", [disk.ToDict()]) |
1019 | a8083063 | Iustin Pop | |
1020 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1021 | 72737a7f | Iustin Pop | def call_blockdev_addchildren(self, node, bdev, ndevs): |
1022 | 72737a7f | Iustin Pop | """Request adding a list of children to a (mirroring) device.
|
1023 | a8083063 | Iustin Pop |
|
1024 | 72737a7f | Iustin Pop | This is a single-node call.
|
1025 | a8083063 | Iustin Pop |
|
1026 | 72737a7f | Iustin Pop | """
|
1027 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "blockdev_addchildren", |
1028 | 9a525d83 | Michael Hanselmann | [bdev.ToDict(), |
1029 | 9a525d83 | Michael Hanselmann | [disk.ToDict() for disk in ndevs]]) |
1030 | a8083063 | Iustin Pop | |
1031 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1032 | 72737a7f | Iustin Pop | def call_blockdev_removechildren(self, node, bdev, ndevs): |
1033 | 72737a7f | Iustin Pop | """Request removing a list of children from a (mirroring) device.
|
1034 | a8083063 | Iustin Pop |
|
1035 | 72737a7f | Iustin Pop | This is a single-node call.
|
1036 | a8083063 | Iustin Pop |
|
1037 | 72737a7f | Iustin Pop | """
|
1038 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "blockdev_removechildren", |
1039 | 9a525d83 | Michael Hanselmann | [bdev.ToDict(), |
1040 | 9a525d83 | Michael Hanselmann | [disk.ToDict() for disk in ndevs]]) |
1041 | a8083063 | Iustin Pop | |
1042 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1043 | 72737a7f | Iustin Pop | def call_blockdev_getmirrorstatus(self, node, disks): |
1044 | 72737a7f | Iustin Pop | """Request status of a (mirroring) device.
|
1045 | a8083063 | Iustin Pop |
|
1046 | 72737a7f | Iustin Pop | This is a single-node call.
|
1047 | a8083063 | Iustin Pop |
|
1048 | 72737a7f | Iustin Pop | """
|
1049 | 36145b12 | Michael Hanselmann | result = self._SingleNodeCall(node, "blockdev_getmirrorstatus", |
1050 | 36145b12 | Michael Hanselmann | [dsk.ToDict() for dsk in disks]) |
1051 | edb4b374 | Michael Hanselmann | if not result.fail_msg: |
1052 | 36145b12 | Michael Hanselmann | result.payload = [objects.BlockDevStatus.FromDict(i) |
1053 | 36145b12 | Michael Hanselmann | for i in result.payload] |
1054 | 36145b12 | Michael Hanselmann | return result
|
1055 | a8083063 | Iustin Pop | |
1056 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1057 | b8d26c6e | Michael Hanselmann | def call_blockdev_getmirrorstatus_multi(self, node_list, node_disks): |
1058 | b8d26c6e | Michael Hanselmann | """Request status of (mirroring) devices from multiple nodes.
|
1059 | b8d26c6e | Michael Hanselmann |
|
1060 | b8d26c6e | Michael Hanselmann | This is a multi-node call.
|
1061 | b8d26c6e | Michael Hanselmann |
|
1062 | b8d26c6e | Michael Hanselmann | """
|
1063 | b8d26c6e | Michael Hanselmann | result = self._MultiNodeCall(node_list, "blockdev_getmirrorstatus_multi", |
1064 | b8d26c6e | Michael Hanselmann | [dict((name, [dsk.ToDict() for dsk in disks]) |
1065 | b8d26c6e | Michael Hanselmann | for name, disks in node_disks.items())]) |
1066 | b8d26c6e | Michael Hanselmann | for nres in result.values(): |
1067 | c6a9dffa | Michael Hanselmann | if nres.fail_msg:
|
1068 | c6a9dffa | Michael Hanselmann | continue
|
1069 | c6a9dffa | Michael Hanselmann | |
1070 | c6a9dffa | Michael Hanselmann | for idx, (success, status) in enumerate(nres.payload): |
1071 | c6a9dffa | Michael Hanselmann | if success:
|
1072 | c6a9dffa | Michael Hanselmann | nres.payload[idx] = (success, objects.BlockDevStatus.FromDict(status)) |
1073 | c6a9dffa | Michael Hanselmann | |
1074 | b8d26c6e | Michael Hanselmann | return result
|
1075 | b8d26c6e | Michael Hanselmann | |
1076 | b8d26c6e | Michael Hanselmann | @_RpcTimeout(_TMO_NORMAL)
|
1077 | 72737a7f | Iustin Pop | def call_blockdev_find(self, node, disk): |
1078 | 72737a7f | Iustin Pop | """Request identification of a given block device.
|
1079 | 72737a7f | Iustin Pop |
|
1080 | 72737a7f | Iustin Pop | This is a single-node call.
|
1081 | a8083063 | Iustin Pop |
|
1082 | 72737a7f | Iustin Pop | """
|
1083 | 96acbc09 | Michael Hanselmann | result = self._SingleNodeCall(node, "blockdev_find", [disk.ToDict()]) |
1084 | edb4b374 | Michael Hanselmann | if not result.fail_msg and result.payload is not None: |
1085 | 96acbc09 | Michael Hanselmann | result.payload = objects.BlockDevStatus.FromDict(result.payload) |
1086 | 96acbc09 | Michael Hanselmann | return result
|
1087 | d61cbe76 | Iustin Pop | |
1088 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1089 | b2e7666a | Iustin Pop | def call_blockdev_close(self, node, instance_name, disks): |
1090 | 72737a7f | Iustin Pop | """Closes the given block devices.
|
1091 | d61cbe76 | Iustin Pop |
|
1092 | 72737a7f | Iustin Pop | This is a single-node call.
|
1093 | d61cbe76 | Iustin Pop |
|
1094 | 72737a7f | Iustin Pop | """
|
1095 | b2e7666a | Iustin Pop | params = [instance_name, [cf.ToDict() for cf in disks]] |
1096 | b2e7666a | Iustin Pop | return self._SingleNodeCall(node, "blockdev_close", params) |
1097 | a8083063 | Iustin Pop | |
1098 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1099 | ccfbbd2d | Iustin Pop | def call_blockdev_getsize(self, node, disks): |
1100 | 968a7623 | Iustin Pop | """Returns the size of the given disks.
|
1101 | 968a7623 | Iustin Pop |
|
1102 | 968a7623 | Iustin Pop | This is a single-node call.
|
1103 | 968a7623 | Iustin Pop |
|
1104 | 968a7623 | Iustin Pop | """
|
1105 | 968a7623 | Iustin Pop | params = [[cf.ToDict() for cf in disks]] |
1106 | 968a7623 | Iustin Pop | return self._SingleNodeCall(node, "blockdev_getsize", params) |
1107 | 968a7623 | Iustin Pop | |
1108 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1109 | 6b93ec9d | Iustin Pop | def call_drbd_disconnect_net(self, node_list, nodes_ip, disks): |
1110 | 6b93ec9d | Iustin Pop | """Disconnects the network of the given drbd devices.
|
1111 | 6b93ec9d | Iustin Pop |
|
1112 | 6b93ec9d | Iustin Pop | This is a multi-node call.
|
1113 | 6b93ec9d | Iustin Pop |
|
1114 | 6b93ec9d | Iustin Pop | """
|
1115 | 6b93ec9d | Iustin Pop | return self._MultiNodeCall(node_list, "drbd_disconnect_net", |
1116 | 6b93ec9d | Iustin Pop | [nodes_ip, [cf.ToDict() for cf in disks]]) |
1117 | 6b93ec9d | Iustin Pop | |
1118 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1119 | 6b93ec9d | Iustin Pop | def call_drbd_attach_net(self, node_list, nodes_ip, |
1120 | 6b93ec9d | Iustin Pop | disks, instance_name, multimaster): |
1121 | 6b93ec9d | Iustin Pop | """Disconnects the given drbd devices.
|
1122 | 6b93ec9d | Iustin Pop |
|
1123 | 6b93ec9d | Iustin Pop | This is a multi-node call.
|
1124 | 6b93ec9d | Iustin Pop |
|
1125 | 6b93ec9d | Iustin Pop | """
|
1126 | 6b93ec9d | Iustin Pop | return self._MultiNodeCall(node_list, "drbd_attach_net", |
1127 | 6b93ec9d | Iustin Pop | [nodes_ip, [cf.ToDict() for cf in disks], |
1128 | 6b93ec9d | Iustin Pop | instance_name, multimaster]) |
1129 | 6b93ec9d | Iustin Pop | |
1130 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_SLOW)
|
1131 | 6b93ec9d | Iustin Pop | def call_drbd_wait_sync(self, node_list, nodes_ip, disks): |
1132 | 6b93ec9d | Iustin Pop | """Waits for the synchronization of drbd devices is complete.
|
1133 | 6b93ec9d | Iustin Pop |
|
1134 | 6b93ec9d | Iustin Pop | This is a multi-node call.
|
1135 | 6b93ec9d | Iustin Pop |
|
1136 | 6b93ec9d | Iustin Pop | """
|
1137 | 6b93ec9d | Iustin Pop | return self._MultiNodeCall(node_list, "drbd_wait_sync", |
1138 | 6b93ec9d | Iustin Pop | [nodes_ip, [cf.ToDict() for cf in disks]]) |
1139 | 6b93ec9d | Iustin Pop | |
1140 | c46b9782 | Luca Bigliardi | @_RpcTimeout(_TMO_URGENT)
|
1141 | c46b9782 | Luca Bigliardi | def call_drbd_helper(self, node_list): |
1142 | c46b9782 | Luca Bigliardi | """Gets drbd helper.
|
1143 | c46b9782 | Luca Bigliardi |
|
1144 | c46b9782 | Luca Bigliardi | This is a multi-node call.
|
1145 | c46b9782 | Luca Bigliardi |
|
1146 | c46b9782 | Luca Bigliardi | """
|
1147 | c46b9782 | Luca Bigliardi | return self._MultiNodeCall(node_list, "drbd_helper", []) |
1148 | c46b9782 | Luca Bigliardi | |
1149 | 9a525d83 | Michael Hanselmann | @classmethod
|
1150 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1151 | 9a525d83 | Michael Hanselmann | def call_upload_file(cls, node_list, file_name, address_list=None): |
1152 | 72737a7f | Iustin Pop | """Upload a file.
|
1153 | 72737a7f | Iustin Pop |
|
1154 | 72737a7f | Iustin Pop | The node will refuse the operation in case the file is not on the
|
1155 | 72737a7f | Iustin Pop | approved file list.
|
1156 | 72737a7f | Iustin Pop |
|
1157 | 72737a7f | Iustin Pop | This is a multi-node call.
|
1158 | a8083063 | Iustin Pop |
|
1159 | 6b294c53 | Iustin Pop | @type node_list: list
|
1160 | 6b294c53 | Iustin Pop | @param node_list: the list of node names to upload to
|
1161 | 6b294c53 | Iustin Pop | @type file_name: str
|
1162 | 6b294c53 | Iustin Pop | @param file_name: the filename to upload
|
1163 | 6b294c53 | Iustin Pop | @type address_list: list or None
|
1164 | 6b294c53 | Iustin Pop | @keyword address_list: an optional list of node addresses, in order
|
1165 | 6b294c53 | Iustin Pop | to optimize the RPC speed
|
1166 | 6b294c53 | Iustin Pop |
|
1167 | 72737a7f | Iustin Pop | """
|
1168 | 12bce260 | Michael Hanselmann | file_contents = utils.ReadFile(file_name) |
1169 | 12bce260 | Michael Hanselmann | data = cls._Compress(file_contents) |
1170 | 72737a7f | Iustin Pop | st = os.stat(file_name) |
1171 | 72737a7f | Iustin Pop | params = [file_name, data, st.st_mode, st.st_uid, st.st_gid, |
1172 | 72737a7f | Iustin Pop | st.st_atime, st.st_mtime] |
1173 | 9a525d83 | Michael Hanselmann | return cls._StaticMultiNodeCall(node_list, "upload_file", params, |
1174 | 9a525d83 | Michael Hanselmann | address_list=address_list) |
1175 | 72737a7f | Iustin Pop | |
1176 | 6ddc95ec | Michael Hanselmann | @classmethod
|
1177 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1178 | 03d1dba2 | Michael Hanselmann | def call_write_ssconf_files(cls, node_list, values): |
1179 | 6ddc95ec | Michael Hanselmann | """Write ssconf files.
|
1180 | 6ddc95ec | Michael Hanselmann |
|
1181 | 6ddc95ec | Michael Hanselmann | This is a multi-node call.
|
1182 | 6ddc95ec | Michael Hanselmann |
|
1183 | 6ddc95ec | Michael Hanselmann | """
|
1184 | 03d1dba2 | Michael Hanselmann | return cls._StaticMultiNodeCall(node_list, "write_ssconf_files", [values]) |
1185 | 6ddc95ec | Michael Hanselmann | |
1186 | 4f6014d4 | René Nussbaumer | @_RpcTimeout(_TMO_NORMAL)
|
1187 | 0092d621 | René Nussbaumer | def call_run_oob(self, node, oob_program, command, remote_node, timeout): |
1188 | 4f6014d4 | René Nussbaumer | """Runs OOB.
|
1189 | 4f6014d4 | René Nussbaumer |
|
1190 | 4f6014d4 | René Nussbaumer | This is a single-node call.
|
1191 | 4f6014d4 | René Nussbaumer |
|
1192 | 4f6014d4 | René Nussbaumer | """
|
1193 | 4f6014d4 | René Nussbaumer | return self._SingleNodeCall(node, "run_oob", [oob_program, command, |
1194 | 0092d621 | René Nussbaumer | remote_node, timeout]) |
1195 | 4f6014d4 | René Nussbaumer | |
1196 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_FAST)
|
1197 | 72737a7f | Iustin Pop | def call_os_diagnose(self, node_list): |
1198 | 72737a7f | Iustin Pop | """Request a diagnose of OS definitions.
|
1199 | 72737a7f | Iustin Pop |
|
1200 | 72737a7f | Iustin Pop | This is a multi-node call.
|
1201 | a8083063 | Iustin Pop |
|
1202 | 72737a7f | Iustin Pop | """
|
1203 | 83d92ad8 | Iustin Pop | return self._MultiNodeCall(node_list, "os_diagnose", []) |
1204 | a8083063 | Iustin Pop | |
1205 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_FAST)
|
1206 | 72737a7f | Iustin Pop | def call_os_get(self, node, name): |
1207 | 72737a7f | Iustin Pop | """Returns an OS definition.
|
1208 | a8083063 | Iustin Pop |
|
1209 | 72737a7f | Iustin Pop | This is a single-node call.
|
1210 | a8083063 | Iustin Pop |
|
1211 | 72737a7f | Iustin Pop | """
|
1212 | 9a525d83 | Michael Hanselmann | result = self._SingleNodeCall(node, "os_get", [name]) |
1213 | 84e3f66f | Guido Trotter | if not result.fail_msg and isinstance(result.payload, dict): |
1214 | 84e3f66f | Guido Trotter | result.payload = objects.OS.FromDict(result.payload) |
1215 | 781de953 | Iustin Pop | return result
|
1216 | a8083063 | Iustin Pop | |
1217 | acd9ff9e | Iustin Pop | @_RpcTimeout(_TMO_FAST)
|
1218 | acd9ff9e | Iustin Pop | def call_os_validate(self, required, nodes, name, checks, params): |
1219 | acd9ff9e | Iustin Pop | """Run a validation routine for a given OS.
|
1220 | acd9ff9e | Iustin Pop |
|
1221 | acd9ff9e | Iustin Pop | This is a multi-node call.
|
1222 | acd9ff9e | Iustin Pop |
|
1223 | acd9ff9e | Iustin Pop | """
|
1224 | acd9ff9e | Iustin Pop | return self._MultiNodeCall(nodes, "os_validate", |
1225 | acd9ff9e | Iustin Pop | [required, name, checks, params]) |
1226 | acd9ff9e | Iustin Pop | |
1227 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1228 | 72737a7f | Iustin Pop | def call_hooks_runner(self, node_list, hpath, phase, env): |
1229 | 72737a7f | Iustin Pop | """Call the hooks runner.
|
1230 | a8083063 | Iustin Pop |
|
1231 | 72737a7f | Iustin Pop | Args:
|
1232 | 72737a7f | Iustin Pop | - op: the OpCode instance
|
1233 | 72737a7f | Iustin Pop | - env: a dictionary with the environment
|
1234 | a8083063 | Iustin Pop |
|
1235 | 72737a7f | Iustin Pop | This is a multi-node call.
|
1236 | a8083063 | Iustin Pop |
|
1237 | 72737a7f | Iustin Pop | """
|
1238 | 72737a7f | Iustin Pop | params = [hpath, phase, env] |
1239 | 9a525d83 | Michael Hanselmann | return self._MultiNodeCall(node_list, "hooks_runner", params) |
1240 | a8083063 | Iustin Pop | |
1241 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1242 | 72737a7f | Iustin Pop | def call_iallocator_runner(self, node, name, idata): |
1243 | 72737a7f | Iustin Pop | """Call an iallocator on a remote node
|
1244 | 8d528b7c | Iustin Pop |
|
1245 | 72737a7f | Iustin Pop | Args:
|
1246 | 72737a7f | Iustin Pop | - name: the iallocator name
|
1247 | 72737a7f | Iustin Pop | - input: the json-encoded input string
|
1248 | 8d528b7c | Iustin Pop |
|
1249 | 72737a7f | Iustin Pop | This is a single-node call.
|
1250 | 8d528b7c | Iustin Pop |
|
1251 | 72737a7f | Iustin Pop | """
|
1252 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "iallocator_runner", [name, idata]) |
1253 | 8d528b7c | Iustin Pop | |
1254 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1255 | 72737a7f | Iustin Pop | def call_blockdev_grow(self, node, cf_bdev, amount): |
1256 | 72737a7f | Iustin Pop | """Request a snapshot of the given block device.
|
1257 | 4c8ba8b3 | Iustin Pop |
|
1258 | 72737a7f | Iustin Pop | This is a single-node call.
|
1259 | 4c8ba8b3 | Iustin Pop |
|
1260 | 72737a7f | Iustin Pop | """
|
1261 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "blockdev_grow", |
1262 | 9a525d83 | Michael Hanselmann | [cf_bdev.ToDict(), amount]) |
1263 | 4c8ba8b3 | Iustin Pop | |
1264 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_1DAY)
|
1265 | 858f3d18 | Iustin Pop | def call_blockdev_export(self, node, cf_bdev, |
1266 | 858f3d18 | Iustin Pop | dest_node, dest_path, cluster_name): |
1267 | 858f3d18 | Iustin Pop | """Export a given disk to another node.
|
1268 | 858f3d18 | Iustin Pop |
|
1269 | 858f3d18 | Iustin Pop | This is a single-node call.
|
1270 | 858f3d18 | Iustin Pop |
|
1271 | 858f3d18 | Iustin Pop | """
|
1272 | 858f3d18 | Iustin Pop | return self._SingleNodeCall(node, "blockdev_export", |
1273 | 858f3d18 | Iustin Pop | [cf_bdev.ToDict(), dest_node, dest_path, |
1274 | 858f3d18 | Iustin Pop | cluster_name]) |
1275 | 858f3d18 | Iustin Pop | |
1276 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1277 | 72737a7f | Iustin Pop | def call_blockdev_snapshot(self, node, cf_bdev): |
1278 | 72737a7f | Iustin Pop | """Request a snapshot of the given block device.
|
1279 | a8083063 | Iustin Pop |
|
1280 | 72737a7f | Iustin Pop | This is a single-node call.
|
1281 | a8083063 | Iustin Pop |
|
1282 | 72737a7f | Iustin Pop | """
|
1283 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "blockdev_snapshot", [cf_bdev.ToDict()]) |
1284 | a8083063 | Iustin Pop | |
1285 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1286 | 72737a7f | Iustin Pop | def call_finalize_export(self, node, instance, snap_disks): |
1287 | 72737a7f | Iustin Pop | """Request the completion of an export operation.
|
1288 | a8083063 | Iustin Pop |
|
1289 | 72737a7f | Iustin Pop | This writes the export config file, etc.
|
1290 | a8083063 | Iustin Pop |
|
1291 | 72737a7f | Iustin Pop | This is a single-node call.
|
1292 | a8083063 | Iustin Pop |
|
1293 | 72737a7f | Iustin Pop | """
|
1294 | 72737a7f | Iustin Pop | flat_disks = [] |
1295 | 72737a7f | Iustin Pop | for disk in snap_disks: |
1296 | a97da6b7 | Iustin Pop | if isinstance(disk, bool): |
1297 | a97da6b7 | Iustin Pop | flat_disks.append(disk) |
1298 | a97da6b7 | Iustin Pop | else:
|
1299 | a97da6b7 | Iustin Pop | flat_disks.append(disk.ToDict()) |
1300 | 9a525d83 | Michael Hanselmann | |
1301 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "finalize_export", |
1302 | 9a525d83 | Michael Hanselmann | [self._InstDict(instance), flat_disks])
|
1303 | a8083063 | Iustin Pop | |
1304 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_FAST)
|
1305 | 72737a7f | Iustin Pop | def call_export_info(self, node, path): |
1306 | 72737a7f | Iustin Pop | """Queries the export information in a given path.
|
1307 | a8083063 | Iustin Pop |
|
1308 | 72737a7f | Iustin Pop | This is a single-node call.
|
1309 | a8083063 | Iustin Pop |
|
1310 | 72737a7f | Iustin Pop | """
|
1311 | 3eccac06 | Iustin Pop | return self._SingleNodeCall(node, "export_info", [path]) |
1312 | a8083063 | Iustin Pop | |
1313 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_FAST)
|
1314 | 72737a7f | Iustin Pop | def call_export_list(self, node_list): |
1315 | 72737a7f | Iustin Pop | """Gets the stored exports list.
|
1316 | a8083063 | Iustin Pop |
|
1317 | 72737a7f | Iustin Pop | This is a multi-node call.
|
1318 | a8083063 | Iustin Pop |
|
1319 | 72737a7f | Iustin Pop | """
|
1320 | 9a525d83 | Michael Hanselmann | return self._MultiNodeCall(node_list, "export_list", []) |
1321 | a8083063 | Iustin Pop | |
1322 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_FAST)
|
1323 | 72737a7f | Iustin Pop | def call_export_remove(self, node, export): |
1324 | 72737a7f | Iustin Pop | """Requests removal of a given export.
|
1325 | a8083063 | Iustin Pop |
|
1326 | 72737a7f | Iustin Pop | This is a single-node call.
|
1327 | a8083063 | Iustin Pop |
|
1328 | 72737a7f | Iustin Pop | """
|
1329 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "export_remove", [export]) |
1330 | a8083063 | Iustin Pop | |
1331 | 9a525d83 | Michael Hanselmann | @classmethod
|
1332 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1333 | b989b9d9 | Ken Wehr | def call_node_leave_cluster(cls, node, modify_ssh_setup): |
1334 | 72737a7f | Iustin Pop | """Requests a node to clean the cluster information it has.
|
1335 | a8083063 | Iustin Pop |
|
1336 | 72737a7f | Iustin Pop | This will remove the configuration information from the ganeti data
|
1337 | 72737a7f | Iustin Pop | dir.
|
1338 | a8083063 | Iustin Pop |
|
1339 | 72737a7f | Iustin Pop | This is a single-node call.
|
1340 | a8083063 | Iustin Pop |
|
1341 | 72737a7f | Iustin Pop | """
|
1342 | b989b9d9 | Ken Wehr | return cls._StaticSingleNodeCall(node, "node_leave_cluster", |
1343 | b989b9d9 | Ken Wehr | [modify_ssh_setup]) |
1344 | dcb93971 | Michael Hanselmann | |
1345 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_FAST)
|
1346 | 72737a7f | Iustin Pop | def call_node_volumes(self, node_list): |
1347 | 72737a7f | Iustin Pop | """Gets all volumes on node(s).
|
1348 | dcb93971 | Michael Hanselmann |
|
1349 | 72737a7f | Iustin Pop | This is a multi-node call.
|
1350 | dcb93971 | Michael Hanselmann |
|
1351 | 72737a7f | Iustin Pop | """
|
1352 | 9a525d83 | Michael Hanselmann | return self._MultiNodeCall(node_list, "node_volumes", []) |
1353 | 06009e27 | Iustin Pop | |
1354 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_FAST)
|
1355 | 56aa9fd5 | Iustin Pop | def call_node_demote_from_mc(self, node): |
1356 | 56aa9fd5 | Iustin Pop | """Demote a node from the master candidate role.
|
1357 | 56aa9fd5 | Iustin Pop |
|
1358 | 56aa9fd5 | Iustin Pop | This is a single-node call.
|
1359 | 56aa9fd5 | Iustin Pop |
|
1360 | 56aa9fd5 | Iustin Pop | """
|
1361 | 56aa9fd5 | Iustin Pop | return self._SingleNodeCall(node, "node_demote_from_mc", []) |
1362 | 56aa9fd5 | Iustin Pop | |
1363 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1364 | f5118ade | Iustin Pop | def call_node_powercycle(self, node, hypervisor): |
1365 | f5118ade | Iustin Pop | """Tries to powercycle a node.
|
1366 | f5118ade | Iustin Pop |
|
1367 | f5118ade | Iustin Pop | This is a single-node call.
|
1368 | f5118ade | Iustin Pop |
|
1369 | f5118ade | Iustin Pop | """
|
1370 | f5118ade | Iustin Pop | return self._SingleNodeCall(node, "node_powercycle", [hypervisor]) |
1371 | f5118ade | Iustin Pop | |
1372 | 92fd2250 | Iustin Pop | @_RpcTimeout(None) |
1373 | 72737a7f | Iustin Pop | def call_test_delay(self, node_list, duration): |
1374 | 72737a7f | Iustin Pop | """Sleep for a fixed time on given node(s).
|
1375 | 06009e27 | Iustin Pop |
|
1376 | 72737a7f | Iustin Pop | This is a multi-node call.
|
1377 | 06009e27 | Iustin Pop |
|
1378 | 72737a7f | Iustin Pop | """
|
1379 | 92fd2250 | Iustin Pop | return self._MultiNodeCall(node_list, "test_delay", [duration], |
1380 | 92fd2250 | Iustin Pop | read_timeout=int(duration + 5)) |
1381 | 5e04ed8b | Manuel Franceschini | |
1382 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_FAST)
|
1383 | 72737a7f | Iustin Pop | def call_file_storage_dir_create(self, node, file_storage_dir): |
1384 | 72737a7f | Iustin Pop | """Create the given file storage directory.
|
1385 | 5e04ed8b | Manuel Franceschini |
|
1386 | 72737a7f | Iustin Pop | This is a single-node call.
|
1387 | 5e04ed8b | Manuel Franceschini |
|
1388 | 72737a7f | Iustin Pop | """
|
1389 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "file_storage_dir_create", |
1390 | 9a525d83 | Michael Hanselmann | [file_storage_dir]) |
1391 | 5e04ed8b | Manuel Franceschini | |
1392 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_FAST)
|
1393 | 72737a7f | Iustin Pop | def call_file_storage_dir_remove(self, node, file_storage_dir): |
1394 | 72737a7f | Iustin Pop | """Remove the given file storage directory.
|
1395 | 5e04ed8b | Manuel Franceschini |
|
1396 | 72737a7f | Iustin Pop | This is a single-node call.
|
1397 | 5e04ed8b | Manuel Franceschini |
|
1398 | 72737a7f | Iustin Pop | """
|
1399 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "file_storage_dir_remove", |
1400 | 9a525d83 | Michael Hanselmann | [file_storage_dir]) |
1401 | 5e04ed8b | Manuel Franceschini | |
1402 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_FAST)
|
1403 | 72737a7f | Iustin Pop | def call_file_storage_dir_rename(self, node, old_file_storage_dir, |
1404 | 72737a7f | Iustin Pop | new_file_storage_dir): |
1405 | 72737a7f | Iustin Pop | """Rename file storage directory.
|
1406 | 5e04ed8b | Manuel Franceschini |
|
1407 | 72737a7f | Iustin Pop | This is a single-node call.
|
1408 | 5e04ed8b | Manuel Franceschini |
|
1409 | 72737a7f | Iustin Pop | """
|
1410 | 9a525d83 | Michael Hanselmann | return self._SingleNodeCall(node, "file_storage_dir_rename", |
1411 | 9a525d83 | Michael Hanselmann | [old_file_storage_dir, new_file_storage_dir]) |
1412 | ca52cdeb | Michael Hanselmann | |
1413 | 9a525d83 | Michael Hanselmann | @classmethod
|
1414 | d2cd6944 | Iustin Pop | @_RpcTimeout(_TMO_URGENT)
|
1415 | 9a525d83 | Michael Hanselmann | def call_jobqueue_update(cls, node_list, address_list, file_name, content): |
1416 | 72737a7f | Iustin Pop | """Update job queue.
|
1417 | ca52cdeb | Michael Hanselmann |
|
1418 | 72737a7f | Iustin Pop | This is a multi-node call.
|
1419 | ca52cdeb | Michael Hanselmann |
|
1420 | 72737a7f | Iustin Pop | """
|
1421 | 9a525d83 | Michael Hanselmann | return cls._StaticMultiNodeCall(node_list, "jobqueue_update", |
1422 | 12bce260 | Michael Hanselmann | [file_name, cls._Compress(content)], |
1423 | 9a525d83 | Michael Hanselmann | address_list=address_list) |
1424 | ca52cdeb | Michael Hanselmann | |
1425 | 9a525d83 | Michael Hanselmann | @classmethod
|
1426 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1427 | 9a525d83 | Michael Hanselmann | def call_jobqueue_purge(cls, node): |
1428 | 72737a7f | Iustin Pop | """Purge job queue.
|
1429 | ca52cdeb | Michael Hanselmann |
|
1430 | 72737a7f | Iustin Pop | This is a single-node call.
|
1431 | ca52cdeb | Michael Hanselmann |
|
1432 | 72737a7f | Iustin Pop | """
|
1433 | 9a525d83 | Michael Hanselmann | return cls._StaticSingleNodeCall(node, "jobqueue_purge", []) |
1434 | af5ebcb1 | Michael Hanselmann | |
1435 | 9a525d83 | Michael Hanselmann | @classmethod
|
1436 | d2cd6944 | Iustin Pop | @_RpcTimeout(_TMO_URGENT)
|
1437 | dd875d32 | Michael Hanselmann | def call_jobqueue_rename(cls, node_list, address_list, rename): |
1438 | 72737a7f | Iustin Pop | """Rename a job queue file.
|
1439 | af5ebcb1 | Michael Hanselmann |
|
1440 | 72737a7f | Iustin Pop | This is a multi-node call.
|
1441 | af5ebcb1 | Michael Hanselmann |
|
1442 | 72737a7f | Iustin Pop | """
|
1443 | dd875d32 | Michael Hanselmann | return cls._StaticMultiNodeCall(node_list, "jobqueue_rename", rename, |
1444 | 9a525d83 | Michael Hanselmann | address_list=address_list) |
1445 | 6217e295 | Iustin Pop | |
1446 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1447 | 6217e295 | Iustin Pop | def call_hypervisor_validate_params(self, node_list, hvname, hvparams): |
1448 | 6217e295 | Iustin Pop | """Validate the hypervisor params.
|
1449 | 6217e295 | Iustin Pop |
|
1450 | 6217e295 | Iustin Pop | This is a multi-node call.
|
1451 | 6217e295 | Iustin Pop |
|
1452 | 6217e295 | Iustin Pop | @type node_list: list
|
1453 | 6217e295 | Iustin Pop | @param node_list: the list of nodes to query
|
1454 | 6217e295 | Iustin Pop | @type hvname: string
|
1455 | 6217e295 | Iustin Pop | @param hvname: the hypervisor name
|
1456 | 6217e295 | Iustin Pop | @type hvparams: dict
|
1457 | 6217e295 | Iustin Pop | @param hvparams: the hypervisor parameters to be validated
|
1458 | 6217e295 | Iustin Pop |
|
1459 | 6217e295 | Iustin Pop | """
|
1460 | 6217e295 | Iustin Pop | cluster = self._cfg.GetClusterInfo()
|
1461 | abe609b2 | Guido Trotter | hv_full = objects.FillDict(cluster.hvparams.get(hvname, {}), hvparams) |
1462 | 9a525d83 | Michael Hanselmann | return self._MultiNodeCall(node_list, "hypervisor_validate_params", |
1463 | 9a525d83 | Michael Hanselmann | [hvname, hv_full]) |
1464 | f942a838 | Michael Hanselmann | |
1465 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1466 | 37549316 | Michael Hanselmann | def call_x509_cert_create(self, node, validity): |
1467 | f942a838 | Michael Hanselmann | """Creates a new X509 certificate for SSL/TLS.
|
1468 | f942a838 | Michael Hanselmann |
|
1469 | f942a838 | Michael Hanselmann | This is a single-node call.
|
1470 | f942a838 | Michael Hanselmann |
|
1471 | f942a838 | Michael Hanselmann | @type validity: int
|
1472 | f942a838 | Michael Hanselmann | @param validity: Validity in seconds
|
1473 | f942a838 | Michael Hanselmann |
|
1474 | f942a838 | Michael Hanselmann | """
|
1475 | 37549316 | Michael Hanselmann | return self._SingleNodeCall(node, "x509_cert_create", [validity]) |
1476 | f942a838 | Michael Hanselmann | |
1477 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1478 | 37549316 | Michael Hanselmann | def call_x509_cert_remove(self, node, name): |
1479 | f942a838 | Michael Hanselmann | """Removes a X509 certificate.
|
1480 | f942a838 | Michael Hanselmann |
|
1481 | f942a838 | Michael Hanselmann | This is a single-node call.
|
1482 | f942a838 | Michael Hanselmann |
|
1483 | f942a838 | Michael Hanselmann | @type name: string
|
1484 | f942a838 | Michael Hanselmann | @param name: Certificate name
|
1485 | f942a838 | Michael Hanselmann |
|
1486 | f942a838 | Michael Hanselmann | """
|
1487 | 37549316 | Michael Hanselmann | return self._SingleNodeCall(node, "x509_cert_remove", [name]) |
1488 | 1651d116 | Michael Hanselmann | |
1489 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1490 | eb630f50 | Michael Hanselmann | def call_import_start(self, node, opts, instance, dest, dest_args): |
1491 | 1651d116 | Michael Hanselmann | """Starts a listener for an import.
|
1492 | 1651d116 | Michael Hanselmann |
|
1493 | 1651d116 | Michael Hanselmann | This is a single-node call.
|
1494 | 1651d116 | Michael Hanselmann |
|
1495 | 1651d116 | Michael Hanselmann | @type node: string
|
1496 | 1651d116 | Michael Hanselmann | @param node: Node name
|
1497 | 1651d116 | Michael Hanselmann | @type instance: C{objects.Instance}
|
1498 | 1651d116 | Michael Hanselmann | @param instance: Instance object
|
1499 | 1651d116 | Michael Hanselmann |
|
1500 | 1651d116 | Michael Hanselmann | """
|
1501 | ef40fbfb | Michael Hanselmann | return self._SingleNodeCall(node, "import_start", |
1502 | eb630f50 | Michael Hanselmann | [opts.ToDict(), |
1503 | 1651d116 | Michael Hanselmann | self._InstDict(instance), dest,
|
1504 | 1651d116 | Michael Hanselmann | _EncodeImportExportIO(dest, dest_args)]) |
1505 | 1651d116 | Michael Hanselmann | |
1506 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1507 | eb630f50 | Michael Hanselmann | def call_export_start(self, node, opts, host, port, |
1508 | 1651d116 | Michael Hanselmann | instance, source, source_args): |
1509 | 1651d116 | Michael Hanselmann | """Starts an export daemon.
|
1510 | 1651d116 | Michael Hanselmann |
|
1511 | 1651d116 | Michael Hanselmann | This is a single-node call.
|
1512 | 1651d116 | Michael Hanselmann |
|
1513 | 1651d116 | Michael Hanselmann | @type node: string
|
1514 | 1651d116 | Michael Hanselmann | @param node: Node name
|
1515 | 1651d116 | Michael Hanselmann | @type instance: C{objects.Instance}
|
1516 | 1651d116 | Michael Hanselmann | @param instance: Instance object
|
1517 | 1651d116 | Michael Hanselmann |
|
1518 | 1651d116 | Michael Hanselmann | """
|
1519 | ef40fbfb | Michael Hanselmann | return self._SingleNodeCall(node, "export_start", |
1520 | eb630f50 | Michael Hanselmann | [opts.ToDict(), host, port, |
1521 | 1651d116 | Michael Hanselmann | self._InstDict(instance), source,
|
1522 | 1651d116 | Michael Hanselmann | _EncodeImportExportIO(source, source_args)]) |
1523 | 1651d116 | Michael Hanselmann | |
1524 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_FAST)
|
1525 | ef40fbfb | Michael Hanselmann | def call_impexp_status(self, node, names): |
1526 | 1651d116 | Michael Hanselmann | """Gets the status of an import or export.
|
1527 | 1651d116 | Michael Hanselmann |
|
1528 | 1651d116 | Michael Hanselmann | This is a single-node call.
|
1529 | 1651d116 | Michael Hanselmann |
|
1530 | 1651d116 | Michael Hanselmann | @type node: string
|
1531 | 1651d116 | Michael Hanselmann | @param node: Node name
|
1532 | 1651d116 | Michael Hanselmann | @type names: List of strings
|
1533 | 1651d116 | Michael Hanselmann | @param names: Import/export names
|
1534 | 1651d116 | Michael Hanselmann | @rtype: List of L{objects.ImportExportStatus} instances
|
1535 | 1651d116 | Michael Hanselmann | @return: Returns a list of the state of each named import/export or None if
|
1536 | 1651d116 | Michael Hanselmann | a status couldn't be retrieved
|
1537 | 1651d116 | Michael Hanselmann |
|
1538 | 1651d116 | Michael Hanselmann | """
|
1539 | ef40fbfb | Michael Hanselmann | result = self._SingleNodeCall(node, "impexp_status", [names]) |
1540 | 1651d116 | Michael Hanselmann | |
1541 | 1651d116 | Michael Hanselmann | if not result.fail_msg: |
1542 | 1651d116 | Michael Hanselmann | decoded = [] |
1543 | 1651d116 | Michael Hanselmann | |
1544 | 1651d116 | Michael Hanselmann | for i in result.payload: |
1545 | 1651d116 | Michael Hanselmann | if i is None: |
1546 | 1651d116 | Michael Hanselmann | decoded.append(None)
|
1547 | 1651d116 | Michael Hanselmann | continue
|
1548 | 1651d116 | Michael Hanselmann | decoded.append(objects.ImportExportStatus.FromDict(i)) |
1549 | 1651d116 | Michael Hanselmann | |
1550 | 1651d116 | Michael Hanselmann | result.payload = decoded |
1551 | 1651d116 | Michael Hanselmann | |
1552 | 1651d116 | Michael Hanselmann | return result
|
1553 | 1651d116 | Michael Hanselmann | |
1554 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1555 | f81c4737 | Michael Hanselmann | def call_impexp_abort(self, node, name): |
1556 | f81c4737 | Michael Hanselmann | """Aborts an import or export.
|
1557 | f81c4737 | Michael Hanselmann |
|
1558 | f81c4737 | Michael Hanselmann | This is a single-node call.
|
1559 | f81c4737 | Michael Hanselmann |
|
1560 | f81c4737 | Michael Hanselmann | @type node: string
|
1561 | f81c4737 | Michael Hanselmann | @param node: Node name
|
1562 | f81c4737 | Michael Hanselmann | @type name: string
|
1563 | f81c4737 | Michael Hanselmann | @param name: Import/export name
|
1564 | f81c4737 | Michael Hanselmann |
|
1565 | f81c4737 | Michael Hanselmann | """
|
1566 | f81c4737 | Michael Hanselmann | return self._SingleNodeCall(node, "impexp_abort", [name]) |
1567 | f81c4737 | Michael Hanselmann | |
1568 | 92fd2250 | Iustin Pop | @_RpcTimeout(_TMO_NORMAL)
|
1569 | ef40fbfb | Michael Hanselmann | def call_impexp_cleanup(self, node, name): |
1570 | 1651d116 | Michael Hanselmann | """Cleans up after an import or export.
|
1571 | 1651d116 | Michael Hanselmann |
|
1572 | 1651d116 | Michael Hanselmann | This is a single-node call.
|
1573 | 1651d116 | Michael Hanselmann |
|
1574 | 1651d116 | Michael Hanselmann | @type node: string
|
1575 | 1651d116 | Michael Hanselmann | @param node: Node name
|
1576 | 1651d116 | Michael Hanselmann | @type name: string
|
1577 | 1651d116 | Michael Hanselmann | @param name: Import/export name
|
1578 | 1651d116 | Michael Hanselmann |
|
1579 | 1651d116 | Michael Hanselmann | """
|
1580 | ef40fbfb | Michael Hanselmann | return self._SingleNodeCall(node, "impexp_cleanup", [name]) |