Statistics
| Branch: | Tag: | Revision:

root / lib / cmdlib.py @ c120ff34

History | View | Annotate | Download (245.5 kB)

1
#
2
#
3

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

    
21

    
22
"""Module implementing the master-side code."""
23

    
24
# pylint: disable-msg=W0613,W0201
25

    
26
import os
27
import os.path
28
import time
29
import tempfile
30
import re
31
import platform
32
import logging
33
import copy
34
import random
35

    
36
from ganeti import ssh
37
from ganeti import utils
38
from ganeti import errors
39
from ganeti import hypervisor
40
from ganeti import locking
41
from ganeti import constants
42
from ganeti import objects
43
from ganeti import opcodes
44
from ganeti import serializer
45
from ganeti import ssconf
46

    
47

    
48
class LogicalUnit(object):
49
  """Logical Unit base class.
50

51
  Subclasses must follow these rules:
52
    - implement ExpandNames
53
    - implement CheckPrereq
54
    - implement Exec
55
    - implement BuildHooksEnv
56
    - redefine HPATH and HTYPE
57
    - optionally redefine their run requirements:
58
        REQ_BGL: the LU needs to hold the Big Ganeti Lock exclusively
59

60
  Note that all commands require root permissions.
61

62
  """
63
  HPATH = None
64
  HTYPE = None
65
  _OP_REQP = []
66
  REQ_BGL = True
67

    
68
  def __init__(self, processor, op, context, rpc):
69
    """Constructor for LogicalUnit.
70

71
    This needs to be overriden in derived classes in order to check op
72
    validity.
73

74
    """
75
    self.proc = processor
76
    self.op = op
77
    self.cfg = context.cfg
78
    self.context = context
79
    self.rpc = rpc
80
    # Dicts used to declare locking needs to mcpu
81
    self.needed_locks = None
82
    self.acquired_locks = {}
83
    self.share_locks = dict(((i, 0) for i in locking.LEVELS))
84
    self.add_locks = {}
85
    self.remove_locks = {}
86
    # Used to force good behavior when calling helper functions
87
    self.recalculate_locks = {}
88
    self.__ssh = None
89
    # logging
90
    self.LogWarning = processor.LogWarning
91
    self.LogInfo = processor.LogInfo
92

    
93
    for attr_name in self._OP_REQP:
94
      attr_val = getattr(op, attr_name, None)
95
      if attr_val is None:
96
        raise errors.OpPrereqError("Required parameter '%s' missing" %
97
                                   attr_name)
98
    self.CheckArguments()
99

    
100
  def __GetSSH(self):
101
    """Returns the SshRunner object
102

103
    """
104
    if not self.__ssh:
105
      self.__ssh = ssh.SshRunner(self.cfg.GetClusterName())
106
    return self.__ssh
107

    
108
  ssh = property(fget=__GetSSH)
109

    
110
  def CheckArguments(self):
111
    """Check syntactic validity for the opcode arguments.
112

113
    This method is for doing a simple syntactic check and ensure
114
    validity of opcode parameters, without any cluster-related
115
    checks. While the same can be accomplished in ExpandNames and/or
116
    CheckPrereq, doing these separate is better because:
117

118
      - ExpandNames is left as as purely a lock-related function
119
      - CheckPrereq is run after we have aquired locks (and possible
120
        waited for them)
121

122
    The function is allowed to change the self.op attribute so that
123
    later methods can no longer worry about missing parameters.
124

125
    """
126
    pass
127

    
128
  def ExpandNames(self):
129
    """Expand names for this LU.
130

131
    This method is called before starting to execute the opcode, and it should
132
    update all the parameters of the opcode to their canonical form (e.g. a
133
    short node name must be fully expanded after this method has successfully
134
    completed). This way locking, hooks, logging, ecc. can work correctly.
135

136
    LUs which implement this method must also populate the self.needed_locks
137
    member, as a dict with lock levels as keys, and a list of needed lock names
138
    as values. Rules:
139

140
      - use an empty dict if you don't need any lock
141
      - if you don't need any lock at a particular level omit that level
142
      - don't put anything for the BGL level
143
      - if you want all locks at a level use locking.ALL_SET as a value
144

145
    If you need to share locks (rather than acquire them exclusively) at one
146
    level you can modify self.share_locks, setting a true value (usually 1) for
147
    that level. By default locks are not shared.
148

149
    Examples::
150

151
      # Acquire all nodes and one instance
152
      self.needed_locks = {
153
        locking.LEVEL_NODE: locking.ALL_SET,
154
        locking.LEVEL_INSTANCE: ['instance1.example.tld'],
155
      }
156
      # Acquire just two nodes
157
      self.needed_locks = {
158
        locking.LEVEL_NODE: ['node1.example.tld', 'node2.example.tld'],
159
      }
160
      # Acquire no locks
161
      self.needed_locks = {} # No, you can't leave it to the default value None
162

163
    """
164
    # The implementation of this method is mandatory only if the new LU is
165
    # concurrent, so that old LUs don't need to be changed all at the same
166
    # time.
167
    if self.REQ_BGL:
168
      self.needed_locks = {} # Exclusive LUs don't need locks.
169
    else:
170
      raise NotImplementedError
171

    
172
  def DeclareLocks(self, level):
173
    """Declare LU locking needs for a level
174

175
    While most LUs can just declare their locking needs at ExpandNames time,
176
    sometimes there's the need to calculate some locks after having acquired
177
    the ones before. This function is called just before acquiring locks at a
178
    particular level, but after acquiring the ones at lower levels, and permits
179
    such calculations. It can be used to modify self.needed_locks, and by
180
    default it does nothing.
181

182
    This function is only called if you have something already set in
183
    self.needed_locks for the level.
184

185
    @param level: Locking level which is going to be locked
186
    @type level: member of ganeti.locking.LEVELS
187

188
    """
189

    
190
  def CheckPrereq(self):
191
    """Check prerequisites for this LU.
192

193
    This method should check that the prerequisites for the execution
194
    of this LU are fulfilled. It can do internode communication, but
195
    it should be idempotent - no cluster or system changes are
196
    allowed.
197

198
    The method should raise errors.OpPrereqError in case something is
199
    not fulfilled. Its return value is ignored.
200

201
    This method should also update all the parameters of the opcode to
202
    their canonical form if it hasn't been done by ExpandNames before.
203

204
    """
205
    raise NotImplementedError
206

    
207
  def Exec(self, feedback_fn):
208
    """Execute the LU.
209

210
    This method should implement the actual work. It should raise
211
    errors.OpExecError for failures that are somewhat dealt with in
212
    code, or expected.
213

214
    """
215
    raise NotImplementedError
216

    
217
  def BuildHooksEnv(self):
218
    """Build hooks environment for this LU.
219

220
    This method should return a three-node tuple consisting of: a dict
221
    containing the environment that will be used for running the
222
    specific hook for this LU, a list of node names on which the hook
223
    should run before the execution, and a list of node names on which
224
    the hook should run after the execution.
225

226
    The keys of the dict must not have 'GANETI_' prefixed as this will
227
    be handled in the hooks runner. Also note additional keys will be
228
    added by the hooks runner. If the LU doesn't define any
229
    environment, an empty dict (and not None) should be returned.
230

231
    No nodes should be returned as an empty list (and not None).
232

233
    Note that if the HPATH for a LU class is None, this function will
234
    not be called.
235

236
    """
237
    raise NotImplementedError
238

    
239
  def HooksCallBack(self, phase, hook_results, feedback_fn, lu_result):
240
    """Notify the LU about the results of its hooks.
241

242
    This method is called every time a hooks phase is executed, and notifies
243
    the Logical Unit about the hooks' result. The LU can then use it to alter
244
    its result based on the hooks.  By default the method does nothing and the
245
    previous result is passed back unchanged but any LU can define it if it
246
    wants to use the local cluster hook-scripts somehow.
247

248
    @param phase: one of L{constants.HOOKS_PHASE_POST} or
249
        L{constants.HOOKS_PHASE_PRE}; it denotes the hooks phase
250
    @param hook_results: the results of the multi-node hooks rpc call
251
    @param feedback_fn: function used send feedback back to the caller
252
    @param lu_result: the previous Exec result this LU had, or None
253
        in the PRE phase
254
    @return: the new Exec result, based on the previous result
255
        and hook results
256

257
    """
258
    return lu_result
259

    
260
  def _ExpandAndLockInstance(self):
261
    """Helper function to expand and lock an instance.
262

263
    Many LUs that work on an instance take its name in self.op.instance_name
264
    and need to expand it and then declare the expanded name for locking. This
265
    function does it, and then updates self.op.instance_name to the expanded
266
    name. It also initializes needed_locks as a dict, if this hasn't been done
267
    before.
268

269
    """
270
    if self.needed_locks is None:
271
      self.needed_locks = {}
272
    else:
273
      assert locking.LEVEL_INSTANCE not in self.needed_locks, \
274
        "_ExpandAndLockInstance called with instance-level locks set"
275
    expanded_name = self.cfg.ExpandInstanceName(self.op.instance_name)
276
    if expanded_name is None:
277
      raise errors.OpPrereqError("Instance '%s' not known" %
278
                                  self.op.instance_name)
279
    self.needed_locks[locking.LEVEL_INSTANCE] = expanded_name
280
    self.op.instance_name = expanded_name
281

    
282
  def _LockInstancesNodes(self, primary_only=False):
283
    """Helper function to declare instances' nodes for locking.
284

285
    This function should be called after locking one or more instances to lock
286
    their nodes. Its effect is populating self.needed_locks[locking.LEVEL_NODE]
287
    with all primary or secondary nodes for instances already locked and
288
    present in self.needed_locks[locking.LEVEL_INSTANCE].
289

290
    It should be called from DeclareLocks, and for safety only works if
291
    self.recalculate_locks[locking.LEVEL_NODE] is set.
292

293
    In the future it may grow parameters to just lock some instance's nodes, or
294
    to just lock primaries or secondary nodes, if needed.
295

296
    If should be called in DeclareLocks in a way similar to::
297

298
      if level == locking.LEVEL_NODE:
299
        self._LockInstancesNodes()
300

301
    @type primary_only: boolean
302
    @param primary_only: only lock primary nodes of locked instances
303

304
    """
305
    assert locking.LEVEL_NODE in self.recalculate_locks, \
306
      "_LockInstancesNodes helper function called with no nodes to recalculate"
307

    
308
    # TODO: check if we're really been called with the instance locks held
309

    
310
    # For now we'll replace self.needed_locks[locking.LEVEL_NODE], but in the
311
    # future we might want to have different behaviors depending on the value
312
    # of self.recalculate_locks[locking.LEVEL_NODE]
313
    wanted_nodes = []
314
    for instance_name in self.acquired_locks[locking.LEVEL_INSTANCE]:
315
      instance = self.context.cfg.GetInstanceInfo(instance_name)
316
      wanted_nodes.append(instance.primary_node)
317
      if not primary_only:
318
        wanted_nodes.extend(instance.secondary_nodes)
319

    
320
    if self.recalculate_locks[locking.LEVEL_NODE] == constants.LOCKS_REPLACE:
321
      self.needed_locks[locking.LEVEL_NODE] = wanted_nodes
322
    elif self.recalculate_locks[locking.LEVEL_NODE] == constants.LOCKS_APPEND:
323
      self.needed_locks[locking.LEVEL_NODE].extend(wanted_nodes)
324

    
325
    del self.recalculate_locks[locking.LEVEL_NODE]
326

    
327

    
328
class NoHooksLU(LogicalUnit):
329
  """Simple LU which runs no hooks.
330

331
  This LU is intended as a parent for other LogicalUnits which will
332
  run no hooks, in order to reduce duplicate code.
333

334
  """
335
  HPATH = None
336
  HTYPE = None
337

    
338

    
339
def _GetWantedNodes(lu, nodes):
340
  """Returns list of checked and expanded node names.
341

342
  @type lu: L{LogicalUnit}
343
  @param lu: the logical unit on whose behalf we execute
344
  @type nodes: list
345
  @param nodes: list of node names or None for all nodes
346
  @rtype: list
347
  @return: the list of nodes, sorted
348
  @raise errors.OpProgrammerError: if the nodes parameter is wrong type
349

350
  """
351
  if not isinstance(nodes, list):
352
    raise errors.OpPrereqError("Invalid argument type 'nodes'")
353

    
354
  if not nodes:
355
    raise errors.ProgrammerError("_GetWantedNodes should only be called with a"
356
      " non-empty list of nodes whose name is to be expanded.")
357

    
358
  wanted = []
359
  for name in nodes:
360
    node = lu.cfg.ExpandNodeName(name)
361
    if node is None:
362
      raise errors.OpPrereqError("No such node name '%s'" % name)
363
    wanted.append(node)
364

    
365
  return utils.NiceSort(wanted)
366

    
367

    
368
def _GetWantedInstances(lu, instances):
369
  """Returns list of checked and expanded instance names.
370

371
  @type lu: L{LogicalUnit}
372
  @param lu: the logical unit on whose behalf we execute
373
  @type instances: list
374
  @param instances: list of instance names or None for all instances
375
  @rtype: list
376
  @return: the list of instances, sorted
377
  @raise errors.OpPrereqError: if the instances parameter is wrong type
378
  @raise errors.OpPrereqError: if any of the passed instances is not found
379

380
  """
381
  if not isinstance(instances, list):
382
    raise errors.OpPrereqError("Invalid argument type 'instances'")
383

    
384
  if instances:
385
    wanted = []
386

    
387
    for name in instances:
388
      instance = lu.cfg.ExpandInstanceName(name)
389
      if instance is None:
390
        raise errors.OpPrereqError("No such instance name '%s'" % name)
391
      wanted.append(instance)
392

    
393
  else:
394
    wanted = utils.NiceSort(lu.cfg.GetInstanceList())
395
  return wanted
396

    
397

    
398
def _CheckOutputFields(static, dynamic, selected):
399
  """Checks whether all selected fields are valid.
400

401
  @type static: L{utils.FieldSet}
402
  @param static: static fields set
403
  @type dynamic: L{utils.FieldSet}
404
  @param dynamic: dynamic fields set
405

406
  """
407
  f = utils.FieldSet()
408
  f.Extend(static)
409
  f.Extend(dynamic)
410

    
411
  delta = f.NonMatching(selected)
412
  if delta:
413
    raise errors.OpPrereqError("Unknown output fields selected: %s"
414
                               % ",".join(delta))
415

    
416

    
417
def _CheckBooleanOpField(op, name):
418
  """Validates boolean opcode parameters.
419

420
  This will ensure that an opcode parameter is either a boolean value,
421
  or None (but that it always exists).
422

423
  """
424
  val = getattr(op, name, None)
425
  if not (val is None or isinstance(val, bool)):
426
    raise errors.OpPrereqError("Invalid boolean parameter '%s' (%s)" %
427
                               (name, str(val)))
428
  setattr(op, name, val)
429

    
430

    
431
def _CheckNodeOnline(lu, node):
432
  """Ensure that a given node is online.
433

434
  @param lu: the LU on behalf of which we make the check
435
  @param node: the node to check
436
  @raise errors.OpPrereqError: if the node is offline
437

438
  """
439
  if lu.cfg.GetNodeInfo(node).offline:
440
    raise errors.OpPrereqError("Can't use offline node %s" % node)
441

    
442

    
443
def _CheckNodeNotDrained(lu, node):
444
  """Ensure that a given node is not drained.
445

446
  @param lu: the LU on behalf of which we make the check
447
  @param node: the node to check
448
  @raise errors.OpPrereqError: if the node is drained
449

450
  """
451
  if lu.cfg.GetNodeInfo(node).drained:
452
    raise errors.OpPrereqError("Can't use drained node %s" % node)
453

    
454

    
455
def _BuildInstanceHookEnv(name, primary_node, secondary_nodes, os_type, status,
456
                          memory, vcpus, nics, disk_template, disks,
457
                          bep, hvp, hypervisor):
458
  """Builds instance related env variables for hooks
459

460
  This builds the hook environment from individual variables.
461

462
  @type name: string
463
  @param name: the name of the instance
464
  @type primary_node: string
465
  @param primary_node: the name of the instance's primary node
466
  @type secondary_nodes: list
467
  @param secondary_nodes: list of secondary nodes as strings
468
  @type os_type: string
469
  @param os_type: the name of the instance's OS
470
  @type status: boolean
471
  @param status: the should_run status of the instance
472
  @type memory: string
473
  @param memory: the memory size of the instance
474
  @type vcpus: string
475
  @param vcpus: the count of VCPUs the instance has
476
  @type nics: list
477
  @param nics: list of tuples (ip, bridge, mac) representing
478
      the NICs the instance  has
479
  @type disk_template: string
480
  @param disk_template: the distk template of the instance
481
  @type disks: list
482
  @param disks: the list of (size, mode) pairs
483
  @type bep: dict
484
  @param bep: the backend parameters for the instance
485
  @type hvp: dict
486
  @param hvp: the hypervisor parameters for the instance
487
  @type hypervisor: string
488
  @param hypervisor: the hypervisor for the instance
489
  @rtype: dict
490
  @return: the hook environment for this instance
491

492
  """
493
  if status:
494
    str_status = "up"
495
  else:
496
    str_status = "down"
497
  env = {
498
    "OP_TARGET": name,
499
    "INSTANCE_NAME": name,
500
    "INSTANCE_PRIMARY": primary_node,
501
    "INSTANCE_SECONDARIES": " ".join(secondary_nodes),
502
    "INSTANCE_OS_TYPE": os_type,
503
    "INSTANCE_STATUS": str_status,
504
    "INSTANCE_MEMORY": memory,
505
    "INSTANCE_VCPUS": vcpus,
506
    "INSTANCE_DISK_TEMPLATE": disk_template,
507
    "INSTANCE_HYPERVISOR": hypervisor,
508
  }
509

    
510
  if nics:
511
    nic_count = len(nics)
512
    for idx, (ip, bridge, mac) in enumerate(nics):
513
      if ip is None:
514
        ip = ""
515
      env["INSTANCE_NIC%d_IP" % idx] = ip
516
      env["INSTANCE_NIC%d_BRIDGE" % idx] = bridge
517
      env["INSTANCE_NIC%d_MAC" % idx] = mac
518
  else:
519
    nic_count = 0
520

    
521
  env["INSTANCE_NIC_COUNT"] = nic_count
522

    
523
  if disks:
524
    disk_count = len(disks)
525
    for idx, (size, mode) in enumerate(disks):
526
      env["INSTANCE_DISK%d_SIZE" % idx] = size
527
      env["INSTANCE_DISK%d_MODE" % idx] = mode
528
  else:
529
    disk_count = 0
530

    
531
  env["INSTANCE_DISK_COUNT"] = disk_count
532

    
533
  for source, kind in [(bep, "BE"), (hvp, "HV")]:
534
    for key, value in source.items():
535
      env["INSTANCE_%s_%s" % (kind, key)] = value
536

    
537
  return env
538

    
539

    
540
def _BuildInstanceHookEnvByObject(lu, instance, override=None):
541
  """Builds instance related env variables for hooks from an object.
542

543
  @type lu: L{LogicalUnit}
544
  @param lu: the logical unit on whose behalf we execute
545
  @type instance: L{objects.Instance}
546
  @param instance: the instance for which we should build the
547
      environment
548
  @type override: dict
549
  @param override: dictionary with key/values that will override
550
      our values
551
  @rtype: dict
552
  @return: the hook environment dictionary
553

554
  """
555
  cluster = lu.cfg.GetClusterInfo()
556
  bep = cluster.FillBE(instance)
557
  hvp = cluster.FillHV(instance)
558
  args = {
559
    'name': instance.name,
560
    'primary_node': instance.primary_node,
561
    'secondary_nodes': instance.secondary_nodes,
562
    'os_type': instance.os,
563
    'status': instance.admin_up,
564
    'memory': bep[constants.BE_MEMORY],
565
    'vcpus': bep[constants.BE_VCPUS],
566
    'nics': [(nic.ip, nic.bridge, nic.mac) for nic in instance.nics],
567
    'disk_template': instance.disk_template,
568
    'disks': [(disk.size, disk.mode) for disk in instance.disks],
569
    'bep': bep,
570
    'hvp': hvp,
571
    'hypervisor': instance.hypervisor,
572
  }
