Statistics
| Branch: | Tag: | Revision:

root / lib / rpc.py @ 2f31098c

History | View | Annotate | Download (18.4 kB)

1 2f31098c Iustin Pop
#
2 a8083063 Iustin Pop
#
3 a8083063 Iustin Pop
4 a8083063 Iustin Pop
# Copyright (C) 2006, 2007 Google Inc.
5 a8083063 Iustin Pop
#
6 a8083063 Iustin Pop
# This program is free software; you can redistribute it and/or modify
7 a8083063 Iustin Pop
# it under the terms of the GNU General Public License as published by
8 a8083063 Iustin Pop
# the Free Software Foundation; either version 2 of the License, or
9 a8083063 Iustin Pop
# (at your option) any later version.
10 a8083063 Iustin Pop
#
11 a8083063 Iustin Pop
# This program is distributed in the hope that it will be useful, but
12 a8083063 Iustin Pop
# WITHOUT ANY WARRANTY; without even the implied warranty of
13 a8083063 Iustin Pop
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14 a8083063 Iustin Pop
# General Public License for more details.
15 a8083063 Iustin Pop
#
16 a8083063 Iustin Pop
# You should have received a copy of the GNU General Public License
17 a8083063 Iustin Pop
# along with this program; if not, write to the Free Software
18 a8083063 Iustin Pop
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
19 a8083063 Iustin Pop
# 02110-1301, USA.
20 a8083063 Iustin Pop
21 a8083063 Iustin Pop
22 a8083063 Iustin Pop
"""Script to show add a new node to the cluster
23 a8083063 Iustin Pop

24 a8083063 Iustin Pop
"""
25 a8083063 Iustin Pop
26 a8083063 Iustin Pop
# pylint: disable-msg=C0103
27 a8083063 Iustin Pop
28 a8083063 Iustin Pop
import os
29 a8083063 Iustin Pop
30 a8083063 Iustin Pop
from twisted.internet.pollreactor import PollReactor
31 a8083063 Iustin Pop
32 a8083063 Iustin Pop
class ReReactor(PollReactor):
33 098c0958 Michael Hanselmann
  """A re-startable Reactor implementation.
34 a8083063 Iustin Pop

35 098c0958 Michael Hanselmann
  """
36 a8083063 Iustin Pop
  def run(self, installSignalHandlers=1):
37 a8083063 Iustin Pop
    """Custom run method.
38 a8083063 Iustin Pop

39 a8083063 Iustin Pop
    This is customized run that, before calling Reactor.run, will
40 a8083063 Iustin Pop
    reinstall the shutdown events and re-create the threadpool in case
41 a8083063 Iustin Pop
    these are not present (as will happen on the second run of the
42 a8083063 Iustin Pop
    reactor).
43 a8083063 Iustin Pop

44 a8083063 Iustin Pop
    """
45 a8083063 Iustin Pop
    if not 'shutdown' in self._eventTriggers:
46 a8083063 Iustin Pop
      # the shutdown queue has been killed, we are most probably
47 a8083063 Iustin Pop
      # at the second run, thus recreate the queue
48 a8083063 Iustin Pop
      self.addSystemEventTrigger('during', 'shutdown', self.crash)
49 a8083063 Iustin Pop
      self.addSystemEventTrigger('during', 'shutdown', self.disconnectAll)
50 a8083063 Iustin Pop
    if self.threadpool is not None and self.threadpool.joined == 1:
51 a8083063 Iustin Pop
      # in case the threadpool has been stopped, re-start it
52 a8083063 Iustin Pop
      # and add a trigger to stop it at reactor shutdown
53 a8083063 Iustin Pop
      self.threadpool.start()
54 a8083063 Iustin Pop
      self.addSystemEventTrigger('during', 'shutdown', self.threadpool.stop)
55 a8083063 Iustin Pop
56 a8083063 Iustin Pop
    return PollReactor.run(self, installSignalHandlers)
57 a8083063 Iustin Pop
58 a8083063 Iustin Pop
59 a8083063 Iustin Pop
import twisted.internet.main
60 a8083063 Iustin Pop
twisted.internet.main.installReactor(ReReactor())
61 a8083063 Iustin Pop
62 a8083063 Iustin Pop
from twisted.spread import pb
63 a8083063 Iustin Pop
from twisted.internet import reactor
64 a8083063 Iustin Pop
from twisted.cred import credentials
65 a8083063 Iustin Pop
from OpenSSL import SSL, crypto
66 a8083063 Iustin Pop
67 a8083063 Iustin Pop
from ganeti import logger
68 a8083063 Iustin Pop
from ganeti import utils
69 a8083063 Iustin Pop
from ganeti import errors
70 a8083063 Iustin Pop
from ganeti import constants
71 a8083063 Iustin Pop
from ganeti import objects
72 a8083063 Iustin Pop
from ganeti import ssconf
73 a8083063 Iustin Pop
74 a8083063 Iustin Pop
class NodeController:
75 a8083063 Iustin Pop
  """Node-handling class.
76 a8083063 Iustin Pop

77 a8083063 Iustin Pop
  For each node that we speak with, we create an instance of this
78 a8083063 Iustin Pop
  class, so that we have a safe place to store the details of this
79 a8083063 Iustin Pop
  individual call.
80 a8083063 Iustin Pop

81 a8083063 Iustin Pop
  """
82 a8083063 Iustin Pop
  def __init__(self, parent, node):
83 a8083063 Iustin Pop
    self.parent = parent
84 a8083063 Iustin Pop
    self.node = node
85 a8083063 Iustin Pop
86 a8083063 Iustin Pop
  def _check_end(self):
87 a8083063 Iustin Pop
    """Stop the reactor if we got all the results.
88 a8083063 Iustin Pop

89 a8083063 Iustin Pop
    """
90 a8083063 Iustin Pop
    if len(self.parent.results) == len(self.parent.nc):
91 a8083063 Iustin Pop
      reactor.stop()
