Statistics
| Branch: | Tag: | Revision:

root / lib / cmdlib.py @ 97c61d46

History | View | Annotate | Download (251.6 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 re
30
import platform
31
import logging
32
import copy
33

    
34
from ganeti import ssh
35
from ganeti import utils
36
from ganeti import errors
37
from ganeti import hypervisor
38
from ganeti import locking
39
from ganeti import constants
40
from ganeti import objects
41
from ganeti import serializer
42
from ganeti import ssconf
43

    
44

    
45
class LogicalUnit(object):
46
  """Logical Unit base class.
47

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

57
  Note that all commands require root permissions.
58

59
  """
60
  HPATH = None
61
  HTYPE = None
62
  _OP_REQP = []
63
  REQ_BGL = True
64

    
65
  def __init__(self, processor, op, context, rpc):
66
    """Constructor for LogicalUnit.
67

68
    This needs to be overridden in derived classes in order to check op
69
    validity.
70

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

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

    
97
  def __GetSSH(self):
98
    """Returns the SshRunner object
99

100
    """
101
    if not self.__ssh:
102
      self.__ssh = ssh.SshRunner(self.cfg.GetClusterName())
103
    return self.__ssh
104

    
105
  ssh = property(fget=__GetSSH)
106

    
107
  def CheckArguments(self):
108
    """Check syntactic validity for the opcode arguments.
109

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

115
      - ExpandNames is left as as purely a lock-related function
116
      - CheckPrereq is run after we have acquired locks (and possible
117
        waited for them)
118

119
    The function is allowed to change the self.op attribute so that
120
    later methods can no longer worry about missing parameters.
121

122
    """
123
    pass
124

    
125
  def ExpandNames(self):
126
    """Expand names for this LU.
127

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

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

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

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

146
    Examples::
147

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

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

    
169
  def DeclareLocks(self, level):
170
    """Declare LU locking needs for a level
171

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

179
    This function is only called if you have something already set in
180
    self.needed_locks for the level.
181

182
    @param level: Locking level which is going to be locked
183
    @type level: member of ganeti.locking.LEVELS
184

185
    """
186

    
187
  def CheckPrereq(self):
188
    """Check prerequisites for this LU.
189

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

195
    The method should raise errors.OpPrereqError in case something is
196
    not fulfilled. Its return value is ignored.
197

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

201
    """
202
    raise NotImplementedError
203

    
204
  def Exec(self, feedback_fn):
205
    """Execute the LU.
206

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

211
    """
212
    raise NotImplementedError
213

    
214
  def BuildHooksEnv(self):
215
    """Build hooks environment for this LU.
216

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

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

228
    No nodes should be returned as an empty list (and not None).
229

230
    Note that if the HPATH for a LU class is None, this function will
231
    not be called.
232

233
    """
234
    raise NotImplementedError
235

    
236
  def HooksCallBack(self, phase, hook_results, feedback_fn, lu_result):
237
    """Notify the LU about the results of its hooks.
238

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

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

254
    """
255
    return lu_result
256

    
257
  def _ExpandAndLockInstance(self):
258
    """Helper function to expand and lock an instance.
259

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

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

    
279
  def _LockInstancesNodes(self, primary_only=False):
280
    """Helper function to declare instances' nodes for locking.
281

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

287
    It should be called from DeclareLocks, and for safety only works if
288
    self.recalculate_locks[locking.LEVEL_NODE] is set.
289

290
    In the future it may grow parameters to just lock some instance's nodes, or
291
    to just lock primaries or secondary nodes, if needed.
292

293
    If should be called in DeclareLocks in a way similar to::
294

295
      if level == locking.LEVEL_NODE:
296
        self._LockInstancesNodes()
297

298
    @type primary_only: boolean
299
    @param primary_only: only lock primary nodes of locked instances
300

301
    """
302
    assert locking.LEVEL_NODE in self.recalculate_locks, \
303
      "_LockInstancesNodes helper function called with no nodes to recalculate"
304

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

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

    
317
    if self.recalculate_locks[locking.LEVEL_NODE] == constants.LOCKS_REPLACE:
318
      self.needed_locks[locking.LEVEL_NODE] = wanted_nodes
319
    elif self.recalculate_locks[locking.LEVEL_NODE] == constants.LOCKS_APPEND:
320
      self.needed_locks[locking.LEVEL_NODE].extend(wanted_nodes)
321

    
322
    del self.recalculate_locks[locking.LEVEL_NODE]
323

    
324

    
325
class NoHooksLU(LogicalUnit):
326
  """Simple LU which runs no hooks.
327

328
  This LU is intended as a parent for other LogicalUnits which will
329
  run no hooks, in order to reduce duplicate code.
330

331
  """
332
  HPATH = None
333
  HTYPE = None
334

    
335

    
336
def _GetWantedNodes(lu, nodes):
337
  """Returns list of checked and expanded node names.
338

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

347
  """
348
  if not isinstance(nodes, list):
349
    raise errors.OpPrereqError("Invalid argument type 'nodes'")
350

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

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

    
362
  return utils.NiceSort(wanted)
363

    
364

    
365
def _GetWantedInstances(lu, instances):
366
  """Returns list of checked and expanded instance names.
367

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

377
  """
378
  if not isinstance(instances, list):
379
    raise errors.OpPrereqError("Invalid argument type 'instances'")
380

    
381
  if instances:
382
    wanted = []
383

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

    
390
  else:
391
    wanted = utils.NiceSort(lu.cfg.GetInstanceList())
392
  return wanted
393

    
394

    
395
def _CheckOutputFields(static, dynamic, selected):
396
  """Checks whether all selected fields are valid.
397

398
  @type static: L{utils.FieldSet}
399
  @param static: static fields set
400
  @type dynamic: L{utils.FieldSet}
401
  @param dynamic: dynamic fields set
402

403
  """
404
  f = utils.FieldSet()
405
  f.Extend(static)
406
  f.Extend(dynamic)
407

    
408
  delta = f.NonMatching(selected)
409
  if delta:
410
    raise errors.OpPrereqError("Unknown output fields selected: %s"
411
                               % ",".join(delta))
412

    
413

    
414
def _CheckBooleanOpField(op, name):
415
  """Validates boolean opcode parameters.
416

417
  This will ensure that an opcode parameter is either a boolean value,
418
  or None (but that it always exists).
419

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

    
427

    
428
def _CheckNodeOnline(lu, node):
429
  """Ensure that a given node is online.
430

431
  @param lu: the LU on behalf of which we make the check
432
  @param node: the node to check
433
  @raise errors.OpPrereqError: if the node is offline
434

435
  """
436
  if lu.cfg.GetNodeInfo(node).offline:
437
    raise errors.OpPrereqError("Can't use offline node %s" % node)
438

    
439

    
440
def _CheckNodeNotDrained(lu, node):
441
  """Ensure that a given node is not drained.
442

443
  @param lu: the LU on behalf of which we make the check
444
  @param node: the node to check
445
  @raise errors.OpPrereqError: if the node is drained
446

447
  """
448
  if lu.cfg.GetNodeInfo(node).drained:
449
    raise errors.OpPrereqError("Can't use drained node %s" % node)
450

    
451

    
452
def _BuildInstanceHookEnv(name, primary_node, secondary_nodes, os_type, status,
453
                          memory, vcpus, nics, disk_template, disks,
454
                          bep, hvp, hypervisor_name):
455
  """Builds instance related env variables for hooks
456

457
  This builds the hook environment from individual variables.
458

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

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

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

    
518
  env["INSTANCE_NIC_COUNT"] = nic_count
519

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

    
528
  env["INSTANCE_DISK_COUNT"] = disk_count
529

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

    
534
  return env
535

    
536

    
537
def _BuildInstanceHookEnvByObject(lu, instance, override=None):
538
  """Builds instance related env variables for hooks from an object.
539

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

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

    
574

    
575
def _AdjustCandidatePool(lu):
576
  """Adjust the candidate pool after node operations.
577

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

    
590

    
591
def _CheckInstanceBridgesExist(lu, instance):
592
  """Check that the bridges needed by an instance exist.
593

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

    
604

    
605
class LUDestroyCluster(NoHooksLU):
606
  """Logical unit for destroying the cluster.
607

608
  """
609
  _OP_REQP = []
610

    
611
  def CheckPrereq(self):
612
    """Check prerequisites.
613

614
    This checks whether the cluster is empty.
615

616
    Any errors are signaled by raising errors.OpPrereqError.
617

618
    """
619
    master = self.cfg.GetMasterNode()
620

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

    
630
  def Exec(self, feedback_fn):
631
    """Destroys the cluster.
632

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

    
644

    
645
class LUVerifyCluster(LogicalUnit):
646
  """Verifies the cluster status.
647

648
  """
649
  HPATH = "cluster-verify"
650
  HTYPE = constants.HTYPE_CLUSTER
651
  _OP_REQP = ["skip_checks"]
652
  REQ_BGL = False
653

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

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

666
    Test list:
667

668
      - compares ganeti version
669
      - checks vg existence and size > 20G
670
      - checks config file checksum
671
      - checks ssh to other nodes
672

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

685
    """
686
    node = nodeinfo.name
687

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

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

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

    
706
    # node seems compatible, we can actually try to look into its results
707

    
708
    bad = False
709

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

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

    
730
    # checks config file checksum
731

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

    
759
    # checks ssh to any
760

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

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

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

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

    
807
    return bad
808

    
809
  def _VerifyInstance(self, instance, instanceconfig, node_vol_is,
810
                      node_instance, feedback_fn, n_offline):
811
    """Verify an instance.
812

813
    This function checks to see if the required block devices are
814
    available on the instance's node.
815

816
    """
817
    bad = False
818

    
819
    node_current = instanceconfig.primary_node
820

    
821
    node_vol_should = {}
822
    instanceconfig.MapLVsByNode(node_vol_should)
823

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

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

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

    
849
    return bad
850

    
851
  def _VerifyOrphanVolumes(self, node_vol_should, node_vol_is, feedback_fn):
852
    """Verify if there are any unknown volumes in the cluster.
853

854
    The .os, .swap and backup volumes are ignored. All other volumes are
855
    reported as unknown.
856

857
    """
858
    bad = False
859

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

    
868
  def _VerifyOrphanInstances(self, instancelist, node_instance, feedback_fn):
869
    """Verify the list of running instances.
870

871
    This checks what instances are running but unknown to the cluster.
872

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

    
883
  def _VerifyNPlusOneMemory(self, node_info, instance_cfg, feedback_fn):
884
    """Verify N+1 Memory Resilience.
885

886
    Check that if one single node dies we can still start all the instances it
887
    was primary for.
888

889
    """
890
    bad = False
891

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

    
913
  def CheckPrereq(self):
914
    """Check prerequisites.
915

916
    Transform the list of checks we're going to skip into a set and check that
917
    all its members are valid.
918

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

    
924
  def BuildHooksEnv(self):
925
    """Build hooks env.
926

927
    Cluster-Verify hooks just ran in the post phase and their failure makes
928
    the output be logged in the verify output and the verification to fail.
929

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

    
938
    return env, [], all_nodes
939

    
940
  def Exec(self, feedback_fn):
941
    """Verify integrity of cluster, performing various test on nodes.
942

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

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

    
965
    # FIXME: verify OS list
966
    # do local checksums
967
    master_files = [constants.CLUSTER_CONF_FILE]
968

    
969
    file_names = ssconf.SimpleStore().GetFileList()
970
    file_names.append(constants.SSL_CERT_FILE)
971
    file_names.append(constants.RAPI_CERT_FILE)
972
    file_names.extend(master_files)
973

    
974
    local_checksums = utils.FingerprintFiles(file_names)
975

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

    
996
    cluster = self.cfg.GetClusterInfo()
997
    master_node = self.cfg.GetMasterNode()
998
    all_drbd_map = self.cfg.ComputeDRBDMap()
999

    
1000
    for node_i in nodeinfo:
1001
      node = node_i.name
1002
      nresult = all_nvinfo[node].data
1003

    
1004
      if node_i.offline:
1005
        feedback_fn("* Skipping offline node %s" % (node,))
1006
        n_offline.append(node)
1007
        continue
1008

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

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

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

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

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

    
1065
      node_instance[node] = idata
1066

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

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

    
1103
    node_vol_should = {}
1104

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

    
1113
      inst_config.MapLVsByNode(node_vol_should)
1114

    
1115
      instance_cfg[instance] = inst_config
1116

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

    
1125
      if pnode in n_offline:
1126
        inst_nodes_offline.append(pnode)
1127

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

    
1139
      if not cluster.FillBE(inst_config)[constants.BE_AUTO_BALANCE]:
1140
        i_non_a_balanced.append(instance)
1141

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

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

    
1161
    feedback_fn("* Verifying orphan volumes")
1162
    result = self._VerifyOrphanVolumes(node_vol_should, node_volume,
1163
                                       feedback_fn)
1164
    bad = bad or result
1165

    
1166
    feedback_fn("* Verifying remaining instances")
1167
    result = self._VerifyOrphanInstances(instancelist, node_instance,
1168
                                         feedback_fn)
1169
    bad = bad or result
1170

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

    
1176
    feedback_fn("* Other Notes")
1177
    if i_non_redundant:
1178
      feedback_fn("  - NOTICE: %d non-redundant instance(s) found."
1179
                  % len(i_non_redundant))
1180

    
1181
    if i_non_a_balanced:
1182
      feedback_fn("  - NOTICE: %d non-auto-balanced instance(s) found."
1183
                  % len(i_non_a_balanced))
1184

    
1185
    if n_offline:
1186
      feedback_fn("  - NOTICE: %d offline node(s) found." % len(n_offline))
1187

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

    
1191
    return not bad
1192

    
1193
  def HooksCallBack(self, phase, hooks_results, feedback_fn, lu_result):
1194
    """Analyze the post-hooks' result
1195

1196
    This method analyses the hook result, handles it, and sends some
1197
    nicely-formatted feedback back to the user.
1198

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

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

    
1240
      return lu_result
1241

    
1242

    
1243
class LUVerifyDisks(NoHooksLU):
1244
  """Verifies the cluster disks status.
1245

1246
  """
1247
  _OP_REQP = []
1248
  REQ_BGL = False
1249

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

    
1257
  def CheckPrereq(self):
1258
    """Check prerequisites.
1259

1260
    This has no prerequisites.
1261

1262
    """
1263
    pass
1264

    
1265
  def Exec(self, feedback_fn):
1266
    """Verify integrity of cluster disks.
1267

1268
    """
1269
    result = res_nodes, res_nlvm, res_instances, res_missing = [], {}, [], {}
1270

    
1271
    vg_name = self.cfg.GetVGName()
1272
    nodes = utils.NiceSort(self.cfg.GetNodeList())
1273
    instances = [self.cfg.GetInstanceInfo(name)
1274
                 for name in self.cfg.GetInstanceList()]
1275

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

    
1288
    if not nv_dict:
1289
      return result
1290

    
1291
    node_lvs = self.rpc.call_volume_list(nodes, vg_name)
1292

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

    
1312
      for lv_name, (_, lv_inactive, lv_online) in lvs.iteritems():
1313
        inst = nv_dict.pop((node, lv_name), None)
1314
        if (not lv_online and inst is not None
1315
            and inst.name not in res_instances):
1316
          res_instances.append(inst.name)
1317

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

    
1325
    return result
1326

    
1327

    
1328
class LURepairDiskSizes(NoHooksLU):
1329
  """Verifies the cluster disks sizes.
1330

1331
  """
1332
  _OP_REQP = ["instances"]
1333
  REQ_BGL = False
1334

    
1335
  def ExpandNames(self):
1336

    
1337
    if not isinstance(self.op.instances, list):
1338
      raise errors.OpPrereqError("Invalid argument type 'instances'")
1339

    
1340
    if self.op.instances:
1341
      self.wanted_names = []
1342
      for name in self.op.instances:
1343
        full_name = self.cfg.ExpandInstanceName(name)
1344
        if full_name is None:
1345
          raise errors.OpPrereqError("Instance '%s' not known" % name)
1346
        self.wanted_names.append(full_name)
1347
      self.needed_locks[locking.LEVEL_INSTANCE] = self.wanted_names
1348
      self.needed_locks = {
1349
        locking.LEVEL_NODE: [],
1350
        locking.LEVEL_INSTANCE: self.wanted_names,
1351
        }
1352
      self.recalculate_locks[locking.LEVEL_NODE] = constants.LOCKS_REPLACE
1353
    else:
1354
      self.wanted_names = None
1355
      self.needed_locks = {
1356
        locking.LEVEL_NODE: locking.ALL_SET,
1357
        locking.LEVEL_INSTANCE: locking.ALL_SET,
1358
        }
1359
    self.share_locks = dict(((i, 1) for i in locking.LEVELS))
1360

    
1361
  def DeclareLocks(self, level):
1362
    if level == locking.LEVEL_NODE and self.wanted_names is not None:
1363
      self._LockInstancesNodes(primary_only=True)
1364

    
1365
  def CheckPrereq(self):
1366
    """Check prerequisites.
1367

1368
    This only checks the optional instance list against the existing names.
1369

1370
    """
1371
    if self.wanted_names is None:
1372
      self.wanted_names = self.acquired_locks[locking.LEVEL_INSTANCE]
1373

    
1374
    self.wanted_instances = [self.cfg.GetInstanceInfo(name) for name
1375
                             in self.wanted_names]
1376

    
1377
  def Exec(self, feedback_fn):
1378
    """Verify the size of cluster disks.
1379

1380
    """
1381
    # TODO: check child disks too
1382
    # TODO: check differences in size between primary/secondary nodes
1383
    per_node_disks = {}
1384
    for instance in self.wanted_instances:
1385
      pnode = instance.primary_node
1386
      if pnode not in per_node_disks:
1387
        per_node_disks[pnode] = []
1388
      for idx, disk in enumerate(instance.disks):
1389
        per_node_disks[pnode].append((instance, idx, disk))
1390

    
1391
    changed = []
1392
    for node, dskl in per_node_disks.items():
1393
      result = self.rpc.call_blockdev_getsizes(node, [v[2] for v in dskl])
1394
      if result.failed:
1395
        self.LogWarning("Failure in blockdev_getsizes call to node"
1396
                        " %s, ignoring", node)
1397
        continue
1398
      if len(result.data) != len(dskl):
1399
        self.LogWarning("Invalid result from node %s, ignoring node results",
1400
                        node)
1401
        continue
1402
      for ((instance, idx, disk), size) in zip(dskl, result.data):
1403
        if size is None:
1404
          self.LogWarning("Disk %d of instance %s did not return size"
1405
                          " information, ignoring", idx, instance.name)
1406
          continue
1407
        if not isinstance(size, (int, long)):
1408
          self.LogWarning("Disk %d of instance %s did not return valid"
1409
                          " size information, ignoring", idx, instance.name)
1410
          continue
1411
        size = size >> 20
1412
        if size != disk.size:
1413
          self.LogInfo("Disk %d of instance %s has mismatched size,"
1414
                       " correcting: recorded %d, actual %d", idx,
1415
                       instance.name, disk.size, size)
1416
          disk.size = size
1417
          self.cfg.Update(instance)
1418
          changed.append((instance.name, idx, size))
1419
    return changed
1420

    
1421

    
1422
class LURenameCluster(LogicalUnit):
1423
  """Rename the cluster.
1424

1425
  """
1426
  HPATH = "cluster-rename"
1427
  HTYPE = constants.HTYPE_CLUSTER
1428
  _OP_REQP = ["name"]
1429

    
1430
  def BuildHooksEnv(self):
1431
    """Build hooks env.
1432

1433
    """
1434
    env = {
1435
      "OP_TARGET": self.cfg.GetClusterName(),
1436
      "NEW_NAME": self.op.name,
1437
      }
1438
    mn = self.cfg.GetMasterNode()
1439
    return env, [mn], [mn]
1440

    
1441
  def CheckPrereq(self):
1442
    """Verify that the passed name is a valid one.
1443

1444
    """
1445
    hostname = utils.HostInfo(self.op.name)
1446

    
1447
    new_name = hostname.name
1448
    self.ip = new_ip = hostname.ip
1449
    old_name = self.cfg.GetClusterName()
1450
    old_ip = self.cfg.GetMasterIP()
1451
    if new_name == old_name and new_ip == old_ip:
1452
      raise errors.OpPrereqError("Neither the name nor the IP address of the"
1453
                                 " cluster has changed")
1454
    if new_ip != old_ip:
1455
      if utils.TcpPing(new_ip, constants.DEFAULT_NODED_PORT):
1456
        raise errors.OpPrereqError("The given cluster IP address (%s) is"
1457
                                   " reachable on the network. Aborting." %
1458
                                   new_ip)
1459

    
1460
    self.op.name = new_name
1461

    
1462
  def Exec(self, feedback_fn):
1463
    """Rename the cluster.
1464

1465
    """
1466
    clustername = self.op.name
1467
    ip = self.ip
1468

    
1469
    # shutdown the master IP
1470
    master = self.cfg.GetMasterNode()
1471
    result = self.rpc.call_node_stop_master(master, False)
1472
    if result.failed or not result.data:
1473
      raise errors.OpExecError("Could not disable the master role")
1474

    
1475
    try:
1476
      cluster = self.cfg.GetClusterInfo()
1477
      cluster.cluster_name = clustername
1478
      cluster.master_ip = ip
1479
      self.cfg.Update(cluster)
1480

    
1481
      # update the known hosts file
1482
      ssh.WriteKnownHostsFile(self.cfg, constants.SSH_KNOWN_HOSTS_FILE)
1483
      node_list = self.cfg.GetNodeList()
1484
      try:
1485
        node_list.remove(master)
1486
      except ValueError:
1487
        pass
1488
      result = self.rpc.call_upload_file(node_list,
1489
                                         constants.SSH_KNOWN_HOSTS_FILE)
1490
      for to_node, to_result in result.iteritems():
1491
        if to_result.failed or not to_result.data:
1492
          logging.error("Copy of file %s to node %s failed",
1493
                        constants.SSH_KNOWN_HOSTS_FILE, to_node)
1494

    
1495
    finally:
1496
      result = self.rpc.call_node_start_master(master, False, False)
1497
      if result.failed or not result.data:
1498
        self.LogWarning("Could not re-enable the master role on"
1499
                        " the master, please restart manually.")
1500

    
1501

    
1502
def _RecursiveCheckIfLVMBased(disk):
1503
  """Check if the given disk or its children are lvm-based.
1504

1505
  @type disk: L{objects.Disk}
1506
  @param disk: the disk to check
1507
  @rtype: boolean
1508
  @return: boolean indicating whether a LD_LV dev_type was found or not
1509

1510
  """
1511
  if disk.children:
1512
    for chdisk in disk.children:
1513
      if _RecursiveCheckIfLVMBased(chdisk):
1514
        return True
1515
  return disk.dev_type == constants.LD_LV
1516

    
1517

    
1518
class LUSetClusterParams(LogicalUnit):
1519
  """Change the parameters of the cluster.
1520

1521
  """
1522
  HPATH = "cluster-modify"
1523
  HTYPE = constants.HTYPE_CLUSTER
1524
  _OP_REQP = []
1525
  REQ_BGL = False
1526

    
1527
  def CheckArguments(self):
1528
    """Check parameters
1529

1530
    """
1531
    if not hasattr(self.op, "candidate_pool_size"):
1532
      self.op.candidate_pool_size = None
1533
    if self.op.candidate_pool_size is not None:
1534
      try:
1535
        self.op.candidate_pool_size = int(self.op.candidate_pool_size)
1536
      except (ValueError, TypeError), err:
1537
        raise errors.OpPrereqError("Invalid candidate_pool_size value: %s" %
1538
                                   str(err))
1539
      if self.op.candidate_pool_size < 1:
1540
        raise errors.OpPrereqError("At least one master candidate needed")
1541

    
1542
  def ExpandNames(self):
1543
    # FIXME: in the future maybe other cluster params won't require checking on
1544
    # all nodes to be modified.
1545
    self.needed_locks = {
1546
      locking.LEVEL_NODE: locking.ALL_SET,
1547
    }
1548
    self.share_locks[locking.LEVEL_NODE] = 1
1549

    
1550
  def BuildHooksEnv(self):
1551
    """Build hooks env.
1552

1553
    """
1554
    env = {
1555
      "OP_TARGET": self.cfg.GetClusterName(),
1556
      "NEW_VG_NAME": self.op.vg_name,
1557
      }
1558
    mn = self.cfg.GetMasterNode()
1559
    return env, [mn], [mn]
1560

    
1561
  def CheckPrereq(self):
1562
    """Check prerequisites.
1563

1564
    This checks whether the given params don't conflict and
1565
    if the given volume group is valid.
1566

1567
    """
1568
    if self.op.vg_name is not None and not self.op.vg_name:
1569
      instances = self.cfg.GetAllInstancesInfo().values()
1570
      for inst in instances:
1571
        for disk in inst.disks:
1572
          if _RecursiveCheckIfLVMBased(disk):
1573
            raise errors.OpPrereqError("Cannot disable lvm storage while"
1574
                                       " lvm-based instances exist")
1575

    
1576
    node_list = self.acquired_locks[locking.LEVEL_NODE]
1577

    
1578
    # if vg_name not None, checks given volume group on all nodes
1579
    if self.op.vg_name:
1580
      vglist = self.rpc.call_vg_list(node_list)
1581
      for node in node_list:
1582
        if vglist[node].failed:
1583
          # ignoring down node
1584
          self.LogWarning("Node %s unreachable/error, ignoring" % node)
1585
          continue
1586
        vgstatus = utils.CheckVolumeGroupSize(vglist[node].data,
1587
                                              self.op.vg_name,
1588
                                              constants.MIN_VG_SIZE)
1589
        if vgstatus:
1590
          raise errors.OpPrereqError("Error on node '%s': %s" %
1591
                                     (node, vgstatus))
1592

    
1593
    self.cluster = cluster = self.cfg.GetClusterInfo()
1594
    # validate beparams changes
1595
    if self.op.beparams:
1596
      utils.ForceDictType(self.op.beparams, constants.BES_PARAMETER_TYPES)
1597
      self.new_beparams = cluster.FillDict(
1598
        cluster.beparams[constants.BEGR_DEFAULT], self.op.beparams)
1599

    
1600
    # hypervisor list/parameters
1601
    self.new_hvparams = cluster.FillDict(cluster.hvparams, {})
1602
    if self.op.hvparams:
1603
      if not isinstance(self.op.hvparams, dict):
1604
        raise errors.OpPrereqError("Invalid 'hvparams' parameter on input")
1605
      for hv_name, hv_dict in self.op.hvparams.items():
1606
        if hv_name not in self.new_hvparams:
1607
          self.new_hvparams[hv_name] = hv_dict
1608
        else:
1609
          self.new_hvparams[hv_name].update(hv_dict)
1610

    
1611
    if self.op.enabled_hypervisors is not None:
1612
      self.hv_list = self.op.enabled_hypervisors
1613
      if not self.hv_list:
1614
        raise errors.OpPrereqError("Enabled hypervisors list must contain at"
1615
                                   " least one member")
1616
      invalid_hvs = set(self.hv_list) - constants.HYPER_TYPES
1617
      if invalid_hvs:
1618
        raise errors.OpPrereqError("Enabled hypervisors contains invalid"
1619
                                   " entries: %s" % invalid_hvs)
1620
    else:
1621
      self.hv_list = cluster.enabled_hypervisors
1622

    
1623
    if self.op.hvparams or self.op.enabled_hypervisors is not None:
1624
      # either the enabled list has changed, or the parameters have, validate
1625
      for hv_name, hv_params in self.new_hvparams.items():
1626
        if ((self.op.hvparams and hv_name in self.op.hvparams) or
1627
            (self.op.enabled_hypervisors and
1628
             hv_name in self.op.enabled_hypervisors)):
1629
          # either this is a new hypervisor, or its parameters have changed
1630
          hv_class = hypervisor.GetHypervisor(hv_name)
1631
          utils.ForceDictType(hv_params, constants.HVS_PARAMETER_TYPES)
1632
          hv_class.CheckParameterSyntax(hv_params)
1633
          _CheckHVParams(self, node_list, hv_name, hv_params)
1634

    
1635
  def Exec(self, feedback_fn):
1636
    """Change the parameters of the cluster.
1637

1638
    """
1639
    if self.op.vg_name is not None:
1640
      new_volume = self.op.vg_name
1641
      if not new_volume:
1642
        new_volume = None
1643
      if new_volume != self.cfg.GetVGName():
1644
        self.cfg.SetVGName(new_volume)
1645
      else:
1646
        feedback_fn("Cluster LVM configuration already in desired"
1647
                    " state, not changing")
1648
    if self.op.hvparams:
1649
      self.cluster.hvparams = self.new_hvparams
1650
    if self.op.enabled_hypervisors is not None:
1651
      self.cluster.enabled_hypervisors = self.op.enabled_hypervisors
1652
    if self.op.beparams:
1653
      self.cluster.beparams[constants.BEGR_DEFAULT] = self.new_beparams
1654
    if self.op.candidate_pool_size is not None:
1655
      self.cluster.candidate_pool_size = self.op.candidate_pool_size
1656
      # we need to update the pool size here, otherwise the save will fail
1657
      _AdjustCandidatePool(self)
1658

    
1659
    self.cfg.Update(self.cluster)
1660

    
1661

    
1662
class LURedistributeConfig(NoHooksLU):
1663
  """Force the redistribution of cluster configuration.
1664

1665
  This is a very simple LU.
1666

1667
  """
1668
  _OP_REQP = []
1669
  REQ_BGL = False
1670

    
1671
  def ExpandNames(self):
1672
    self.needed_locks = {
1673
      locking.LEVEL_NODE: locking.ALL_SET,
1674
    }
1675
    self.share_locks[locking.LEVEL_NODE] = 1
1676

    
1677
  def CheckPrereq(self):
1678
    """Check prerequisites.
1679

1680
    """
1681

    
1682
  def Exec(self, feedback_fn):
1683
    """Redistribute the configuration.
1684

1685
    """
1686
    self.cfg.Update(self.cfg.GetClusterInfo())
1687

    
1688

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

1692
  """
1693
  if not instance.disks:
1694
    return True
1695

    
1696
  if not oneshot:
1697
    lu.proc.LogInfo("Waiting for instance %s to sync disks." % instance.name)
1698

    
1699
  node = instance.primary_node
1700

    
1701
  for dev in instance.disks:
1702
    lu.cfg.SetDiskID(dev, node)
1703

    
1704
  retries = 0
1705
  degr_retries = 10 # in seconds, as we sleep 1 second each time
1706
  while True:
1707
    max_time = 0
1708
    done = True
1709
    cumul_degraded = False
1710
    rstats = lu.rpc.call_blockdev_getmirrorstatus(node, instance.disks)
1711
    if rstats.failed or not rstats.data:
1712
      lu.LogWarning("Can't get any data from node %s", node)
1713
      retries += 1
1714
      if retries >= 10:
1715
        raise errors.RemoteError("Can't contact node %s for mirror data,"
1716
                                 " aborting." % node)
1717
      time.sleep(6)
1718
      continue
1719
    rstats = rstats.data
1720
    retries = 0
1721
    for i, mstat in enumerate(rstats):
1722
      if mstat is None:
1723
        lu.LogWarning("Can't compute data for node %s/%s",
1724
                           node, instance.disks[i].iv_name)
1725
        continue
1726
      # we ignore the ldisk parameter
1727
      perc_done, est_time, is_degraded, _ = mstat
1728
      cumul_degraded = cumul_degraded or (is_degraded and perc_done is None)
1729
      if perc_done is not None:
1730
        done = False
1731
        if est_time is not None:
1732
          rem_time = "%d estimated seconds remaining" % est_time
1733
          max_time = est_time
1734
        else:
1735
          rem_time = "no time estimate"
1736
        lu.proc.LogInfo("- device %s: %5.2f%% done, %s" %
1737
                        (instance.disks[i].iv_name, perc_done, rem_time))
1738

    
1739
    # if we're done but degraded, let's do a few small retries, to
1740
    # make sure we see a stable and not transient situation; therefore
1741
    # we force restart of the loop
1742
    if (done or oneshot) and cumul_degraded and degr_retries > 0:
1743
      logging.info("Degraded disks found, %d retries left", degr_retries)
1744
      degr_retries -= 1
1745
      time.sleep(1)
1746
      continue
1747

    
1748
    if done or oneshot:
1749
      break
1750

    
1751
    time.sleep(min(60, max_time))
1752

    
1753
  if done:
1754
    lu.proc.LogInfo("Instance %s's disks are in sync." % instance.name)
1755
  return not cumul_degraded
1756

    
1757

    
1758
def _CheckDiskConsistency(lu, dev, node, on_primary, ldisk=False):
1759
  """Check that mirrors are not degraded.
1760

1761
  The ldisk parameter, if True, will change the test from the
1762
  is_degraded attribute (which represents overall non-ok status for
1763
  the device(s)) to the ldisk (representing the local storage status).
1764

1765
  """
1766
  lu.cfg.SetDiskID(dev, node)
1767
  if ldisk:
1768
    idx = 6
1769
  else:
1770
    idx = 5
1771

    
1772
  result = True
1773
  if on_primary or dev.AssembleOnSecondary():
1774
    rstats = lu.rpc.call_blockdev_find(node, dev)
1775
    msg = rstats.RemoteFailMsg()
1776
    if msg:
1777
      lu.LogWarning("Can't find disk on node %s: %s", node, msg)
1778
      result = False
1779
    elif not rstats.payload:
1780
      lu.LogWarning("Can't find disk on node %s", node)
1781
      result = False
1782
    else:
1783
      result = result and (not rstats.payload[idx])
1784
  if dev.children:
1785
    for child in dev.children:
1786
      result = result and _CheckDiskConsistency(lu, child, node, on_primary)
1787

    
1788
  return result
1789

    
1790

    
1791
class LUDiagnoseOS(NoHooksLU):
1792
  """Logical unit for OS diagnose/query.
1793

1794
  """
1795
  _OP_REQP = ["output_fields", "names"]
1796
  REQ_BGL = False
1797
  _FIELDS_STATIC = utils.FieldSet()
1798
  _FIELDS_DYNAMIC = utils.FieldSet("name", "valid", "node_status")
1799

    
1800
  def ExpandNames(self):
1801
    if self.op.names:
1802
      raise errors.OpPrereqError("Selective OS query not supported")
1803

    
1804
    _CheckOutputFields(static=self._FIELDS_STATIC,
1805
                       dynamic=self._FIELDS_DYNAMIC,
1806
                       selected=self.op.output_fields)
1807

    
1808
    # Lock all nodes, in shared mode
1809
    # Temporary removal of locks, should be reverted later
1810
    # TODO: reintroduce locks when they are lighter-weight
1811
    self.needed_locks = {}
1812
    #self.share_locks[locking.LEVEL_NODE] = 1
1813
    #self.needed_locks[locking.LEVEL_NODE] = locking.ALL_SET
1814

    
1815
  def CheckPrereq(self):
1816
    """Check prerequisites.
1817

1818
    """
1819

    
1820
  @staticmethod
1821
  def _DiagnoseByOS(node_list, rlist):
1822
    """Remaps a per-node return list into an a per-os per-node dictionary
1823

1824
    @param node_list: a list with the names of all nodes
1825
    @param rlist: a map with node names as keys and OS objects as values
1826

1827
    @rtype: dict
1828
    @return: a dictionary with osnames as keys and as value another map, with
1829
        nodes as keys and list of OS objects as values, eg::
1830

1831
          {"debian-etch": {"node1": [<object>,...],
1832
                           "node2": [<object>,]}
1833
          }
1834

1835
    """
1836
    all_os = {}
1837
    # we build here the list of nodes that didn't fail the RPC (at RPC
1838
    # level), so that nodes with a non-responding node daemon don't
1839
    # make all OSes invalid
1840
    good_nodes = [node_name for node_name in rlist
1841
                  if not rlist[node_name].failed]
1842
    for node_name, nr in rlist.iteritems():
1843
      if nr.failed or not nr.data:
1844
        continue
1845
      for os_obj in nr.data:
1846
        if os_obj.name not in all_os:
1847
          # build a list of nodes for this os containing empty lists
1848
          # for each node in node_list
1849
          all_os[os_obj.name] = {}
1850
          for nname in good_nodes:
1851
            all_os[os_obj.name][nname] = []
1852
        all_os[os_obj.name][node_name].append(os_obj)
1853
    return all_os
1854

    
1855
  def Exec(self, feedback_fn):
1856
    """Compute the list of OSes.
1857

1858
    """
1859
    valid_nodes = [node for node in self.cfg.GetOnlineNodeList()]
1860
    node_data = self.rpc.call_os_diagnose(valid_nodes)
1861
    if node_data == False:
1862
      raise errors.OpExecError("Can't gather the list of OSes")
1863
    pol = self._DiagnoseByOS(valid_nodes, node_data)
1864
    output = []
1865
    for os_name, os_data in pol.iteritems():
1866
      row = []
1867
      for field in self.op.output_fields:
1868
        if field == "name":
1869
          val = os_name
1870
        elif field == "valid":
1871
          val = utils.all([osl and osl[0] for osl in os_data.values()])
1872
        elif field == "node_status":
1873
          val = {}
1874
          for node_name, nos_list in os_data.iteritems():
1875
            val[node_name] = [(v.status, v.path) for v in nos_list]
1876
        else:
1877
          raise errors.ParameterError(field)
1878
        row.append(val)
1879
      output.append(row)
1880

    
1881
    return output
1882

    
1883

    
1884
class LURemoveNode(LogicalUnit):
1885
  """Logical unit for removing a node.
1886

1887
  """
1888
  HPATH = "node-remove"
1889
  HTYPE = constants.HTYPE_NODE
1890
  _OP_REQP = ["node_name"]
1891

    
1892
  def BuildHooksEnv(self):
1893
    """Build hooks env.
1894

1895
    This doesn't run on the target node in the pre phase as a failed
1896
    node would then be impossible to remove.
1897

1898
    """
1899
    env = {
1900
      "OP_TARGET": self.op.node_name,
1901
      "NODE_NAME": self.op.node_name,
1902
      }
1903
    all_nodes = self.cfg.GetNodeList()
1904
    all_nodes.remove(self.op.node_name)
1905
    return env, all_nodes, all_nodes
1906

    
1907
  def CheckPrereq(self):
1908
    """Check prerequisites.
1909

1910
    This checks:
1911
     - the node exists in the configuration
1912
     - it does not have primary or secondary instances
1913
     - it's not the master
1914

1915
    Any errors are signaled by raising errors.OpPrereqError.
1916

1917
    """
1918
    node = self.cfg.GetNodeInfo(self.cfg.ExpandNodeName(self.op.node_name))
1919
    if node is None:
1920
      raise errors.OpPrereqError, ("Node '%s' is unknown." % self.op.node_name)
1921

    
1922
    instance_list = self.cfg.GetInstanceList()
1923

    
1924
    masternode = self.cfg.GetMasterNode()
1925
    if node.name == masternode:
1926
      raise errors.OpPrereqError("Node is the master node,"
1927
                                 " you need to failover first.")
1928

    
1929
    for instance_name in instance_list:
1930
      instance = self.cfg.GetInstanceInfo(instance_name)
1931
      if node.name in instance.all_nodes:
1932
        raise errors.OpPrereqError("Instance %s is still running on the node,"
1933
                                   " please remove first." % instance_name)
1934
    self.op.node_name = node.name
1935
    self.node = node
1936

    
1937
  def Exec(self, feedback_fn):
1938
    """Removes the node from the cluster.
1939

1940
    """
1941
    node = self.node
1942
    logging.info("Stopping the node daemon and removing configs from node %s",
1943
                 node.name)
1944

    
1945
    self.context.RemoveNode(node.name)
1946

    
1947
    self.rpc.call_node_leave_cluster(node.name)
1948

    
1949
    # Promote nodes to master candidate as needed
1950
    _AdjustCandidatePool(self)
1951

    
1952

    
1953
class LUQueryNodes(NoHooksLU):
1954
  """Logical unit for querying nodes.
1955

1956
  """
1957
  _OP_REQP = ["output_fields", "names", "use_locking"]
1958
  REQ_BGL = False
1959
  _FIELDS_DYNAMIC = utils.FieldSet(
1960
    "dtotal", "dfree",
1961
    "mtotal", "mnode", "mfree",
1962
    "bootid",
1963
    "ctotal", "cnodes", "csockets",
1964
    )
1965

    
1966
  _FIELDS_STATIC = utils.FieldSet(
1967
    "name", "pinst_cnt", "sinst_cnt",
1968
    "pinst_list", "sinst_list",
1969
    "pip", "sip", "tags",
1970
    "serial_no",
1971
    "master_candidate",
1972
    "master",
1973
    "offline",
1974
    "drained",
1975
    "role",
1976
    )
1977

    
1978
  def ExpandNames(self):
1979
    _CheckOutputFields(static=self._FIELDS_STATIC,
1980
                       dynamic=self._FIELDS_DYNAMIC,
1981
                       selected=self.op.output_fields)
1982

    
1983
    self.needed_locks = {}
1984
    self.share_locks[locking.LEVEL_NODE] = 1
1985

    
1986
    if self.op.names:
1987
      self.wanted = _GetWantedNodes(self, self.op.names)
1988
    else:
1989
      self.wanted = locking.ALL_SET
1990

    
1991
    self.do_node_query = self._FIELDS_STATIC.NonMatching(self.op.output_fields)
1992
    self.do_locking = self.do_node_query and self.op.use_locking
1993
    if self.do_locking:
1994
      # if we don't request only static fields, we need to lock the nodes
1995
      self.needed_locks[locking.LEVEL_NODE] = self.wanted
1996

    
1997

    
1998
  def CheckPrereq(self):
1999
    """Check prerequisites.
2000

2001
    """
2002
    # The validation of the node list is done in the _GetWantedNodes,
2003
    # if non empty, and if empty, there's no validation to do
2004
    pass
2005

    
2006
  def Exec(self, feedback_fn):
2007
    """Computes the list of nodes and their attributes.
2008

2009
    """
2010
    all_info = self.cfg.GetAllNodesInfo()
2011
    if self.do_locking:
2012
      nodenames = self.acquired_locks[locking.LEVEL_NODE]
2013
    elif self.wanted != locking.ALL_SET:
2014
      nodenames = self.wanted
2015
      missing = set(nodenames).difference(all_info.keys())
2016
      if missing:
2017
        raise errors.OpExecError(
2018
          "Some nodes were removed before retrieving their data: %s" % missing)
2019
    else:
2020
      nodenames = all_info.keys()
2021

    
2022
    nodenames = utils.NiceSort(nodenames)
2023
    nodelist = [all_info[name] for name in nodenames]
2024

    
2025
    # begin data gathering
2026

    
2027
    if self.do_node_query:
2028
      live_data = {}
2029
      node_data = self.rpc.call_node_info(nodenames, self.cfg.GetVGName(),
2030
                                          self.cfg.GetHypervisorType())
2031
      for name in nodenames:
2032
        nodeinfo = node_data[name]
2033
        if not nodeinfo.failed and nodeinfo.data:
2034
          nodeinfo = nodeinfo.data
2035
          fn = utils.TryConvert
2036
          live_data[name] = {
2037
            "mtotal": fn(int, nodeinfo.get('memory_total', None)),
2038
            "mnode": fn(int, nodeinfo.get('memory_dom0', None)),
2039
            "mfree": fn(int, nodeinfo.get('memory_free', None)),
2040
            "dtotal": fn(int, nodeinfo.get('vg_size', None)),
2041
            "dfree": fn(int, nodeinfo.get('vg_free', None)),
2042
            "ctotal": fn(int, nodeinfo.get('cpu_total', None)),
2043
            "bootid": nodeinfo.get('bootid', None),
2044
            "cnodes": fn(int, nodeinfo.get('cpu_nodes', None)),
2045
            "csockets": fn(int, nodeinfo.get('cpu_sockets', None)),
2046
            }
2047
        else:
2048
          live_data[name] = {}
2049
    else:
2050
      live_data = dict.fromkeys(nodenames, {})
2051

    
2052
    node_to_primary = dict([(name, set()) for name in nodenames])
2053
    node_to_secondary = dict([(name, set()) for name in nodenames])
2054

    
2055
    inst_fields = frozenset(("pinst_cnt", "pinst_list",
2056
                             "sinst_cnt", "sinst_list"))
2057
    if inst_fields & frozenset(self.op.output_fields):
2058
      instancelist = self.cfg.GetInstanceList()
2059

    
2060
      for instance_name in instancelist:
2061
        inst = self.cfg.GetInstanceInfo(instance_name)
2062
        if inst.primary_node in node_to_primary:
2063
          node_to_primary[inst.primary_node].add(inst.name)
2064
        for secnode in inst.secondary_nodes:
2065
          if secnode in node_to_secondary:
2066
            node_to_secondary[secnode].add(inst.name)
2067

    
2068
    master_node = self.cfg.GetMasterNode()
2069

    
2070
    # end data gathering
2071

    
2072
    output = []
2073
    for node in nodelist:
2074
      node_output = []
2075
      for field in self.op.output_fields:
2076
        if field == "name":
2077
          val = node.name
2078
        elif field == "pinst_list":
2079
          val = list(node_to_primary[node.name])
2080
        elif field == "sinst_list":
2081
          val = list(node_to_secondary[node.name])
2082
        elif field == "pinst_cnt":
2083
          val = len(node_to_primary[node.name])
2084
        elif field == "sinst_cnt":
2085
          val = len(node_to_secondary[node.name])
2086
        elif field == "pip":
2087
          val = node.primary_ip
2088
        elif field == "sip":
2089
          val = node.secondary_ip
2090
        elif field == "tags":
2091
          val = list(node.GetTags())
2092
        elif field == "serial_no":
2093
          val = node.serial_no
2094
        elif field == "master_candidate":
2095
          val = node.master_candidate
2096
        elif field == "master":
2097
          val = node.name == master_node
2098
        elif field == "offline":
2099
          val = node.offline
2100
        elif field == "drained":
2101
          val = node.drained
2102
        elif self._FIELDS_DYNAMIC.Matches(field):
2103
          val = live_data[node.name].get(field, None)
2104
        elif field == "role":
2105
          if node.name == master_node:
2106
            val = "M"
2107
          elif node.master_candidate:
2108
            val = "C"
2109
          elif node.drained:
2110
            val = "D"
2111
          elif node.offline:
2112
            val = "O"
2113
          else:
2114
            val = "R"
2115
        else:
2116
          raise errors.ParameterError(field)
2117
        node_output.append(val)
2118
      output.append(node_output)
2119

    
2120
    return output
2121

    
2122

    
2123
class LUQueryNodeVolumes(NoHooksLU):
2124
  """Logical unit for getting volumes on node(s).
2125

2126
  """
2127
  _OP_REQP = ["nodes", "output_fields"]
2128
  REQ_BGL = False
2129
  _FIELDS_DYNAMIC = utils.FieldSet("phys", "vg", "name", "size", "instance")
2130
  _FIELDS_STATIC = utils.FieldSet("node")
2131

    
2132
  def ExpandNames(self):
2133
    _CheckOutputFields(static=self._FIELDS_STATIC,
2134
                       dynamic=self._FIELDS_DYNAMIC,
2135
                       selected=self.op.output_fields)
2136

    
2137
    self.needed_locks = {}
2138
    self.share_locks[locking.LEVEL_NODE] = 1
2139
    if not self.op.nodes:
2140
      self.needed_locks[locking.LEVEL_NODE] = locking.ALL_SET
2141
    else:
2142
      self.needed_locks[locking.LEVEL_NODE] = \
2143
        _GetWantedNodes(self, self.op.nodes)
2144

    
2145
  def CheckPrereq(self):
2146
    """Check prerequisites.
2147

2148
    This checks that the fields required are valid output fields.
2149

2150
    """
2151
    self.nodes = self.acquired_locks[locking.LEVEL_NODE]
2152

    
2153
  def Exec(self, feedback_fn):
2154
    """Computes the list of nodes and their attributes.
2155

2156
    """
2157
    nodenames = self.nodes
2158
    volumes = self.rpc.call_node_volumes(nodenames)
2159

    
2160
    ilist = [self.cfg.GetInstanceInfo(iname) for iname
2161
             in self.cfg.GetInstanceList()]
2162

    
2163
    lv_by_node = dict([(inst, inst.MapLVsByNode()) for inst in ilist])
2164

    
2165
    output = []
2166
    for node in nodenames:
2167
      if node not in volumes or volumes[node].failed or not volumes[node].data:
2168
        continue
2169

    
2170
      node_vols = volumes[node].data[:]
2171
      node_vols.sort(key=lambda vol: vol['dev'])
2172

    
2173
      for vol in node_vols:
2174
        node_output = []
2175
        for field in self.op.output_fields:
2176
          if field == "node":
2177
            val = node
2178
          elif field == "phys":
2179
            val = vol['dev']
2180
          elif field == "vg":
2181
            val = vol['vg']
2182
          elif field == "name":
2183
            val = vol['name']
2184
          elif field == "size":
2185
            val = int(float(vol['size']))
2186
          elif field == "instance":
2187
            for inst in ilist:
2188
              if node not in lv_by_node[inst]:
2189
                continue
2190
              if vol['name'] in lv_by_node[inst][node]:
2191
                val = inst.name
2192
                break
2193
            else:
2194
              val = '-'
2195
          else:
2196
            raise errors.ParameterError(field)
2197
          node_output.append(str(val))
2198

    
2199
        output.append(node_output)
2200

    
2201
    return output
2202

    
2203

    
2204
class LUAddNode(LogicalUnit):
2205
  """Logical unit for adding node to the cluster.
2206

2207
  """
2208
  HPATH = "node-add"
2209
  HTYPE = constants.HTYPE_NODE
2210
  _OP_REQP = ["node_name"]
2211

    
2212
  def BuildHooksEnv(self):
2213
    """Build hooks env.
2214

2215
    This will run on all nodes before, and on all nodes + the new node after.
2216

2217
    """
2218
    env = {
2219
      "OP_TARGET": self.op.node_name,
2220
      "NODE_NAME": self.op.node_name,
2221
      "NODE_PIP": self.op.primary_ip,
2222
      "NODE_SIP": self.op.secondary_ip,
2223
      }
2224
    nodes_0 = self.cfg.GetNodeList()
2225
    nodes_1 = nodes_0 + [self.op.node_name, ]
2226
    return env, nodes_0, nodes_1
2227

    
2228
  def CheckPrereq(self):
2229
    """Check prerequisites.
2230

2231
    This checks:
2232
     - the new node is not already in the config
2233
     - it is resolvable
2234
     - its parameters (single/dual homed) matches the cluster
2235

2236
    Any errors are signaled by raising errors.OpPrereqError.
2237

2238
    """
2239
    node_name = self.op.node_name
2240
    cfg = self.cfg
2241

    
2242
    dns_data = utils.HostInfo(node_name)
2243

    
2244
    node = dns_data.name
2245
    primary_ip = self.op.primary_ip = dns_data.ip
2246
    secondary_ip = getattr(self.op, "secondary_ip", None)
2247
    if secondary_ip is None:
2248
      secondary_ip = primary_ip
2249
    if not utils.IsValidIP(secondary_ip):
2250
      raise errors.OpPrereqError("Invalid secondary IP given")
2251
    self.op.secondary_ip = secondary_ip
2252

    
2253
    node_list = cfg.GetNodeList()
2254
    if not self.op.readd and node in node_list:
2255
      raise errors.OpPrereqError("Node %s is already in the configuration" %
2256
                                 node)
2257
    elif self.op.readd and node not in node_list:
2258
      raise errors.OpPrereqError("Node %s is not in the configuration" % node)
2259

    
2260
    for existing_node_name in node_list:
2261
      existing_node = cfg.GetNodeInfo(existing_node_name)
2262

    
2263
      if self.op.readd and node == existing_node_name:
2264
        if (existing_node.primary_ip != primary_ip or
2265
            existing_node.secondary_ip != secondary_ip):
2266
          raise errors.OpPrereqError("Readded node doesn't have the same IP"
2267
                                     " address configuration as before")
2268
        continue
2269

    
2270
      if (existing_node.primary_ip == primary_ip or
2271
          existing_node.secondary_ip == primary_ip or
2272
          existing_node.primary_ip == secondary_ip or
2273
          existing_node.secondary_ip == secondary_ip):
2274
        raise errors.OpPrereqError("New node ip address(es) conflict with"
2275
                                   " existing node %s" % existing_node.name)
2276

    
2277
    # check that the type of the node (single versus dual homed) is the
2278
    # same as for the master
2279
    myself = cfg.GetNodeInfo(self.cfg.GetMasterNode())
2280
    master_singlehomed = myself.secondary_ip == myself.primary_ip
2281
    newbie_singlehomed = secondary_ip == primary_ip
2282
    if master_singlehomed != newbie_singlehomed:
2283
      if master_singlehomed:
2284
        raise errors.OpPrereqError("The master has no private ip but the"
2285
                                   " new node has one")
2286
      else:
2287
        raise errors.OpPrereqError("The master has a private ip but the"
2288
                                   " new node doesn't have one")
2289

    
2290
    # checks reachability
2291
    if not utils.TcpPing(primary_ip, constants.DEFAULT_NODED_PORT):
2292
      raise errors.OpPrereqError("Node not reachable by ping")
2293

    
2294
    if not newbie_singlehomed:
2295
      # check reachability from my secondary ip to newbie's secondary ip
2296
      if not utils.TcpPing(secondary_ip, constants.DEFAULT_NODED_PORT,
2297
                           source=myself.secondary_ip):
2298
        raise errors.OpPrereqError("Node secondary ip not reachable by TCP"
2299
                                   " based ping to noded port")
2300

    
2301
    cp_size = self.cfg.GetClusterInfo().candidate_pool_size
2302
    if self.op.readd:
2303
      exceptions = [node]
2304
    else:
2305
      exceptions = []
2306
    mc_now, mc_max = self.cfg.GetMasterCandidateStats(exceptions)
2307
    # the new node will increase mc_max with one, so:
2308
    mc_max = min(mc_max + 1, cp_size)
2309
    self.master_candidate = mc_now < mc_max
2310

    
2311
    if self.op.readd:
2312
      self.new_node = self.cfg.GetNodeInfo(node)
2313
      assert self.new_node is not None, "Can't retrieve locked node %s" % node
2314
    else:
2315
      self.new_node = objects.Node(name=node,
2316
                                   primary_ip=primary_ip,
2317
                                   secondary_ip=secondary_ip,
2318
                                   master_candidate=self.master_candidate,
2319
                                   offline=False, drained=False)
2320

    
2321
  def Exec(self, feedback_fn):
2322
    """Adds the new node to the cluster.
2323

2324
    """
2325
    new_node = self.new_node
2326
    node = new_node.name
2327

    
2328
    # for re-adds, reset the offline/drained/master-candidate flags;
2329
    # we need to reset here, otherwise offline would prevent RPC calls
2330
    # later in the procedure; this also means that if the re-add
2331
    # fails, we are left with a non-offlined, broken node
2332
    if self.op.readd:
2333
      new_node.drained = new_node.offline = False
2334
      self.LogInfo("Readding a node, the offline/drained flags were reset")
2335
      # if we demote the node, we do cleanup later in the procedure
2336
      new_node.master_candidate = self.master_candidate
2337

    
2338
    # notify the user about any possible mc promotion
2339
    if new_node.master_candidate:
2340
      self.LogInfo("Node will be a master candidate")
2341

    
2342
    # check connectivity
2343
    result = self.rpc.call_version([node])[node]
2344
    result.Raise()
2345
    if result.data:
2346
      if constants.PROTOCOL_VERSION == result.data:
2347
        logging.info("Communication to node %s fine, sw version %s match",
2348
                     node, result.data)
2349
      else:
2350
        raise errors.OpExecError("Version mismatch master version %s,"
2351
                                 " node version %s" %
2352
                                 (constants.PROTOCOL_VERSION, result.data))
2353
    else:
2354
      raise errors.OpExecError("Cannot get version from the new node")
2355

    
2356
    # setup ssh on node
2357
    logging.info("Copy ssh key to node %s", node)
2358
    priv_key, pub_key, _ = ssh.GetUserFiles(constants.GANETI_RUNAS)
2359
    keyarray = []
2360
    keyfiles = [constants.SSH_HOST_DSA_PRIV, constants.SSH_HOST_DSA_PUB,
2361
                constants.SSH_HOST_RSA_PRIV, constants.SSH_HOST_RSA_PUB,
2362
                priv_key, pub_key]
2363

    
2364
    for i in keyfiles:
2365
      f = open(i, 'r')
2366
      try:
2367
        keyarray.append(f.read())
2368
      finally:
2369
        f.close()
2370

    
2371
    result = self.rpc.call_node_add(node, keyarray[0], keyarray[1],
2372
                                    keyarray[2],
2373
                                    keyarray[3], keyarray[4], keyarray[5])
2374

    
2375
    msg = result.RemoteFailMsg()
2376
    if msg:
2377
      raise errors.OpExecError("Cannot transfer ssh keys to the"
2378
                               " new node: %s" % msg)
2379

    
2380
    # Add node to our /etc/hosts, and add key to known_hosts
2381
    if self.cfg.GetClusterInfo().modify_etc_hosts:
2382
      utils.AddHostToEtcHosts(new_node.name)
2383

    
2384
    if new_node.secondary_ip != new_node.primary_ip:
2385
      result = self.rpc.call_node_has_ip_address(new_node.name,
2386
                                                 new_node.secondary_ip)
2387
      if result.failed or not result.data:
2388
        raise errors.OpExecError("Node claims it doesn't have the secondary ip"
2389
                                 " you gave (%s). Please fix and re-run this"
2390
                                 " command." % new_node.secondary_ip)
2391

    
2392
    node_verify_list = [self.cfg.GetMasterNode()]
2393
    node_verify_param = {
2394
      'nodelist': [node],
2395
      # TODO: do a node-net-test as well?
2396
    }
2397

    
2398
    result = self.rpc.call_node_verify(node_verify_list, node_verify_param,
2399
                                       self.cfg.GetClusterName())
2400
    for verifier in node_verify_list:
2401
      if result[verifier].failed or not result[verifier].data:
2402
        raise errors.OpExecError("Cannot communicate with %s's node daemon"
2403
                                 " for remote verification" % verifier)
2404
      if result[verifier].data['nodelist']:
2405
        for failed in result[verifier].data['nodelist']:
2406
          feedback_fn("ssh/hostname verification failed %s -> %s" %
2407
                      (verifier, result[verifier].data['nodelist'][failed]))
2408
        raise errors.OpExecError("ssh/hostname verification failed.")
2409

    
2410
    # Distribute updated /etc/hosts and known_hosts to all nodes,
2411
    # including the node just added
2412
    myself = self.cfg.GetNodeInfo(self.cfg.GetMasterNode())
2413
    dist_nodes = self.cfg.GetNodeList()
2414
    if not self.op.readd:
2415
      dist_nodes.append(node)
2416
    if myself.name in dist_nodes:
2417
      dist_nodes.remove(myself.name)
2418

    
2419
    logging.debug("Copying hosts and known_hosts to all nodes")
2420
    for fname in (constants.ETC_HOSTS, constants.SSH_KNOWN_HOSTS_FILE):
2421
      result = self.rpc.call_upload_file(dist_nodes, fname)
2422
      for to_node, to_result in result.iteritems():
2423
        if to_result.failed or not to_result.data:
2424
          logging.error("Copy of file %s to node %s failed", fname, to_node)
2425

    
2426
    to_copy = []
2427
    enabled_hypervisors = self.cfg.GetClusterInfo().enabled_hypervisors
2428
    if constants.HTS_COPY_VNC_PASSWORD.intersection(enabled_hypervisors):
2429
      to_copy.append(constants.VNC_PASSWORD_FILE)
2430

    
2431
    for fname in to_copy:
2432
      result = self.rpc.call_upload_file([node], fname)
2433
      if result[node].failed or not result[node]:
2434
        logging.error("Could not copy file %s to node %s", fname, node)
2435

    
2436
    if self.op.readd:
2437
      self.context.ReaddNode(new_node)
2438
      # make sure we redistribute the config
2439
      self.cfg.Update(new_node)
2440
      # and make sure the new node will not have old files around
2441
      if not new_node.master_candidate:
2442
        result = self.rpc.call_node_demote_from_mc(new_node.name)
2443
        msg = result.RemoteFailMsg()
2444
        if msg:
2445
          self.LogWarning("Node failed to demote itself from master"
2446
                          " candidate status: %s" % msg)
2447
    else:
2448
      self.context.AddNode(new_node)
2449

    
2450

    
2451
class LUSetNodeParams(LogicalUnit):
2452
  """Modifies the parameters of a node.
2453

2454
  """
2455
  HPATH = "node-modify"
2456
  HTYPE = constants.HTYPE_NODE
2457
  _OP_REQP = ["node_name"]
2458
  REQ_BGL = False
2459

    
2460
  def CheckArguments(self):
2461
    node_name = self.cfg.ExpandNodeName(self.op.node_name)
2462
    if node_name is None:
2463
      raise errors.OpPrereqError("Invalid node name '%s'" % self.op.node_name)
2464
    self.op.node_name = node_name
2465
    _CheckBooleanOpField(self.op, 'master_candidate')
2466
    _CheckBooleanOpField(self.op, 'offline')
2467
    _CheckBooleanOpField(self.op, 'drained')
2468
    all_mods = [self.op.offline, self.op.master_candidate, self.op.drained]
2469
    if all_mods.count(None) == 3:
2470
      raise errors.OpPrereqError("Please pass at least one modification")
2471
    if all_mods.count(True) > 1:
2472
      raise errors.OpPrereqError("Can't set the node into more than one"
2473
                                 " state at the same time")
2474

    
2475
  def ExpandNames(self):
2476
    self.needed_locks = {locking.LEVEL_NODE: self.op.node_name}
2477

    
2478
  def BuildHooksEnv(self):
2479
    """Build hooks env.
2480

2481
    This runs on the master node.
2482

2483
    """
2484
    env = {
2485
      "OP_TARGET": self.op.node_name,
2486
      "MASTER_CANDIDATE": str(self.op.master_candidate),
2487
      "OFFLINE": str(self.op.offline),
2488
      "DRAINED": str(self.op.drained),
2489
      }
2490
    nl = [self.cfg.GetMasterNode(),
2491
          self.op.node_name]
2492
    return env, nl, nl
2493

    
2494
  def CheckPrereq(self):
2495
    """Check prerequisites.
2496

2497
    This only checks the instance list against the existing names.
2498

2499
    """
2500
    node = self.node = self.cfg.GetNodeInfo(self.op.node_name)
2501

    
2502
    if (self.op.master_candidate is not None or
2503
        self.op.drained is not None or
2504
        self.op.offline is not None):
2505
      # we can't change the master's node flags
2506
      if self.op.node_name == self.cfg.GetMasterNode():
2507
        raise errors.OpPrereqError("The master role can be changed"
2508
                                   " only via masterfailover")
2509

    
2510
    if ((self.op.master_candidate == False or self.op.offline == True or
2511
         self.op.drained == True) and node.master_candidate):
2512
      cp_size = self.cfg.GetClusterInfo().candidate_pool_size
2513
      num_candidates, _ = self.cfg.GetMasterCandidateStats()
2514
      if num_candidates <= cp_size:
2515
        msg = ("Not enough master candidates (desired"
2516
               " %d, new value will be %d)" % (cp_size, num_candidates-1))
2517
        if self.op.force:
2518
          self.LogWarning(msg)
2519
        else:
2520
          raise errors.OpPrereqError(msg)
2521

    
2522
    if (self.op.master_candidate == True and
2523
        ((node.offline and not self.op.offline == False) or
2524
         (node.drained and not self.op.drained == False))):
2525
      raise errors.OpPrereqError("Node '%s' is offline or drained, can't set"
2526
                                 " to master_candidate" % node.name)
2527

    
2528
    return
2529

    
2530
  def Exec(self, feedback_fn):
2531
    """Modifies a node.
2532

2533
    """
2534
    node = self.node
2535

    
2536
    result = []
2537
    changed_mc = False
2538

    
2539
    if self.op.offline is not None:
2540
      node.offline = self.op.offline
2541
      result.append(("offline", str(self.op.offline)))
2542
      if self.op.offline == True:
2543
        if node.master_candidate:
2544
          node.master_candidate = False
2545
          changed_mc = True
2546
          result.append(("master_candidate", "auto-demotion due to offline"))
2547
        if node.drained:
2548
          node.drained = False
2549
          result.append(("drained", "clear drained status due to offline"))
2550

    
2551
    if self.op.master_candidate is not None:
2552
      node.master_candidate = self.op.master_candidate
2553
      changed_mc = True
2554
      result.append(("master_candidate", str(self.op.master_candidate)))
2555
      if self.op.master_candidate == False:
2556
        rrc = self.rpc.call_node_demote_from_mc(node.name)
2557
        msg = rrc.RemoteFailMsg()
2558
        if msg:
2559
          self.LogWarning("Node failed to demote itself: %s" % msg)
2560

    
2561
    if self.op.drained is not None:
2562
      node.drained = self.op.drained
2563
      result.append(("drained", str(self.op.drained)))
2564
      if self.op.drained == True:
2565
        if node.master_candidate:
2566
          node.master_candidate = False
2567
          changed_mc = True
2568
          result.append(("master_candidate", "auto-demotion due to drain"))
2569
          rrc = self.rpc.call_node_demote_from_mc(node.name)
2570
          msg = rrc.RemoteFailMsg()
2571
          if msg:
2572
            self.LogWarning("Node failed to demote itself: %s" % msg)
2573
        if node.offline:
2574
          node.offline = False
2575
          result.append(("offline", "clear offline status due to drain"))
2576

    
2577
    # this will trigger configuration file update, if needed
2578
    self.cfg.Update(node)
2579
    # this will trigger job queue propagation or cleanup
2580
    if changed_mc:
2581
      self.context.ReaddNode(node)
2582

    
2583
    return result
2584

    
2585

    
2586
class LUQueryClusterInfo(NoHooksLU):
2587
  """Query cluster configuration.
2588

2589
  """
2590
  _OP_REQP = []
2591
  REQ_BGL = False
2592

    
2593
  def ExpandNames(self):
2594
    self.needed_locks = {}
2595

    
2596
  def CheckPrereq(self):
2597
    """No prerequsites needed for this LU.
2598

2599
    """
2600
    pass
2601

    
2602
  def Exec(self, feedback_fn):
2603
    """Return cluster config.
2604

2605
    """
2606
    cluster = self.cfg.GetClusterInfo()
2607
    result = {
2608
      "software_version": constants.RELEASE_VERSION,
2609
      "protocol_version": constants.PROTOCOL_VERSION,
2610
      "config_version": constants.CONFIG_VERSION,
2611
      "os_api_version": constants.OS_API_VERSION,
2612
      "export_version": constants.EXPORT_VERSION,
2613
      "architecture": (platform.architecture()[0], platform.machine()),
2614
      "name": cluster.cluster_name,
2615
      "master": cluster.master_node,
2616
      "default_hypervisor": cluster.default_hypervisor,
2617
      "enabled_hypervisors": cluster.enabled_hypervisors,
2618
      "hvparams": dict([(hypervisor_name, cluster.hvparams[hypervisor_name])
2619
                        for hypervisor_name in cluster.enabled_hypervisors]),
2620
      "beparams": cluster.beparams,
2621
      "candidate_pool_size": cluster.candidate_pool_size,
2622
      "default_bridge": cluster.default_bridge,
2623
      "master_netdev": cluster.master_netdev,
2624
      "volume_group_name": cluster.volume_group_name,
2625
      "file_storage_dir": cluster.file_storage_dir,
2626
      }
2627

    
2628
    return result
2629

    
2630

    
2631
class LUQueryConfigValues(NoHooksLU):
2632
  """Return configuration values.
2633

2634
  """
2635
  _OP_REQP = []
2636
  REQ_BGL = False
2637
  _FIELDS_DYNAMIC = utils.FieldSet()
2638
  _FIELDS_STATIC = utils.FieldSet("cluster_name", "master_node", "drain_flag")
2639

    
2640
  def ExpandNames(self):
2641
    self.needed_locks = {}
2642

    
2643
    _CheckOutputFields(static=self._FIELDS_STATIC,
2644
                       dynamic=self._FIELDS_DYNAMIC,
2645
                       selected=self.op.output_fields)
2646

    
2647
  def CheckPrereq(self):
2648
    """No prerequisites.
2649

2650
    """
2651
    pass
2652

    
2653
  def Exec(self, feedback_fn):
2654
    """Dump a representation of the cluster config to the standard output.
2655

2656
    """
2657
    values = []
2658
    for field in self.op.output_fields:
2659
      if field == "cluster_name":
2660
        entry = self.cfg.GetClusterName()
2661
      elif field == "master_node":
2662
        entry = self.cfg.GetMasterNode()
2663
      elif field == "drain_flag":
2664
        entry = os.path.exists(constants.JOB_QUEUE_DRAIN_FILE)
2665
      else:
2666
        raise errors.ParameterError(field)
2667
      values.append(entry)
2668
    return values
2669

    
2670

    
2671
class LUActivateInstanceDisks(NoHooksLU):
2672
  """Bring up an instance's disks.
2673

2674
  """
2675
  _OP_REQP = ["instance_name"]
2676
  REQ_BGL = False
2677

    
2678
  def ExpandNames(self):
2679
    self._ExpandAndLockInstance()
2680
    self.needed_locks[locking.LEVEL_NODE] = []
2681
    self.recalculate_locks[locking.LEVEL_NODE] = constants.LOCKS_REPLACE
2682

    
2683
  def DeclareLocks(self, level):
2684
    if level == locking.LEVEL_NODE:
2685
      self._LockInstancesNodes()
2686

    
2687
  def CheckPrereq(self):
2688
    """Check prerequisites.
2689

2690
    This checks that the instance is in the cluster.
2691

2692
    """
2693
    self.instance = self.cfg.GetInstanceInfo(self.op.instance_name)
2694
    assert self.instance is not None, \
2695
      "Cannot retrieve locked instance %s" % self.op.instance_name
2696
    _CheckNodeOnline(self, self.instance.primary_node)
2697
    if not hasattr(self.op, "ignore_size"):
2698
      self.op.ignore_size = False
2699

    
2700
  def Exec(self, feedback_fn):
2701
    """Activate the disks.
2702

2703
    """
2704
    disks_ok, disks_info = \
2705
              _AssembleInstanceDisks(self, self.instance,
2706
                                     ignore_size=self.op.ignore_size)
2707
    if not disks_ok:
2708
      raise errors.OpExecError("Cannot activate block devices")
2709

    
2710
    return disks_info
2711

    
2712

    
2713
def _AssembleInstanceDisks(lu, instance, ignore_secondaries=False,
2714
                           ignore_size=False):
2715
  """Prepare the block devices for an instance.
2716

2717
  This sets up the block devices on all nodes.
2718

2719
  @type lu: L{LogicalUnit}
2720
  @param lu: the logical unit on whose behalf we execute
2721
  @type instance: L{objects.Instance}
2722
  @param instance: the instance for whose disks we assemble
2723
  @type ignore_secondaries: boolean
2724
  @param ignore_secondaries: if true, errors on secondary nodes
2725
      won't result in an error return from the function
2726
  @type ignore_size: boolean
2727
  @param ignore_size: if true, the current known size of the disk
2728
      will not be used during the disk activation, useful for cases
2729
      when the size is wrong
2730
  @return: False if the operation failed, otherwise a list of
2731
      (host, instance_visible_name, node_visible_name)
2732
      with the mapping from node devices to instance devices
2733

2734
  """
2735
  device_info = []
2736
  disks_ok = True
2737
  iname = instance.name
2738
  # With the two passes mechanism we try to reduce the window of
2739
  # opportunity for the race condition of switching DRBD to primary
2740
  # before handshaking occured, but we do not eliminate it
2741

    
2742
  # The proper fix would be to wait (with some limits) until the
2743
  # connection has been made and drbd transitions from WFConnection
2744
  # into any other network-connected state (Connected, SyncTarget,
2745
  # SyncSource, etc.)
2746

    
2747
  # 1st pass, assemble on all nodes in secondary mode
2748
  for inst_disk in instance.disks:
2749
    for node, node_disk in inst_disk.ComputeNodeTree(instance.primary_node):
2750
      if ignore_size:
2751
        node_disk = node_disk.Copy()
2752
        node_disk.UnsetSize()
2753
      lu.cfg.SetDiskID(node_disk, node)
2754
      result = lu.rpc.call_blockdev_assemble(node, node_disk, iname, False)
2755
      msg = result.RemoteFailMsg()
2756
      if msg:
2757
        lu.proc.LogWarning("Could not prepare block device %s on node %s"
2758
                           " (is_primary=False, pass=1): %s",
2759
                           inst_disk.iv_name, node, msg)
2760
        if not ignore_secondaries:
2761
          disks_ok = False
2762

    
2763
  # FIXME: race condition on drbd migration to primary
2764

    
2765
  # 2nd pass, do only the primary node
2766
  for inst_disk in instance.disks:
2767
    for node, node_disk in inst_disk.ComputeNodeTree(instance.primary_node):
2768
      if node != instance.primary_node:
2769
        continue
2770
      if ignore_size:
2771
        node_disk = node_disk.Copy()
2772
        node_disk.UnsetSize()
2773
      lu.cfg.SetDiskID(node_disk, node)
2774
      result = lu.rpc.call_blockdev_assemble(node, node_disk, iname, True)
2775
      msg = result.RemoteFailMsg()
2776
      if msg:
2777
        lu.proc.LogWarning("Could not prepare block device %s on node %s"
2778
                           " (is_primary=True, pass=2): %s",
2779
                           inst_disk.iv_name, node, msg)
2780
        disks_ok = False
2781
    device_info.append((instance.primary_node, inst_disk.iv_name,
2782
                        result.payload))
2783

    
2784
  # leave the disks configured for the primary node
2785
  # this is a workaround that would be fixed better by
2786
  # improving the logical/physical id handling
2787
  for disk in instance.disks:
2788
    lu.cfg.SetDiskID(disk, instance.primary_node)
2789

    
2790
  return disks_ok, device_info
2791

    
2792

    
2793
def _StartInstanceDisks(lu, instance, force):
2794
  """Start the disks of an instance.
2795

2796
  """
2797
  disks_ok, _ = _AssembleInstanceDisks(lu, instance,
2798
                                           ignore_secondaries=force)
2799
  if not disks_ok:
2800
    _ShutdownInstanceDisks(lu, instance)
2801
    if force is not None and not force:
2802
      lu.proc.LogWarning("", hint="If the message above refers to a"
2803
                         " secondary node,"
2804
                         " you can retry the operation using '--force'.")
2805
    raise errors.OpExecError("Disk consistency error")
2806

    
2807

    
2808
class LUDeactivateInstanceDisks(NoHooksLU):
2809
  """Shutdown an instance's disks.
2810

2811
  """
2812
  _OP_REQP = ["instance_name"]
2813
  REQ_BGL = False
2814

    
2815
  def ExpandNames(self):
2816
    self._ExpandAndLockInstance()
2817
    self.needed_locks[locking.LEVEL_NODE] = []
2818
    self.recalculate_locks[locking.LEVEL_NODE] = constants.LOCKS_REPLACE
2819

    
2820
  def DeclareLocks(self, level):
2821
    if level == locking.LEVEL_NODE:
2822
      self._LockInstancesNodes()
2823

    
2824
  def CheckPrereq(self):
2825
    """Check prerequisites.
2826

2827
    This checks that the instance is in the cluster.
2828

2829
    """
2830
    self.instance = self.cfg.GetInstanceInfo(self.op.instance_name)
2831
    assert self.instance is not None, \
2832
      "Cannot retrieve locked instance %s" % self.op.instance_name
2833

    
2834
  def Exec(self, feedback_fn):
2835
    """Deactivate the disks
2836

2837
    """
2838
    instance = self.instance
2839
    _SafeShutdownInstanceDisks(self, instance)
2840

    
2841

    
2842
def _SafeShutdownInstanceDisks(lu, instance):
2843
  """Shutdown block devices of an instance.
2844

2845
  This function checks if an instance is running, before calling
2846
  _ShutdownInstanceDisks.
2847

2848
  """
2849
  ins_l = lu.rpc.call_instance_list([instance.primary_node],
2850
                                      [instance.hypervisor])
2851
  ins_l = ins_l[instance.primary_node]
2852
  if ins_l.failed or not isinstance(ins_l.data, list):
2853
    raise errors.OpExecError("Can't contact node '%s'" %
2854
                             instance.primary_node)
2855

    
2856
  if instance.name in ins_l.data:
2857
    raise errors.OpExecError("Instance is running, can't shutdown"
2858
                             " block devices.")
2859

    
2860
  _ShutdownInstanceDisks(lu, instance)
2861

    
2862

    
2863
def _ShutdownInstanceDisks(lu, instance, ignore_primary=False):
2864
  """Shutdown block devices of an instance.
2865

2866
  This does the shutdown on all nodes of the instance.
2867

2868
  If the ignore_primary is false, errors on the primary node are
2869
  ignored.
2870

2871
  """
2872
  all_result = True
2873
  for disk in instance.disks:
2874
    for node, top_disk in disk.ComputeNodeTree(instance.primary_node):
2875
      lu.cfg.SetDiskID(top_disk, node)
2876
      result = lu.rpc.call_blockdev_shutdown(node, top_disk)
2877
      msg = result.RemoteFailMsg()
2878
      if msg:
2879
        lu.LogWarning("Could not shutdown block device %s on node %s: %s",
2880
                      disk.iv_name, node, msg)
2881
        if not ignore_primary or node != instance.primary_node:
2882
          all_result = False
2883
  return all_result
2884

    
2885

    
2886
def _CheckNodeFreeMemory(lu, node, reason, requested, hypervisor_name):
2887
  """Checks if a node has enough free memory.
2888

2889
  This function check if a given node has the needed amount of free
2890
  memory. In case the node has less memory or we cannot get the
2891
  information from the node, this function raise an OpPrereqError
2892
  exception.
2893

2894
  @type lu: C{LogicalUnit}
2895
  @param lu: a logical unit from which we get configuration data
2896
  @type node: C{str}
2897
  @param node: the node to check
2898
  @type reason: C{str}
2899
  @param reason: string to use in the error message
2900
  @type requested: C{int}
2901
  @param requested: the amount of memory in MiB to check for
2902
  @type hypervisor_name: C{str}
2903
  @param hypervisor_name: the hypervisor to ask for memory stats
2904
  @raise errors.OpPrereqError: if the node doesn't have enough memory, or
2905
      we cannot check the node
2906

2907
  """
2908
  nodeinfo = lu.rpc.call_node_info([node], lu.cfg.GetVGName(), hypervisor_name)
2909
  nodeinfo[node].Raise()
2910
  free_mem = nodeinfo[node].data.get('memory_free')
2911
  if not isinstance(free_mem, int):
2912
    raise errors.OpPrereqError("Can't compute free memory on node %s, result"
2913
                             " was '%s'" % (node, free_mem))
2914
  if requested > free_mem:
2915
    raise errors.OpPrereqError("Not enough memory on node %s for %s:"
2916
                             " needed %s MiB, available %s MiB" %
2917
                             (node, reason, requested, free_mem))
2918

    
2919

    
2920
class LUStartupInstance(LogicalUnit):
2921
  """Starts an instance.
2922

2923
  """
2924
  HPATH = "instance-start"
2925
  HTYPE = constants.HTYPE_INSTANCE
2926
  _OP_REQP = ["instance_name", "force"]
2927
  REQ_BGL = False
2928

    
2929
  def ExpandNames(self):
2930
    self._ExpandAndLockInstance()
2931

    
2932
  def BuildHooksEnv(self):
2933
    """Build hooks env.
2934

2935
    This runs on master, primary and secondary nodes of the instance.
2936

2937
    """
2938
    env = {
2939
      "FORCE": self.op.force,
2940
      }
2941
    env.update(_BuildInstanceHookEnvByObject(self, self.instance))
2942
    nl = [self.cfg.GetMasterNode()] + list(self.instance.all_nodes)
2943
    return env, nl, nl
2944

    
2945
  def CheckPrereq(self):
2946
    """Check prerequisites.
2947

2948
    This checks that the instance is in the cluster.
2949

2950
    """
2951
    self.instance = instance = self.cfg.GetInstanceInfo(self.op.instance_name)
2952
    assert self.instance is not None, \
2953
      "Cannot retrieve locked instance %s" % self.op.instance_name
2954

    
2955
    # extra beparams
2956
    self.beparams = getattr(self.op, "beparams", {})
2957
    if self.beparams:
2958
      if not isinstance(self.beparams, dict):
2959
        raise errors.OpPrereqError("Invalid beparams passed: %s, expected"
2960
                                   " dict" % (type(self.beparams), ))
2961
      # fill the beparams dict
2962
      utils.ForceDictType(self.beparams, constants.BES_PARAMETER_TYPES)
2963
      self.op.beparams = self.beparams
2964

    
2965
    # extra hvparams
2966
    self.hvparams = getattr(self.op, "hvparams", {})
2967
    if self.hvparams:
2968
      if not isinstance(self.hvparams, dict):
2969
        raise errors.OpPrereqError("Invalid hvparams passed: %s, expected"
2970
                                   " dict" % (type(self.hvparams), ))
2971

    
2972
      # check hypervisor parameter syntax (locally)
2973
      cluster = self.cfg.GetClusterInfo()
2974
      utils.ForceDictType(self.hvparams, constants.HVS_PARAMETER_TYPES)
2975
      filled_hvp = cluster.FillDict(cluster.hvparams[instance.hypervisor],
2976
                                    instance.hvparams)
2977
      filled_hvp.update(self.hvparams)
2978
      hv_type = hypervisor.GetHypervisor(instance.hypervisor)
2979
      hv_type.CheckParameterSyntax(filled_hvp)
2980
      _CheckHVParams(self, instance.all_nodes, instance.hypervisor, filled_hvp)
2981
      self.op.hvparams = self.hvparams
2982

    
2983
    _CheckNodeOnline(self, instance.primary_node)
2984

    
2985
    bep = self.cfg.GetClusterInfo().FillBE(instance)
2986
    # check bridges existence
2987
    _CheckInstanceBridgesExist(self, instance)
2988

    
2989
    remote_info = self.rpc.call_instance_info(instance.primary_node,
2990
                                              instance.name,
2991
                                              instance.hypervisor)
2992
    remote_info.Raise()
2993
    if not remote_info.data:
2994
      _CheckNodeFreeMemory(self, instance.primary_node,
2995
                           "starting instance %s" % instance.name,
2996
                           bep[constants.BE_MEMORY], instance.hypervisor)
2997

    
2998
  def Exec(self, feedback_fn):
2999
    """Start the instance.
3000

3001
    """
3002
    instance = self.instance
3003
    force = self.op.force
3004

    
3005
    self.cfg.MarkInstanceUp(instance.name)
3006

    
3007
    node_current = instance.primary_node
3008

    
3009
    _StartInstanceDisks(self, instance, force)
3010

    
3011
    result = self.rpc.call_instance_start(node_current, instance,
3012
                                          self.hvparams, self.beparams)
3013
    msg = result.RemoteFailMsg()
3014
    if msg:
3015
      _ShutdownInstanceDisks(self, instance)
3016
      raise errors.OpExecError("Could not start instance: %s" % msg)
3017

    
3018

    
3019
class LURebootInstance(LogicalUnit):
3020
  """Reboot an instance.
3021

3022
  """
3023
  HPATH = "instance-reboot"
3024
  HTYPE = constants.HTYPE_INSTANCE
3025
  _OP_REQP = ["instance_name", "ignore_secondaries", "reboot_type"]
3026
  REQ_BGL = False
3027

    
3028
  def ExpandNames(self):
3029
    if self.op.reboot_type not in [constants.INSTANCE_REBOOT_SOFT,
3030
                                   constants.INSTANCE_REBOOT_HARD,
3031
                                   constants.INSTANCE_REBOOT_FULL]:
3032
      raise errors.ParameterError("reboot type not in [%s, %s, %s]" %
3033
                                  (constants.INSTANCE_REBOOT_SOFT,
3034
                                   constants.INSTANCE_REBOOT_HARD,
3035
                                   constants.INSTANCE_REBOOT_FULL))
3036
    self._ExpandAndLockInstance()
3037

    
3038
  def BuildHooksEnv(self):
3039
    """Build hooks env.
3040

3041
    This runs on master, primary and secondary nodes of the instance.
3042

3043
    """
3044
    env = {
3045
      "IGNORE_SECONDARIES": self.op.ignore_secondaries,
3046
      "REBOOT_TYPE": self.op.reboot_type,
3047
      }
3048
    env.update(_BuildInstanceHookEnvByObject(self, self.instance))
3049
    nl = [self.cfg.GetMasterNode()] + list(self.instance.all_nodes)
3050
    return env, nl, nl
3051

    
3052
  def CheckPrereq(self):
3053
    """Check prerequisites.
3054

3055
    This checks that the instance is in the cluster.
3056

3057
    """
3058
    self.instance = instance = self.cfg.GetInstanceInfo(self.op.instance_name)
3059
    assert self.instance is not None, \
3060
      "Cannot retrieve locked instance %s" % self.op.instance_name
3061

    
3062
    _CheckNodeOnline(self, instance.primary_node)
3063

    
3064
    # check bridges existence
3065
    _CheckInstanceBridgesExist(self, instance)
3066

    
3067
  def Exec(self, feedback_fn):
3068
    """Reboot the instance.
3069

3070
    """
3071
    instance = self.instance
3072
    ignore_secondaries = self.op.ignore_secondaries
3073
    reboot_type = self.op.reboot_type
3074

    
3075
    node_current = instance.primary_node
3076

    
3077
    if reboot_type in [constants.INSTANCE_REBOOT_SOFT,
3078
                       constants.INSTANCE_REBOOT_HARD]:
3079
      for disk in instance.disks:
3080
        self.cfg.SetDiskID(disk, node_current)
3081
      result = self.rpc.call_instance_reboot(node_current, instance,
3082
                                             reboot_type)
3083
      msg = result.RemoteFailMsg()
3084
      if msg:
3085
        raise errors.OpExecError("Could not reboot instance: %s" % msg)
3086
    else:
3087
      result = self.rpc.call_instance_shutdown(node_current, instance)
3088
      msg = result.RemoteFailMsg()
3089
      if msg:
3090
        raise errors.OpExecError("Could not shutdown instance for"
3091
                                 " full reboot: %s" % msg)
3092
      _ShutdownInstanceDisks(self, instance)
3093
      _StartInstanceDisks(self, instance, ignore_secondaries)
3094
      result = self.rpc.call_instance_start(node_current, instance, None, None)
3095
      msg = result.RemoteFailMsg()
3096
      if msg:
3097
        _ShutdownInstanceDisks(self, instance)
3098
        raise errors.OpExecError("Could not start instance for"
3099
                                 " full reboot: %s" % msg)
3100

    
3101
    self.cfg.MarkInstanceUp(instance.name)
3102

    
3103

    
3104
class LUShutdownInstance(LogicalUnit):
3105
  """Shutdown an instance.
3106

3107
  """
3108
  HPATH = "instance-stop"
3109
  HTYPE = constants.HTYPE_INSTANCE
3110
  _OP_REQP = ["instance_name"]
3111
  REQ_BGL = False
3112

    
3113
  def ExpandNames(self):
3114
    self._ExpandAndLockInstance()
3115

    
3116
  def BuildHooksEnv(self):
3117
    """Build hooks env.
3118

3119
    This runs on master, primary and secondary nodes of the instance.
3120

3121
    """
3122
    env = _BuildInstanceHookEnvByObject(self, self.instance)
3123
    nl = [self.cfg.GetMasterNode()] + list(self.instance.all_nodes)
3124
    return env, nl, nl
3125

    
3126
  def CheckPrereq(self):
3127
    """Check prerequisites.
3128

3129
    This checks that the instance is in the cluster.
3130

3131
    """
3132
    self.instance = self.cfg.GetInstanceInfo(self.op.instance_name)
3133
    assert self.instance is not None, \
3134
      "Cannot retrieve locked instance %s" % self.op.instance_name
3135
    _CheckNodeOnline(self, self.instance.primary_node)
3136

    
3137
  def Exec(self, feedback_fn):
3138
    """Shutdown the instance.
3139

3140
    """
3141
    instance = self.instance
3142
    node_current = instance.primary_node
3143
    self.cfg.MarkInstanceDown(instance.name)
3144
    result = self.rpc.call_instance_shutdown(node_current, instance)
3145
    msg = result.RemoteFailMsg()
3146
    if msg:
3147
      self.proc.LogWarning("Could not shutdown instance: %s" % msg)
3148

    
3149
    _ShutdownInstanceDisks(self, instance)
3150

    
3151

    
3152
class LUReinstallInstance(LogicalUnit):
3153
  """Reinstall an instance.
3154

3155
  """
3156
  HPATH = "instance-reinstall"
3157
  HTYPE = constants.HTYPE_INSTANCE
3158
  _OP_REQP = ["instance_name"]
3159
  REQ_BGL = False
3160

    
3161
  def ExpandNames(self):
3162
    self._ExpandAndLockInstance()
3163

    
3164
  def BuildHooksEnv(self):
3165
    """Build hooks env.
3166

3167
    This runs on master, primary and secondary nodes of the instance.
3168

3169
    """
3170
    env = _BuildInstanceHookEnvByObject(self, self.instance)
3171
    nl = [self.cfg.GetMasterNode()] + list(self.instance.all_nodes)
3172
    return env, nl, nl
3173

    
3174
  def CheckPrereq(self):
3175
    """Check prerequisites.
3176

3177
    This checks that the instance is in the cluster and is not running.
3178

3179
    """
3180
    instance = self.cfg.GetInstanceInfo(self.op.instance_name)
3181
    assert instance is not None, \
3182
      "Cannot retrieve locked instance %s" % self.op.instance_name
3183
    _CheckNodeOnline(self, instance.primary_node)
3184

    
3185
    if instance.disk_template == constants.DT_DISKLESS:
3186
      raise errors.OpPrereqError("Instance '%s' has no disks" %
3187
                                 self.op.instance_name)
3188
    if instance.admin_up:
3189
      raise errors.OpPrereqError("Instance '%s' is marked to be up" %
3190
                                 self.op.instance_name)
3191
    remote_info = self.rpc.call_instance_info(instance.primary_node,
3192
                                              instance.name,
3193
                                              instance.hypervisor)
3194
    remote_info.Raise()
3195
    if remote_info.data:
3196
      raise errors.OpPrereqError("Instance '%s' is running on the node %s" %
3197
                                 (self.op.instance_name,
3198
                                  instance.primary_node))
3199

    
3200
    self.op.os_type = getattr(self.op, "os_type", None)
3201
    if self.op.os_type is not None:
3202
      # OS verification
3203
      pnode = self.cfg.GetNodeInfo(
3204
        self.cfg.ExpandNodeName(instance.primary_node))
3205
      if pnode is None:
3206
        raise errors.OpPrereqError("Primary node '%s' is unknown" %
3207
                                   self.op.pnode)
3208
      result = self.rpc.call_os_get(pnode.name, self.op.os_type)
3209
      result.Raise()
3210
      if not isinstance(result.data, objects.OS):
3211
        raise errors.OpPrereqError("OS '%s' not in supported OS list for"
3212
                                   " primary node"  % self.op.os_type)
3213

    
3214
    self.instance = instance
3215

    
3216
  def Exec(self, feedback_fn):
3217
    """Reinstall the instance.
3218

3219
    """
3220
    inst = self.instance
3221

    
3222
    if self.op.os_type is not None:
3223
      feedback_fn("Changing OS to '%s'..." % self.op.os_type)
3224
      inst.os = self.op.os_type
3225
      self.cfg.Update(inst)
3226

    
3227
    _StartInstanceDisks(self, inst, None)
3228
    try:
3229
      feedback_fn("Running the instance OS create scripts...")
3230
      result = self.rpc.call_instance_os_add(inst.primary_node, inst)
3231
      msg = result.RemoteFailMsg()
3232
      if msg:
3233
        raise errors.OpExecError("Could not install OS for instance %s"
3234
                                 " on node %s: %s" %
3235
                                 (inst.name, inst.primary_node, msg))
3236
    finally:
3237
      _ShutdownInstanceDisks(self, inst)
3238

    
3239

    
3240
class LURenameInstance(LogicalUnit):
3241
  """Rename an instance.
3242

3243
  """
3244
  HPATH = "instance-rename"
3245
  HTYPE = constants.HTYPE_INSTANCE
3246
  _OP_REQP = ["instance_name", "new_name"]
3247

    
3248
  def BuildHooksEnv(self):
3249
    """Build hooks env.
3250

3251
    This runs on master, primary and secondary nodes of the instance.
3252

3253
    """
3254
    env = _BuildInstanceHookEnvByObject(self, self.instance)
3255
    env["INSTANCE_NEW_NAME"] = self.op.new_name
3256
    nl = [self.cfg.GetMasterNode()] + list(self.instance.all_nodes)
3257
    return env, nl, nl
3258

    
3259
  def CheckPrereq(self):
3260
    """Check prerequisites.
3261

3262
    This checks that the instance is in the cluster and is not running.
3263

3264
    """
3265
    instance = self.cfg.GetInstanceInfo(
3266
      self.cfg.ExpandInstanceName(self.op.instance_name))
3267
    if instance is None:
3268
      raise errors.OpPrereqError("Instance '%s' not known" %
3269
                                 self.op.instance_name)
3270
    _CheckNodeOnline(self, instance.primary_node)
3271

    
3272
    if instance.admin_up:
3273
      raise errors.OpPrereqError("Instance '%s' is marked to be up" %
3274
                                 self.op.instance_name)
3275
    remote_info = self.rpc.call_instance_info(instance.primary_node,
3276
                                              instance.name,
3277
                                              instance.hypervisor)
3278
    remote_info.Raise()
3279
    if remote_info.data:
3280
      raise errors.OpPrereqError("Instance '%s' is running on the node %s" %
3281
                                 (self.op.instance_name,
3282
                                  instance.primary_node))
3283
    self.instance = instance
3284

    
3285
    # new name verification
3286
    name_info = utils.HostInfo(self.op.new_name)
3287

    
3288
    self.op.new_name = new_name = name_info.name
3289
    instance_list = self.cfg.GetInstanceList()
3290
    if new_name in instance_list:
3291
      raise errors.OpPrereqError("Instance '%s' is already in the cluster" %
3292
                                 new_name)
3293

    
3294
    if not getattr(self.op, "ignore_ip", False):
3295
      if utils.TcpPing(name_info.ip, constants.DEFAULT_NODED_PORT):
3296
        raise errors.OpPrereqError("IP %s of instance %s already in use" %
3297
                                   (name_info.ip, new_name))
3298

    
3299

    
3300
  def Exec(self, feedback_fn):
3301
    """Reinstall the instance.
3302

3303
    """
3304
    inst = self.instance
3305
    old_name = inst.name
3306

    
3307
    if inst.disk_template == constants.DT_FILE:
3308
      old_file_storage_dir = os.path.dirname(inst.disks[0].logical_id[1])
3309

    
3310
    self.cfg.RenameInstance(inst.name, self.op.new_name)
3311
    # Change the instance lock. This is definitely safe while we hold the BGL
3312
    self.context.glm.remove(locking.LEVEL_INSTANCE, old_name)
3313
    self.context.glm.add(locking.LEVEL_INSTANCE, self.op.new_name)
3314

    
3315
    # re-read the instance from the configuration after rename
3316
    inst = self.cfg.GetInstanceInfo(self.op.new_name)
3317

    
3318
    if inst.disk_template == constants.DT_FILE:
3319
      new_file_storage_dir = os.path.dirname(inst.disks[0].logical_id[1])
3320
      result = self.rpc.call_file_storage_dir_rename(inst.primary_node,
3321
                                                     old_file_storage_dir,
3322
                                                     new_file_storage_dir)
3323
      result.Raise()
3324
      if not result.data:
3325
        raise errors.OpExecError("Could not connect to node '%s' to rename"
3326
                                 " directory '%s' to '%s' (but the instance"
3327
                                 " has been renamed in Ganeti)" % (
3328
                                 inst.primary_node, old_file_storage_dir,
3329
                                 new_file_storage_dir))
3330

    
3331
      if not result.data[0]:
3332
        raise errors.OpExecError("Could not rename directory '%s' to '%s'"
3333
                                 " (but the instance has been renamed in"
3334
                                 " Ganeti)" % (old_file_storage_dir,
3335
                                               new_file_storage_dir))
3336

    
3337
    _StartInstanceDisks(self, inst, None)
3338
    try:
3339
      result = self.rpc.call_instance_run_rename(inst.primary_node, inst,
3340
                                                 old_name)
3341
      msg = result.RemoteFailMsg()
3342
      if msg:
3343
        msg = ("Could not run OS rename script for instance %s on node %s"
3344
               " (but the instance has been renamed in Ganeti): %s" %
3345
               (inst.name, inst.primary_node, msg))
3346
        self.proc.LogWarning(msg)
3347
    finally:
3348
      _ShutdownInstanceDisks(self, inst)
3349

    
3350

    
3351
class LURemoveInstance(LogicalUnit):
3352
  """Remove an instance.
3353

3354
  """
3355
  HPATH = "instance-remove"
3356
  HTYPE = constants.HTYPE_INSTANCE
3357
  _OP_REQP = ["instance_name", "ignore_failures"]
3358
  REQ_BGL = False
3359

    
3360
  def ExpandNames(self):
3361
    self._ExpandAndLockInstance()
3362
    self.needed_locks[locking.LEVEL_NODE] = []
3363
    self.recalculate_locks[locking.LEVEL_NODE] = constants.LOCKS_REPLACE
3364

    
3365
  def DeclareLocks(self, level):
3366
    if level == locking.LEVEL_NODE:
3367
      self._LockInstancesNodes()
3368

    
3369
  def BuildHooksEnv(self):
3370
    """Build hooks env.
3371

3372
    This runs on master, primary and secondary nodes of the instance.
3373

3374
    """
3375
    env = _BuildInstanceHookEnvByObject(self, self.instance)
3376
    nl = [self.cfg.GetMasterNode()]
3377
    return env, nl, nl
3378

    
3379
  def CheckPrereq(self):
3380
    """Check prerequisites.
3381

3382
    This checks that the instance is in the cluster.
3383

3384
    """
3385
    self.instance = self.cfg.GetInstanceInfo(self.op.instance_name)
3386
    assert self.instance is not None, \
3387
      "Cannot retrieve locked instance %s" % self.op.instance_name
3388

    
3389
  def Exec(self, feedback_fn):
3390
    """Remove the instance.
3391

3392
    """
3393
    instance = self.instance
3394
    logging.info("Shutting down instance %s on node %s",
3395
                 instance.name, instance.primary_node)
3396

    
3397
    result = self.rpc.call_instance_shutdown(instance.primary_node, instance)
3398
    msg = result.RemoteFailMsg()
3399
    if msg:
3400
      if self.op.ignore_failures:
3401
        feedback_fn("Warning: can't shutdown instance: %s" % msg)
3402
      else:
3403
        raise errors.OpExecError("Could not shutdown instance %s on"
3404
                                 " node %s: %s" %
3405
                                 (instance.name, instance.primary_node, msg))
3406

    
3407
    logging.info("Removing block devices for instance %s", instance.name)
3408

    
3409
    if not _RemoveDisks(self, instance):
3410
      if self.op.ignore_failures:
3411
        feedback_fn("Warning: can't remove instance's disks")
3412
      else:
3413
        raise errors.OpExecError("Can't remove instance's disks")
3414

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

    
3417
    self.cfg.RemoveInstance(instance.name)
3418
    self.remove_locks[locking.LEVEL_INSTANCE] = instance.name
3419

    
3420

    
3421
class LUQueryInstances(NoHooksLU):
3422
  """Logical unit for querying instances.
3423

3424
  """
3425
  _OP_REQP = ["output_fields", "names", "use_locking"]
3426
  REQ_BGL = False
3427
  _FIELDS_STATIC = utils.FieldSet(*["name", "os", "pnode", "snodes",
3428
                                    "admin_state",
3429
                                    "disk_template", "ip", "mac", "bridge",
3430
                                    "sda_size", "sdb_size", "vcpus", "tags",
3431
                                    "network_port", "beparams",
3432
                                    r"(disk)\.(size)/([0-9]+)",
3433
                                    r"(disk)\.(sizes)", "disk_usage",
3434
                                    r"(nic)\.(mac|ip|bridge)/([0-9]+)",
3435
                                    r"(nic)\.(macs|ips|bridges)",
3436
                                    r"(disk|nic)\.(count)",
3437
                                    "serial_no", "hypervisor", "hvparams",] +
3438
                                  ["hv/%s" % name
3439
                                   for name in constants.HVS_PARAMETERS] +
3440
                                  ["be/%s" % name
3441
                                   for name in constants.BES_PARAMETERS])
3442
  _FIELDS_DYNAMIC = utils.FieldSet("oper_state", "oper_ram", "status")
3443

    
3444

    
3445
  def ExpandNames(self):
3446
    _CheckOutputFields(static=self._FIELDS_STATIC,
3447
                       dynamic=self._FIELDS_DYNAMIC,
3448
                       selected=self.op.output_fields)
3449

    
3450
    self.needed_locks = {}
3451
    self.share_locks[locking.LEVEL_INSTANCE] = 1
3452
    self.share_locks[locking.LEVEL_NODE] = 1
3453

    
3454
    if self.op.names:
3455
      self.wanted = _GetWantedInstances(self, self.op.names)
3456
    else:
3457
      self.wanted = locking.ALL_SET
3458

    
3459
    self.do_node_query = self._FIELDS_STATIC.NonMatching(self.op.output_fields)
3460
    self.do_locking = self.do_node_query and self.op.use_locking
3461
    if self.do_locking:
3462
      self.needed_locks[locking.LEVEL_INSTANCE] = self.wanted
3463
      self.needed_locks[locking.LEVEL_NODE] = []
3464
      self.recalculate_locks[locking.LEVEL_NODE] = constants.LOCKS_REPLACE
3465

    
3466
  def DeclareLocks(self, level):
3467
    if level == locking.LEVEL_NODE and self.do_locking:
3468
      self._LockInstancesNodes()
3469

    
3470
  def CheckPrereq(self):
3471
    """Check prerequisites.
3472

3473
    """
3474
    pass
3475

    
3476
  def Exec(self, feedback_fn):
3477
    """Computes the list of nodes and their attributes.
3478

3479
    """
3480
    all_info = self.cfg.GetAllInstancesInfo()
3481
    if self.wanted == locking.ALL_SET:
3482
      # caller didn't specify instance names, so ordering is not important
3483
      if self.do_locking:
3484
        instance_names = self.acquired_locks[locking.LEVEL_INSTANCE]
3485
      else:
3486
        instance_names = all_info.keys()
3487
      instance_names = utils.NiceSort(instance_names)
3488
    else:
3489
      # caller did specify names, so we must keep the ordering
3490
      if self.do_locking:
3491
        tgt_set = self.acquired_locks[locking.LEVEL_INSTANCE]
3492
      else:
3493
        tgt_set = all_info.keys()
3494
      missing = set(self.wanted).difference(tgt_set)
3495
      if missing:
3496
        raise errors.OpExecError("Some instances were removed before"
3497
                                 " retrieving their data: %s" % missing)
3498
      instance_names = self.wanted
3499

    
3500
    instance_list = [all_info[iname] for iname in instance_names]
3501

    
3502
    # begin data gathering
3503

    
3504
    nodes = frozenset([inst.primary_node for inst in instance_list])
3505
    hv_list = list(set([inst.hypervisor for inst in instance_list]))
3506

    
3507
    bad_nodes = []
3508
    off_nodes = []
3509
    if self.do_node_query:
3510
      live_data = {}
3511
      node_data = self.rpc.call_all_instances_info(nodes, hv_list)
3512
      for name in nodes:
3513
        result = node_data[name]
3514
        if result.offline:
3515
          # offline nodes will be in both lists
3516
          off_nodes.append(name)
3517
        if result.failed:
3518
          bad_nodes.append(name)
3519
        else:
3520
          if result.data:
3521
            live_data.update(result.data)
3522
            # else no instance is alive
3523
    else:
3524
      live_data = dict([(name, {}) for name in instance_names])
3525

    
3526
    # end data gathering
3527

    
3528
    HVPREFIX = "hv/"
3529
    BEPREFIX = "be/"
3530
    output = []
3531
    for instance in instance_list:
3532
      iout = []
3533
      i_hv = self.cfg.GetClusterInfo().FillHV(instance)
3534
      i_be = self.cfg.GetClusterInfo().FillBE(instance)
3535
      for field in self.op.output_fields:
3536
        st_match = self._FIELDS_STATIC.Matches(field)
3537
        if field == "name":
3538
          val = instance.name
3539
        elif field == "os":
3540
          val = instance.os
3541
        elif field == "pnode":
3542
          val = instance.primary_node
3543
        elif field == "snodes":
3544
          val = list(instance.secondary_nodes)
3545
        elif field == "admin_state":
3546
          val = instance.admin_up
3547
        elif field == "oper_state":
3548
          if instance.primary_node in bad_nodes:
3549
            val = None
3550
          else:
3551
            val = bool(live_data.get(instance.name))
3552
        elif field == "status":
3553
          if instance.primary_node in off_nodes:
3554
            val = "ERROR_nodeoffline"
3555
          elif instance.primary_node in bad_nodes:
3556
            val = "ERROR_nodedown"
3557
          else:
3558
            running = bool(live_data.get(instance.name))
3559
            if running:
3560
              if instance.admin_up:
3561
                val = "running"
3562
              else:
3563
                val = "ERROR_up"
3564
            else:
3565
              if instance.admin_up:
3566
                val = "ERROR_down"
3567
              else:
3568
                val = "ADMIN_down"
3569
        elif field == "oper_ram":
3570
          if instance.primary_node in bad_nodes:
3571
            val = None
3572
          elif instance.name in live_data:
3573
            val = live_data[instance.name].get("memory", "?")
3574
          else:
3575
            val = "-"
3576
        elif field == "vcpus":
3577
          val = i_be[constants.BE_VCPUS]
3578
        elif field == "disk_template":
3579
          val = instance.disk_template
3580
        elif field == "ip":
3581
          if instance.nics:
3582
            val = instance.nics[0].ip
3583
          else:
3584
            val = None
3585
        elif field == "bridge":
3586
          if instance.nics:
3587
            val = instance.nics[0].bridge
3588
          else:
3589
            val = None
3590
        elif field == "mac":
3591
          if instance.nics:
3592
            val = instance.nics[0].mac
3593
          else:
3594
            val = None
3595
        elif field == "sda_size" or field == "sdb_size":
3596
          idx = ord(field[2]) - ord('a')
3597
          try:
3598
            val = instance.FindDisk(idx).size
3599
          except errors.OpPrereqError:
3600
            val = None
3601
        elif field == "disk_usage": # total disk usage per node
3602
          disk_sizes = [{'size': disk.size} for disk in instance.disks]
3603
          val = _ComputeDiskSize(instance.disk_template, disk_sizes)
3604
        elif field == "tags":
3605
          val = list(instance.GetTags())
3606
        elif field == "serial_no":
3607
          val = instance.serial_no
3608
        elif field == "network_port":
3609
          val = instance.network_port
3610
        elif field == "hypervisor":
3611
          val = instance.hypervisor
3612
        elif field == "hvparams":
3613
          val = i_hv
3614
        elif (field.startswith(HVPREFIX) and
3615
              field[len(HVPREFIX):] in constants.HVS_PARAMETERS):
3616
          val = i_hv.get(field[len(HVPREFIX):], None)
3617
        elif field == "beparams":
3618
          val = i_be
3619
        elif (field.startswith(BEPREFIX) and
3620
              field[len(BEPREFIX):] in constants.BES_PARAMETERS):
3621
          val = i_be.get(field[len(BEPREFIX):], None)
3622
        elif st_match and st_match.groups():
3623
          # matches a variable list
3624
          st_groups = st_match.groups()
3625
          if st_groups and st_groups[0] == "disk":
3626
            if st_groups[1] == "count":
3627
              val = len(instance.disks)
3628
            elif st_groups[1] == "sizes":
3629
              val = [disk.size for disk in instance.disks]
3630
            elif st_groups[1] == "size":
3631
              try:
3632
                val = instance.FindDisk(st_groups[2]).size
3633
              except errors.OpPrereqError:
3634
                val = None
3635
            else:
3636
              assert False, "Unhandled disk parameter"
3637
          elif st_groups[0] == "nic":
3638
            if st_groups[1] == "count":
3639
              val = len(instance.nics)
3640
            elif st_groups[1] == "macs":
3641
              val = [nic.mac for nic in instance.nics]
3642
            elif st_groups[1] == "ips":
3643
              val = [nic.ip for nic in instance.nics]
3644
            elif st_groups[1] == "bridges":
3645
              val = [nic.bridge for nic in instance.nics]
3646
            else:
3647
              # index-based item
3648
              nic_idx = int(st_groups[2])
3649
              if nic_idx >= len(instance.nics):
3650
                val = None
3651
              else:
3652
                if st_groups[1] == "mac":
3653
                  val = instance.nics[nic_idx].mac
3654
                elif st_groups[1] == "ip":
3655
                  val = instance.nics[nic_idx].ip
3656
                elif st_groups[1] == "bridge":
3657
                  val = instance.nics[nic_idx].bridge
3658
                else:
3659
                  assert False, "Unhandled NIC parameter"
3660
          else:
3661
            assert False, ("Declared but unhandled variable parameter '%s'" %
3662
                           field)
3663
        else:
3664
          assert False, "Declared but unhandled parameter '%s'" % field
3665
        iout.append(val)
3666
      output.append(iout)
3667

    
3668
    return output
3669

    
3670

    
3671
class LUFailoverInstance(LogicalUnit):
3672
  """Failover an instance.
3673

3674
  """
3675
  HPATH = "instance-failover"
3676
  HTYPE = constants.HTYPE_INSTANCE
3677
  _OP_REQP = ["instance_name", "ignore_consistency"]
3678
  REQ_BGL = False
3679

    
3680
  def ExpandNames(self):
3681
    self._ExpandAndLockInstance()
3682
    self.needed_locks[locking.LEVEL_NODE] = []
3683
    self.recalculate_locks[locking.LEVEL_NODE] = constants.LOCKS_REPLACE
3684

    
3685
  def DeclareLocks(self, level):
3686
    if level == locking.LEVEL_NODE:
3687
      self._LockInstancesNodes()
3688

    
3689
  def BuildHooksEnv(self):
3690
    """Build hooks env.
3691

3692
    This runs on master, primary and secondary nodes of the instance.
3693

3694
    """
3695
    env = {
3696
      "IGNORE_CONSISTENCY": self.op.ignore_consistency,
3697
      }
3698
    env.update(_BuildInstanceHookEnvByObject(self, self.instance))
3699
    nl = [self.cfg.GetMasterNode()] + list(self.instance.secondary_nodes)
3700
    return env, nl, nl
3701

    
3702
  def CheckPrereq(self):
3703
    """Check prerequisites.
3704

3705
    This checks that the instance is in the cluster.
3706

3707
    """
3708
    self.instance = instance = self.cfg.GetInstanceInfo(self.op.instance_name)
3709
    assert self.instance is not None, \
3710
      "Cannot retrieve locked instance %s" % self.op.instance_name
3711

    
3712
    bep = self.cfg.GetClusterInfo().FillBE(instance)
3713
    if instance.disk_template not in constants.DTS_NET_MIRROR:
3714
      raise errors.OpPrereqError("Instance's disk layout is not"
3715
                                 " network mirrored, cannot failover.")
3716

    
3717
    secondary_nodes = instance.secondary_nodes
3718
    if not secondary_nodes:
3719
      raise errors.ProgrammerError("no secondary node but using "
3720
                                   "a mirrored disk template")
3721

    
3722
    target_node = secondary_nodes[0]
3723
    _CheckNodeOnline(self, target_node)
3724
    _CheckNodeNotDrained(self, target_node)
3725

    
3726
    if instance.admin_up:
3727
      # check memory requirements on the secondary node
3728
      _CheckNodeFreeMemory(self, target_node, "failing over instance %s" %
3729
                           instance.name, bep[constants.BE_MEMORY],
3730
                           instance.hypervisor)
3731
    else:
3732
      self.LogInfo("Not checking memory on the secondary node as"
3733
                   " instance will not be started")
3734

    
3735
    # check bridge existence
3736
    brlist = [nic.bridge for nic in instance.nics]
3737
    result = self.rpc.call_bridges_exist(target_node, brlist)
3738
    result.Raise()
3739
    if not result.data:
3740
      raise errors.OpPrereqError("One or more target bridges %s does not"
3741
                                 " exist on destination node '%s'" %
3742
                                 (brlist, target_node))
3743

    
3744
  def Exec(self, feedback_fn):
3745
    """Failover an instance.
3746

3747
    The failover is done by shutting it down on its present node and
3748
    starting it on the secondary.
3749

3750
    """
3751
    instance = self.instance
3752

    
3753
    source_node = instance.primary_node
3754
    target_node = instance.secondary_nodes[0]
3755

    
3756
    feedback_fn("* checking disk consistency between source and target")
3757
    for dev in instance.disks:
3758
      # for drbd, these are drbd over lvm
3759
      if not _CheckDiskConsistency(self, dev, target_node, False):
3760
        if instance.admin_up and not self.op.ignore_consistency:
3761
          raise errors.OpExecError("Disk %s is degraded on target node,"
3762
                                   " aborting failover." % dev.iv_name)
3763

    
3764
    feedback_fn("* shutting down instance on source node")
3765
    logging.info("Shutting down instance %s on node %s",
3766
                 instance.name, source_node)
3767

    
3768
    result = self.rpc.call_instance_shutdown(source_node, instance)
3769
    msg = result.RemoteFailMsg()
3770
    if msg:
3771
      if self.op.ignore_consistency:
3772
        self.proc.LogWarning("Could not shutdown instance %s on node %s."
3773
                             " Proceeding anyway. Please make sure node"
3774
                             " %s is down. Error details: %s",
3775
                             instance.name, source_node, source_node, msg)
3776
      else:
3777
        raise errors.OpExecError("Could not shutdown instance %s on"
3778
                                 " node %s: %s" %
3779
                                 (instance.name, source_node, msg))
3780

    
3781
    feedback_fn("* deactivating the instance's disks on source node")
3782
    if not _ShutdownInstanceDisks(self, instance, ignore_primary=True):
3783
      raise errors.OpExecError("Can't shut down the instance's disks.")
3784

    
3785
    instance.primary_node = target_node
3786
    # distribute new instance config to the other nodes
3787
    self.cfg.Update(instance)
3788

    
3789
    # Only start the instance if it's marked as up
3790
    if instance.admin_up:
3791
      feedback_fn("* activating the instance's disks on target node")
3792
      logging.info("Starting instance %s on node %s",
3793
                   instance.name, target_node)
3794

    
3795
      disks_ok, _ = _AssembleInstanceDisks(self, instance,
3796
                                               ignore_secondaries=True)
3797
      if not disks_ok:
3798
        _ShutdownInstanceDisks(self, instance)
3799
        raise errors.OpExecError("Can't activate the instance's disks")
3800

    
3801
      feedback_fn("* starting the instance on the target node")
3802
      result = self.rpc.call_instance_start(target_node, instance, None, None)
3803
      msg = result.RemoteFailMsg()
3804
      if msg:
3805
        _ShutdownInstanceDisks(self, instance)
3806
        raise errors.OpExecError("Could not start instance %s on node %s: %s" %
3807
                                 (instance.name, target_node, msg))
3808

    
3809

    
3810
class LUMigrateInstance(LogicalUnit):
3811
  """Migrate an instance.
3812

3813
  This is migration without shutting down, compared to the failover,
3814
  which is done with shutdown.
3815

3816
  """
3817
  HPATH = "instance-migrate"
3818
  HTYPE = constants.HTYPE_INSTANCE
3819
  _OP_REQP = ["instance_name", "live", "cleanup"]
3820

    
3821
  REQ_BGL = False
3822

    
3823
  def ExpandNames(self):
3824
    self._ExpandAndLockInstance()
3825
    self.needed_locks[locking.LEVEL_NODE] = []
3826
    self.recalculate_locks[locking.LEVEL_NODE] = constants.LOCKS_REPLACE
3827

    
3828
  def DeclareLocks(self, level):
3829
    if level == locking.LEVEL_NODE:
3830
      self._LockInstancesNodes()
3831

    
3832
  def BuildHooksEnv(self):
3833
    """Build hooks env.
3834

3835
    This runs on master, primary and secondary nodes of the instance.
3836

3837
    """
3838
    env = _BuildInstanceHookEnvByObject(self, self.instance)
3839
    env["MIGRATE_LIVE"] = self.op.live
3840
    env["MIGRATE_CLEANUP"] = self.op.cleanup
3841
    nl = [self.cfg.GetMasterNode()] + list(self.instance.secondary_nodes)
3842
    return env, nl, nl
3843

    
3844
  def CheckPrereq(self):
3845
    """Check prerequisites.
3846

3847
    This checks that the instance is in the cluster.
3848

3849
    """
3850
    instance = self.cfg.GetInstanceInfo(
3851
      self.cfg.ExpandInstanceName(self.op.instance_name))
3852
    if instance is None:
3853
      raise errors.OpPrereqError("Instance '%s' not known" %
3854
                                 self.op.instance_name)
3855

    
3856
    if instance.disk_template != constants.DT_DRBD8:
3857
      raise errors.OpPrereqError("Instance's disk layout is not"
3858
                                 " drbd8, cannot migrate.")
3859

    
3860
    secondary_nodes = instance.secondary_nodes
3861
    if not secondary_nodes:
3862
      raise errors.ConfigurationError("No secondary node but using"
3863
                                      " drbd8 disk template")
3864

    
3865
    i_be = self.cfg.GetClusterInfo().FillBE(instance)
3866

    
3867
    target_node = secondary_nodes[0]
3868
    # check memory requirements on the secondary node
3869
    _CheckNodeFreeMemory(self, target_node, "migrating instance %s" %
3870
                         instance.name, i_be[constants.BE_MEMORY],
3871
                         instance.hypervisor)
3872

    
3873
    # check bridge existence
3874
    brlist = [nic.bridge for nic in instance.nics]
3875
    result = self.rpc.call_bridges_exist(target_node, brlist)
3876
    if result.failed or not result.data:
3877
      raise errors.OpPrereqError("One or more target bridges %s does not"
3878
                                 " exist on destination node '%s'" %
3879
                                 (brlist, target_node))
3880

    
3881
    if not self.op.cleanup:
3882
      _CheckNodeNotDrained(self, target_node)
3883
      result = self.rpc.call_instance_migratable(instance.primary_node,
3884
                                                 instance)
3885
      msg = result.RemoteFailMsg()
3886
      if msg:
3887
        raise errors.OpPrereqError("Can't migrate: %s - please use failover" %
3888
                                   msg)
3889

    
3890
    self.instance = instance
3891

    
3892
  def _WaitUntilSync(self):
3893
    """Poll with custom rpc for disk sync.
3894

3895
    This uses our own step-based rpc call.
3896

3897
    """
3898
    self.feedback_fn("* wait until resync is done")
3899
    all_done = False
3900
    while not all_done:
3901
      all_done = True
3902
      result = self.rpc.call_drbd_wait_sync(self.all_nodes,
3903
                                            self.nodes_ip,
3904
                                            self.instance.disks)
3905
      min_percent = 100
3906
      for node, nres in result.items():
3907
        msg = nres.RemoteFailMsg()
3908
        if msg:
3909
          raise errors.OpExecError("Cannot resync disks on node %s: %s" %
3910
                                   (node, msg))
3911
        node_done, node_percent = nres.payload
3912
        all_done = all_done and node_done
3913
        if node_percent is not None:
3914
          min_percent = min(min_percent, node_percent)
3915
      if not all_done:
3916
        if min_percent < 100:
3917
          self.feedback_fn("   - progress: %.1f%%" % min_percent)
3918
        time.sleep(2)
3919

    
3920
  def _EnsureSecondary(self, node):
3921
    """Demote a node to secondary.
3922

3923
    """
3924
    self.feedback_fn("* switching node %s to secondary mode" % node)
3925

    
3926
    for dev in self.instance.disks:
3927
      self.cfg.SetDiskID(dev, node)
3928

    
3929
    result = self.rpc.call_blockdev_close(node, self.instance.name,
3930
                                          self.instance.disks)
3931
    msg = result.RemoteFailMsg()
3932
    if msg:
3933
      raise errors.OpExecError("Cannot change disk to secondary on node %s,"
3934
                               " error %s" % (node, msg))
3935

    
3936
  def _GoStandalone(self):
3937
    """Disconnect from the network.
3938

3939
    """
3940
    self.feedback_fn("* changing into standalone mode")
3941
    result = self.rpc.call_drbd_disconnect_net(self.all_nodes, self.nodes_ip,
3942
                                               self.instance.disks)
3943
    for node, nres in result.items():
3944
      msg = nres.RemoteFailMsg()
3945
      if msg:
3946
        raise errors.OpExecError("Cannot disconnect disks node %s,"
3947
                                 " error %s" % (node, msg))
3948

    
3949
  def _GoReconnect(self, multimaster):
3950
    """Reconnect to the network.
3951

3952
    """
3953
    if multimaster:
3954
      msg = "dual-master"
3955
    else:
3956
      msg = "single-master"
3957
    self.feedback_fn("* changing disks into %s mode" % msg)
3958
    result = self.rpc.call_drbd_attach_net(self.all_nodes, self.nodes_ip,
3959
                                           self.instance.disks,
3960
                                           self.instance.name, multimaster)
3961
    for node, nres in result.items():
3962
      msg = nres.RemoteFailMsg()
3963
      if msg:
3964
        raise errors.OpExecError("Cannot change disks config on node %s,"
3965
                                 " error: %s" % (node, msg))
3966

    
3967
  def _ExecCleanup(self):
3968
    """Try to cleanup after a failed migration.
3969

3970
    The cleanup is done by:
3971
      - check that the instance is running only on one node
3972
        (and update the config if needed)
3973
      - change disks on its secondary node to secondary
3974
      - wait until disks are fully synchronized
3975
      - disconnect from the network
3976
      - change disks into single-master mode
3977
      - wait again until disks are fully synchronized
3978

3979
    """
3980
    instance = self.instance
3981
    target_node = self.target_node
3982
    source_node = self.source_node
3983

    
3984
    # check running on only one node
3985
    self.feedback_fn("* checking where the instance actually runs"
3986
                     " (if this hangs, the hypervisor might be in"
3987
                     " a bad state)")
3988
    ins_l = self.rpc.call_instance_list(self.all_nodes, [instance.hypervisor])
3989
    for node, result in ins_l.items():
3990
      result.Raise()
3991
      if not isinstance(result.data, list):
3992
        raise errors.OpExecError("Can't contact node '%s'" % node)
3993

    
3994
    runningon_source = instance.name in ins_l[source_node].data
3995
    runningon_target = instance.name in ins_l[target_node].data
3996

    
3997
    if runningon_source and runningon_target:
3998
      raise errors.OpExecError("Instance seems to be running on two nodes,"
3999
                               " or the hypervisor is confused. You will have"
4000