573
  if override:
574
    args.update(override)
575
  return _BuildInstanceHookEnv(**args)
576

    
577

    
578
def _AdjustCandidatePool(lu):
579
  """Adjust the candidate pool after node operations.
580

581
  """
582
  mod_list = lu.cfg.MaintainCandidatePool()
583
  if mod_list:
584
    lu.LogInfo("Promoted nodes to master candidate role: %s",
585
               ", ".join(node.name for node in mod_list))
586
    for name in mod_list:
587
      lu.context.ReaddNode(name)
588
  mc_now, mc_max = lu.cfg.GetMasterCandidateStats()
589
  if mc_now > mc_max:
590
    lu.LogInfo("Note: more nodes are candidates (%d) than desired (%d)" %
591
               (mc_now, mc_max))
592

    
593

    
594
def _CheckInstanceBridgesExist(lu, instance):
595
  """Check that the brigdes needed by an instance exist.
596

597
  """
598
  # check bridges existance
599
  brlist = [nic.bridge for nic in instance.nics]
600
  result = lu.rpc.call_bridges_exist(instance.primary_node, brlist)
601
  result.Raise()
602
  if not result.data:
603
    raise errors.OpPrereqError("One or more target bridges %s does not"
604
                               " exist on destination node '%s'" %
605
                               (brlist, instance.primary_node))
606

    
607

    
608
class LUDestroyCluster(NoHooksLU):
609
  """Logical unit for destroying the cluster.
610

611
  """
612
  _OP_REQP = []
613

    
614
  def CheckPrereq(self):
615
    """Check prerequisites.
616

617
    This checks whether the cluster is empty.
618

619
    Any errors are signalled by raising errors.OpPrereqError.
620

621
    """
622
    master = self.cfg.GetMasterNode()
623

    
624
    nodelist = self.cfg.GetNodeList()
625
    if len(nodelist) != 1 or nodelist[0] != master:
626
      raise errors.OpPrereqError("There are still %d node(s) in"
627
                                 " this cluster." % (len(nodelist) - 1))
628
    instancelist = self.cfg.GetInstanceList()
629
    if instancelist:
630
      raise errors.OpPrereqError("There are still %d instance(s) in"
631
                                 " this cluster." % len(instancelist))
632

    
633
  def Exec(self, feedback_fn):
634
    """Destroys the cluster.
635

636
    """
637
    master = self.cfg.GetMasterNode()
638
    result = self.rpc.call_node_stop_master(master, False)
639
    result.Raise()
640
    if not result.data:
641
      raise errors.OpExecError("Could not disable the master role")
642
    priv_key, pub_key, _ = ssh.GetUserFiles(constants.GANETI_RUNAS)
643
    utils.CreateBackup(priv_key)
644
    utils.CreateBackup(pub_key)
645
    return master
646

    
647

    
648
class LUVerifyCluster(LogicalUnit):
649
  """Verifies the cluster status.
650

651
  """
652
  HPATH = "cluster-verify"
653
  HTYPE = constants.HTYPE_CLUSTER
654
  _OP_REQP = ["skip_checks"]
655
  REQ_BGL = False
656

    
657
  def ExpandNames(self):
658
    self.needed_locks = {
659
      locking.LEVEL_NODE: locking.ALL_SET,
660
      locking.LEVEL_INSTANCE: locking.ALL_SET,
661
    }
662
    self.share_locks = dict(((i, 1) for i in locking.LEVELS))
663

    
664
  def _VerifyNode(self, nodeinfo, file_list, local_cksum,
665
                  node_result, feedback_fn, master_files,
666
                  drbd_map, vg_name):
667
    """Run multiple tests against a node.
668

669
    Test list:
670

671
      - compares ganeti version
672
      - checks vg existance and size > 20G
673
      - checks config file checksum
674
      - checks ssh to other nodes
675

676
    @type nodeinfo: L{objects.Node}
677
    @param nodeinfo: the node to check
678
    @param file_list: required list of files
679
    @param local_cksum: dictionary of local files and their checksums
680
    @param node_result: the results from the node
681
    @param feedback_fn: function used to accumulate results
682
    @param master_files: list of files that only masters should have
683
    @param drbd_map: the useddrbd minors for this node, in
684
        form of minor: (instance, must_exist) which correspond to instances
685
        and their running status
686
    @param vg_name: Ganeti Volume Group (result of self.cfg.GetVGName())
687

688
    """
689
    node = nodeinfo.name
690

    
691
    # main result, node_result should be a non-empty dict
692
    if not node_result or not isinstance(node_result, dict):
693
      feedback_fn("  - ERROR: unable to verify node %s." % (node,))
694
      return True
695

    
696
    # compares ganeti version
697
    local_version = constants.PROTOCOL_VERSION
698
    remote_version = node_result.get('version', None)
699
    if not (remote_version and isinstance(remote_version, (list, tuple)) and
700
            len(remote_version) == 2):
701
      feedback_fn("  - ERROR: connection to %s failed" % (node))
702
      return True
703

    
704
    if local_version != remote_version[0]:
705
      feedback_fn("  - ERROR: incompatible protocol versions: master %s,"
706
                  " node %s %s" % (local_version, node, remote_version[0]))
707
      return True
708

    
709
    # node seems compatible, we can actually try to look into its results
710

    
711
    bad = False
712

    
713
    # full package version
714
    if constants.RELEASE_VERSION != remote_version[1]:
715
      feedback_fn("  - WARNING: software version mismatch: master %s,"
716
                  " node %s %s" %
717
                  (constants.RELEASE_VERSION, node, remote_version[1]))
718

    
719
    # checks vg existence and size > 20G
720
    if vg_name is not None:
721
      vglist = node_result.get(constants.NV_VGLIST, None)
722
      if not vglist:
723
        feedback_fn("  - ERROR: unable to check volume groups on node %s." %
724
                        (node,))
725
        bad = True
726
      else:
727
        vgstatus = utils.CheckVolumeGroupSize(vglist, vg_name,
728
                                              constants.MIN_VG_SIZE)
729
        if vgstatus:
730
          feedback_fn("  - ERROR: %s on node %s" % (vgstatus, node))
731
          bad = True
732

    
733
    # checks config file checksum
734

    
735
    remote_cksum = node_result.get(constants.NV_FILELIST, None)
736
    if not isinstance(remote_cksum, dict):
737
      bad = True
738
      feedback_fn("  - ERROR: node hasn't returned file checksum data")
739
    else:
740
      for file_name in file_list:
741
        node_is_mc = nodeinfo.master_candidate
742
        must_have_file = file_name not in master_files
743
        if file_name not in remote_cksum:
744
          if node_is_mc or must_have_file:
745
            bad = True
746
            feedback_fn("  - ERROR: file '%s' missing" % file_name)
747
        elif remote_cksum[file_name] != local_cksum[file_name]:
748
          if node_is_mc or must_have_file:
749
            bad = True
750
            feedback_fn("  - ERROR: file '%s' has wrong checksum" % file_name)
751
          else:
752
            # not candidate and this is not a must-have file
753
            bad = True
754
            feedback_fn("  - ERROR: non master-candidate has old/wrong file"
755
                        " '%s'" % file_name)
756
        else:
757
          # all good, except non-master/non-must have combination
758
          if not node_is_mc and not must_have_file:
759
            feedback_fn("  - ERROR: file '%s' should not exist on non master"
760
                        " candidates" % file_name)
761

    
762
    # checks ssh to any
763

    
764
    if constants.NV_NODELIST not in node_result:
765
      bad = True
766
      feedback_fn("  - ERROR: node hasn't returned node ssh connectivity data")
767
    else:
768
      if node_result[constants.NV_NODELIST]:
769
        bad = True
770
        for node in node_result[constants.NV_NODELIST]:
771
          feedback_fn("  - ERROR: ssh communication with node '%s': %s" %
772
                          (node, node_result[constants.NV_NODELIST][node]))
773

    
774
    if constants.NV_NODENETTEST not in node_result:
775
      bad = True
776
      feedback_fn("  - ERROR: node hasn't returned node tcp connectivity data")
777
    else:
778
      if node_result[constants.NV_NODENETTEST]:
779
        bad = True
780
        nlist = utils.NiceSort(node_result[constants.NV_NODENETTEST].keys())
781
        for node in nlist:
782
          feedback_fn("  - ERROR: tcp communication with node '%s': %s" %
783
                          (node, node_result[constants.NV_NODENETTEST][node]))
784

    
785
    hyp_result = node_result.get(constants.NV_HYPERVISOR, None)
786
    if isinstance(hyp_result, dict):
787
      for hv_name, hv_result in hyp_result.iteritems():
788
        if hv_result is not None:
789
          feedback_fn("  - ERROR: hypervisor %s verify failure: '%s'" %
790
                      (hv_name, hv_result))
791

    
792
    # check used drbd list
793
    if vg_name is not None:
794
      used_minors = node_result.get(constants.NV_DRBDLIST, [])
795
      if not isinstance(used_minors, (tuple, list)):
796
        feedback_fn("  - ERROR: cannot parse drbd status file: %s" %
797
                    str(used_minors))
798
      else:
799
        for minor, (iname, must_exist) in drbd_map.items():
800
          if minor not in used_minors and must_exist:
801
            feedback_fn("  - ERROR: drbd minor %d of instance %s is"
802
                        " not active" % (minor, iname))
803
            bad = True
804
        for minor in used_minors:
805
          if minor not in drbd_map:
806
            feedback_fn("  - ERROR: unallocated drbd minor %d is in use" %
807
                        minor)
808
            bad = True
809

    
810
    return bad
811

    
812
  def _VerifyInstance(self, instance, instanceconfig, node_vol_is,
813
                      node_instance, feedback_fn, n_offline):
814
    """Verify an instance.
815

816
    This function checks to see if the required block devices are
817
    available on the instance's node.
818

819
    """
820
    bad = False
821

    
822
    node_current = instanceconfig.primary_node
823

    
824
    node_vol_should = {}
825
    instanceconfig.MapLVsByNode(node_vol_should)
826

    
827
    for node in node_vol_should:
828
      if node in n_offline:
829
        # ignore missing volumes on offline nodes
830
        continue
831
      for volume in node_vol_should[node]:
832
        if node not in node_vol_is or volume not in node_vol_is[node]:
833
          feedback_fn("  - ERROR: volume %s missing on node %s" %
834
                          (volume, node))
835
          bad = True
836

    
837
    if instanceconfig.admin_up:
838
      if ((node_current not in node_instance or
839
          not instance in node_instance[node_current]) and
840
          node_current not in n_offline):
841
        feedback_fn("  - ERROR: instance %s not running on node %s" %
842
                        (instance, node_current))
843
        bad = True
844

    
845
    for node in node_instance:
846
      if (not node == node_current):
847
        if instance in node_instance[node]:
848
          feedback_fn("  - ERROR: instance %s should not run on node %s" %
849
                          (instance, node))
850
          bad = True
851

    
852
    return bad
853

    
854
  def _VerifyOrphanVolumes(self, node_vol_should, node_vol_is, feedback_fn):
855
    """Verify if there are any unknown volumes in the cluster.
856

857
    The .os, .swap and backup volumes are ignored. All other volumes are
858
    reported as unknown.
859

860
    """
861
    bad = False
862

    
863
    for node in node_vol_is:
864
      for volume in node_vol_is[node]:
865
        if node not in node_vol_should or volume not in node_vol_should[node]:
866
          feedback_fn("  - ERROR: volume %s on node %s should not exist" %
867
                      (volume, node))
868
          bad = True
869
    return bad
870

    
871
  def _VerifyOrphanInstances(self, instancelist, node_instance, feedback_fn):
872
    """Verify the list of running instances.
873

874
    This checks what instances are running but unknown to the cluster.
875

876
    """
877
    bad = False
878
    for node in node_instance:
879
      for runninginstance in node_instance[node]:
880
        if runninginstance not in instancelist:
881
          feedback_fn("  - ERROR: instance %s on node %s should not exist" %
882
                          (runninginstance, node))
883
          bad = True
884
    return bad
885

    
886
  def _VerifyNPlusOneMemory(self, node_info, instance_cfg, feedback_fn):
887
    """Verify N+1 Memory Resilience.
888

889
    Check that if one single node dies we can still start all the instances it
890
    was primary for.
891

892
    """
893
    bad = False
894

    
895
    for node, nodeinfo in node_info.iteritems():
896
      # This code checks that every node which is now listed as secondary has
897
      # enough memory to host all instances it is supposed to should a single
898
      # other node in the cluster fail.
899
      # FIXME: not ready for failover to an arbitrary node
900
      # FIXME: does not support file-backed instances
901
      # WARNING: we currently take into account down instances as well as up
902
      # ones, considering that even if they're down someone might want to start
903
      # them even in the event of a node failure.
904
      for prinode, instances in nodeinfo['sinst-by-pnode'].iteritems():
905
        needed_mem = 0
906
        for instance in instances:
907
          bep = self.cfg.GetClusterInfo().FillBE(instance_cfg[instance])
908
          if bep[constants.BE_AUTO_BALANCE]:
909
            needed_mem += bep[constants.BE_MEMORY]
910
        if nodeinfo['mfree'] < needed_mem:
911
          feedback_fn("  - ERROR: not enough memory on node %s to accomodate"
912
                      " failovers should node %s fail" % (node, prinode))
913
          bad = True
914
    return bad
915

    
916
  def CheckPrereq(self):
917
    """Check prerequisites.
918

919
    Transform the list of checks we're going to skip into a set and check that
920
    all its members are valid.
921

922
    """
923
    self.skip_set = frozenset(self.op.skip_checks)
924
    if not constants.VERIFY_OPTIONAL_CHECKS.issuperset(self.skip_set):
925
      raise errors.OpPrereqError("Invalid checks to be skipped specified")
926

    
927
  def BuildHooksEnv(self):
928
    """Build hooks env.
929

930
    Cluster-Verify hooks just rone in the post phase and their failure makes
931
    the output be logged in the verify output and the verification to fail.
932

933
    """
934
    all_nodes = self.cfg.GetNodeList()
935
    env = {
936
      "CLUSTER_TAGS": " ".join(self.cfg.GetClusterInfo().GetTags())
937
      }
938
    for node in self.cfg.GetAllNodesInfo().values():
939
      env["NODE_TAGS_%s" % node.name] = " ".join(node.GetTags())
940

    
941
    return env, [], all_nodes
942

    
943
  def Exec(self, feedback_fn):
944
    """Verify integrity of cluster, performing various test on nodes.
945

946
    """
947
    bad = False
948
    feedback_fn("* Verifying global settings")
949
    for msg in self.cfg.VerifyConfig():
950
      feedback_fn("  - ERROR: %s" % msg)
951

    
952
    vg_name = self.cfg.GetVGName()
953
    hypervisors = self.cfg.GetClusterInfo().enabled_hypervisors
954
    nodelist = utils.NiceSort(self.cfg.GetNodeList())
955
    nodeinfo = [self.cfg.GetNodeInfo(nname) for nname in nodelist]
956
    instancelist = utils.NiceSort(self.cfg.GetInstanceList())
957
    instanceinfo = dict((iname, self.cfg.GetInstanceInfo(iname))
958
                        for iname in instancelist)
959
    i_non_redundant = [] # Non redundant instances
960
    i_non_a_balanced = [] # Non auto-balanced instances
961
    n_offline = [] # List of offline nodes
962
    n_drained = [] # List of nodes being drained
963
    node_volume = {}
964
    node_instance = {}
965
    node_info = {}
966
    instance_cfg = {}
967

    
968
    # FIXME: verify OS list
969
    # do local checksums
970
    master_files = [constants.CLUSTER_CONF_FILE]
971

    
972
    file_names = ssconf.SimpleStore().GetFileList()
973
    file_names.append(constants.SSL_CERT_FILE)
974
    file_names.append(constants.RAPI_CERT_FILE)
975
    file_names.extend(master_files)
976

    
977
    local_checksums = utils.FingerprintFiles(file_names)
978

    
979
    feedback_fn("* Gathering data (%d nodes)" % len(nodelist))
980
    node_verify_param = {
981
      constants.NV_FILELIST: file_names,
982
      constants.NV_NODELIST: [node.name for node in nodeinfo
983
                              if not node.offline],
984
      constants.NV_HYPERVISOR: hypervisors,
985
      constants.NV_NODENETTEST: [(node.name, node.primary_ip,
986
                                  node.secondary_ip) for node in nodeinfo
987
                                 if not node.offline],
988
      constants.NV_INSTANCELIST: hypervisors,
989
      constants.NV_VERSION: None,
990
      constants.NV_HVINFO: self.cfg.GetHypervisorType(),
991
      }
992
    if vg_name is not None:
993
      node_verify_param[constants.NV_VGLIST] = None
994
      node_verify_param[constants.NV_LVLIST] = vg_name
995
      node_verify_param[constants.NV_DRBDLIST] = None
996
    all_nvinfo = self.rpc.call_node_verify(nodelist, node_verify_param,
997
                                           self.cfg.GetClusterName())
998

    
999
    cluster = self.cfg.GetClusterInfo()
1000
    master_node = self.cfg.GetMasterNode()
1001
    all_drbd_map = self.cfg.ComputeDRBDMap()
1002

    
1003
    for node_i in nodeinfo:
1004
      node = node_i.name
1005
      nresult = all_nvinfo[node].data
1006

    
1007
      if node_i.offline:
1008
        feedback_fn("* Skipping offline node %s" % (node,))
1009
        n_offline.append(node)
1010
        continue
1011

    
1012
      if node == master_node:
1013
        ntype = "master"
1014
      elif node_i.master_candidate:
1015
        ntype = "master candidate"
1016
      elif node_i.drained:
1017
        ntype = "drained"
1018
        n_drained.append(node)
1019
      else:
1020
        ntype = "regular"
1021
      feedback_fn("* Verifying node %s (%s)" % (node, ntype))
1022

    
1023
      if all_nvinfo[node].failed or not isinstance(nresult, dict):
1024
        feedback_fn("  - ERROR: connection to %s failed" % (node,))
1025
        bad = True
1026
        continue
1027

    
1028
      node_drbd = {}
1029
      for minor, instance in all_drbd_map[node].items():
1030
        if instance not in instanceinfo:
1031
          feedback_fn("  - ERROR: ghost instance '%s' in temporary DRBD map" %
1032
                      instance)
1033
          # ghost instance should not be running, but otherwise we
1034
          # don't give double warnings (both ghost instance and
1035
          # unallocated minor in use)
1036
          node_drbd[minor] = (instance, False)
1037
        else:
1038
          instance = instanceinfo[instance]
1039
          node_drbd[minor] = (instance.name, instance.admin_up)
1040
      result = self._VerifyNode(node_i, file_names, local_checksums,
1041
                                nresult, feedback_fn, master_files,
1042
                                node_drbd, vg_name)
1043
      bad = bad or result
1044

    
1045
      lvdata = nresult.get(constants.NV_LVLIST, "Missing LV data")
1046
      if vg_name is None:
1047
        node_volume[node] = {}
1048
      elif isinstance(lvdata, basestring):
1049
        feedback_fn("  - ERROR: LVM problem on node %s: %s" %
1050
                    (node, utils.SafeEncode(lvdata)))
1051
        bad = True
1052
        node_volume[node] = {}
1053
      elif not isinstance(lvdata, dict):
1054
        feedback_fn("  - ERROR: connection to %s failed (lvlist)" % (node,))
1055
        bad = True
1056
        continue
1057
      else:
1058
        node_volume[node] = lvdata
1059

    
1060
      # node_instance
1061
      idata = nresult.get(constants.NV_INSTANCELIST, None)
1062
      if not isinstance(idata, list):
1063
        feedback_fn("  - ERROR: connection to %s failed (instancelist)" %
1064
                    (node,))