92 a8083063 Iustin Pop
93 a8083063 Iustin Pop
  def cb_call(self, obj):
94 31ee599c Michael Hanselmann
    """Callback for successful connect.
95 a8083063 Iustin Pop

96 a8083063 Iustin Pop
    If the connect and login sequence succeeded, we proceed with
97 a8083063 Iustin Pop
    making the actual call.
98 a8083063 Iustin Pop

99 a8083063 Iustin Pop
    """
100 a8083063 Iustin Pop
    deferred = obj.callRemote(self.parent.procedure, self.parent.args)
101 a8083063 Iustin Pop
    deferred.addCallbacks(self.cb_done, self.cb_err2)
102 a8083063 Iustin Pop
103 a8083063 Iustin Pop
  def cb_done(self, result):
104 a8083063 Iustin Pop
    """Callback for successful call.
105 a8083063 Iustin Pop

106 a8083063 Iustin Pop
    When we receive the result from a call, we check if it was an
107 a8083063 Iustin Pop
    error and if so we raise a generic RemoteError (we can't pass yet
108 a8083063 Iustin Pop
    the actual exception over). If there was no error, we store the
109 a8083063 Iustin Pop
    result.
110 a8083063 Iustin Pop

111 a8083063 Iustin Pop
    """
112 a8083063 Iustin Pop
    tb, self.parent.results[self.node] = result
113 a8083063 Iustin Pop
    self._check_end()
114 a8083063 Iustin Pop
    if tb:
115 a8083063 Iustin Pop
      raise errors.RemoteError("Remote procedure error calling %s on %s:"
116 a8083063 Iustin Pop
                               "\n%s" % (self.parent.procedure,
117 a8083063 Iustin Pop
                                         self.node,
118 a8083063 Iustin Pop
                                         tb))
119 a8083063 Iustin Pop
120 a8083063 Iustin Pop
  def cb_err1(self, reason):
121 a8083063 Iustin Pop
    """Error callback for unsuccessful connect.
122 a8083063 Iustin Pop

123 a8083063 Iustin Pop
    """
124 a8083063 Iustin Pop
    logger.Error("caller_connect: could not connect to remote host %s,"
125 a8083063 Iustin Pop
                 " reason %s" % (self.node, reason))
126 a8083063 Iustin Pop
    self.parent.results[self.node] = False
127 a8083063 Iustin Pop
    self._check_end()
128 a8083063 Iustin Pop
129 a8083063 Iustin Pop
  def cb_err2(self, reason):
130 a8083063 Iustin Pop
    """Error callback for unsuccessful call.
131 a8083063 Iustin Pop

132 a8083063 Iustin Pop
    This is when the call didn't return anything, not even an error,
133 a8083063 Iustin Pop
    or when it time out, etc.
134 a8083063 Iustin Pop

135 a8083063 Iustin Pop
    """
136 a8083063 Iustin Pop
    logger.Error("caller_call: could not call %s on node %s,"
137 a8083063 Iustin Pop
                 " reason %s" % (self.parent.procedure, self.node, reason))
138 a8083063 Iustin Pop
    self.parent.results[self.node] = False
139 a8083063 Iustin Pop
    self._check_end()
140 a8083063 Iustin Pop
141 a8083063 Iustin Pop
142 a8083063 Iustin Pop
class MirrorContextFactory:
143 a8083063 Iustin Pop
  """Certificate verifier factory.
144 a8083063 Iustin Pop

145 a8083063 Iustin Pop
  This factory creates contexts that verify if the remote end has a
146 a8083063 Iustin Pop
  specific certificate (i.e. our own certificate).
147 a8083063 Iustin Pop

148 a8083063 Iustin Pop
  The checks we do are that the PEM dump of the certificate is the
149 a8083063 Iustin Pop
  same as our own and (somewhat redundantly) that the SHA checksum is
150 a8083063 Iustin Pop
  the same.
151 a8083063 Iustin Pop

152 a8083063 Iustin Pop
  """
153 a8083063 Iustin Pop
  isClient = 1
154 a8083063 Iustin Pop
155 a8083063 Iustin Pop
  def __init__(self):
156 a8083063 Iustin Pop
    try:
157 a8083063 Iustin Pop
      fd = open(constants.SSL_CERT_FILE, 'r')
158 a8083063 Iustin Pop
      try:
159 a8083063 Iustin Pop
        data = fd.read(16384)
160 a8083063 Iustin Pop
      finally:
161 a8083063 Iustin Pop
        fd.close()
162 a8083063 Iustin Pop
    except EnvironmentError, err:
163 3ecf6786 Iustin Pop
      raise errors.ConfigurationError("missing SSL certificate: %s" %
164 3ecf6786 Iustin Pop
                                      str(err))
165 a8083063 Iustin Pop
    self.mycert = crypto.load_certificate(crypto.FILETYPE_PEM, data)
166 a8083063 Iustin Pop
    self.mypem = crypto.dump_certificate(crypto.FILETYPE_PEM, self.mycert)
167 a8083063 Iustin Pop
    self.mydigest = self.mycert.digest('SHA')
168 a8083063 Iustin Pop
169 a8083063 Iustin Pop
  def verifier(self, conn, x509, errno, err_depth, retcode):
170 a8083063 Iustin Pop
    """Certificate verify method.
171 a8083063 Iustin Pop

172 a8083063 Iustin Pop
    """
173 a8083063 Iustin Pop
    if self.mydigest != x509.digest('SHA'):
174 a8083063 Iustin Pop
      return False
175 a8083063 Iustin Pop
    if crypto.dump_certificate(crypto.FILETYPE_PEM, x509) != self.mypem:
176 a8083063 Iustin Pop
      return False
177 a8083063 Iustin Pop
    return True
178 a8083063 Iustin Pop
179 a8083063 Iustin Pop
  def getContext(self):
180 a8083063 Iustin Pop
    """Context generator.
181 a8083063 Iustin Pop

182 a8083063 Iustin Pop
    """
183 a8083063 Iustin Pop
    context = SSL.Context(SSL.TLSv1_METHOD)