1065
        bad = True
1066
        continue
1067

    
1068
      node_instance[node] = idata
1069

    
1070
      # node_info
1071
      nodeinfo = nresult.get(constants.NV_HVINFO, None)
1072
      if not isinstance(nodeinfo, dict):
1073
        feedback_fn("  - ERROR: connection to %s failed (hvinfo)" % (node,))
1074
        bad = True
1075
        continue
1076

    
1077
      try:
1078
        node_info[node] = {
1079
          "mfree": int(nodeinfo['memory_free']),
1080
          "pinst": [],
1081
          "sinst": [],
1082
          # dictionary holding all instances this node is secondary for,
1083
          # grouped by their primary node. Each key is a cluster node, and each
1084
          # value is a list of instances which have the key as primary and the
1085
          # current node as secondary.  this is handy to calculate N+1 memory
1086
          # availability if you can only failover from a primary to its
1087
          # secondary.
1088
          "sinst-by-pnode": {},
1089
        }
1090
        # FIXME: devise a free space model for file based instances as well
1091
        if vg_name is not None:
1092
          if (constants.NV_VGLIST not in nresult or
1093
              vg_name not in nresult[constants.NV_VGLIST]):
1094
            feedback_fn("  - ERROR: node %s didn't return data for the"
1095
                        " volume group '%s' - it is either missing or broken" %
1096
                        (node, vg_name))
1097
            bad = True
1098
            continue
1099
          node_info[node]["dfree"] = int(nresult[constants.NV_VGLIST][vg_name])
1100
      except (ValueError, KeyError):
1101
        feedback_fn("  - ERROR: invalid nodeinfo value returned"
1102
                    " from node %s" % (node,))
1103
        bad = True
1104
        continue
1105

    
1106
    node_vol_should = {}
1107

    
1108
    for instance in instancelist:
1109
      feedback_fn("* Verifying instance %s" % instance)
1110
      inst_config = instanceinfo[instance]
1111
      result =  self._VerifyInstance(instance, inst_config, node_volume,
1112
                                     node_instance, feedback_fn, n_offline)
1113
      bad = bad or result
1114
      inst_nodes_offline = []
1115

    
1116
      inst_config.MapLVsByNode(node_vol_should)
1117

    
1118
      instance_cfg[instance] = inst_config
1119

    
1120
      pnode = inst_config.primary_node
1121
      if pnode in node_info:
1122
        node_info[pnode]['pinst'].append(instance)
1123
      elif pnode not in n_offline:
1124
        feedback_fn("  - ERROR: instance %s, connection to primary node"
1125
                    " %s failed" % (instance, pnode))
1126
        bad = True
1127

    
1128
      if pnode in n_offline:
1129
        inst_nodes_offline.append(pnode)
1130

    
1131
      # If the instance is non-redundant we cannot survive losing its primary
1132
      # node, so we are not N+1 compliant. On the other hand we have no disk
1133
      # templates with more than one secondary so that situation is not well
1134
      # supported either.
1135
      # FIXME: does not support file-backed instances
1136
      if len(inst_config.secondary_nodes) == 0:
1137
        i_non_redundant.append(instance)
1138
      elif len(inst_config.secondary_nodes) > 1:
1139
        feedback_fn("  - WARNING: multiple secondaries for instance %s"
1140
                    % instance)
1141

    
1142
      if not cluster.FillBE(inst_config)[constants.BE_AUTO_BALANCE]:
1143
        i_non_a_balanced.append(instance)
1144

    
1145
      for snode in inst_config.secondary_nodes:
1146
        if snode in node_info:
1147
          node_info[snode]['sinst'].append(instance)
1148
          if pnode not in node_info[snode]['sinst-by-pnode']:
1149
            node_info[snode]['sinst-by-pnode'][pnode] = []
1150
          node_info[snode]['sinst-by-pnode'][pnode].append(instance)
1151
        elif snode not in n_offline:
1152
          feedback_fn("  - ERROR: instance %s, connection to secondary node"
1153
                      " %s failed" % (instance, snode))
1154
          bad = True
1155
        if snode in n_offline:
1156
          inst_nodes_offline.append(snode)
1157

    
1158
      if inst_nodes_offline:
1159
        # warn that the instance lives on offline nodes, and set bad=True
1160
        feedback_fn("  - ERROR: instance lives on offline node(s) %s" %
1161
                    ", ".join(inst_nodes_offline))
1162
        bad = True
1163

    
1164
    feedback_fn("* Verifying orphan volumes")
1165
    result = self._VerifyOrphanVolumes(node_vol_should, node_volume,
1166
                                       feedback_fn)
1167
    bad = bad or result
1168

    
1169
    feedback_fn("* Verifying remaining instances")
1170
    result = self._VerifyOrphanInstances(instancelist, node_instance,
1171
                                         feedback_fn)
1172
    bad = bad or result
1173

    
1174
    if constants.VERIFY_NPLUSONE_MEM not in self.skip_set:
1175
      feedback_fn("* Verifying N+1 Memory redundancy")
1176
      result = self._VerifyNPlusOneMemory(node_info, instance_cfg, feedback_fn)
1177
      bad = bad or result
1178

    
1179
    feedback_fn("* Other Notes")
1180
    if i_non_redundant:
1181
      feedback_fn("  - NOTICE: %d non-redundant instance(s) found."
1182
                  % len(i_non_redundant))
1183

    
1184
    if i_non_a_balanced:
1185
      feedback_fn("  - NOTICE: %d non-auto-balanced instance(s) found."
1186
                  % len(i_non_a_balanced))
1187

    
1188
    if n_offline:
1189
      feedback_fn("  - NOTICE: %d offline node(s) found." % len(n_offline))
1190

    
1191
    if n_drained:
1192
      feedback_fn("  - NOTICE: %d drained node(s) found." % len(n_drained))
1193

    
1194
    return not bad
1195

    
1196
  def HooksCallBack(self, phase, hooks_results, feedback_fn, lu_result):
1197
    """Analize the post-hooks' result
1198

1199
    This method analyses the hook result, handles it, and sends some
1200
    nicely-formatted feedback back to the user.
1201

1202
    @param phase: one of L{constants.HOOKS_PHASE_POST} or
1203
        L{constants.HOOKS_PHASE_PRE}; it denotes the hooks phase
1204
    @param hooks_results: the results of the multi-node hooks rpc call
1205
    @param feedback_fn: function used send feedback back to the caller
1206
    @param lu_result: previous Exec result
1207
    @return: the new Exec result, based on the previous result
1208
        and hook results
1209

1210
    """
1211
    # We only really run POST phase hooks, and are only interested in
1212
    # their results
1213
    if phase == constants.HOOKS_PHASE_POST:
1214
      # Used to change hooks' output to proper indentation
1215
      indent_re = re.compile('^', re.M)
1216
      feedback_fn("* Hooks Results")
1217
      if not hooks_results:
1218
        feedback_fn("  - ERROR: general communication failure")
1219
        lu_result = 1
1220
      else:
1221
        for node_name in hooks_results:
1222
          show_node_header = True
1223
          res = hooks_results[node_name]
1224
          if res.failed or res.data is False or not isinstance(res.data, list):
1225
            if res.offline:
1226
              # no need to warn or set fail return value
1227
              continue
1228
            feedback_fn("    Communication failure in hooks execution")
1229
            lu_result = 1
1230
            continue
1231
          for script, hkr, output in res.data:
1232
            if hkr == constants.HKR_FAIL:
1233
              # The node header is only shown once, if there are
1234
              # failing hooks on that node
1235
              if show_node_header:
1236
                feedback_fn("  Node %s:" % node_name)
1237
                show_node_header = False
1238
              feedback_fn("    ERROR: Script %s failed, output:" % script)
1239
              output = indent_re.sub('      ', output)
1240
              feedback_fn("%s" % output)
1241
              lu_result = 1
1242

    
1243
      return lu_result
1244

    
1245

    
1246
class LUVerifyDisks(NoHooksLU):
1247
  """Verifies the cluster disks status.
1248

1249
  """
1250
  _OP_REQP = []
1251
  REQ_BGL = False
1252

    
1253
  def ExpandNames(self):
1254
    self.needed_locks = {
1255
      locking.LEVEL_NODE: locking.ALL_SET,
1256
      locking.LEVEL_INSTANCE: locking.ALL_SET,
1257
    }
1258
    self.share_locks = dict(((i, 1) for i in locking.LEVELS))
1259

    
1260
  def CheckPrereq(self):
1261
    """Check prerequisites.
1262

1263
    This has no prerequisites.
1264

1265
    """
1266
    pass
1267

    
1268
  def Exec(self, feedback_fn):
1269
    """Verify integrity of cluster disks.
1270

1271
    """
1272
    result = res_nodes, res_nlvm, res_instances, res_missing = [], {}, [], {}
1273

    
1274
    vg_name = self.cfg.GetVGName()
1275
    nodes = utils.NiceSort(self.cfg.GetNodeList())
1276
    instances = [self.cfg.GetInstanceInfo(name)
1277
                 for name in self.cfg.GetInstanceList()]
1278

    
1279
    nv_dict = {}
1280
    for inst in instances:
1281
      inst_lvs = {}
1282
      if (not inst.admin_up or
1283
          inst.disk_template not in constants.DTS_NET_MIRROR):
1284
        continue
1285
      inst.MapLVsByNode(inst_lvs)
1286
      # transform { iname: {node: [vol,],},} to {(node, vol): iname}
1287
      for node, vol_list in inst_lvs.iteritems():
1288
        for vol in vol_list:
1289
          nv_dict[(node, vol)] = inst
1290

    
1291
    if not nv_dict:
1292
      return result
1293

    
1294
    node_lvs = self.rpc.call_volume_list(nodes, vg_name)
1295

    
1296
    to_act = set()
1297
    for node in nodes:
1298
      # node_volume
1299
      lvs = node_lvs[node]
1300
      if lvs.failed:
1301
        if not lvs.offline:
1302
          self.LogWarning("Connection to node %s failed: %s" %
1303
                          (node, lvs.data))
1304
        continue
1305
      lvs = lvs.data
1306
      if isinstance(lvs, basestring):
1307
        logging.warning("Error enumerating LVs on node %s: %s", node, lvs)
1308
        res_nlvm[node] = lvs
1309
        continue
1310
      elif not isinstance(lvs, dict):
1311
        logging.warning("Connection to node %s failed or invalid data"
1312
                        " returned", node)
1313
        res_nodes.append(node)
1314
        continue
1315

    
1316
      for lv_name, (_, lv_inactive, lv_online) in lvs.iteritems():
1317
        inst = nv_dict.pop((node, lv_name), None)
1318
        if (not lv_online and inst is not None
1319
            and inst.name not in res_instances):
1320
          res_instances.append(inst.name)
1321

    
1322
    # any leftover items in nv_dict are missing LVs, let's arrange the
1323
    # data better
1324
    for key, inst in nv_dict.iteritems():
1325
      if inst.name not in res_missing:
1326
        res_missing[inst.name] = []
1327
      res_missing[inst.name].append(key)
1328

    
1329
    return result
1330

    
1331

    
1332
class LURenameCluster(LogicalUnit):
1333
  """Rename the cluster.
1334

1335
  """
1336
  HPATH = "cluster-rename"
1337
  HTYPE = constants.HTYPE_CLUSTER
1338
  _OP_REQP = ["name"]
1339

    
1340
  def BuildHooksEnv(self):
1341
    """Build hooks env.
1342

1343
    """
1344
    env = {
1345
      "OP_TARGET": self.cfg.GetClusterName(),
1346
      "NEW_NAME": self.op.name,
1347
      }
1348
    mn = self.cfg.GetMasterNode()
1349
    return env, [mn], [mn]
1350

    
1351
  def CheckPrereq(self):
1352
    """Verify that the passed name is a valid one.
1353

1354
    """
1355
    hostname = utils.HostInfo(self.op.name)
1356

    
1357
    new_name = hostname.name
1358
    self.ip = new_ip = hostname.ip
1359
    old_name = self.cfg.GetClusterName()
1360
    old_ip = self.cfg.GetMasterIP()
1361
    if new_name == old_name and new_ip == old_ip:
1362
      raise errors.OpPrereqError("Neither the name nor the IP address of the"
1363
                                 " cluster has changed")
1364
    if new_ip != old_ip:
1365
      if utils.TcpPing(new_ip, constants.DEFAULT_NODED_PORT):
1366
        raise errors.OpPrereqError("The given cluster IP address (%s) is"
1367
                                   " reachable on the network. Aborting." %
1368
                                   new_ip)
1369

    
1370
    self.op.name = new_name
1371

    
1372
  def Exec(self, feedback_fn):
1373
    """Rename the cluster.
1374

1375
    """
1376
    clustername = self.op.name
1377
    ip = self.ip
1378

    
1379
    # shutdown the master IP
1380
    master = self.cfg.GetMasterNode()
1381
    result = self.rpc.call_node_stop_master(master, False)
1382
    if result.failed or not result.data:
1383
      raise errors.OpExecError("Could not disable the master role")
1384

    
1385
    try:
1386
      cluster = self.cfg.GetClusterInfo()
1387
      cluster.cluster_name = clustername
1388
      cluster.master_ip = ip
1389
      self.cfg.Update(cluster)
1390

    
1391
      # update the known hosts file
1392
      ssh.WriteKnownHostsFile(self.cfg, constants.SSH_KNOWN_HOSTS_FILE)
1393
      node_list = self.cfg.GetNodeList()
1394
      try:
1395
        node_list.remove(master)
1396
      except ValueError:
1397
        pass
1398
      result = self.rpc.call_upload_file(node_list,
1399
                                         constants.SSH_KNOWN_HOSTS_FILE)
1400
      for to_node, to_result in result.iteritems():
1401
        if to_result.failed or not to_result.data:
1402
          logging.error("Copy of file %s to node %s failed",
1403
                        constants.SSH_KNOWN_HOSTS_FILE, to_node)
1404

    
1405
    finally:
1406
      result = self.rpc.call_node_start_master(master, False)
1407
      if result.failed or not result.data:
1408
        self.LogWarning("Could not re-enable the master role on"
1409
                        " the master, please restart manually.")
1410

    
1411

    
1412
def _RecursiveCheckIfLVMBased(disk):
1413
  """Check if the given disk or its children are lvm-based.
1414

1415
  @type disk: L{objects.Disk}
1416
  @param disk: the disk to check
1417
  @rtype: booleean
1418
  @return: boolean indicating whether a LD_LV dev_type was found or not
1419

1420
  """
1421
  if disk.children:
1422
    for chdisk in disk.children:
1423
      if _RecursiveCheckIfLVMBased(chdisk):
1424
        return True
1425
  return disk.dev_type == constants.LD_LV
1426

    
1427

    
1428
class LUSetClusterParams(LogicalUnit):
1429
  """Change the parameters of the cluster.
1430

1431
  """
1432
  HPATH = "cluster-modify"
1433
  HTYPE = constants.HTYPE_CLUSTER
1434
  _OP_REQP = []
1435
  REQ_BGL = False
1436

    
1437
  def CheckArguments(self):
1438
    """Check parameters
1439

1440
    """
1441
    if not hasattr(self.op, "candidate_pool_size"):
1442
      self.op.candidate_pool_size = None
1443
    if self.op.candidate_pool_size is not None:
1444
      try:
1445
        self.op.candidate_pool_size = int(self.op.candidate_pool_size)
1446
      except (ValueError, TypeError), err:
1447
        raise errors.OpPrereqError("Invalid candidate_pool_size value: %s" %
1448
                                   str(err))
1449
      if self.op.candidate_pool_size < 1:
1450
        raise errors.OpPrereqError("At least one master candidate needed")
1451

    
1452
  def ExpandNames(self):
1453
    # FIXME: in the future maybe other cluster params won't require checking on
1454
    # all nodes to be modified.
1455
    self.needed_locks = {
1456
      locking.LEVEL_NODE: locking.ALL_SET,
1457
    }
1458
    self.share_locks[locking.LEVEL_NODE] = 1
1459

    
1460
  def BuildHooksEnv(self):
1461
    """Build hooks env.
1462

1463
    """
1464
    env = {
1465
      "OP_TARGET": self.cfg.GetClusterName(),
1466
      "NEW_VG_NAME": self.op.vg_name,
1467
      }
1468
    mn = self.cfg.GetMasterNode()
1469
    return env, [mn], [mn]
1470

    
1471
  def CheckPrereq(self):
1472
    """Check prerequisites.
1473

1474
    This checks whether the given params don't conflict and
1475
    if the given volume group is valid.
1476

1477
    """
1478
    if self.op.vg_name is not None and not self.op.vg_name:
1479
      instances = self.cfg.GetAllInstancesInfo().values()
1480
      for inst in instances:
1481
        for disk in inst.disks:
1482
          if _RecursiveCheckIfLVMBased(disk):
1483
            raise errors.OpPrereqError("Cannot disable lvm storage while"
1484
                                       " lvm-based instances exist")
1485

    
1486
    node_list = self.acquired_locks[locking.LEVEL_NODE]
1487

    
1488
    # if vg_name not None, checks given volume group on all nodes
1489
    if self.op.vg_name:
1490
      vglist = self.rpc.call_vg_list(node_list)
1491
      for node in node_list:
1492
        if vglist[node].failed:
1493
          # ignoring down node
1494
          self.LogWarning("Node %s unreachable/error, ignoring" % node)
1495
          continue
1496
        vgstatus = utils.CheckVolumeGroupSize(vglist[node].data,
1497
                                              self.op.vg_name,
1498
                                              constants.MIN_VG_SIZE)
1499
        if vgstatus:
1500
          raise errors.OpPrereqError("Error on node '%s': %s" %
1501
                                     (node, vgstatus))
1502

    
1503
    self.cluster = cluster = self.cfg.GetClusterInfo()
1504
    # validate beparams changes
1505
    if self.op.beparams:
1506
      utils.ForceDictType(self.op.beparams, constants.BES_PARAMETER_TYPES)
1507
      self.new_beparams = cluster.FillDict(
1508
        cluster.beparams[constants.BEGR_DEFAULT], self.op.beparams)
1509

    
1510
    # hypervisor list/parameters
1511
    self.new_hvparams = cluster.FillDict(cluster.hvparams, {})
1512
    if self.op.hvparams:
1513
      if not isinstance(self.op.hvparams, dict):
1514
        raise errors.OpPrereqError("Invalid 'hvparams' parameter on input")
1515
      for hv_name, hv_dict in self.op.hvparams.items():
1516
        if hv_name not in self.new_hvparams:
1517
          self.new_hvparams[hv_name] = hv_dict
1518
        else:
1519
          self.new_hvparams[hv_name].update(hv_dict)
1520

    
1521
    if self.op.enabled_hypervisors is not None:
1522
      self.hv_list = self.op.enabled_hypervisors
1523
    else:
1524
      self.hv_list = cluster.enabled_hypervisors
1525

    
1526
    if self.op.hvparams or self.op.enabled_hypervisors is not None:
1527
      # either the enabled list has changed, or the parameters have, validate
1528
      for hv_name, hv_params in self.new_hvparams.items():
1529
        if ((self.op.hvparams and hv_name in self.op.hvparams) or
1530
            (self.op.enabled_hypervisors and
1531
             hv_name in self.op.enabled_hypervisors)):
1532
          # either this is a new hypervisor, or its parameters have changed
1533
          hv_class = hypervisor.GetHypervisor(hv_name)
1534
          utils.ForceDictType(hv_params, constants.HVS_PARAMETER_TYPES)
1535
          hv_class.CheckParameterSyntax(hv_params)
1536
          _CheckHVParams(self, node_list, hv_name, hv_params)
1537

    
1538
  def Exec(self, feedback_fn):
1539
    """Change the parameters of the cluster.
1540

1541
    """
1542
    if self.op.vg_name is not None:
1543
      new_volume = self.op.vg_name
1544
      if not new_volume:
1545
        new_volume = None
1546
      if new_volume != self.cfg.GetVGName():