184 a8083063 Iustin Pop
    context.set_verify(SSL.VERIFY_PEER, self.verifier)
185 a8083063 Iustin Pop
    return context
186 a8083063 Iustin Pop
187 a8083063 Iustin Pop
class Client:
188 a8083063 Iustin Pop
  """RPC Client class.
189 a8083063 Iustin Pop

190 a8083063 Iustin Pop
  This class, given a (remote) ethod name, a list of parameters and a
191 a8083063 Iustin Pop
  list of nodes, will contact (in parallel) all nodes, and return a
192 a8083063 Iustin Pop
  dict of results (key: node name, value: result).
193 a8083063 Iustin Pop

194 a8083063 Iustin Pop
  One current bug is that generic failure is still signalled by
195 a8083063 Iustin Pop
  'False' result, which is not good. This overloading of values can
196 a8083063 Iustin Pop
  cause bugs.
197 a8083063 Iustin Pop

198 a8083063 Iustin Pop
  """
199 a8083063 Iustin Pop
  result_set = False
200 a8083063 Iustin Pop
  result = False
201 a8083063 Iustin Pop
  allresult = []
202 a8083063 Iustin Pop
203 a8083063 Iustin Pop
  def __init__(self, procedure, args):
204 a8083063 Iustin Pop
    ss = ssconf.SimpleStore()
205 a8083063 Iustin Pop
    self.port = ss.GetNodeDaemonPort()
206 a8083063 Iustin Pop
    self.nodepw = ss.GetNodeDaemonPassword()
207 a8083063 Iustin Pop
    self.nc = {}
208 a8083063 Iustin Pop
    self.results = {}
209 a8083063 Iustin Pop
    self.procedure = procedure
210 a8083063 Iustin Pop
    self.args = args
211 a8083063 Iustin Pop
212 a8083063 Iustin Pop
  #--- generic connector -------------
213 a8083063 Iustin Pop
214 a8083063 Iustin Pop
  def connect_list(self, node_list):
215 a8083063 Iustin Pop
    """Add a list of nodes to the target nodes.
216 a8083063 Iustin Pop

217 a8083063 Iustin Pop
    """
218 a8083063 Iustin Pop
    for node in node_list:
219 a8083063 Iustin Pop
      self.connect(node)
220 a8083063 Iustin Pop
221 a8083063 Iustin Pop
  def connect(self, connect_node):
222 a8083063 Iustin Pop
    """Add a node to the target list.
223 a8083063 Iustin Pop

224 a8083063 Iustin Pop
    """
225 a8083063 Iustin Pop
    factory = pb.PBClientFactory()
226 a8083063 Iustin Pop
    self.nc[connect_node] = nc = NodeController(self, connect_node)
227 a8083063 Iustin Pop
    reactor.connectSSL(connect_node, self.port, factory,
228 a8083063 Iustin Pop
                       MirrorContextFactory())
229 a8083063 Iustin Pop
    #d = factory.getRootObject()
230 a8083063 Iustin Pop
    d = factory.login(credentials.UsernamePassword("master_node", self.nodepw))
231 a8083063 Iustin Pop
    d.addCallbacks(nc.cb_call, nc.cb_err1)
232 a8083063 Iustin Pop
233 a8083063 Iustin Pop
  def getresult(self):
234 a8083063 Iustin Pop
    """Return the results of the call.
235 a8083063 Iustin Pop

236 a8083063 Iustin Pop
    """
237 a8083063 Iustin Pop
    return self.results
238 a8083063 Iustin Pop
239 a8083063 Iustin Pop
  def run(self):
240 a8083063 Iustin Pop
    """Wrapper over reactor.run().
241 a8083063 Iustin Pop

242 a8083063 Iustin Pop
    This function simply calls reactor.run() if we have any requests
243 a8083063 Iustin Pop
    queued, otherwise it does nothing.
244 a8083063 Iustin Pop

245 a8083063 Iustin Pop
    """
246 a8083063 Iustin Pop
    if self.nc:
247 a8083063 Iustin Pop
      reactor.run()
248 a8083063 Iustin Pop
249 a8083063 Iustin Pop
250 a8083063 Iustin Pop
def call_volume_list(node_list, vg_name):
251 a8083063 Iustin Pop
  """Gets the logical volumes present in a given volume group.
252 a8083063 Iustin Pop

253 a8083063 Iustin Pop
  This is a multi-node call.
254 a8083063 Iustin Pop

255 a8083063 Iustin Pop
  """
256 a8083063 Iustin Pop
  c = Client("volume_list", [vg_name])
257 a8083063 Iustin Pop
  c.connect_list(node_list)
258 a8083063 Iustin Pop
  c.run()
259 a8083063 Iustin Pop
  return c.getresult()
260 a8083063 Iustin Pop
261 a8083063 Iustin Pop
262 a8083063 Iustin Pop
def call_vg_list(node_list):
263 a8083063 Iustin Pop
  """Gets the volume group list.
264 a8083063 Iustin Pop

265 a8083063 Iustin Pop
  This is a multi-node call.
266 a8083063 Iustin Pop

267 a8083063 Iustin Pop
  """
268 a8083063 Iustin Pop
  c = Client("vg_list", [])
269 a8083063 Iustin Pop
  c.connect_list(node_list)
270 a8083063 Iustin Pop
  c.run()
271 a8083063 Iustin Pop
  return c.getresult()
272 a8083063 Iustin Pop
273 a8083063 Iustin Pop
274 a8083063 Iustin Pop
def call_bridges_exist(node, bridges_list):
275 a8083063 Iustin Pop
  """Checks if a node has all the bridges given.
276 a8083063 Iustin Pop

277 a8083063 Iustin Pop
  This method checks if all bridges given in the bridges_list are
278 a8083063 Iustin Pop
  present on the remote node, so that an instance that uses interfaces
279 a8083063 Iustin Pop
  on those bridges can be started.
280 a8083063 Iustin Pop

281 a8083063 Iustin Pop
  This is a single-node call.
282 a8083063 Iustin Pop

283 a8083063 Iustin Pop
  """
284 a8083063 Iustin Pop
  c = Client("bridges_exist", [bridges_list])
285 a8083063 Iustin Pop
  c.connect(node)
286 a8083063 Iustin Pop
  c.run()
287 a8083063 Iustin Pop
  return c.getresult().get(node, False)
288 a8083063 Iustin Pop
289 a8083063 Iustin Pop
290 a8083063 Iustin Pop
def call_instance_start(node, instance, extra_args):
291 a8083063 Iustin Pop
  """Stars an instance.
292 a8083063 Iustin Pop

293 a8083063 Iustin Pop
  This is a single-node call.
294 a8083063 Iustin Pop

295 a8083063 Iustin Pop
  """
296 319856a9 Michael Hanselmann
  c = Client("instance_start", [instance.ToDict(), extra_args])
297 a8083063 Iustin Pop
  c.connect(node)
298 a8083063 Iustin Pop
  c.run()
299 a8083063 Iustin Pop
  return c.getresult().get(node, False)
300 a8083063 Iustin Pop
301 a8083063 Iustin Pop
302 a8083063 Iustin Pop
def call_instance_shutdown(node, instance):
303 a8083063 Iustin Pop
  """Stops an instance.
304 a8083063 Iustin Pop

305 a8083063 Iustin Pop
  This is a single-node call.
306 a8083063 Iustin Pop

307 a8083063 Iustin Pop
  """
308 319856a9 Michael Hanselmann
  c = Client("instance_shutdown", [instance.ToDict()])
309 a8083063 Iustin Pop
  c.connect(node)
310 a8083063 Iustin Pop
  c.run()
311 a8083063 Iustin Pop
  return c.getresult().get(node, False)
312 a8083063 Iustin Pop
313 a8083063 Iustin Pop
314 a8083063 Iustin Pop
def call_instance_os_add(node, inst, osdev, swapdev):
315 a8083063 Iustin Pop
  """Installs an OS on the given instance.
316 a8083063 Iustin Pop

317 a8083063 Iustin Pop
  This is a single-node call.
318 a8083063 Iustin Pop

319 a8083063 Iustin Pop
  """
320 319856a9 Michael Hanselmann
  params = [inst.ToDict(), osdev, swapdev]
321 a8083063 Iustin Pop
  c = Client("instance_os_add", params)
322 a8083063 Iustin Pop
  c.connect(node)
323 a8083063 Iustin Pop
  c.run()
324 a8083063 Iustin Pop
  return c.getresult().get(node, False)
325 a8083063 Iustin Pop
326 a8083063 Iustin Pop
327 decd5f45 Iustin Pop
def call_instance_run_rename(node, inst, old_name, osdev, swapdev):
328 decd5f45 Iustin Pop
  """Run the OS rename script for an instance.
329 decd5f45 Iustin Pop

330 decd5f45 Iustin Pop
  This is a single-node call.
331 decd5f45 Iustin Pop

332 decd5f45 Iustin Pop
  """
333 319856a9 Michael Hanselmann
  params = [inst.ToDict(), old_name, osdev, swapdev]
334 decd5f45 Iustin Pop
  c = Client("instance_run_rename", params)
335 decd5f45 Iustin Pop
  c.connect(node)
336 decd5f45 Iustin Pop
  c.run()
337 decd5f45 Iustin Pop
  return c.getresult().get(node, False)
338 decd5f45 Iustin Pop
339 decd5f45 Iustin Pop
340 a8083063 Iustin Pop
def call_instance_info(node, instance):
341 a8083063 Iustin Pop
  """Returns information about a single instance.
342 a8083063 Iustin Pop

343 a8083063 Iustin Pop
  This is a single-node call.
344 a8083063 Iustin Pop

345 a8083063 Iustin Pop
  """
346 a8083063 Iustin Pop
  c = Client("instance_info", [instance])
347 a8083063 Iustin Pop
  c.connect(node)
348 a8083063 Iustin Pop
  c.run()
349 a8083063 Iustin Pop
  return c.getresult().get(node, False)
350 a8083063 Iustin Pop
351 a8083063 Iustin Pop
352 a8083063 Iustin Pop
def call_all_instances_info(node_list):
353 a8083063 Iustin Pop
  """Returns information about all instances on a given node.
354 a8083063 Iustin Pop

355 a8083063 Iustin Pop
  This is a single-node call.
356 a8083063 Iustin Pop

357 a8083063 Iustin Pop
  """
358 a8083063 Iustin Pop
  c = Client("all_instances_info", [])
359 a8083063 Iustin Pop
  c.connect_list(node_list)
360 a8083063 Iustin Pop
  c.run()
361 a8083063 Iustin Pop
  return c.getresult()
362 a8083063 Iustin Pop
363 a8083063 Iustin Pop
364 a8083063 Iustin Pop
def call_instance_list(node_list):
365 a8083063 Iustin Pop
  """Returns the list of running instances on a given node.
366 a8083063 Iustin Pop

367 a8083063 Iustin Pop
  This is a single-node call.
368 a8083063 Iustin Pop

369 a8083063 Iustin Pop
  """
370 a8083063 Iustin Pop
  c = Client("instance_list", [])
371 a8083063 Iustin Pop
  c.connect_list(node_list)
372 a8083063 Iustin Pop
  c.run()
373 a8083063 Iustin Pop
  return c.getresult()
374 a8083063 Iustin Pop
375 a8083063 Iustin Pop
376 a8083063 Iustin Pop
def call_node_info(node_list, vg_name):
377 a8083063 Iustin Pop
  """Return node information.
378 a8083063 Iustin Pop

379 a8083063 Iustin Pop
  This will return memory information and volume group size and free
380 a8083063 Iustin Pop
  space.
381 a8083063 Iustin Pop

382 a8083063 Iustin Pop
  This is a multi-node call.
383 a8083063 Iustin Pop

384 a8083063 Iustin Pop
  """