1547
        self.cfg.SetVGName(new_volume)
1548
      else:
1549
        feedback_fn("Cluster LVM configuration already in desired"
1550
                    " state, not changing")
1551
    if self.op.hvparams:
1552
      self.cluster.hvparams = self.new_hvparams
1553
    if self.op.enabled_hypervisors is not None:
1554
      self.cluster.enabled_hypervisors = self.op.enabled_hypervisors
1555
    if self.op.beparams:
1556
      self.cluster.beparams[constants.BEGR_DEFAULT] = self.new_beparams
1557
    if self.op.candidate_pool_size is not None:
1558
      self.cluster.candidate_pool_size = self.op.candidate_pool_size
1559

    
1560
    self.cfg.Update(self.cluster)
1561

    
1562
    # we want to update nodes after the cluster so that if any errors
1563
    # happen, we have recorded and saved the cluster info
1564
    if self.op.candidate_pool_size is not None:
1565
      _AdjustCandidatePool(self)
1566

    
1567

    
1568
class LURedistributeConfig(NoHooksLU):
1569
  """Force the redistribution of cluster configuration.
1570

1571
  This is a very simple LU.
1572

1573
  """
1574
  _OP_REQP = []
1575
  REQ_BGL = False
1576

    
1577
  def ExpandNames(self):
1578
    self.needed_locks = {
1579
      locking.LEVEL_NODE: locking.ALL_SET,
1580
    }
1581
    self.share_locks[locking.LEVEL_NODE] = 1
1582

    
1583
  def CheckPrereq(self):
1584
    """Check prerequisites.
1585

1586
    """
1587

    
1588
  def Exec(self, feedback_fn):
1589
    """Redistribute the configuration.
1590

1591
    """
1592
    self.cfg.Update(self.cfg.GetClusterInfo())
1593

    
1594

    
1595
def _WaitForSync(lu, instance, oneshot=False, unlock=False):
1596
  """Sleep and poll for an instance's disk to sync.
1597

1598
  """
1599
  if not instance.disks:
1600
    return True
1601

    
1602
  if not oneshot:
1603
    lu.proc.LogInfo("Waiting for instance %s to sync disks." % instance.name)
1604

    
1605
  node = instance.primary_node
1606

    
1607
  for dev in instance.disks:
1608
    lu.cfg.SetDiskID(dev, node)
1609

    
1610
  retries = 0
1611
  degr_retries = 10 # in seconds, as we sleep 1 second each time
1612
  while True:
1613
    max_time = 0
1614
    done = True
1615
    cumul_degraded = False
1616
    rstats = lu.rpc.call_blockdev_getmirrorstatus(node, instance.disks)
1617
    if rstats.failed or not rstats.data:
1618
      lu.LogWarning("Can't get any data from node %s", node)
1619
      retries += 1
1620
      if retries >= 10:
1621
        raise errors.RemoteError("Can't contact node %s for mirror data,"
1622
                                 " aborting." % node)
1623
      time.sleep(6)
1624
      continue
1625
    rstats = rstats.data
1626
    retries = 0
1627
    for i, mstat in enumerate(rstats):
1628
      if mstat is None:
1629
        lu.LogWarning("Can't compute data for node %s/%s",
1630
                           node, instance.disks[i].iv_name)
1631
        continue
1632
      # we ignore the ldisk parameter
1633
      perc_done, est_time, is_degraded, _ = mstat
1634
      cumul_degraded = cumul_degraded or (is_degraded and perc_done is None)
1635
      if perc_done is not None:
1636
        done = False
1637
        if est_time is not None:
1638
          rem_time = "%d estimated seconds remaining" % est_time
1639
          max_time = est_time
1640
        else:
1641
          rem_time = "no time estimate"
1642
        lu.proc.LogInfo("- device %s: %5.2f%% done, %s" %
1643
                        (instance.disks[i].iv_name, perc_done, rem_time))
1644

    
1645
    # if we're done but degraded, let's do a few small retries, to
1646
    # make sure we see a stable and not transient situation; therefore
1647
    # we force restart of the loop
1648
    if (done or oneshot) and cumul_degraded and degr_retries > 0:
1649
      logging.info("Degraded disks found, %d retries left", degr_retries)
1650
      degr_retries -= 1
1651
      time.sleep(1)
1652
      continue
1653

    
1654
    if done or oneshot:
1655
      break
1656

    
1657
    time.sleep(min(60, max_time))
1658

    
1659
  if done:
1660
    lu.proc.LogInfo("Instance %s's disks are in sync." % instance.name)
1661
  return not cumul_degraded
1662

    
1663

    
1664
def _CheckDiskConsistency(lu, dev, node, on_primary, ldisk=False):
1665
  """Check that mirrors are not degraded.
1666

1667
  The ldisk parameter, if True, will change the test from the
1668
  is_degraded attribute (which represents overall non-ok status for
1669
  the device(s)) to the ldisk (representing the local storage status).
1670

1671
  """
1672
  lu.cfg.SetDiskID(dev, node)
1673
  if ldisk:
1674
    idx = 6
1675
  else:
1676
    idx = 5
1677

    
1678
  result = True
1679
  if on_primary or dev.AssembleOnSecondary():
1680
    rstats = lu.rpc.call_blockdev_find(node, dev)
1681
    msg = rstats.RemoteFailMsg()
1682
    if msg:
1683
      lu.LogWarning("Can't find disk on node %s: %s", node, msg)
1684
      result = False
1685
    elif not rstats.payload:
1686
      lu.LogWarning("Can't find disk on node %s", node)
1687
      result = False
1688
    else:
1689
      result = result and (not rstats.payload[idx])
1690
  if dev.children:
1691
    for child in dev.children:
1692
      result = result and _CheckDiskConsistency(lu, child, node, on_primary)
1693

    
1694
  return result
1695

    
1696

    
1697
class LUDiagnoseOS(NoHooksLU):
1698
  """Logical unit for OS diagnose/query.
1699

1700
  """
1701
  _OP_REQP = ["output_fields", "names"]
1702
  REQ_BGL = False
1703
  _FIELDS_STATIC = utils.FieldSet()
1704
  _FIELDS_DYNAMIC = utils.FieldSet("name", "valid", "node_status")
1705

    
1706
  def ExpandNames(self):
1707
    if self.op.names:
1708
      raise errors.OpPrereqError("Selective OS query not supported")
1709

    
1710
    _CheckOutputFields(static=self._FIELDS_STATIC,
1711
                       dynamic=self._FIELDS_DYNAMIC,
1712
                       selected=self.op.output_fields)
1713

    
1714
    # Lock all nodes, in shared mode
1715
    # Temporary removal of locks, should be reverted later
1716
    # TODO: reintroduce locks when they are lighter-weight
1717
    self.needed_locks = {}
1718
    #self.share_locks[locking.LEVEL_NODE] = 1
1719
    #self.needed_locks[locking.LEVEL_NODE] = locking.ALL_SET
1720

    
1721
  def CheckPrereq(self):
1722
    """Check prerequisites.
1723

1724
    """
1725

    
1726
  @staticmethod
1727
  def _DiagnoseByOS(node_list, rlist):
1728
    """Remaps a per-node return list into an a per-os per-node dictionary
1729

1730
    @param node_list: a list with the names of all nodes
1731
    @param rlist: a map with node names as keys and OS objects as values
1732

1733
    @rtype: dict
1734
    @return: a dictionary with osnames as keys and as value another map, with
1735
        nodes as keys and list of OS objects as values, eg::
1736

1737
          {"debian-etch": {"node1": [<object>,...],
1738
                           "node2": [<object>,]}
1739
          }
1740

1741
    """
1742
    all_os = {}
1743
    # we build here the list of nodes that didn't fail the RPC (at RPC
1744
    # level), so that nodes with a non-responding node daemon don't
1745
    # make all OSes invalid
1746
    good_nodes = [node_name for node_name in rlist
1747
                  if not rlist[node_name].failed]
1748
    for node_name, nr in rlist.iteritems():
1749
      if nr.failed or not nr.data:
1750
        continue
1751
      for os_obj in nr.data:
1752
        if os_obj.name not in all_os:
1753
          # build a list of nodes for this os containing empty lists
1754
          # for each node in node_list
1755
          all_os[os_obj.name] = {}
1756
          for nname in good_nodes:
1757
            all_os[os_obj.name][nname] = []
1758
        all_os[os_obj.name][node_name].append(os_obj)
1759
    return all_os
1760

    
1761
  def Exec(self, feedback_fn):
1762
    """Compute the list of OSes.
1763

1764
    """
1765
    valid_nodes = [node for node in self.cfg.GetOnlineNodeList()]
1766
    node_data = self.rpc.call_os_diagnose(valid_nodes)
1767
    if node_data == False:
1768
      raise errors.OpExecError("Can't gather the list of OSes")
1769
    pol = self._DiagnoseByOS(valid_nodes, node_data)
1770
    output = []
1771
    for os_name, os_data in pol.iteritems():
1772
      row = []
1773
      for field in self.op.output_fields:
1774
        if field == "name":
1775
          val = os_name
1776
        elif field == "valid":
1777
          val = utils.all([osl and osl[0] for osl in os_data.values()])
1778
        elif field == "node_status":
1779
          val = {}
1780
          for node_name, nos_list in os_data.iteritems():
1781
            val[node_name] = [(v.status, v.path) for v in nos_list]
1782
        else:
1783
          raise errors.ParameterError(field)
1784
        row.append(val)
1785
      output.append(row)
1786

    
1787
    return output
1788

    
1789

    
1790
class LURemoveNode(LogicalUnit):
1791
  """Logical unit for removing a node.
1792

1793
  """
1794
  HPATH = "node-remove"
1795
  HTYPE = constants.HTYPE_NODE
1796
  _OP_REQP = ["node_name"]
1797

    
1798
  def BuildHooksEnv(self):
1799
    """Build hooks env.
1800

1801
    This doesn't run on the target node in the pre phase as a failed
1802
    node would then be impossible to remove.
1803

1804
    """
1805
    env = {
1806
      "OP_TARGET": self.op.node_name,
1807
      "NODE_NAME": self.op.node_name,
1808
      }
1809
    all_nodes = self.cfg.GetNodeList()
1810
    all_nodes.remove(self.op.node_name)
1811
    return env, all_nodes, all_nodes
1812

    
1813
  def CheckPrereq(self):
1814
    """Check prerequisites.
1815

1816
    This checks:
1817
     - the node exists in the configuration
1818
     - it does not have primary or secondary instances
1819
     - it's not the master
1820

1821
    Any errors are signalled by raising errors.OpPrereqError.
1822

1823
    """
1824
    node = self.cfg.GetNodeInfo(self.cfg.ExpandNodeName(self.op.node_name))
1825
    if node is None:
1826
      raise errors.OpPrereqError, ("Node '%s' is unknown." % self.op.node_name)
1827

    
1828
    instance_list = self.cfg.GetInstanceList()
1829

    
1830
    masternode = self.cfg.GetMasterNode()
1831
    if node.name == masternode:
1832
      raise errors.OpPrereqError("Node is the master node,"
1833
                                 " you need to failover first.")
1834

    
1835
    for instance_name in instance_list:
1836
      instance = self.cfg.GetInstanceInfo(instance_name)
1837
      if node.name in instance.all_nodes:
1838
        raise errors.OpPrereqError("Instance %s is still running on the node,"
1839
                                   " please remove first." % instance_name)
1840
    self.op.node_name = node.name
1841
    self.node = node
1842

    
1843
  def Exec(self, feedback_fn):
1844
    """Removes the node from the cluster.
1845

1846
    """
1847
    node = self.node
1848
    logging.info("Stopping the node daemon and removing configs from node %s",
1849
                 node.name)
1850

    
1851
    self.context.RemoveNode(node.name)
1852

    
1853
    self.rpc.call_node_leave_cluster(node.name)
1854

    
1855
    # Promote nodes to master candidate as needed
1856
    _AdjustCandidatePool(self)
1857

    
1858

    
1859
class LUQueryNodes(NoHooksLU):
1860
  """Logical unit for querying nodes.
1861

1862
  """
1863
  _OP_REQP = ["output_fields", "names", "use_locking"]
1864
  REQ_BGL = False
1865
  _FIELDS_DYNAMIC = utils.FieldSet(
1866
    "dtotal", "dfree",
1867
    "mtotal", "mnode", "mfree",
1868
    "bootid",
1869
    "ctotal", "cnodes", "csockets",
1870
    )
1871

    
1872
  _FIELDS_STATIC = utils.FieldSet(
1873
    "name", "pinst_cnt", "sinst_cnt",
1874
    "pinst_list", "sinst_list",
1875
    "pip", "sip", "tags",
1876
    "serial_no",
1877
    "master_candidate",
1878
    "master",
1879
    "offline",
1880
    "drained",
1881
    "role",
1882
    )
1883

    
1884
  def ExpandNames(self):
1885
    _CheckOutputFields(static=self._FIELDS_STATIC,
1886
                       dynamic=self._FIELDS_DYNAMIC,
1887
                       selected=self.op.output_fields)
1888

    
1889
    self.needed_locks = {}
1890
    self.share_locks[locking.LEVEL_NODE] = 1
1891

    
1892
    if self.op.names:
1893
      self.wanted = _GetWantedNodes(self, self.op.names)
1894
    else:
1895
      self.wanted = locking.ALL_SET
1896

    
1897
    self.do_node_query = self._FIELDS_STATIC.NonMatching(self.op.output_fields)
1898
    self.do_locking = self.do_node_query and self.op.use_locking
1899
    if self.do_locking:
1900
      # if we don't request only static fields, we need to lock the nodes
1901
      self.needed_locks[locking.LEVEL_NODE] = self.wanted
1902

    
1903

    
1904
  def CheckPrereq(self):
1905
    """Check prerequisites.
1906

1907
    """
1908
    # The validation of the node list is done in the _GetWantedNodes,
1909
    # if non empty, and if empty, there's no validation to do
1910
    pass
1911

    
1912
  def Exec(self, feedback_fn):
1913
    """Computes the list of nodes and their attributes.
1914

1915
    """
1916
    all_info = self.cfg.GetAllNodesInfo()
1917
    if self.do_locking:
1918
      nodenames = self.acquired_locks[locking.LEVEL_NODE]
1919
    elif self.wanted != locking.ALL_SET:
1920
      nodenames = self.wanted
1921
      missing = set(nodenames).difference(all_info.keys())
1922
      if missing:
1923
        raise errors.OpExecError(
1924
          "Some nodes were removed before retrieving their data: %s" % missing)
1925
    else:
1926
      nodenames = all_info.keys()
1927

    
1928
    nodenames = utils.NiceSort(nodenames)
1929
    nodelist = [all_info[name] for name in nodenames]
1930

    
1931
    # begin data gathering
1932

    
1933
    if self.do_node_query:
1934
      live_data = {}
1935
      node_data = self.rpc.call_node_info(nodenames, self.cfg.GetVGName(),
1936
                                          self.cfg.GetHypervisorType())
1937
      for name in nodenames:
1938
        nodeinfo = node_data[name]
1939
        if not nodeinfo.failed and nodeinfo.data:
1940
          nodeinfo = nodeinfo.data
1941
          fn = utils.TryConvert
1942
          live_data[name] = {
1943
            "mtotal": fn(int, nodeinfo.get('memory_total', None)),
1944
            "mnode": fn(int, nodeinfo.get('memory_dom0', None)),
1945
            "mfree": fn(int, nodeinfo.get('memory_free', None)),
1946
            "dtotal": fn(int, nodeinfo.get('vg_size', None)),
1947
            "dfree": fn(int, nodeinfo.get('vg_free', None)),
1948
            "ctotal": fn(int, nodeinfo.get('cpu_total', None)),
1949
            "bootid": nodeinfo.get('bootid', None),
1950
            "cnodes": fn(int, nodeinfo.get('cpu_nodes', None)),
1951
            "csockets": fn(int, nodeinfo.get('cpu_sockets', None)),
1952
            }
1953
        else:
1954
          live_data[name] = {}
1955
    else:
1956
      live_data = dict.fromkeys(nodenames, {})
1957

    
1958
    node_to_primary = dict([(name, set()) for name in nodenames])
1959
    node_to_secondary = dict([(name, set()) for name in nodenames])
1960

    
1961
    inst_fields = frozenset(("pinst_cnt", "pinst_list",
1962
                             "sinst_cnt", "sinst_list"))
1963
    if inst_fields & frozenset(self.op.output_fields):
1964
      instancelist = self.cfg.GetInstanceList()
1965

    
1966
      for instance_name in instancelist:
1967
        inst = self.cfg.GetInstanceInfo(instance_name)
1968
        if inst.primary_node in node_to_primary:
1969
          node_to_primary[inst.primary_node].add(inst.name)
1970
        for secnode in inst.secondary_nodes:
1971
          if secnode in node_to_secondary:
1972
            node_to_secondary[secnode].add(inst.name)
1973

    
1974
    master_node = self.cfg.GetMasterNode()
1975

    
1976
    # end data gathering
1977

    
1978
    output = []
1979
    for node in nodelist:
1980
      node_output = []
1981
      for field in self.op.output_fields:
1982
        if field == "name":
1983
          val = node.name
1984
        elif field == "pinst_list":
1985
          val = list(node_to_primary[node.name])
1986
        elif field == "sinst_list":
1987
          val = list(node_to_secondary[node.name])
1988
        elif field == "pinst_cnt":
1989
          val = len(node_to_primary[node.name])
1990
        elif field == "sinst_cnt":
1991
          val = len(node_to_secondary[node.name])
1992
        elif field == "pip":
1993
          val = node.primary_ip
1994
        elif field == "sip":
1995
          val = node.secondary_ip
1996
        elif field == "tags":
1997
          val = list(node.GetTags())
1998
        elif field == "serial_no":
1999
          val = node.serial_no
2000
        elif field == "master_candidate":
2001
          val = node.master_candidate
2002
        elif field == "master":
2003
          val = node.name == master_node
2004
        elif field == "offline":
2005
          val = node.offline
2006
        elif field == "drained":
2007
          val = node.drained
2008
        elif self._FIELDS_DYNAMIC.Matches(field):
2009
          val = live_data[node.name].get(field, None)
2010
        elif field == "role":
2011
          if node.name == master_node:
2012
            val = "M"
2013
          elif node.master_candidate:
2014
            val = "C"
2015
          elif node.drained:
2016
            val = "D"
2017
          elif node.offline:
2018
            val = "O"
2019
          else:
2020
            val = "R"
2021
        else:
2022
          raise errors.ParameterError(field)
2023
        node_output.append(val)
2024
      output.append(node_output)
2025

    
2026
    return output
2027

    
2028

    
2029
class LUQueryNodeVolumes(NoHooksLU):
2030
  """Logical unit for getting volumes on node(s).
2031

2032
  """
2033
  _OP_REQP = ["nodes", "output_fields"]
2034
  REQ_BGL = False
2035
  _FIELDS_DYNAMIC = utils.FieldSet("phys", "vg", "name", "size", "instance")
2036
  _FIELDS_STATIC = utils.FieldSet("node")
2037

    
2038
  def ExpandNames(self):
2039
    _CheckOutputFields(static=self._FIELDS_STATIC,
2040
                       dynamic=self._FIELDS_DYNAMIC,
2041
                       selected=self.op.output_fields)
2042

    
2043
    self.needed_locks = {}
2044
    self.share_locks[locking.LEVEL_NODE] = 1
2045
    if not self.op.nodes:
2046
      self.needed_locks[locking.LEVEL_NODE] = locking.ALL_SET
2047
    else:
2048
      self.needed_locks[locking.LEVEL_NODE] = \
2049
        _GetWantedNodes(self, self.op.nodes)
2050

    
2051
  def CheckPrereq(self):
2052
    """Check prerequisites.
2053

2054
    This checks that the fields required are valid output fields.
2055

2056
    """
2057
    self.nodes = self.acquired_locks[locking.LEVEL_NODE]
2058

    
2059
  def Exec(self, feedback_fn):
2060
    """Computes the list of nodes and their attributes.
2061

2062
    """
2063
    nodenames = self.nodes
2064
    volumes = self.rpc.call_node_volumes(nodenames)
2065

    
2066
    ilist = [self.cfg.GetInstanceInfo(iname) for iname
2067
             in self.cfg.GetInstanceList()]
2068

    
2069
    lv_by_node = dict([(inst, inst.MapLVsByNode()) for inst in ilist])
2070

    
2071
    output = []
2072
    for node in nodenames:
2073
      if node not in volumes or volumes[node].failed or not volumes[node].data:
2074
        continue
2075

    
2076
      node_vols = volumes[node].data[:]
2077
      node_vols.sort(key=lambda vol: vol['dev'])
2078

    
2079
      for vol in node_vols:
2080
        node_output = []
2081
        for field in self.op.output_fields:
2082
          if field == "node":
2083
            val = node
2084
          elif field == "phys":
2085
            val = vol['dev']
2086
          elif field == "vg":
2087
            val = vol['vg']
2088
          elif field == "name":
2089
            val = vol['name']
2090
          elif field == "size":
2091
            val = int(float(vol['size']))
2092
          elif field == "instance":
2093
            for inst in ilist:
2094
              if node not in lv_by_node[inst]:
2095
                continue
2096
              if vol['name'] in lv_by_node[inst][node]:
2097
                val = inst.name
2098
                break
2099
            else:
2100
              val = '-'
2101
          else:
2102
            raise errors.ParameterError(field)
2103
          node_output.append(str(val))
2104

    
2105
        output.append(node_output)
2106

    
2107
    return output
2108

    
2109

    
2110
class LUAddNode(LogicalUnit):
2111
  """Logical unit for adding node to the cluster.
2112

2113
  """
2114
  HPATH = "node-add"
2115
  HTYPE = constants.HTYPE_NODE
2116
  _OP_REQP = ["node_name"]
2117

    
2118
  def BuildHooksEnv(self):
2119
    """Build hooks env.
2120

2121
    This will run on all nodes before, and on all nodes + the new node after.
2122

2123
    """
2124
    env = {
2125
      "OP_TARGET": self.op.node_name,
2126
      "NODE_NAME": self.op.node_name,
2127
      "NODE_PIP": self.op.primary_ip,
2128
      "NODE_SIP": self.op.secondary_ip,
2129
      }
2130
    nodes_0 = self.cfg.GetNodeList()
2131
    nodes_1 = nodes_0 + [self.op.node_name, ]
2132
    return env, nodes_0, nodes_1
2133

    
2134
  def CheckPrereq(self):
2135
    """Check prerequisites.
2136

2137
    This checks:
2138
     - the new node is not already in the config
2139
     - it is resolvable
2140
     - its parameters (single/dual homed) matches the cluster
2141

2142
    Any errors are signalled by raising errors.OpPrereqError.
2143

2144
    """
2145
    node_name = self.op.node_name
2146
    cfg = self.cfg
2147

    
2148
    dns_data = utils.HostInfo(node_name)
2149

    
2150
    node = dns_data.name
2151
    primary_ip = self.op.primary_ip = dns_data.ip
2152
    secondary_ip = getattr(self.op, "secondary_ip", None)
2153
    if secondary_ip is None:
2154
      secondary_ip = primary_ip
2155
    if not utils.IsValidIP(secondary_ip):
2156
      raise errors.OpPrereqError("Invalid secondary IP given")
2157
    self.op.secondary_ip = secondary_ip
2158

    
2159
    node_list = cfg.GetNodeList()
2160
    if not self.op.readd and node in node_list:
2161
      raise errors.OpPrereqError("Node %s is already in the configuration" %
2162
                                 node)
2163
    elif self.op.readd and node not in node_list:
2164
      raise errors.OpPrereqError("Node %s is not in the configuration" % node)
2165

    
2166
    for existing_node_name in node_list:
2167
      existing_node = cfg.GetNodeInfo(existing_node_name)
2168

    
2169
      if self.op.readd and node == existing_node_name:
2170
        if (existing_node.primary_ip != primary_ip or
2171
            existing_node.secondary_ip != secondary_ip):
2172
          raise errors.OpPrereqError("Readded node doesn't have the same IP"
2173
                                     " address configuration as before")
2174
        continue
2175

    
2176
      if (existing_node.primary_ip == primary_ip or
2177
          existing_node.secondary_ip == primary_ip or
2178
          existing_node.primary_ip == secondary_ip or
2179
          existing_node.secondary_ip == secondary_ip):
2180
        raise errors.OpPrereqError("New node ip address(es) conflict with"
2181
                                   " existing node %s" % existing_node.name)
2182

    
2183
    # check that the type of the node (single versus dual homed) is the
2184
    # same as for the master
2185
    myself = cfg.GetNodeInfo(self.cfg.GetMasterNode())
2186
    master_singlehomed = myself.secondary_ip == myself.primary_ip
2187
    newbie_singlehomed = secondary_ip == primary_ip
2188
    if master_singlehomed != newbie_singlehomed:
2189
      if master_singlehomed:
2190
        raise errors.OpPrereqError("The master has no private ip but the"
2191
                                   " new node has one")
2192
      else:
2193
        raise errors.OpPrereqError("The master has a private ip but the"
2194
                                   " new node doesn't have one")
2195

    
2196
    # checks reachablity
2197
    if not utils.TcpPing(primary_ip, constants.DEFAULT_NODED_PORT):
2198
      raise errors.OpPrereqError("Node not reachable by ping")
2199

    
2200
    if not newbie_singlehomed:
2201
      # check reachability from my secondary ip to newbie's secondary ip
2202
      if not utils.TcpPing(secondary_ip, constants.DEFAULT_NODED_PORT,
2203
                           source=myself.secondary_ip):
2204
        raise errors.OpPrereqError("Node secondary ip not reachable by TCP"
2205
                                   " based ping to noded port")
2206

    
2207
    cp_size = self.cfg.GetClusterInfo().candidate_pool_size
2208
    mc_now, _ = self.cfg.GetMasterCandidateStats()
2209
    master_candidate = mc_now < cp_size
2210

    
2211
    self.new_node = objects.Node(name=node,
2212
                                 primary_ip=primary_ip,
2213
                                 secondary_ip=secondary_ip,
2214
                                 master_candidate=master_candidate,
2215
                                 offline=False, drained=False)
2216

    
2217
  def Exec(self, feedback_fn):
2218
    """Adds the new node to the cluster.
2219

2220
    """
2221
    new_node = self.new_node
2222
    node = new_node.name
2223

    
2224
    # check connectivity
2225
    result = self.rpc.call_version([node])[node]
2226
    result.Raise()
2227
    if result.data:
2228
      if constants.PROTOCOL_VERSION == result.data:
2229
        logging.info("Communication to node %s fine, sw version %s match",
2230
                     node, result.data)
2231
      else:
2232
        raise errors.OpExecError("Version mismatch master version %s,"
2233
                                 " node version %s" %
2234
                                 (constants.PROTOCOL_VERSION, result.data))
2235
    else:
2236
      raise errors.OpExecError("Cannot get version from the new node")
2237

    
2238
    # setup ssh on node
2239
    logging.info("Copy ssh key to node %s", node)
2240
    priv_key, pub_key, _ = ssh.GetUserFiles(constants.GANETI_RUNAS)
2241
    keyarray = []
2242
    keyfiles = [constants.SSH_HOST_DSA_PRIV, constants.SSH_HOST_DSA_PUB,
2243
                constants.SSH_HOST_RSA_PRIV, constants.SSH_HOST_RSA_PUB,
2244
                priv_key, pub_key]
2245

    
2246
    for i in keyfiles:
2247
      f = open(i, 'r')
2248
      try:
2249
        keyarray.append(f.read())
2250
      finally:
2251
        f.close()
2252

    
2253
    result = self.rpc.call_node_add(node, keyarray[0], keyarray[1],
2254
                                    keyarray[2],
2255
                                    keyarray[3], keyarray[4], keyarray[5])
2256

    
2257
    msg = result.RemoteFailMsg()
2258
    if msg:
2259
      raise errors.OpExecError("Cannot transfer ssh keys to the"
2260
                               " new node: %s" % msg)
2261

    
2262
    # Add node to our /etc/hosts, and add key to known_hosts
2263
    utils.AddHostToEtcHosts(new_node.name)
2264

    
2265
    if new_node.secondary_ip != new_node.primary_ip:
2266
      result = self.rpc.call_node_has_ip_address(new_node.name,
2267
                                                 new_node.secondary_ip)
2268
      if result.failed or not result.data:
2269
        raise errors.OpExecError("Node claims it doesn't have the secondary ip"
2270
                                 " you gave (%s). Please fix and re-run this"
2271
                                 " command." % new_node.secondary_ip)
2272

    
2273
    node_verify_list = [self.cfg.GetMasterNode()]
2274
    node_verify_param = {
2275
      'nodelist': [node],
2276
      # TODO: do a node-net-test as well?
2277
    }
2278

    
2279
    result = self.rpc.call_node_verify(node_verify_list, node_verify_param,
2280
                                       self.cfg.GetClusterName())
2281
    for verifier in node_verify_list:
2282
      if result[verifier].failed or not result[verifier].data:
2283
        raise errors.OpExecError("Cannot communicate with %s's node daemon"
2284
                                 " for remote verification" % verifier)
2285
      if result[verifier].data['nodelist']:
2286
        for failed in result[verifier].data['nodelist']:
2287
          feedback_fn("ssh/hostname verification failed %s -> %s" %
2288
                      (verifier, result[verifier].data['nodelist'][failed]))
2289
        raise errors.OpExecError("ssh/hostname verification failed.")
2290

    
2291
    # Distribute updated /etc/hosts and known_hosts to all nodes,
2292
    # including the node just added
2293
    myself = self.cfg.GetNodeInfo(self.cfg.GetMasterNode())
2294
    dist_nodes = self.cfg.GetNodeList()
2295
    if not self.op.readd:
2296
      dist_nodes.append(node)
2297
    if myself.name in dist_nodes:
2298
      dist_nodes.remove(myself.name)
2299

    
2300
    logging.debug("Copying hosts and known_hosts to all nodes")
2301
    for fname in (constants.ETC_HOSTS, constants.SSH_KNOWN_HOSTS_FILE):
2302
      result = self.rpc.call_upload_file(dist_nodes, fname)
2303
      for to_node, to_result in result.iteritems():
2304
        if to_result.failed or not to_result.data:
2305
          logging.error("Copy of file %s to node %s failed", fname, to_node)
2306

    
2307
    to_copy = []
2308
    enabled_hypervisors = self.cfg.GetClusterInfo().enabled_hypervisors
2309
    if constants.HTS_COPY_VNC_PASSWORD.intersection(enabled_hypervisors):
2310
      to_copy.append(constants.VNC_PASSWORD_FILE)
2311

    
2312
    for fname in to_copy:
2313
      result = self.rpc.call_upload_file([node], fname)
2314
      if result[node].failed or not result[node]:
2315
        logging.error("Could not copy file %s to node %s", fname, node)
2316

    
2317
    if self.op.readd:
2318
      self.context.ReaddNode(new_node)
2319
    else:
2320
      self.context.AddNode(new_node)
2321

    
2322

    
2323
class LUSetNodeParams(LogicalUnit):
2324
  """Modifies the parameters of a node.
2325

2326
  """
2327
  HPATH = "node-modify"
2328
  HTYPE = constants.HTYPE_NODE
2329
  _OP_REQP = ["node_name"]
2330
  REQ_BGL = False
2331

    
2332
  def CheckArguments(self):
2333
    node_name = self.cfg.ExpandNodeName(self.op.node_name)
2334
    if node_name is None:
2335
      raise errors.OpPrereqError("Invalid node name '%s'" % self.op.node_name)
2336
    self.op.node_name = node_name
2337
    _CheckBooleanOpField(self.op, 'master_candidate')
2338
    _CheckBooleanOpField(self.op, 'offline')
2339
    _CheckBooleanOpField(self.op, 'drained')
2340
    all_mods = [self.op.offline, self.op.master_candidate, self.op.drained]
2341
    if all_mods.count(None) == 3:
2342
      raise errors.OpPrereqError("Please pass at least one modification")
2343
    if all_mods.count(True) > 1:
2344
      raise errors.OpPrereqError("Can't set the node into more than one"
2345
                                 " state at the same time")
2346

    
2347
  def ExpandNames(self):
2348
    self.needed_locks = {locking.LEVEL_NODE: self.op.node_name}
2349

    
2350
  def BuildHooksEnv(self):
2351
    """Build hooks env.
2352

2353
    This runs on the master node.
2354

2355
    """
2356
    env = {
2357
      "OP_TARGET": self.op.node_name,
2358
      "MASTER_CANDIDATE": str(self.op.master_candidate),
2359
      "OFFLINE": str(self.op.offline),
2360
      "DRAINED": str(self.op.drained),
2361
      }
2362
    nl = [self.cfg.GetMasterNode(),
2363
          self.op.node_name]
2364
    return env, nl, nl
2365

    
2366
  def CheckPrereq(self):
2367
    """Check prerequisites.
2368

2369
    This only checks the instance list against the existing names.
2370

2371
    """
2372
    node = self.node = self.cfg.GetNodeInfo(self.op.node_name)
2373

    
2374
    if ((self.op.master_candidate == False or self.op.offline == True or
2375
         self.op.drained == True) and node.master_candidate):
2376
      # we will demote the node from master_candidate
2377
      if self.op.node_name == self.cfg.GetMasterNode():
2378
        raise errors.OpPrereqError("The master node has to be a"
2379
                                   " master candidate, online and not drained")
2380
      cp_size = self.cfg.GetClusterInfo().candidate_pool_size
2381
      num_candidates, _ = self.cfg.GetMasterCandidateStats()
2382
      if num_candidates <= cp_size:
2383
        msg = ("Not enough master candidates (desired"
2384
               " %d, new value will be %d)" % (cp_size, num_candidates-1))
2385
        if self.op.force:
2386
          self.LogWarning(msg)
2387
        else:
2388
          raise errors.OpPrereqError(msg)
2389

    
2390
    if (self.op.master_candidate == True and
2391
        ((node.offline and not self.op.offline == False) or
2392
         (node.drained and not self.op.drained == False))):
2393
      raise errors.OpPrereqError("Node '%s' is offline or drained, can't set"
2394
                                 " to master_candidate" % node.name)
2395

    
2396
    return
2397

    
2398
  def Exec(self, feedback_fn):
2399
    """Modifies a node.
2400

2401
    """
2402
    node = self.node
2403

    
2404
    result = []
2405
    changed_mc = False
2406

    
2407
    if self.op.offline is not None:
2408
      node.offline = self.op.offline
2409
      result.append(("offline", str(self.op.offline)))
2410
      if self.op.offline == True:
2411
        if node.master_candidate:
2412
          node.master_candidate = False
2413
          changed_mc = True
2414
          result.append(("master_candidate", "auto-demotion due to offline"))
2415
        if node.drained:
2416
          node.drained = False
2417
          result.append(("drained", "clear drained status due to offline"))
2418

    
2419
    if self.op.master_candidate is not None:
2420
      node.master_candidate = self.op.master_candidate
2421
      changed_mc = True
2422
      result.append(("master_candidate", str(self.op.master_candidate)))
2423
      if self.op.master_candidate == False:
2424
        rrc = self.rpc.call_node_demote_from_mc(node.name)
2425
        msg = rrc.RemoteFailMsg()
2426
        if msg:
2427
          self.LogWarning("Node failed to demote itself: %s" % msg)
2428

    
2429
    if self.op.drained is not None:
2430
      node.drained = self.op.drained
2431
      result.append(("drained", str(self.op.drained)))
2432
      if self.op.drained == True:
2433
        if node.master_candidate:
2434
          node.master_candidate = False
2435
          changed_mc = True
2436
          result.append(("master_candidate", "auto-demotion due to drain"))
2437
        if node.offline:
2438
          node.offline = False
2439
          result.append(("offline", "clear offline status due to drain"))
2440

    
2441
    # this will trigger configuration file update, if needed
2442
    self.cfg.Update(node)
2443
    # this will trigger job queue propagation or cleanup
2444
    if changed_mc:
2445
      self.context.ReaddNode(node)
2446

    
2447
    return result
2448

    
2449

    
2450
class LUQueryClusterInfo(NoHooksLU):
2451
  """Query cluster configuration.
2452

2453
  """
2454
  _OP_REQP = []
2455
  REQ_BGL = False
2456

    
2457
  def ExpandNames(self):
2458
    self.needed_locks = {}
2459

    
2460
  def CheckPrereq(self):
2461
    """No prerequsites needed for this LU.
2462

2463
    """
2464
    pass
2465

    
2466
  def Exec(self, feedback_fn):
2467
    """Return cluster config.
2468

2469
    """
2470
    cluster = self.cfg.GetClusterInfo()
2471
    result = {
2472
      "software_version": constants.RELEASE_VERSION,
2473
      "protocol_version": constants.PROTOCOL_VERSION,
2474
      "config_version": constants.CONFIG_VERSION,
2475
      "os_api_version": constants.OS_API_VERSION,
2476
      "export_version": constants.EXPORT_VERSION,
2477
      "architecture": (platform.architecture()[0], platform.machine()),
2478
      "name": cluster.cluster_name,
2479
      "master": cluster.master_node,
2480
      "default_hypervisor": cluster.default_hypervisor,
2481
      "enabled_hypervisors": cluster.enabled_hypervisors,
2482
      "hvparams": dict([(hypervisor, cluster.hvparams[hypervisor])
2483
                        for hypervisor in cluster.enabled_hypervisors]),
2484
      "beparams": cluster.beparams,
2485
      "candidate_pool_size": cluster.candidate_pool_size,
2486
      "default_bridge": cluster.default_bridge,
2487
      "master_netdev": cluster.master_netdev,
2488
      "volume_group_name": cluster.volume_group_name,
2489
      "file_storage_dir": cluster.file_storage_dir,
2490
      }
2491

    
2492
    return result
2493

    
2494

    
2495
class LUQueryConfigValues(NoHooksLU):
2496
  """Return configuration values.
2497

2498
  """
2499
  _OP_REQP = []
2500
  REQ_BGL = False
2501
  _FIELDS_DYNAMIC = utils.FieldSet()
2502
  _FIELDS_STATIC = utils.FieldSet("cluster_name", "master_node", "drain_flag")
2503

    
2504
  def ExpandNames(self):
2505
    self.needed_locks = {}
2506

    
2507
    _CheckOutputFields(static=self._FIELDS_STATIC,
2508
                       dynamic=self._FIELDS_DYNAMIC,
2509
                       selected=self.op.output_fields)
2510

    
2511
  def CheckPrereq(self):
2512
    """No prerequisites.
2513

2514
    """
2515
    pass
2516

    
2517
  def Exec(self, feedback_fn):
2518
    """Dump a representation of the cluster config to the standard output.
2519

2520
    """
2521
    values = []
2522
    for field in self.op.output_fields:
2523
      if field == "cluster_name":
2524
        entry = self.cfg.GetClusterName()
2525
      elif field == "master_node":
2526
        entry = self.cfg.GetMasterNode()
2527
      elif field == "drain_flag":
2528
        entry = os.path.exists(constants.JOB_QUEUE_DRAIN_FILE)
2529
      else:
2530
        raise errors.ParameterError(field)
2531
      values.append(entry)
2532
    return values
2533

    
2534

    
2535
class LUActivateInstanceDisks(NoHooksLU):
2536
  """Bring up an instance's disks.
2537

2538
  """
2539
  _OP_REQP = ["instance_name"]
2540
  REQ_BGL = False
2541

    
2542
  def ExpandNames(self):
2543
    self._ExpandAndLockInstance()
2544
    self.needed_locks[locking.LEVEL_NODE] = []
2545
    self.recalculate_locks[locking.LEVEL_NODE] = constants.LOCKS_REPLACE
2546

    
2547
  def DeclareLocks(self, level):