385 a8083063 Iustin Pop
  c = Client("node_info", [vg_name])
386 a8083063 Iustin Pop
  c.connect_list(node_list)
387 a8083063 Iustin Pop
  c.run()
388 a8083063 Iustin Pop
  retux = c.getresult()
389 a8083063 Iustin Pop
390 a8083063 Iustin Pop
  for node_name in retux:
391 a8083063 Iustin Pop
    ret = retux.get(node_name, False)
392 a8083063 Iustin Pop
    if type(ret) != dict:
393 a8083063 Iustin Pop
      logger.Error("could not connect to node %s" % (node_name))
394 a8083063 Iustin Pop
      ret = {}
395 a8083063 Iustin Pop
396 a8083063 Iustin Pop
    utils.CheckDict(ret,
397 a8083063 Iustin Pop
                    { 'memory_total' : '-',
398 a8083063 Iustin Pop
                      'memory_dom0' : '-',
399 a8083063 Iustin Pop
                      'memory_free' : '-',
400 a8083063 Iustin Pop
                      'vg_size' : 'node_unreachable',
401 a8083063 Iustin Pop
                      'vg_free' : '-' },
402 a8083063 Iustin Pop
                    "call_node_info",
403 a8083063 Iustin Pop
                    )
404 a8083063 Iustin Pop
  return retux
405 a8083063 Iustin Pop
406 a8083063 Iustin Pop
407 a8083063 Iustin Pop
def call_node_add(node, dsa, dsapub, rsa, rsapub, ssh, sshpub):
408 a8083063 Iustin Pop
  """Add a node to the cluster.
409 a8083063 Iustin Pop

410 a8083063 Iustin Pop
  This is a single-node call.
411 a8083063 Iustin Pop

412 a8083063 Iustin Pop
  """
413 a8083063 Iustin Pop
  params = [dsa, dsapub, rsa, rsapub, ssh, sshpub]
414 a8083063 Iustin Pop
  c = Client("node_add", params)
415 a8083063 Iustin Pop
  c.connect(node)
416 a8083063 Iustin Pop
  c.run()
417 a8083063 Iustin Pop
  return c.getresult().get(node, False)
418 a8083063 Iustin Pop
419 a8083063 Iustin Pop
420 a8083063 Iustin Pop
def call_node_verify(node_list, checkdict):
421 a8083063 Iustin Pop
  """Request verification of given parameters.
422 a8083063 Iustin Pop

423 a8083063 Iustin Pop
  This is a multi-node call.
424 a8083063 Iustin Pop

425 a8083063 Iustin Pop
  """
426 a8083063 Iustin Pop
  c = Client("node_verify", [checkdict])
427 a8083063 Iustin Pop
  c.connect_list(node_list)
428 a8083063 Iustin Pop
  c.run()
429 a8083063 Iustin Pop
  return c.getresult()
430 a8083063 Iustin Pop
431 a8083063 Iustin Pop
432 a8083063 Iustin Pop
def call_node_start_master(node):
433 a8083063 Iustin Pop
  """Tells a node to activate itself as a master.
434 a8083063 Iustin Pop

435 a8083063 Iustin Pop
  This is a single-node call.
436 a8083063 Iustin Pop

437 a8083063 Iustin Pop
  """
438 a8083063 Iustin Pop
  c = Client("node_start_master", [])
439 a8083063 Iustin Pop
  c.connect(node)
440 a8083063 Iustin Pop
  c.run()
441 a8083063 Iustin Pop
  return c.getresult().get(node, False)
442 a8083063 Iustin Pop
443 a8083063 Iustin Pop
444 a8083063 Iustin Pop
def call_node_stop_master(node):
445 a8083063 Iustin Pop
  """Tells a node to demote itself from master status.
446 a8083063 Iustin Pop

447 a8083063 Iustin Pop
  This is a single-node call.
448 a8083063 Iustin Pop

449 a8083063 Iustin Pop
  """
450 a8083063 Iustin Pop
  c = Client("node_stop_master", [])
451 a8083063 Iustin Pop
  c.connect(node)
452 a8083063 Iustin Pop
  c.run()
453 a8083063 Iustin Pop
  return c.getresult().get(node, False)
454 a8083063 Iustin Pop
455 a8083063 Iustin Pop
456 a8083063 Iustin Pop
def call_version(node_list):
457 a8083063 Iustin Pop
  """Query node version.
458 a8083063 Iustin Pop

459 a8083063 Iustin Pop
  This is a multi-node call.
460 a8083063 Iustin Pop

461 a8083063 Iustin Pop
  """
462 a8083063 Iustin Pop
  c = Client("version", [])
463 a8083063 Iustin Pop
  c.connect_list(node_list)
464 a8083063 Iustin Pop
  c.run()
465 a8083063 Iustin Pop
  return c.getresult()
466 a8083063 Iustin Pop
467 a8083063 Iustin Pop
468 a0c3fea1 Michael Hanselmann
def call_blockdev_create(node, bdev, size, on_primary, info):
469 a8083063 Iustin Pop
  """Request creation of a given block device.
470 a8083063 Iustin Pop

471 a8083063 Iustin Pop
  This is a single-node call.
472 a8083063 Iustin Pop

473 a8083063 Iustin Pop
  """
474 319856a9 Michael Hanselmann
  params = [bdev.ToDict(), size, on_primary, info]
475 a8083063 Iustin Pop
  c = Client("blockdev_create", params)
476 a8083063 Iustin Pop
  c.connect(node)
477 a8083063 Iustin Pop
  c.run()
478 a8083063 Iustin Pop
  return c.getresult().get(node, False)
479 a8083063 Iustin Pop
480 a8083063 Iustin Pop
481 a8083063 Iustin Pop
def call_blockdev_remove(node, bdev):
482 a8083063 Iustin Pop
  """Request removal of a given block device.
483 a8083063 Iustin Pop

484 a8083063 Iustin Pop
  This is a single-node call.
485 a8083063 Iustin Pop

486 a8083063 Iustin Pop
  """