2548
    if level == locking.LEVEL_NODE:
2549
      self._LockInstancesNodes()
2550

    
2551
  def CheckPrereq(self):
2552
    """Check prerequisites.
2553

2554
    This checks that the instance is in the cluster.
2555

2556
    """
2557
    self.instance = self.cfg.GetInstanceInfo(self.op.instance_name)
2558
    assert self.instance is not None, \
2559
      "Cannot retrieve locked instance %s" % self.op.instance_name
2560
    _CheckNodeOnline(self, self.instance.primary_node)
2561

    
2562
  def Exec(self, feedback_fn):
2563
    """Activate the disks.
2564

2565
    """
2566
    disks_ok, disks_info = _AssembleInstanceDisks(self, self.instance)
2567
    if not disks_ok:
2568
      raise errors.OpExecError("Cannot activate block devices")
2569

    
2570
    return disks_info
2571

    
2572

    
2573
def _AssembleInstanceDisks(lu, instance, ignore_secondaries=False):
2574
  """Prepare the block devices for an instance.
2575

2576
  This sets up the block devices on all nodes.
2577

2578
  @type lu: L{LogicalUnit}
2579
  @param lu: the logical unit on whose behalf we execute
2580
  @type instance: L{objects.Instance}
2581
  @param instance: the instance for whose disks we assemble
2582
  @type ignore_secondaries: boolean
2583
  @param ignore_secondaries: if true, errors on secondary nodes
2584
      won't result in an error return from the function
2585
  @return: False if the operation failed, otherwise a list of
2586
      (host, instance_visible_name, node_visible_name)
2587
      with the mapping from node devices to instance devices
2588

2589
  """
2590
  device_info = []
2591
  disks_ok = True
2592
  iname = instance.name
2593
  # With the two passes mechanism we try to reduce the window of
2594
  # opportunity for the race condition of switching DRBD to primary
2595
  # before handshaking occured, but we do not eliminate it
2596

    
2597
  # The proper fix would be to wait (with some limits) until the
2598
  # connection has been made and drbd transitions from WFConnection
2599
  # into any other network-connected state (Connected, SyncTarget,
2600
  # SyncSource, etc.)
2601

    
2602
  # 1st pass, assemble on all nodes in secondary mode
2603
  for inst_disk in instance.disks:
2604
    for node, node_disk in inst_disk.ComputeNodeTree(instance.primary_node):
2605
      lu.cfg.SetDiskID(node_disk, node)
2606
      result = lu.rpc.call_blockdev_assemble(node, node_disk, iname, False)
2607
      msg = result.RemoteFailMsg()
2608
      if msg:
2609
        lu.proc.LogWarning("Could not prepare block device %s on node %s"
2610
                           " (is_primary=False, pass=1): %s",
2611
                           inst_disk.iv_name, node, msg)
2612
        if not ignore_secondaries:
2613
          disks_ok = False
2614

    
2615
  # FIXME: race condition on drbd migration to primary
2616

    
2617
  # 2nd pass, do only the primary node
2618
  for inst_disk in instance.disks:
2619
    for node, node_disk in inst_disk.ComputeNodeTree(instance.primary_node):
2620
      if node != instance.primary_node:
2621
        continue
2622
      lu.cfg.SetDiskID(node_disk, node)
2623
      result = lu.rpc.call_blockdev_assemble(node, node_disk, iname, True)
2624
      msg = result.RemoteFailMsg()
2625
      if msg:
2626
        lu.proc.LogWarning("Could not prepare block device %s on node %s"
2627
                           " (is_primary=True, pass=2): %s",
2628
                           inst_disk.iv_name, node, msg)
2629
        disks_ok = False
2630
    device_info.append((instance.primary_node, inst_disk.iv_name,
2631
                        result.payload))
2632

    
2633
  # leave the disks configured for the primary node
2634
  # this is a workaround that would be fixed better by
2635
  # improving the logical/physical id handling
2636
  for disk in instance.disks:
2637
    lu.cfg.SetDiskID(disk, instance.primary_node)
2638

    
2639
  return disks_ok, device_info
2640

    
2641

    
2642
def _StartInstanceDisks(lu, instance, force):
2643
  """Start the disks of an instance.
2644

2645
  """
2646
  disks_ok, dummy = _AssembleInstanceDisks(lu, instance,
2647
                                           ignore_secondaries=force)
2648
  if not disks_ok:
2649
    _ShutdownInstanceDisks(lu, instance)
2650
    if force is not None and not force:
2651
      lu.proc.LogWarning("", hint="If the message above refers to a"
2652
                         " secondary node,"
2653
                         " you can retry the operation using '--force'.")
2654
    raise errors.OpExecError("Disk consistency error")
2655

    
2656

    
2657
class LUDeactivateInstanceDisks(NoHooksLU):
2658
  """Shutdown an instance's disks.
2659

2660
  """
2661
  _OP_REQP = ["instance_name"]
2662
  REQ_BGL = False
2663

    
2664
  def ExpandNames(self):
2665
    self._ExpandAndLockInstance()
2666
    self.needed_locks[locking.LEVEL_NODE] = []
2667
    self.recalculate_locks[locking.LEVEL_NODE] = constants.LOCKS_REPLACE
2668

    
2669
  def DeclareLocks(self, level):
2670
    if level == locking.LEVEL_NODE:
2671
      self._LockInstancesNodes()
2672

    
2673
  def CheckPrereq(self):
2674
    """Check prerequisites.
2675

2676
    This checks that the instance is in the cluster.
2677

2678
    """
2679
    self.instance = self.cfg.GetInstanceInfo(self.op.instance_name)
2680
    assert self.instance is not None, \
2681
      "Cannot retrieve locked instance %s" % self.op.instance_name
2682

    
2683
  def Exec(self, feedback_fn):
2684
    """Deactivate the disks
2685

2686
    """
2687
    instance = self.instance
2688
    _SafeShutdownInstanceDisks(self, instance)
2689

    
2690

    
2691
def _SafeShutdownInstanceDisks(lu, instance):
2692
  """Shutdown block devices of an instance.
2693

2694
  This function checks if an instance is running, before calling
2695
  _ShutdownInstanceDisks.
2696

2697
  """
2698
  ins_l = lu.rpc.call_instance_list([instance.primary_node],
2699
                                      [instance.hypervisor])
2700
  ins_l = ins_l[instance.primary_node]
2701
  if ins_l.failed or not isinstance(ins_l.data, list):
2702
    raise errors.OpExecError("Can't contact node '%s'" %
2703
                             instance.primary_node)
2704

    
2705
  if instance.name in ins_l.data:
2706
    raise errors.OpExecError("Instance is running, can't shutdown"
2707
                             " block devices.")
2708

    
2709
  _ShutdownInstanceDisks(lu, instance)
2710

    
2711

    
2712
def _ShutdownInstanceDisks(lu, instance, ignore_primary=False):
2713
  """Shutdown block devices of an instance.
2714

2715
  This does the shutdown on all nodes of the instance.
2716

2717
  If the ignore_primary is false, errors on the primary node are
2718
  ignored.
2719

2720
  """
2721
  all_result = True
2722
  for disk in instance.disks:
2723
    for node, top_disk in disk.ComputeNodeTree(instance.primary_node):
2724
      lu.cfg.SetDiskID(top_disk, node)
2725
      result = lu.rpc.call_blockdev_shutdown(node, top_disk)
2726
      msg = result.RemoteFailMsg()
2727
      if msg:
2728
        lu.LogWarning("Could not shutdown block device %s on node %s: %s",
2729
                      disk.iv_name, node, msg)
2730
        if not ignore_primary or node != instance.primary_node:
2731
          all_result = False
2732
  return all_result
2733

    
2734

    
2735
def _CheckNodeFreeMemory(lu, node, reason, requested, hypervisor_name):
2736
  """Checks if a node has enough free memory.
2737

2738
  This function check if a given node has the needed amount of free
2739
  memory. In case the node has less memory or we cannot get the
2740
  information from the node, this function raise an OpPrereqError
2741
  exception.
2742

2743
  @type lu: C{LogicalUnit}
2744
  @param lu: a logical unit from which we get configuration data
2745
  @type node: C{str}
2746
  @param node: the node to check
2747
  @type reason: C{str}
2748
  @param reason: string to use in the error message
2749
  @type requested: C{int}
2750
  @param requested: the amount of memory in MiB to check for
2751
  @type hypervisor_name: C{str}
2752
  @param hypervisor_name: the hypervisor to ask for memory stats
2753
  @raise errors.OpPrereqError: if the node doesn't have enough memory, or
2754
      we cannot check the node
2755

2756
  """
2757
  nodeinfo = lu.rpc.call_node_info([node], lu.cfg.GetVGName(), hypervisor_name)
2758
  nodeinfo[node].Raise()
2759
  free_mem = nodeinfo[node].data.get('memory_free')
2760
  if not isinstance(free_mem, int):
2761
    raise errors.OpPrereqError("Can't compute free memory on node %s, result"
2762
                             " was '%s'" % (node, free_mem))
2763
  if requested > free_mem:
2764
    raise errors.OpPrereqError("Not enough memory on node %s for %s:"
2765
                             " needed %s MiB, available %s MiB" %
2766
                             (node, reason, requested, free_mem))
2767

    
2768

    
2769
class LUStartupInstance(LogicalUnit):
2770
  """Starts an instance.
2771

2772
  """
2773
  HPATH = "instance-start"
2774
  HTYPE = constants.HTYPE_INSTANCE
2775
  _OP_REQP = ["instance_name", "force"]
2776
  REQ_BGL = False
2777

    
2778
  def ExpandNames(self):
2779
    self._ExpandAndLockInstance()
2780

    
2781
  def BuildHooksEnv(self):
2782
    """Build hooks env.
2783

2784
    This runs on master, primary and secondary nodes of the instance.
2785

2786
    """
2787
    env = {
2788
      "FORCE": self.op.force,
2789
      }
2790
    env.update(_BuildInstanceHookEnvByObject(self, self.instance))
2791
    nl = [self.cfg.GetMasterNode()] + list(self.instance.all_nodes)
2792
    return env, nl, nl
2793

    
2794
  def CheckPrereq(self):
2795
    """Check prerequisites.
2796

2797
    This checks that the instance is in the cluster.
2798

2799
    """
2800
    self.instance = instance = self.cfg.GetInstanceInfo(self.op.instance_name)
2801
    assert self.instance is not None, \
2802
      "Cannot retrieve locked instance %s" % self.op.instance_name
2803

    
2804
    # extra beparams
2805
    self.beparams = getattr(self.op, "beparams", {})
2806
    if self.beparams:
2807
      if not isinstance(self.beparams, dict):
2808
        raise errors.OpPrereqError("Invalid beparams passed: %s, expected"
2809
                                   " dict" % (type(self.beparams), ))
2810
      # fill the beparams dict
2811
      utils.ForceDictType(self.beparams, constants.BES_PARAMETER_TYPES)
2812
      self.op.beparams = self.beparams
2813

    
2814
    # extra hvparams
2815
    self.hvparams = getattr(self.op, "hvparams", {})
2816
    if self.hvparams:
2817
      if not isinstance(self.hvparams, dict):
2818
        raise errors.OpPrereqError("Invalid hvparams passed: %s, expected"
2819
                                   " dict" % (type(self.hvparams), ))
2820

    
2821
      # check hypervisor parameter syntax (locally)
2822
      cluster = self.cfg.GetClusterInfo()
2823
      utils.ForceDictType(self.hvparams, constants.HVS_PARAMETER_TYPES)
2824
      filled_hvp = cluster.FillDict(cluster.hvparams[instance.hypervisor],
2825
                                    instance.hvparams)
2826
      filled_hvp.update(self.hvparams)
2827
      hv_type = hypervisor.GetHypervisor(instance.hypervisor)
2828
      hv_type.CheckParameterSyntax(filled_hvp)
2829
      _CheckHVParams(self, instance.all_nodes, instance.hypervisor, filled_hvp)
2830
      self.op.hvparams = self.hvparams
2831

    
2832
    _CheckNodeOnline(self, instance.primary_node)
2833

    
2834
    bep = self.cfg.GetClusterInfo().FillBE(instance)
2835
    # check bridges existance
2836
    _CheckInstanceBridgesExist(self, instance)
2837

    
2838
    remote_info = self.rpc.call_instance_info(instance.primary_node,
2839
                                              instance.name,
2840
                                              instance.hypervisor)
2841
    remote_info.Raise()
2842
    if not remote_info.data:
2843
      _CheckNodeFreeMemory(self, instance.primary_node,
2844
                           "starting instance %s" % instance.name,
2845
                           bep[constants.BE_MEMORY], instance.hypervisor)
2846

    
2847
  def Exec(self, feedback_fn):
2848
    """Start the instance.
2849

2850
    """
2851
    instance = self.instance
2852
    force = self.op.force
2853

    
2854
    self.cfg.MarkInstanceUp(instance.name)
2855

    
2856
    node_current = instance.primary_node
2857

    
2858
    _StartInstanceDisks(self, instance, force)
2859

    
2860
    result = self.rpc.call_instance_start(node_current, instance,
2861
                                          self.hvparams, self.beparams)
2862
    msg = result.RemoteFailMsg()
2863
    if msg:
2864
      _ShutdownInstanceDisks(self, instance)
2865
      raise errors.OpExecError("Could not start instance: %s" % msg)
2866

    
2867

    
2868
class LURebootInstance(LogicalUnit):
2869
  """Reboot an instance.
2870

2871
  """
2872
  HPATH = "instance-reboot"
2873
  HTYPE = constants.HTYPE_INSTANCE
2874
  _OP_REQP = ["instance_name", "ignore_secondaries", "reboot_type"]
2875
  REQ_BGL = False
2876

    
2877
  def ExpandNames(self):
2878
    if self.op.reboot_type not in [constants.INSTANCE_REBOOT_SOFT,
2879
                                   constants.INSTANCE_REBOOT_HARD,
2880
                                   constants.INSTANCE_REBOOT_FULL]:
2881
      raise errors.ParameterError("reboot type not in [%s, %s, %s]" %
2882
                                  (constants.INSTANCE_REBOOT_SOFT,
2883
                                   constants.INSTANCE_REBOOT_HARD,
2884
                                   constants.INSTANCE_REBOOT_FULL))
2885
    self._ExpandAndLockInstance()
2886

    
2887
  def BuildHooksEnv(self):
2888
    """Build hooks env.
2889

2890
    This runs on master, primary and secondary nodes of the instance.
2891

2892
    """
2893
    env = {
2894
      "IGNORE_SECONDARIES": self.op.ignore_secondaries,
2895
      "REBOOT_TYPE": self.op.reboot_type,
2896
      }
2897
    env.update(_BuildInstanceHookEnvByObject(self, self.instance))
2898
    nl = [self.cfg.GetMasterNode()] + list(self.instance.all_nodes)
2899
    return env, nl, nl
2900

    
2901
  def CheckPrereq(self):
2902
    """Check prerequisites.
2903

2904
    This checks that the instance is in the cluster.
2905

2906
    """
2907
    self.instance = instance = self.cfg.GetInstanceInfo(self.op.instance_name)
2908
    assert self.instance is not None, \
2909
      "Cannot retrieve locked instance %s" % self.op.instance_name
2910

    
2911
    _CheckNodeOnline(self, instance.primary_node)
2912

    
2913
    # check bridges existance
2914
    _CheckInstanceBridgesExist(self, instance)
2915

    
2916
  def Exec(self, feedback_fn):
2917
    """Reboot the instance.
2918

2919
    """
2920
    instance = self.instance
2921
    ignore_secondaries = self.op.ignore_secondaries
2922
    reboot_type = self.op.reboot_type
2923

    
2924
    node_current = instance.primary_node
2925

    
2926
    if reboot_type in [constants.INSTANCE_REBOOT_SOFT,
2927
                       constants.INSTANCE_REBOOT_HARD]:
2928
      for disk in instance.disks:
2929
        self.cfg.SetDiskID(disk, node_current)
2930
      result = self.rpc.call_instance_reboot(node_current, instance,
2931
                                             reboot_type)
2932
      msg = result.RemoteFailMsg()
2933
      if msg:
2934
        raise errors.OpExecError("Could not reboot instance: %s" % msg)
2935
    else:
2936
      result = self.rpc.call_instance_shutdown(node_current, instance)
2937
      msg = result.RemoteFailMsg()
2938
      if msg:
2939
        raise errors.OpExecError("Could not shutdown instance for"
2940
                                 " full reboot: %s" % msg)
2941
      _ShutdownInstanceDisks(self, instance)
2942
      _StartInstanceDisks(self, instance, ignore_secondaries)
2943
      result = self.rpc.call_instance_start(node_current, instance, None, None)
2944
      msg = result.RemoteFailMsg()
2945
      if msg:
2946
        _ShutdownInstanceDisks(self, instance)
2947
        raise errors.OpExecError("Could not start instance for"
2948
                                 " full reboot: %s" % msg)
2949

    
2950
    self.cfg.MarkInstanceUp(instance.name)
2951

    
2952

    
2953
class LUShutdownInstance(LogicalUnit):
2954
  """Shutdown an instance.
2955

2956
  """
2957
  HPATH = "instance-stop"
2958
  HTYPE = constants.HTYPE_INSTANCE
2959
  _OP_REQP = ["instance_name"]
2960
  REQ_BGL = False
2961

    
2962
  def ExpandNames(self):
2963
    self._ExpandAndLockInstance()
2964

    
2965
  def BuildHooksEnv(self):
2966
    """Build hooks env.
2967

2968
    This runs on master, primary and secondary nodes of the instance.
2969

2970
    """
2971
    env = _BuildInstanceHookEnvByObject(self, self.instance)
2972
    nl = [self.cfg.GetMasterNode()] + list(self.instance.all_nodes)
2973
    return env, nl, nl
2974

    
2975
  def CheckPrereq(self):
2976
    """Check prerequisites.
2977

2978
    This checks that the instance is in the cluster.
2979

2980
    """
2981
    self.instance = self.cfg.GetInstanceInfo(self.op.instance_name)
2982
    assert self.instance is not None, \
2983
      "Cannot retrieve locked instance %s" % self.op.instance_name
2984
    _CheckNodeOnline(self, self.instance.primary_node)
2985

    
2986
  def Exec(self, feedback_fn):
2987
    """Shutdown the instance.
2988

2989
    """
2990
    instance = self.instance
2991
    node_current = instance.primary_node
2992
    self.cfg.MarkInstanceDown(instance.name)
2993
    result = self.rpc.call_instance_shutdown(node_current, instance)
2994
    msg = result.RemoteFailMsg()
2995
    if msg:
2996
      self.proc.LogWarning("Could not shutdown instance: %s" % msg)
2997

    
2998
    _ShutdownInstanceDisks(self, instance)
2999

    
3000

    
3001
class LUReinstallInstance(LogicalUnit):
3002
  """Reinstall an instance.
3003

3004
  """
3005
  HPATH = "instance-reinstall"
3006
  HTYPE = constants.HTYPE_INSTANCE
3007
  _OP_REQP = ["instance_name"]
3008
  REQ_BGL = False
3009

    
3010
  def ExpandNames(self):
3011
    self._ExpandAndLockInstance()
3012

    
3013
  def BuildHooksEnv(self):
3014
    """Build hooks env.
3015

3016
    This runs on master, primary and secondary nodes of the instance.
3017

3018
    """
3019
    env = _BuildInstanceHookEnvByObject(self, self.instance)
3020
    nl = [self.cfg.GetMasterNode()] + list(self.instance.all_nodes)
3021
    return env, nl, nl
3022

    
3023
  def CheckPrereq(self):
3024
    """Check prerequisites.
3025

3026
    This checks that the instance is in the cluster and is not running.
3027

3028
    """
3029
    instance = self.cfg.GetInstanceInfo(self.op.instance_name)
3030
    assert instance is not None, \
3031
      "Cannot retrieve locked instance %s" % self.op.instance_name
3032
    _CheckNodeOnline(self, instance.primary_node)