487 319856a9 Michael Hanselmann
  c = Client("blockdev_remove", [bdev.ToDict()])
488 a8083063 Iustin Pop
  c.connect(node)
489 a8083063 Iustin Pop
  c.run()
490 a8083063 Iustin Pop
  return c.getresult().get(node, False)
491 a8083063 Iustin Pop
492 a8083063 Iustin Pop
493 a8083063 Iustin Pop
def call_blockdev_assemble(node, disk, on_primary):
494 a8083063 Iustin Pop
  """Request assembling of a given block device.
495 a8083063 Iustin Pop

496 a8083063 Iustin Pop
  This is a single-node call.
497 a8083063 Iustin Pop

498 a8083063 Iustin Pop
  """
499 319856a9 Michael Hanselmann
  params = [disk.ToDict(), on_primary]
500 a8083063 Iustin Pop
  c = Client("blockdev_assemble", params)
501 a8083063 Iustin Pop
  c.connect(node)
502 a8083063 Iustin Pop
  c.run()
503 a8083063 Iustin Pop
  return c.getresult().get(node, False)
504 a8083063 Iustin Pop
505 a8083063 Iustin Pop
506 a8083063 Iustin Pop
def call_blockdev_shutdown(node, disk):
507 a8083063 Iustin Pop
  """Request shutdown of a given block device.
508 a8083063 Iustin Pop

509 a8083063 Iustin Pop
  This is a single-node call.
510 a8083063 Iustin Pop

511 a8083063 Iustin Pop
  """
512 319856a9 Michael Hanselmann
  c = Client("blockdev_shutdown", [disk.ToDict()])
513 a8083063 Iustin Pop
  c.connect(node)
514 a8083063 Iustin Pop
  c.run()
515 a8083063 Iustin Pop
  return c.getresult().get(node, False)
516 a8083063 Iustin Pop
517 a8083063 Iustin Pop
518 a8083063 Iustin Pop
def call_blockdev_addchild(node, bdev, ndev):
519 a8083063 Iustin Pop
  """Request adding a new child to a (mirroring) device.
520 a8083063 Iustin Pop

521 a8083063 Iustin Pop
  This is a single-node call.
522 a8083063 Iustin Pop

523 a8083063 Iustin Pop
  """
524 319856a9 Michael Hanselmann
  params = [bdev.ToDict(), ndev.ToDict()]
525 a8083063 Iustin Pop
  c = Client("blockdev_addchild", params)
526 a8083063 Iustin Pop
  c.connect(node)
527 a8083063 Iustin Pop
  c.run()
528 a8083063 Iustin Pop
  return c.getresult().get(node, False)
529 a8083063 Iustin Pop
530 a8083063 Iustin Pop
531 a8083063 Iustin Pop
def call_blockdev_removechild(node, bdev, ndev):
532 a8083063 Iustin Pop
  """Request removing a new child from a (mirroring) device.
533 a8083063 Iustin Pop

534 a8083063 Iustin Pop
  This is a single-node call.
535 a8083063 Iustin Pop

536 a8083063 Iustin Pop
  """
537 319856a9 Michael Hanselmann
  params = [bdev.ToDict(), ndev.ToDict()]
538 a8083063 Iustin Pop
  c = Client("blockdev_removechild", params)
539 a8083063 Iustin Pop
  c.connect(node)
540 a8083063 Iustin Pop
  c.run()
541 a8083063 Iustin Pop
  return c.getresult().get(node, False)
542 a8083063 Iustin Pop
543 a8083063 Iustin Pop
544 a8083063 Iustin Pop
def call_blockdev_getmirrorstatus(node, disks):
545 a8083063 Iustin Pop
  """Request status of a (mirroring) device.
546 a8083063 Iustin Pop

547 a8083063 Iustin Pop
  This is a single-node call.
548 a8083063 Iustin Pop

549 a8083063 Iustin Pop
  """
550 319856a9 Michael Hanselmann
  params = [dsk.ToDict() for dsk in disks]
551 a8083063 Iustin Pop
  c = Client("blockdev_getmirrorstatus", params)
552 a8083063 Iustin Pop
  c.connect(node)
553 a8083063 Iustin Pop
  c.run()
554 a8083063 Iustin Pop
  return c.getresult().get(node, False)
555 a8083063 Iustin Pop
556 a8083063 Iustin Pop
557 a8083063 Iustin Pop
def call_blockdev_find(node, disk):
558 a8083063 Iustin Pop
  """Request identification of a given block device.
559 a8083063 Iustin Pop

560 a8083063 Iustin Pop
  This is a single-node call.
561 a8083063 Iustin Pop

562 a8083063 Iustin Pop
  """
563 319856a9 Michael Hanselmann
  c = Client("blockdev_find", [disk.ToDict()])
564 a8083063 Iustin Pop
  c.connect(node)
565 a8083063 Iustin Pop
  c.run()
566 a8083063 Iustin Pop
  return c.getresult().get(node, False)
567 a8083063 Iustin Pop
568 a8083063 Iustin Pop
569 a8083063 Iustin Pop
def call_upload_file(node_list, file_name):
570 a8083063 Iustin Pop
  """Upload a file.
571 a8083063 Iustin Pop

572 a8083063 Iustin Pop
  The node will refuse the operation in case the file is not on the
573 a8083063 Iustin Pop
  approved file list.
574 a8083063 Iustin Pop

575 a8083063 Iustin Pop
  This is a multi-node call.
576 a8083063 Iustin Pop

577 a8083063 Iustin Pop
  """
578 a8083063 Iustin Pop
  fh = file(file_name)
579 a8083063 Iustin Pop
  try:
580 a8083063 Iustin Pop
    data = fh.read()
581 a8083063 Iustin Pop
  finally:
582 a8083063 Iustin Pop
    fh.close()
583 a8083063 Iustin Pop
  st = os.stat(file_name)
584 a8083063 Iustin Pop
  params = [file_name, data, st.st_mode, st.st_uid, st.st_gid,
585 a8083063 Iustin Pop
            st.st_atime, st.st_mtime]
586 a8083063 Iustin Pop
  c = Client("upload_file", params)
587 a8083063 Iustin Pop
  c.connect_list(node_list)
588 a8083063 Iustin Pop
  c.run()
589 a8083063 Iustin Pop
  return c.getresult()
590 a8083063 Iustin Pop
591 a8083063 Iustin Pop
592 a8083063 Iustin Pop
def call_os_diagnose(node_list):
593 a8083063 Iustin Pop
  """Request a diagnose of OS definitions.
594 a8083063 Iustin Pop

595 a8083063 Iustin Pop
  This is a multi-node call.
596 a8083063 Iustin Pop

597 a8083063 Iustin Pop
  """
598 a8083063 Iustin Pop
  c = Client("os_diagnose", [])
599 a8083063 Iustin Pop
  c.connect_list(node_list)
600 a8083063 Iustin Pop
  c.run()
601 a8083063 Iustin Pop
  result = c.getresult()
602 a8083063 Iustin Pop
  new_result = {}
603 a8083063 Iustin Pop
  for node_name in result:
604 a8083063 Iustin Pop
    nr = []
605 a8083063 Iustin Pop
    if result[node_name]:
606 a8083063 Iustin Pop
      for data in result[node_name]:
607 a8083063 Iustin Pop
        if data:
608 319856a9 Michael Hanselmann
          if isinstance(data, dict):
609 319856a9 Michael Hanselmann
            nr.append(objects.OS.FromDict(data))
610 305a7297 Guido Trotter
          elif isinstance(data, tuple) and len(data) == 3:
611 305a7297 Guido Trotter
            nr.append(errors.InvalidOS(data[0], data[1], data[2]))
612 a8083063 Iustin Pop
          else:
613 3ecf6786 Iustin Pop
            raise errors.ProgrammerError("Invalid data from"
614 3ecf6786 Iustin Pop
                                         " xcserver.os_diagnose")
615 a8083063 Iustin Pop
    new_result[node_name] = nr
616 a8083063 Iustin Pop
  return new_result
617 a8083063 Iustin Pop
618 a8083063 Iustin Pop
619 a8083063 Iustin Pop
def call_os_get(node_list, name):
620 a8083063 Iustin Pop
  """Returns an OS definition.
621 a8083063 Iustin Pop

622 a8083063 Iustin Pop
  This is a multi-node call.
623 a8083063 Iustin Pop

624 a8083063 Iustin Pop
  """
625 a8083063 Iustin Pop
  c = Client("os_get", [name])
626 a8083063 Iustin Pop
  c.connect_list(node_list)
627 a8083063 Iustin Pop
  c.run()
628 a8083063 Iustin Pop
  result = c.getresult()
629 a8083063 Iustin Pop
  new_result = {}
630 a8083063 Iustin Pop
  for node_name in result:
631 a8083063 Iustin Pop
    data = result[node_name]
632 319856a9 Michael Hanselmann
    if isinstance(data, dict):
633 319856a9 Michael Hanselmann
      new_result[node_name] = objects.OS.FromDict(data)
634 305a7297 Guido Trotter
    elif isinstance(data, tuple) and len(data) == 3:
635 305a7297 Guido Trotter
      new_result[node_name] = errors.InvalidOS(data[0], data[1], data[2])
636 a8083063 Iustin Pop
    else:
637 a8083063 Iustin Pop
      new_result[node_name] = data
638 a8083063 Iustin Pop
  return new_result
639 a8083063 Iustin Pop
640 a8083063 Iustin Pop
641 a8083063 Iustin Pop
def call_hooks_runner(node_list, hpath, phase, env):
642 a8083063 Iustin Pop
  """Call the hooks runner.
643 a8083063 Iustin Pop

644 a8083063 Iustin Pop
  Args:
645 a8083063 Iustin Pop
    - op: the OpCode instance
646 a8083063 Iustin Pop
    - env: a dictionary with the environment
647 a8083063 Iustin Pop

648 a8083063 Iustin Pop
  This is a multi-node call.
649 a8083063 Iustin Pop

650 a8083063 Iustin Pop
  """
651 a8083063 Iustin Pop
  params = [hpath, phase, env]
652 a8083063 Iustin Pop
  c = Client("hooks_runner", params)
653 a8083063 Iustin Pop
  c.connect_list(node_list)
654 a8083063 Iustin Pop
  c.run()
655 a8083063 Iustin Pop
  result = c.getresult()
656 a8083063 Iustin Pop
  return result
657 a8083063 Iustin Pop
658 a8083063 Iustin Pop
659 a8083063 Iustin Pop
def call_blockdev_snapshot(node, cf_bdev):
660 a8083063 Iustin Pop
  """Request a snapshot of the given block device.
661 a8083063 Iustin Pop

662 a8083063 Iustin Pop
  This is a single-node call.
663 a8083063 Iustin Pop

664 a8083063 Iustin Pop
  """
665 319856a9 Michael Hanselmann
  c = Client("blockdev_snapshot", [cf_bdev.ToDict()])
666 a8083063 Iustin Pop
  c.connect(node)
667 a8083063 Iustin Pop
  c.run()
668 a8083063 Iustin Pop
  return c.getresult().get(node, False)
669 a8083063 Iustin Pop
670 a8083063 Iustin Pop
671 a8083063 Iustin Pop
def call_snapshot_export(node, snap_bdev, dest_node, instance):
672 a8083063 Iustin Pop
  """Request the export of a given snapshot.
673 a8083063 Iustin Pop

674 a8083063 Iustin Pop
  This is a single-node call.
675 a8083063 Iustin Pop

676 a8083063 Iustin Pop
  """
677 319856a9 Michael Hanselmann
  params = [snap_bdev.ToDict(), dest_node, instance.ToDict()]
678 a8083063 Iustin Pop
  c = Client("snapshot_export", params)