3033

    
3034
    if instance.disk_template == constants.DT_DISKLESS:
3035
      raise errors.OpPrereqError("Instance '%s' has no disks" %
3036
                                 self.op.instance_name)
3037
    if instance.admin_up:
3038
      raise errors.OpPrereqError("Instance '%s' is marked to be up" %
3039
                                 self.op.instance_name)
3040
    remote_info = self.rpc.call_instance_info(instance.primary_node,
3041
                                              instance.name,
3042
                                              instance.hypervisor)
3043
    remote_info.Raise()
3044
    if remote_info.data:
3045
      raise errors.OpPrereqError("Instance '%s' is running on the node %s" %
3046
                                 (self.op.instance_name,
3047
                                  instance.primary_node))
3048

    
3049
    self.op.os_type = getattr(self.op, "os_type", None)
3050
    if self.op.os_type is not None:
3051
      # OS verification
3052
      pnode = self.cfg.GetNodeInfo(
3053
        self.cfg.ExpandNodeName(instance.primary_node))
3054
      if pnode is None:
3055
        raise errors.OpPrereqError("Primary node '%s' is unknown" %
3056
                                   self.op.pnode)
3057
      result = self.rpc.call_os_get(pnode.name, self.op.os_type)
3058
      result.Raise()
3059
      if not isinstance(result.data, objects.OS):
3060
        raise errors.OpPrereqError("OS '%s' not in supported OS list for"
3061
                                   " primary node"  % self.op.os_type)
3062

    
3063
    self.instance = instance
3064

    
3065
  def Exec(self, feedback_fn):
3066
    """Reinstall the instance.
3067

3068
    """
3069
    inst = self.instance
3070

    
3071
    if self.op.os_type is not None:
3072
      feedback_fn("Changing OS to '%s'..." % self.op.os_type)
3073
      inst.os = self.op.os_type
3074
      self.cfg.Update(inst)
3075

    
3076
    _StartInstanceDisks(self, inst, None)
3077
    try:
3078
      feedback_fn("Running the instance OS create scripts...")
3079
      result = self.rpc.call_instance_os_add(inst.primary_node, inst)
3080
      msg = result.RemoteFailMsg()
3081
      if msg:
3082
        raise errors.OpExecError("Could not install OS for instance %s"
3083
                                 " on node %s: %s" %
3084
                                 (inst.name, inst.primary_node, msg))
3085
    finally:
3086
      _ShutdownInstanceDisks(self, inst)
3087

    
3088

    
3089
class LURenameInstance(LogicalUnit):
3090
  """Rename an instance.
3091

3092
  """
3093
  HPATH = "instance-rename"
3094
  HTYPE = constants.HTYPE_INSTANCE
3095
  _OP_REQP = ["instance_name", "new_name"]
3096

    
3097
  def BuildHooksEnv(self):
3098
    """Build hooks env.
3099

3100
    This runs on master, primary and secondary nodes of the instance.
3101

3102
    """
3103
    env = _BuildInstanceHookEnvByObject(self, self.instance)
3104
    env["INSTANCE_NEW_NAME"] = self.op.new_name
3105
    nl = [self.cfg.GetMasterNode()] + list(self.instance.all_nodes)
3106
    return env, nl, nl
3107

    
3108
  def CheckPrereq(self):
3109
    """Check prerequisites.
3110

3111
    This checks that the instance is in the cluster and is not running.
3112

3113
    """
3114
    instance = self.cfg.GetInstanceInfo(
3115
      self.cfg.ExpandInstanceName(self.op.instance_name))
3116
    if instance is None:
3117
      raise errors.OpPrereqError("Instance '%s' not known" %
3118
                                 self.op.instance_name)
3119
    _CheckNodeOnline(self, instance.primary_node)
3120

    
3121
    if instance.admin_up:
3122
      raise errors.OpPrereqError("Instance '%s' is marked to be up" %
3123
                                 self.op.instance_name)
3124
    remote_info = self.rpc.call_instance_info(instance.primary_node,
3125
                                              instance.name,
3126
                                              instance.hypervisor)
3127
    remote_info.Raise()
3128
    if remote_info.data:
3129
      raise errors.OpPrereqError("Instance '%s' is running on the node %s" %
3130
                                 (self.op.instance_name,
3131
                                  instance.primary_node))
3132
    self.instance = instance
3133

    
3134
    # new name verification
3135
    name_info = utils.HostInfo(self.op.new_name)
3136

    
3137
    self.op.new_name = new_name = name_info.name
3138
    instance_list = self.cfg.GetInstanceList()
3139
    if new_name in instance_list:
3140
      raise errors.OpPrereqError("Instance '%s' is already in the cluster" %
3141
                                 new_name)
3142

    
3143
    if not getattr(self.op, "ignore_ip", False):
3144
      if utils.TcpPing(name_info.ip, constants.DEFAULT_NODED_PORT):
3145
        raise errors.OpPrereqError("IP %s of instance %s already in use" %
3146
                                   (name_info.ip, new_name))
3147

    
3148

    
3149
  def Exec(self, feedback_fn):
3150
    """Reinstall the instance.
3151

3152
    """
3153
    inst = self.instance
3154
    old_name = inst.name
3155

    
3156
    if inst.disk_template == constants.DT_FILE:
3157
      old_file_storage_dir = os.path.dirname(inst.disks[0].logical_id[1])
3158

    
3159
    self.cfg.RenameInstance(inst.name, self.op.new_name)
3160
    # Change the instance lock. This is definitely safe while we hold the BGL
3161
    self.context.glm.remove(locking.LEVEL_INSTANCE, old_name)
3162
    self.context.glm.add(locking.LEVEL_INSTANCE, self.op.new_name)
3163

    
3164
    # re-read the instance from the configuration after rename
3165
    inst = self.cfg.GetInstanceInfo(self.op.new_name)
3166

    
3167
    if inst.disk_template == constants.DT_FILE:
3168
      new_file_storage_dir = os.path.dirname(inst.disks[0].logical_id[1])
3169
      result = self.rpc.call_file_storage_dir_rename(inst.primary_node,
3170
                                                     old_file_storage_dir,
3171
                                                     new_file_storage_dir)
3172
      result.Raise()
3173
      if not result.data:
3174
        raise errors.OpExecError("Could not connect to node '%s' to rename"
3175
                                 " directory '%s' to '%s' (but the instance"
3176
                                 " has been renamed in Ganeti)" % (
3177
                                 inst.primary_node, old_file_storage_dir,
3178
                                 new_file_storage_dir))
3179

    
3180
      if not result.data[0]:
3181
        raise errors.OpExecError("Could not rename directory '%s' to '%s'"
3182
                                 " (but the instance has been renamed in"
3183
                                 " Ganeti)" % (old_file_storage_dir,
3184
                                               new_file_storage_dir))
3185

    
3186
    _StartInstanceDisks(self, inst, None)
3187
    try:
3188
      result = self.rpc.call_instance_run_rename(inst.primary_node, inst,
3189
                                                 old_name)
3190
      msg = result.RemoteFailMsg()
3191
      if msg:
3192
        msg = ("Could not run OS rename script for instance %s on node %s"
3193
               " (but the instance has been renamed in Ganeti): %s" %
3194
               (inst.name, inst.primary_node, msg))
3195
        self.proc.LogWarning(msg)
3196
    finally:
3197
      _ShutdownInstanceDisks(self, inst)
3198

    
3199

    
3200
class LURemoveInstance(LogicalUnit):
3201
  """Remove an instance.
3202

3203
  """
3204
  HPATH = "instance-remove"
3205
  HTYPE = constants.HTYPE_INSTANCE
3206
  _OP_REQP = ["instance_name", "ignore_failures"]
3207
  REQ_BGL = False
3208

    
3209
  def ExpandNames(self):
3210
    self._ExpandAndLockInstance()
3211
    self.needed_locks[locking.LEVEL_NODE] = []
3212
    self.recalculate_locks[locking.LEVEL_NODE] = constants.LOCKS_REPLACE
3213

    
3214
  def DeclareLocks(self, level):
3215
    if level == locking.LEVEL_NODE:
3216
      self._LockInstancesNodes()
3217

    
3218
  def BuildHooksEnv(self):
3219
    """Build hooks env.
3220

3221
    This runs on master, primary and secondary nodes of the instance.
3222

3223
    """
3224
    env = _BuildInstanceHookEnvByObject(self, self.instance)
3225
    nl = [self.cfg.GetMasterNode()]
3226
    return env, nl, nl
3227

    
3228
  def CheckPrereq(self):
3229
    """Check prerequisites.
3230

3231
    This checks that the instance is in the cluster.
3232

3233
    """
3234
    self.instance = self.cfg.GetInstanceInfo(self.op.instance_name)
3235
    assert self.instance is not None, \
3236
      "Cannot retrieve locked instance %s" % self.op.instance_name
3237

    
3238
  def Exec(self, feedback_fn):
3239
    """Remove the instance.
3240

3241
    """
3242
    instance = self.instance
3243
    logging.info("Shutting down instance %s on node %s",
3244
                 instance.name, instance.primary_node)
3245

    
3246
    result = self.rpc.call_instance_shutdown(instance.primary_node, instance)
3247
    msg = result.RemoteFailMsg()
3248
    if msg:
3249
      if self.op.ignore_failures:
3250
        feedback_fn("Warning: can't shutdown instance: %s" % msg)
3251
      else:
3252
        raise errors.OpExecError("Could not shutdown instance %s on"
3253
                                 " node %s: %s" %
3254
                                 (instance.name, instance.primary_node, msg))
3255

    
3256
    logging.info("Removing block devices for instance %s", instance.name)
3257

    
3258
    if not _RemoveDisks(self, instance):
3259
      if self.op.ignore_failures:
3260
        feedback_fn("Warning: can't remove instance's disks")
3261
      else:
3262
        raise errors.OpExecError("Can't remove instance's disks")
3263

    
3264
    logging.info("Removing instance %s out of cluster config", instance.name)
3265

    
3266
    self.cfg.RemoveInstance(instance.name)
3267
    self.remove_locks[locking.LEVEL_INSTANCE] = instance.name
3268

    
3269

    
3270
class LUQueryInstances(NoHooksLU):
3271
  """Logical unit for querying instances.
3272

3273
  """
3274
  _OP_REQP = ["output_fields", "names", "use_locking"]
3275
  REQ_BGL = False
3276
  _FIELDS_STATIC = utils.FieldSet(*["name", "os", "pnode", "snodes",
3277
                                    "admin_state",
3278
                                    "disk_template", "ip", "mac", "bridge",
3279
                                    "sda_size", "sdb_size", "vcpus", "tags",
3280
                                    "network_port", "beparams",
3281
                                    r"(disk)\.(size)/([0-9]+)",
3282
                                    r"(disk)\.(sizes)", "disk_usage",
3283
                                    r"(nic)\.(mac|ip|bridge)/([0-9]+)",
3284
                                    r"(nic)\.(macs|ips|bridges)",
3285
                                    r"(disk|nic)\.(count)",
3286
                                    "serial_no", "hypervisor", "hvparams",] +
3287
                                  ["hv/%s" % name
3288
                                   for name in constants.HVS_PARAMETERS] +
3289
                                  ["be/%s" % name
3290
                                   for name in constants.BES_PARAMETERS])
3291
  _FIELDS_DYNAMIC = utils.FieldSet("oper_state", "oper_ram", "status")
3292

    
3293

    
3294
  def ExpandNames(self):
3295
    _CheckOutputFields(static=self._FIELDS_STATIC,
3296
                       dynamic=self._FIELDS_DYNAMIC,
3297
                       selected=self.op.output_fields)
3298

    
3299
    self.needed_locks = {}
3300
    self.share_locks[locking.LEVEL_INSTANCE] = 1
3301
    self.share_locks[locking.LEVEL_NODE] = 1
3302

    
3303
    if self.op.names:
3304
      self.wanted = _GetWantedInstances(self, self.op.names)
3305
    else:
3306
      self.wanted = locking.ALL_SET
3307

    
3308
    self.do_node_query = self._FIELDS_STATIC.NonMatching(self.op.output_fields)
3309
    self.do_locking = self.do_node_query and self.op.use_locking
3310
    if self.do_locking:
3311
      self.needed_locks[locking.LEVEL_INSTANCE] = self.wanted
3312
      self.needed_locks[locking.LEVEL_NODE] = []
3313
      self.recalculate_locks[locking.LEVEL_NODE] = constants.LOCKS_REPLACE
3314

    
3315
  def DeclareLocks(self, level):
3316
    if level == locking.LEVEL_NODE and self.do_locking:
3317
      self._LockInstancesNodes()
3318

    
3319
  def CheckPrereq(self):
3320
    """Check prerequisites.
3321

3322
    """
3323
    pass
3324

    
3325
  def Exec(self, feedback_fn):
3326
    """Computes the list of nodes and their attributes.
3327

3328
    """
3329
    all_info = self.cfg.GetAllInstancesInfo()
3330
    if self.wanted == locking.ALL_SET:
3331
      # caller didn't specify instance names, so ordering is not important
3332
      if self.do_locking:
3333
        instance_names = self.acquired_locks[locking.LEVEL_INSTANCE]
3334
      else:
3335
        instance_names = all_info.keys()
3336
      instance_names = utils.NiceSort(instance_names)
3337
    else:
3338
      # caller did specify names, so we must keep the ordering
3339
      if self.do_locking:
3340
        tgt_set = self.acquired_locks[locking.LEVEL_INSTANCE]
3341
      else:
3342
        tgt_set = all_info.keys()
3343
      missing = set(self.wanted).difference(tgt_set)
3344
      if missing:
3345
        raise errors.OpExecError("Some instances were removed before"
3346
                                 " retrieving their data: %s" % missing)
3347
      instance_names = self.wanted
3348

    
3349
    instance_list = [all_info[iname] for iname in instance_names]
3350

    
3351
    # begin data gathering
3352

    
3353
    nodes = frozenset([inst.primary_node for inst in instance_list])
3354
    hv_list = list(set([inst.hypervisor for inst in instance_list]))
3355

    
3356
    bad_nodes = []
3357
    off_nodes = []
3358
    if self.do_node_query:
3359
      live_data = {}
3360
      node_data = self.rpc.call_all_instances_info(nodes, hv_list)
3361
      for name in nodes:
3362
        result = node_data[name]
3363
        if result.offline:
3364
          # offline nodes will be in both lists
3365
          off_nodes.append(name)
3366
        if result.failed:
3367
          bad_nodes.append(name)
3368
        else:
3369
          if result.data:
3370
            live_data.update(result.data)
3371
            # else no instance is alive
3372
    else:
3373
      live_data = dict([(name, {}) for name in instance_names])
3374

    
3375
    # end data gathering
3376

    
3377
    HVPREFIX = "hv/"
3378
    BEPREFIX = "be/"
3379
    output = []
3380
    for instance in instance_list:
3381
      iout = []
3382
      i_hv = self.cfg.GetClusterInfo().FillHV(instance)
3383
      i_be = self.cfg.GetClusterInfo().FillBE(instance)
3384
      for field in self.op.output_fields:
3385
        st_match = self._FIELDS_STATIC.Matches(field)
3386
        if field == "name":
3387
          val = instance.name
3388
        elif field == "os":
3389
          val = instance.os
3390
        elif field == "pnode":
3391
          val = instance.primary_node
3392
        elif field == "snodes":
3393
          val = list(instance.secondary_nodes)
3394
        elif field == "admin_state":
3395
          val = instance.admin_up
3396
        elif field == "oper_state":
3397
          if instance.primary_node in bad_nodes:
3398
            val = None
3399
          else:
3400
            val = bool(live_data.get(instance.name))
3401
        elif field == "status":
3402
          if instance.primary_node in off_nodes:
3403
            val = "ERROR_nodeoffline"
3404
          elif instance.primary_node in bad_nodes:
3405
            val = "ERROR_nodedown"
3406
          else:
3407
            running = bool(live_data.get(instance.name))
3408
            if running:
3409
              if instance.admin_up:
3410
                val = "running"
3411
              else:
3412
                val = "ERROR_up"
3413
            else:
3414
              if instance.admin_up:
3415
                val = "ERROR_down"
3416
              else:
3417
                val = "ADMIN_down"
3418
        elif field == "oper_ram":
3419
          if instance.primary_node in bad_nodes:
3420
            val = None
3421
          elif instance.name in live_data:
3422
            val = live_data[instance.name].get("memory", "?")
3423
          else:
3424
            val = "-"
3425
        elif field == "vcpus":
3426
          val = i_be[constants.BE_VCPUS]
3427
        elif field == "disk_template":
3428
          val = instance.disk_template
3429
        elif field == "ip":
3430
          if instance.nics:
3431
            val = instance.nics[0].ip
3432
          else:
3433
            val = None
3434
        elif field == "bridge":
3435
          if instance.nics:
3436
            val = instance.nics[0].bridge
3437
          else:
3438
            val = None
3439
        elif field == "mac":
3440
          if instance.nics:
3441
            val = instance.nics[0].mac
3442
          else:
3443
            val = None
3444
        elif field == "sda_size" or field == "sdb_size":
3445
          idx = ord(field[2]) - ord('a')
3446
          try:
3447
            val = instance.FindDisk(idx).size
3448
          except errors.OpPrereqError:
3449
            val = None
3450
        elif field == "disk_usage": # total disk usage per node
3451
          disk_sizes = [{'size': disk.size} for disk in instance.disks]
3452
          val = _ComputeDiskSize(instance.disk_template, disk_sizes)
3453
        elif field == "tags":
3454
          val = list(instance.GetTags())
3455
        elif field == "serial_no":
3456
          val = instance.serial_no
3457
        elif field == "network_port":
3458
          val = instance.network_port
3459
        elif field == "hypervisor":
3460
          val = instance.hypervisor
3461
        elif field == "hvparams":
3462
          val = i_hv
3463
        elif (field.startswith(HVPREFIX) and
3464
              field[len(HVPREFIX):] in constants.HVS_PARAMETERS):
3465
          val = i_hv.get(field[len(HVPREFIX):], None)
3466
        elif field == "beparams":
3467
          val = i_be
3468
        elif (field.startswith(BEPREFIX) and
3469
              field[len(BEPREFIX):] in constants.BES_PARAMETERS):
3470
          val = i_be.get(field[len(BEPREFIX):], None)
3471
        elif st_match and st_match.groups():
3472
          # matches a variable list
3473
          st_groups = st_match.groups()
3474
          if st_groups and st_groups[0] == "disk":
3475
            if st_groups[1] == "count":
3476
              val = len(instance.disks)
3477
            elif st_groups[1] == "sizes":
3478
              val = [disk.size for disk in instance.disks]
3479
            elif st_groups[1] == "size":
3480
              try:
3481
                val = instance.FindDisk(st_groups[2]).size
3482
              except errors.OpPrereqError:
3483
                val = None
3484
            else:
3485
              assert False, "Unhandled disk parameter"
3486
          elif st_groups[0] == "nic":
3487
            if st_groups[1] == "count":
3488
              val = len(instance.nics)
3489
            elif st_groups[1] == "macs":
3490
              val = [nic.mac for nic in instance.nics]
3491
            elif st_groups[1] == "ips":
3492
              val = [nic.ip for nic in instance.nics]
3493
            elif st_groups[1] == "bridges":
3494
              val = [nic.bridge for nic in instance.nics]
3495
            else:
3496
              # index-based item
3497
              nic_idx = int(st_groups[2])
3498
              if nic_idx >= len(instance.nics):
3499
                val = None
3500
              else:
3501
                if st_groups[1] == "mac":
3502
                  val = instance.nics[nic_idx].mac
3503
                elif st_groups[1] == "ip":
3504
                  val = instance.nics[nic_idx].ip
3505
                elif st_groups[1] == "bridge":
3506
                  val = instance.nics[nic_idx].bridge
3507
                else:
3508
                  assert False, "Unhandled NIC parameter"
3509
          else:
3510
            assert False, ("Declared but unhandled variable parameter '%s'" %
3511
                           field)