679 a8083063 Iustin Pop
  c.connect(node)
680 a8083063 Iustin Pop
  c.run()
681 a8083063 Iustin Pop
  return c.getresult().get(node, False)
682 a8083063 Iustin Pop
683 a8083063 Iustin Pop
684 a8083063 Iustin Pop
def call_finalize_export(node, instance, snap_disks):
685 a8083063 Iustin Pop
  """Request the completion of an export operation.
686 a8083063 Iustin Pop

687 a8083063 Iustin Pop
  This writes the export config file, etc.
688 a8083063 Iustin Pop

689 a8083063 Iustin Pop
  This is a single-node call.
690 a8083063 Iustin Pop

691 a8083063 Iustin Pop
  """
692 a8083063 Iustin Pop
  flat_disks = []
693 a8083063 Iustin Pop
  for disk in snap_disks:
694 319856a9 Michael Hanselmann
    flat_disks.append(disk.ToDict())
695 319856a9 Michael Hanselmann
  params = [instance.ToDict(), flat_disks]
696 a8083063 Iustin Pop
  c = Client("finalize_export", params)
697 a8083063 Iustin Pop
  c.connect(node)
698 a8083063 Iustin Pop
  c.run()
699 a8083063 Iustin Pop
  return c.getresult().get(node, False)
700 a8083063 Iustin Pop
701 a8083063 Iustin Pop
702 a8083063 Iustin Pop
def call_export_info(node, path):
703 a8083063 Iustin Pop
  """Queries the export information in a given path.
704 a8083063 Iustin Pop

705 a8083063 Iustin Pop
  This is a single-node call.
706 a8083063 Iustin Pop

707 a8083063 Iustin Pop
  """
708 a8083063 Iustin Pop
  c = Client("export_info", [path])
709 a8083063 Iustin Pop
  c.connect(node)
710 a8083063 Iustin Pop
  c.run()
711 a8083063 Iustin Pop
  result = c.getresult().get(node, False)
712 a8083063 Iustin Pop
  if not result:
713 a8083063 Iustin Pop
    return result
714 a8083063 Iustin Pop
  return objects.SerializableConfigParser.Loads(result)
715 a8083063 Iustin Pop
716 a8083063 Iustin Pop
717 a8083063 Iustin Pop
def call_instance_os_import(node, inst, osdev, swapdev, src_node, src_image):
718 a8083063 Iustin Pop
  """Request the import of a backup into an instance.
719 a8083063 Iustin Pop

720 a8083063 Iustin Pop
  This is a single-node call.
721 a8083063 Iustin Pop

722 a8083063 Iustin Pop
  """
723 319856a9 Michael Hanselmann
  params = [inst.ToDict(), osdev, swapdev, src_node, src_image]
724 a8083063 Iustin Pop
  c = Client("instance_os_import", params)
725 a8083063 Iustin Pop
  c.connect(node)
726 a8083063 Iustin Pop
  c.run()
727 a8083063 Iustin Pop
  return c.getresult().get(node, False)
728 a8083063 Iustin Pop
729 a8083063 Iustin Pop
730 a8083063 Iustin Pop
def call_export_list(node_list):
731 a8083063 Iustin Pop
  """Gets the stored exports list.
732 a8083063 Iustin Pop

733 a8083063 Iustin Pop
  This is a multi-node call.
734 a8083063 Iustin Pop

735 a8083063 Iustin Pop
  """
736 a8083063 Iustin Pop
  c = Client("export_list", [])
737 a8083063 Iustin Pop
  c.connect_list(node_list)
738 a8083063 Iustin Pop
  c.run()
739 a8083063 Iustin Pop
  result = c.getresult()
740 a8083063 Iustin Pop
  return result
741 a8083063 Iustin Pop
742 a8083063 Iustin Pop
743 a8083063 Iustin Pop
def call_export_remove(node, export):
744 a8083063 Iustin Pop
  """Requests removal of a given export.
745 a8083063 Iustin Pop

746 a8083063 Iustin Pop
  This is a single-node call.
747 a8083063 Iustin Pop

748 a8083063 Iustin Pop
  """
749 a8083063 Iustin Pop
  c = Client("export_remove", [export])
750 a8083063 Iustin Pop
  c.connect(node)
751 a8083063 Iustin Pop
  c.run()
752 a8083063 Iustin Pop
  return c.getresult().get(node, False)
753 a8083063 Iustin Pop
754 a8083063 Iustin Pop
755 a8083063 Iustin Pop
def call_node_leave_cluster(node):
756 a8083063 Iustin Pop
  """Requests a node to clean the cluster information it has.
757 a8083063 Iustin Pop

758 a8083063 Iustin Pop
  This will remove the configuration information from the ganeti data
759 a8083063 Iustin Pop
  dir.
760 a8083063 Iustin Pop

761 a8083063 Iustin Pop
  This is a single-node call.
762 a8083063 Iustin Pop

763 a8083063 Iustin Pop
  """
764 a8083063 Iustin Pop
  c = Client("node_leave_cluster", [])
765 a8083063 Iustin Pop
  c.connect(node)
766 a8083063 Iustin Pop
  c.run()
767 a8083063 Iustin Pop
  return c.getresult().get(node, False)
768 dcb93971 Michael Hanselmann
769 dcb93971 Michael Hanselmann
770 dcb93971 Michael Hanselmann
def call_node_volumes(node_list):
771 dcb93971 Michael Hanselmann
  """Gets all volumes on node(s).
772 dcb93971 Michael Hanselmann

773 dcb93971 Michael Hanselmann
  This is a multi-node call.
774 dcb93971 Michael Hanselmann

775 dcb93971 Michael Hanselmann
  """
776 dcb93971 Michael Hanselmann
  c = Client("node_volumes", [])
777 dcb93971 Michael Hanselmann
  c.connect_list(node_list)
778 dcb93971 Michael Hanselmann
  c.run()
779 dcb93971 Michael Hanselmann
  return c.getresult()