3512
        else:
3513
          assert False, "Declared but unhandled parameter '%s'" % field
3514
        iout.append(val)
3515
      output.append(iout)
3516

    
3517
    return output
3518

    
3519

    
3520
class LUFailoverInstance(LogicalUnit):
3521
  """Failover an instance.
3522

3523
  """
3524
  HPATH = "instance-failover"
3525
  HTYPE = constants.HTYPE_INSTANCE
3526
  _OP_REQP = ["instance_name", "ignore_consistency"]
3527
  REQ_BGL = False
3528

    
3529
  def ExpandNames(self):
3530
    self._ExpandAndLockInstance()
3531
    self.needed_locks[locking.LEVEL_NODE] = []
3532
    self.recalculate_locks[locking.LEVEL_NODE] = constants.LOCKS_REPLACE
3533

    
3534
  def DeclareLocks(self, level):
3535
    if level == locking.LEVEL_NODE:
3536
      self._LockInstancesNodes()
3537

    
3538
  def BuildHooksEnv(self):
3539
    """Build hooks env.
3540

3541
    This runs on master, primary and secondary nodes of the instance.
3542

3543
    """
3544
    env = {
3545
      "IGNORE_CONSISTENCY": self.op.ignore_consistency,
3546
      }
3547
    env.update(_BuildInstanceHookEnvByObject(self, self.instance))
3548
    nl = [self.cfg.GetMasterNode()] + list(self.instance.secondary_nodes)
3549
    return env, nl, nl
3550

    
3551
  def CheckPrereq(self):
3552
    """Check prerequisites.
3553

3554
    This checks that the instance is in the cluster.
3555

3556
    """
3557
    self.instance = instance = self.cfg.GetInstanceInfo(self.op.instance_name)
3558
    assert self.instance is not None, \
3559
      "Cannot retrieve locked instance %s" % self.op.instance_name
3560

    
3561
    bep = self.cfg.GetClusterInfo().FillBE(instance)
3562
    if instance.disk_template not in constants.DTS_NET_MIRROR:
3563
      raise errors.OpPrereqError("Instance's disk layout is not"
3564
                                 " network mirrored, cannot failover.")
3565

    
3566
    secondary_nodes = instance.secondary_nodes
3567
    if not secondary_nodes:
3568
      raise errors.ProgrammerError("no secondary node but using "
3569
                                   "a mirrored disk template")
3570

    
3571
    target_node = secondary_nodes[0]
3572
    _CheckNodeOnline(self, target_node)
3573
    _CheckNodeNotDrained(self, target_node)
3574

    
3575
    if instance.admin_up:
3576
      # check memory requirements on the secondary node
3577
      _CheckNodeFreeMemory(self, target_node, "failing over instance %s" %
3578
                           instance.name, bep[constants.BE_MEMORY],
3579
                           instance.hypervisor)
3580
    else:
3581
      self.LogInfo("Not checking memory on the secondary node as"
3582
                   " instance will not be started")
3583

    
3584
    # check bridge existance
3585
    brlist = [nic.bridge for nic in instance.nics]
3586
    result = self.rpc.call_bridges_exist(target_node, brlist)
3587
    result.Raise()
3588
    if not result.data:
3589
      raise errors.OpPrereqError("One or more target bridges %s does not"
3590
                                 " exist on destination node '%s'" %
3591
                                 (brlist, target_node))
3592

    
3593
  def Exec(self, feedback_fn):
3594
    """Failover an instance.
3595

3596
    The failover is done by shutting it down on its present node and
3597
    starting it on the secondary.
3598

3599
    """
3600
    instance = self.instance
3601

    
3602
    source_node = instance.primary_node
3603
    target_node = instance.secondary_nodes[0]
3604

    
3605
    feedback_fn("* checking disk consistency between source and target")
3606
    for dev in instance.disks:
3607
      # for drbd, these are drbd over lvm
3608
      if not _CheckDiskConsistency(self, dev, target_node, False):
3609
        if instance.admin_up and not self.op.ignore_consistency:
3610
          raise errors.OpExecError("Disk %s is degraded on target node,"
3611
                                   " aborting failover." % dev.iv_name)
3612

    
3613
    feedback_fn("* shutting down instance on source node")
3614
    logging.info("Shutting down instance %s on node %s",
3615
                 instance.name, source_node)
3616

    
3617
    result = self.rpc.call_instance_shutdown(source_node, instance)
3618
    msg = result.RemoteFailMsg()
3619
    if msg:
3620
      if self.op.ignore_consistency:
3621
        self.proc.LogWarning("Could not shutdown instance %s on node %s."
3622
                             " Proceeding anyway. Please make sure node"
3623
                             " %s is down. Error details: %s",
3624
                             instance.name, source_node, source_node, msg)
3625
      else:
3626
        raise errors.OpExecError("Could not shutdown instance %s on"
3627
                                 " node %s: %s" %
3628
                                 (instance.name, source_node, msg))
3629

    
3630
    feedback_fn("* deactivating the instance's disks on source node")
3631
    if not _ShutdownInstanceDisks(self, instance, ignore_primary=True):
3632
      raise errors.OpExecError("Can't shut down the instance's disks.")
3633

    
3634
    instance.primary_node = target_node
3635
    # distribute new instance config to the other nodes
3636
    self.cfg.Update(instance)
3637

    
3638
    # Only start the instance if it's marked as up
3639
    if instance.admin_up:
3640
      feedback_fn("* activating the instance's disks on target node")
3641
      logging.info("Starting instance %s on node %s",
3642
                   instance.name, target_node)
3643

    
3644
      disks_ok, dummy = _AssembleInstanceDisks(self, instance,
3645
                                               ignore_secondaries=True)
3646
      if not disks_ok:
3647
        _ShutdownInstanceDisks(self, instance)
3648
        raise errors.OpExecError("Can't activate the instance's disks")
3649

    
3650
      feedback_fn("* starting the instance on the target node")
3651
      result = self.rpc.call_instance_start(target_node, instance, None, None)
3652
      msg = result.RemoteFailMsg()
3653
      if msg:
3654
        _ShutdownInstanceDisks(self, instance)
3655
        raise errors.OpExecError("Could not start instance %s on node %s: %s" %
3656
                                 (instance.name, target_node, msg))
3657

    
3658

    
3659
class LUMigrateInstance(LogicalUnit):
3660
  """Migrate an instance.
3661

3662
  This is migration without shutting down, compared to the failover,
3663
  which is done with shutdown.
3664

3665
  """
3666
  HPATH = "instance-migrate"
3667
  HTYPE = constants.HTYPE_INSTANCE
3668
  _OP_REQP = ["instance_name", "live", "cleanup"]
3669

    
3670
  REQ_BGL = False
3671

    
3672
  def ExpandNames(self):
3673
    self._ExpandAndLockInstance()
3674
    self.needed_locks[locking.LEVEL_NODE] = []
3675
    self.recalculate_locks[locking.LEVEL_NODE] = constants.LOCKS_REPLACE
3676

    
3677
  def DeclareLocks(self, level):
3678
    if level == locking.LEVEL_NODE:
3679
      self._LockInstancesNodes()
3680

    
3681
  def BuildHooksEnv(self):
3682
    """Build hooks env.
3683

3684
    This runs on master, primary and secondary nodes of the instance.
3685

3686
    """
3687
    env = _BuildInstanceHookEnvByObject(self, self.instance)
3688
    env["MIGRATE_LIVE"] = self.op.live
3689
    env["MIGRATE_CLEANUP"] = self.op.cleanup
3690
    nl = [self.cfg.GetMasterNode()] + list(self.instance.secondary_nodes)
3691
    return env, nl, nl
3692

    
3693
  def CheckPrereq(self):
3694
    """Check prerequisites.
3695

3696
    This checks that the instance is in the cluster.
3697

3698
    """
3699
    instance = self.cfg.GetInstanceInfo(
3700
      self.cfg.ExpandInstanceName(self.op.instance_name))
3701
    if instance is None:
3702
      raise errors.OpPrereqError("Instance '%s' not known" %
3703
                                 self.op.instance_name)
3704

    
3705
    if instance.disk_template != constants.DT_DRBD8:
3706
      raise errors.OpPrereqError("Instance's disk layout is not"
3707
                                 " drbd8, cannot migrate.")
3708

    
3709
    secondary_nodes = instance.secondary_nodes
3710
    if not secondary_nodes:
3711
      raise errors.ConfigurationError("No secondary node but using"
3712
                                      " drbd8 disk template")
3713

    
3714
    i_be = self.cfg.GetClusterInfo().FillBE(instance)
3715

    
3716
    target_node = secondary_nodes[0]
3717
    # check memory requirements on the secondary node
3718
    _CheckNodeFreeMemory(self, target_node, "migrating instance %s" %
3719
                         instance.name, i_be[constants.BE_MEMORY],
3720
                         instance.hypervisor)
3721

    
3722
    # check bridge existance
3723
    brlist = [nic.bridge for nic in instance.nics]
3724
    result = self.rpc.call_bridges_exist(target_node, brlist)
3725
    if result.failed or not result.data:
3726
      raise errors.OpPrereqError("One or more target bridges %s does not"
3727
                                 " exist on destination node '%s'" %
3728
                                 (brlist, target_node))
3729

    
3730
    if not self.op.cleanup:
3731
      _CheckNodeNotDrained(self, target_node)
3732
      result = self.rpc.call_instance_migratable(instance.primary_node,
3733
                                                 instance)
3734
      msg = result.RemoteFailMsg()
3735
      if msg:
3736
        raise errors.OpPrereqError("Can't migrate: %s - please use failover" %
3737
                                   msg)
3738

    
3739
    self.instance = instance
3740

    
3741
  def _WaitUntilSync(self):
3742
    """Poll with custom rpc for disk sync.
3743

3744
    This uses our own step-based rpc call.
3745

3746
    """
3747
    self.feedback_fn("* wait until resync is done")
3748
    all_done = False
3749
    while not all_done:
3750
      all_done = True
3751
      result = self.rpc.call_drbd_wait_sync(self.all_nodes,
3752
                                            self.nodes_ip,
3753
                                            self.instance.disks)
3754
      min_percent = 100
3755
      for node, nres in result.items():
3756
        msg = nres.RemoteFailMsg()
3757
        if msg:
3758
          raise errors.OpExecError("Cannot resync disks on node %s: %s" %
3759
                                   (node, msg))
3760
        node_done, node_percent = nres.payload
3761
        all_done = all_done and node_done
3762
        if node_percent is not None:
3763
          min_percent = min(min_percent, node_percent)
3764
      if not all_done:
3765
        if min_percent < 100:
3766
          self.feedback_fn("   - progress: %.1f%%" % min_percent)
3767
        time.sleep(2)
3768

    
3769
  def _EnsureSecondary(self, node):
3770
    """Demote a node to secondary.
3771

3772
    """
3773
    self.feedback_fn("* switching node %s to secondary mode" % node)
3774

    
3775
    for dev in self.instance.disks:
3776
      self.cfg.SetDiskID(dev, node)
3777

    
3778
    result = self.rpc.call_blockdev_close(node, self.instance.name,
3779
                                          self.instance.disks)
3780
    msg = result.RemoteFailMsg()
3781
    if msg:
3782
      raise errors.OpExecError("Cannot change disk to secondary on node %s,"
3783
                               " error %s" % (node, msg))
3784

    
3785
  def _GoStandalone(self):
3786
    """Disconnect from the network.
3787

3788
    """
3789
    self.feedback_fn("* changing into standalone mode")
3790
    result = self.rpc.call_drbd_disconnect_net(self.all_nodes, self.nodes_ip,
3791
                                               self.instance.disks)
3792
    for node, nres in result.items():
3793
      msg = nres.RemoteFailMsg()
3794
      if msg:
3795
        raise errors.OpExecError("Cannot disconnect disks node %s,"
3796
                                 " error %s" % (node, msg))
3797

    
3798
  def _GoReconnect(self, multimaster):
3799
    """Reconnect to the network.
3800

3801
    """
3802
    if multimaster:
3803
      msg = "dual-master"
3804
    else:
3805
      msg = "single-master"
3806
    self.feedback_fn("* changing disks into %s mode" % msg)
3807
    result = self.rpc.call_drbd_attach_net(self.all_nodes, self.nodes_ip,
3808
                                           self.instance.disks,
3809
                                           self.instance.name, multimaster)
3810
    for node, nres in result.items():
3811
      msg = nres.RemoteFailMsg()
3812
      if msg:
3813
        raise errors.OpExecError("Cannot change disks config on node %s,"
3814
                                 " error: %s" % (node, msg))
3815

    
3816
  def _ExecCleanup(self):
3817
    """Try to cleanup after a failed migration.
3818

3819
    The cleanup is done by:
3820
      - check that the instance is running only on one node
3821
        (and update the config if needed)
3822
      - change disks on its secondary node to secondary
3823
      - wait until disks are fully synchronized
3824
      - disconnect from the network
3825
      - change disks into single-master mode
3826
      - wait again until disks are fully synchronized
3827

3828
    """
3829
    instance = self.instance
3830
    target_node = self.target_node
3831
    source_node = self.source_node
3832

    
3833
    # check running on only one node
3834
    self.feedback_fn("* checking where the instance actually runs"
3835
                     " (if this hangs, the hypervisor might be in"
3836
                     " a bad state)")
3837
    ins_l = self.rpc.call_instance_list(self.all_nodes, [instance.hypervisor])
3838
    for node, result in ins_l.items():
3839
      result.Raise()
3840
      if not isinstance(result.data, list):
3841
        raise errors.OpExecError("Can't contact node '%s'" % node)
3842

    
3843
    runningon_source = instance.name in ins_l[source_node].data
3844
    runningon_target = instance.name in ins_l[target_node].data
3845

    
3846
    if runningon_source and runningon_target:
3847
      raise errors.OpExecError("Instance seems to be running on two nodes,"
3848
                               " or the hypervisor is confused. You will have"
3849
                               " to ensure manually that it runs only on one"
3850
                               " and restart this operation.")
3851

    
3852
    if not (runningon_source or runningon_target):
3853
      raise errors.OpExecError("Instance does not seem to be running at all."
3854
                               " In this case, it's safer to repair by"
3855
                               " running 'gnt-instance stop' to ensure disk"
3856
                               " shutdown, and then restarting it.")
3857

    
3858
    if runningon_target:
3859
      # the migration has actually succeeded, we need to update the config
3860
      self.feedback_fn("* instance running on secondary node (%s),"
3861
                       " updating config" % target_node)
3862
      instance.primary_node = target_node
3863
      self.cfg.Update(instance)
3864
      demoted_node = source_node
3865
    else:
3866
      self.feedback_fn("* instance confirmed to be running on its"
3867
                       " primary node (%s)" % source_node)
3868
      demoted_node = target_node
3869

    
3870
    self._EnsureSecondary(demoted_node)
3871
    try:
3872
      self._WaitUntilSync()
3873
    except errors.OpExecError:
3874
      # we ignore here errors, since if the device is standalone, it
3875
      # won't be able to sync
3876
      pass
3877
    self._GoStandalone()
3878
    self._GoReconnect(False)
3879
    self._WaitUntilSync()
3880

    
3881
    self.feedback_fn("* done")
3882

    
3883
  def _RevertDiskStatus(self):
3884
    """Try to revert the disk status after a failed migration.
3885

3886
    """
3887
    target_node = self.target_node
3888
    try:
3889
      self._EnsureSecondary(target_node)
3890
      self._GoStandalone()
3891
      self._GoReconnect(False)
3892
      self._WaitUntilSync()
3893
    except errors.OpExecError, err:
3894
      self.LogWarning("Migration failed and I can't reconnect the"
3895
                      " drives: error '%s'\n"
3896
                      "Please look and recover the instance status" %
3897
                      str(err))
3898

    
3899
  def _AbortMigration(self):
3900
    """Call the hypervisor code to abort a started migration.
3901

3902
    """
3903
    instance = self.instance
3904
    target_node = self.target_node
3905
    migration_info = self.migration_info
3906

    
3907
    abort_result = self.rpc.call_finalize_migration(target_node,
3908
                                                    instance,
3909
                                                    migration_info,
3910
                                                    False)
3911
    abort_msg = abort_result.RemoteFailMsg()
3912
    if abort_msg:
3913
      logging.error("Aborting migration failed on target node %s: %s" %
3914
                    (target_node, abort_msg))
3915
      # Don't raise an exception here, as we stil have to try to revert the
3916
      # disk status, even if this step failed.
3917

    
3918
  def _ExecMigration(self):
3919
    """Migrate an instance.
3920

3921
    The migrate is done by:
3922
      - change the disks into dual-master mode
3923
      - wait until disks are fully synchronized again
3924
      - migrate the instance
3925
      - change disks on the new secondary node (the old primary) to secondary
3926
      - wait until disks are fully synchronized
3927
      - change disks into single-master mode
3928

3929
    """
3930
    instance = self.instance
3931
    target_node = self.target_node
3932
    source_node = self.source_node
3933

    
3934
    self.feedback_fn("* checking disk consistency between source and target")
3935
    for dev in instance.disks:
3936
      if not _CheckDiskConsistency(self, dev, target_node, False):
3937
        raise errors.OpExecError("Disk %s is degraded or not fully"
3938
                                 " synchronized on target node,"
3939
                                 " aborting migrate." % dev.iv_name)
3940

    
3941
    # First get the migration information from the remote node
3942
    result = self.rpc.call_migration_info(source_node, instance)
3943
    msg = result.RemoteFailMsg()
3944
    if msg:
3945
      log_err = ("Failed fetching source migration information from %s: %s" %
3946
                 (source_node, msg))
3947
      logging.error(log_err)
3948
      raise errors.OpExecError(log_err)
3949

    
3950
    self.migration_info = migration_info = result.payload
3951

    
3952
    # Then switch the disks to master/master mode
3953
    self._EnsureSecondary(target_node)
3954
    self._GoStandalone()
3955
    self._GoReconnect(True)
3956
    self._WaitUntilSync()
3957

    
3958
    self.feedback_fn("* preparing %s to accept the instance" % target_node)
3959
    result = self.rpc.call_accept_instance(target_node,
3960
                                           instance,
3961
                                           migration_info,
3962
                                           self.nodes_ip[target_node])
3963

    
3964
    msg = result.RemoteFailMsg()
3965
    if msg:
3966
      logging.error("Instance pre-migration failed, trying to revert"
3967
                    " disk status: %s", msg)
3968
      self._AbortMigration()
3969
      self._RevertDiskStatus()
3970
      raise errors.OpExecError("Could not pre-migrate instance %s: %s" %
3971
                               (instance.name, msg))
3972

    
3973
    self.feedback_fn("* migrating instance to %s" % target_node)
3974
    time.sleep(10)
3975
    result = self.rpc.call_instance_migrate(source_node, instance,
3976
                                            self.nodes_ip[target_node],
3977
                                            self.op.live)
3978
    msg = result.RemoteFailMsg()
3979
    if msg:
3980
      logging.error("Instance migration failed, trying to revert"
3981
                    " disk status: %s", msg)
3982
      self._AbortMigration()
3983
      self._RevertDiskStatus()
3984
      raise errors.OpExecError("Could not migrate instance %s: %s" %
3985
                               (instance.name, msg))
3986
    time.sleep(10)
3987

    
3988
    instance.primary_node = target_node
3989
    # distribute new instance config to the other nodes
3990
    self.cfg.Update(instance)
3991

    
3992
    result = self.rpc.call_finalize_migration(target_node,
3993
                                              instance,
3994
                                              migration_info,
3995
                                              True)
3996
    msg = result.RemoteFailMsg()
3997
    if msg:
3998
      logging.error("Instance migration succeeded, but finalization failed:"
3999
                    " %s" % msg)
4000
      raise errors.OpExecError("Could not finalize instance migration: %s" %
4001
                               msg)
4002

    
4003
    self._EnsureSecondary(source_node)
4004
    self._WaitUntilSync()
4005
    self._GoStandalone()
4006
    self._GoReconnect(False)
4007