Statistics
| Branch: | Tag: | Revision:

root / lib / cmdlib.py @ b726aff0

History | View | Annotate | Download (253 kB)

1
#
2
#
3

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

    
21

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

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

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

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

    
47

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

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

60
  Note that all commands require root permissions.
61

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

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

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

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

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

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

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

    
108
  ssh = property(fget=__GetSSH)
109

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

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

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

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

125
    """
126
    pass
127

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

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

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

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

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

149
    Examples::
150

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

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

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

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

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

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

188
    """
189

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

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

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

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

204
    """
205
    raise NotImplementedError
206

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

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

214
    """
215
    raise NotImplementedError
216

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

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

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

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

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

236
    """
237
    raise NotImplementedError
238

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

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

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

257
    """
258
    return lu_result
259

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    
325
    del self.recalculate_locks[locking.LEVEL_NODE]
326

    
327

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

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

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

    
338

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

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

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

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

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

    
365
  return utils.NiceSort(wanted)
366

    
367

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

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

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

    
384
  if instances:
385
    wanted = []
386

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

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

    
397

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

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

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

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

    
416

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

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

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

    
430

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

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

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

    
442

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

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

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

    
454

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

459
  This builds the hook environment from individual variables.
460

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

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

    
502
  if nics:
503
    nic_count = len(nics)
504
    for idx, (ip, mac, mode, link) in enumerate(nics):
505
      if ip is None:
506
        ip = ""
507
      env["INSTANCE_NIC%d_IP" % idx] = ip
508
      env["INSTANCE_NIC%d_MAC" % idx] = mac
509
      env["INSTANCE_NIC%d_MODE" % idx] = mode
510
      env["INSTANCE_NIC%d_LINK" % idx] = link
511
      if mode == constants.NIC_MODE_BRIDGED:
512
        env["INSTANCE_NIC%d_BRIDGE" % idx] = link
513
  else:
514
    nic_count = 0
515

    
516
  env["INSTANCE_NIC_COUNT"] = nic_count
517

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

    
526
  env["INSTANCE_DISK_COUNT"] = disk_count
527

    
528
  return env
529

    
530
def _PreBuildNICHooksList(lu, nics):
531
  """Build a list of nic information tuples.
532

533
  This list is suitable to be passed to _BuildInstanceHookEnv.
534

535
  @type lu:  L{LogicalUnit}
536
  @param lu: the logical unit on whose behalf we execute
537
  @type nics: list of L{objects.NIC}
538
  @param nics: list of nics to convert to hooks tuples
539

540
  """
541
  hooks_nics = []
542
  c_nicparams = lu.cfg.GetClusterInfo().nicparams[constants.PP_DEFAULT]
543
  for nic in nics:
544
    ip = nic.ip
545
    mac = nic.mac
546
    filled_params = objects.FillDict(c_nicparams, nic.nicparams)
547
    mode = filled_params[constants.NIC_MODE]
548
    link = filled_params[constants.NIC_LINK]
549
    hooks_nics.append((ip, mac, mode, link))
550
  return hooks_nics
551

    
552
def _BuildInstanceHookEnvByObject(lu, instance, override=None):
553
  """Builds instance related env variables for hooks from an object.
554

555
  @type lu: L{LogicalUnit}
556
  @param lu: the logical unit on whose behalf we execute
557
  @type instance: L{objects.Instance}
558
  @param instance: the instance for which we should build the
559
      environment
560
  @type override: dict
561
  @param override: dictionary with key/values that will override
562
      our values
563
  @rtype: dict
564
  @return: the hook environment dictionary
565

566
  """
567
  bep = lu.cfg.GetClusterInfo().FillBE(instance)
568
  args = {
569
    'name': instance.name,
570
    'primary_node': instance.primary_node,
571
    'secondary_nodes': instance.secondary_nodes,
572
    'os_type': instance.os,
573
    'status': instance.admin_up,
574
    'memory': bep[constants.BE_MEMORY],
575
    'vcpus': bep[constants.BE_VCPUS],
576
    'nics': _PreBuildNICHooksList(lu, instance.nics),
577
    'disk_template': instance.disk_template,
578
    'disks': [(disk.size, disk.mode) for disk in instance.disks],
579
  }
580
  if override:
581
    args.update(override)
582
  return _BuildInstanceHookEnv(**args)
583

    
584

    
585
def _AdjustCandidatePool(lu):
586
  """Adjust the candidate pool after node operations.
587

588
  """
589
  mod_list = lu.cfg.MaintainCandidatePool()
590
  if mod_list:
591
    lu.LogInfo("Promoted nodes to master candidate role: %s",
592
               ", ".join(node.name for node in mod_list))
593
    for name in mod_list:
594
      lu.context.ReaddNode(name)
595
  mc_now, mc_max = lu.cfg.GetMasterCandidateStats()
596
  if mc_now > mc_max:
597
    lu.LogInfo("Note: more nodes are candidates (%d) than desired (%d)" %
598
               (mc_now, mc_max))
599

    
600

    
601
def _CheckNicsBridgesExist(lu, target_nics, target_node,
602
                               profile=constants.PP_DEFAULT):
603
  """Check that the brigdes needed by a list of nics exist.
604

605
  """
606
  c_nicparams = lu.cfg.GetClusterInfo().nicparams[profile]
607
  paramslist = [objects.FillDict(c_nicparams, nic.nicparams)
608
                for nic in target_nics]
609
  brlist = [params[constants.NIC_LINK] for params in paramslist
610
            if params[constants.NIC_MODE] == constants.NIC_MODE_BRIDGED]
611
  if brlist:
612
    result = lu.rpc.call_bridges_exist(target_node, brlist)
613
    msg = result.RemoteFailMsg()
614
    if msg:
615
      raise errors.OpPrereqError("Error checking bridges on destination node"
616
                                 " '%s': %s" % (target_node, msg))
617

    
618

    
619
def _CheckInstanceBridgesExist(lu, instance, node=None):
620
  """Check that the brigdes needed by an instance exist.
621

622
  """
623
  if node is None:
624
    node=instance.primary_node
625
  _CheckNicsBridgesExist(lu, instance.nics, node)
626

    
627

    
628
class LUDestroyCluster(NoHooksLU):
629
  """Logical unit for destroying the cluster.
630

631
  """
632
  _OP_REQP = []
633

    
634
  def CheckPrereq(self):
635
    """Check prerequisites.
636

637
    This checks whether the cluster is empty.
638

639
    Any errors are signalled by raising errors.OpPrereqError.
640

641
    """
642
    master = self.cfg.GetMasterNode()
643

    
644
    nodelist = self.cfg.GetNodeList()
645
    if len(nodelist) != 1 or nodelist[0] != master:
646
      raise errors.OpPrereqError("There are still %d node(s) in"
647
                                 " this cluster." % (len(nodelist) - 1))
648
    instancelist = self.cfg.GetInstanceList()
649
    if instancelist:
650
      raise errors.OpPrereqError("There are still %d instance(s) in"
651
                                 " this cluster." % len(instancelist))
652

    
653
  def Exec(self, feedback_fn):
654
    """Destroys the cluster.
655

656
    """
657
    master = self.cfg.GetMasterNode()
658
    result = self.rpc.call_node_stop_master(master, False)
659
    result.Raise()
660
    if not result.data:
661
      raise errors.OpExecError("Could not disable the master role")
662
    priv_key, pub_key, _ = ssh.GetUserFiles(constants.GANETI_RUNAS)
663
    utils.CreateBackup(priv_key)
664
    utils.CreateBackup(pub_key)
665
    return master
666

    
667

    
668
class LUVerifyCluster(LogicalUnit):
669
  """Verifies the cluster status.
670

671
  """
672
  HPATH = "cluster-verify"
673
  HTYPE = constants.HTYPE_CLUSTER
674
  _OP_REQP = ["skip_checks"]
675
  REQ_BGL = False
676

    
677
  def ExpandNames(self):
678
    self.needed_locks = {
679
      locking.LEVEL_NODE: locking.ALL_SET,
680
      locking.LEVEL_INSTANCE: locking.ALL_SET,
681
    }
682
    self.share_locks = dict(((i, 1) for i in locking.LEVELS))
683

    
684
  def _VerifyNode(self, nodeinfo, file_list, local_cksum,
685
                  node_result, feedback_fn, master_files,
686
                  drbd_map, vg_name):
687
    """Run multiple tests against a node.
688

689
    Test list:
690

691
      - compares ganeti version
692
      - checks vg existance and size > 20G
693
      - checks config file checksum
694
      - checks ssh to other nodes
695

696
    @type nodeinfo: L{objects.Node}
697
    @param nodeinfo: the node to check
698
    @param file_list: required list of files
699
    @param local_cksum: dictionary of local files and their checksums
700
    @param node_result: the results from the node
701
    @param feedback_fn: function used to accumulate results
702
    @param master_files: list of files that only masters should have
703
    @param drbd_map: the useddrbd minors for this node, in
704
        form of minor: (instance, must_exist) which correspond to instances
705
        and their running status
706
    @param vg_name: Ganeti Volume Group (result of self.cfg.GetVGName())
707

708
    """
709
    node = nodeinfo.name
710

    
711
    # main result, node_result should be a non-empty dict
712
    if not node_result or not isinstance(node_result, dict):
713
      feedback_fn("  - ERROR: unable to verify node %s." % (node,))
714
      return True
715

    
716
    # compares ganeti version
717
    local_version = constants.PROTOCOL_VERSION
718
    remote_version = node_result.get('version', None)
719
    if not (remote_version and isinstance(remote_version, (list, tuple)) and
720
            len(remote_version) == 2):
721
      feedback_fn("  - ERROR: connection to %s failed" % (node))
722
      return True
723

    
724
    if local_version != remote_version[0]:
725
      feedback_fn("  - ERROR: incompatible protocol versions: master %s,"
726
                  " node %s %s" % (local_version, node, remote_version[0]))
727
      return True
728

    
729
    # node seems compatible, we can actually try to look into its results
730

    
731
    bad = False
732

    
733
    # full package version
734
    if constants.RELEASE_VERSION != remote_version[1]:
735
      feedback_fn("  - WARNING: software version mismatch: master %s,"
736
                  " node %s %s" %
737
                  (constants.RELEASE_VERSION, node, remote_version[1]))
738

    
739
    # checks vg existence and size > 20G
740
    if vg_name is not None:
741
      vglist = node_result.get(constants.NV_VGLIST, None)
742
      if not vglist:
743
        feedback_fn("  - ERROR: unable to check volume groups on node %s." %
744
                        (node,))
745
        bad = True
746
      else:
747
        vgstatus = utils.CheckVolumeGroupSize(vglist, vg_name,
748
                                              constants.MIN_VG_SIZE)
749
        if vgstatus:
750
          feedback_fn("  - ERROR: %s on node %s" % (vgstatus, node))
751
          bad = True
752

    
753
    # checks config file checksum
754

    
755
    remote_cksum = node_result.get(constants.NV_FILELIST, None)
756
    if not isinstance(remote_cksum, dict):
757
      bad = True
758
      feedback_fn("  - ERROR: node hasn't returned file checksum data")
759
    else:
760
      for file_name in file_list:
761
        node_is_mc = nodeinfo.master_candidate
762
        must_have_file = file_name not in master_files
763
        if file_name not in remote_cksum:
764
          if node_is_mc or must_have_file:
765
            bad = True
766
            feedback_fn("  - ERROR: file '%s' missing" % file_name)
767
        elif remote_cksum[file_name] != local_cksum[file_name]:
768
          if node_is_mc or must_have_file:
769
            bad = True
770
            feedback_fn("  - ERROR: file '%s' has wrong checksum" % file_name)
771
          else:
772
            # not candidate and this is not a must-have file
773
            bad = True
774
            feedback_fn("  - ERROR: non master-candidate has old/wrong file"
775
                        " '%s'" % file_name)
776
        else:
777
          # all good, except non-master/non-must have combination
778
          if not node_is_mc and not must_have_file:
779
            feedback_fn("  - ERROR: file '%s' should not exist on non master"
780
                        " candidates" % file_name)
781

    
782
    # checks ssh to any
783

    
784
    if constants.NV_NODELIST not in node_result:
785
      bad = True
786
      feedback_fn("  - ERROR: node hasn't returned node ssh connectivity data")
787
    else:
788
      if node_result[constants.NV_NODELIST]:
789
        bad = True
790
        for node in node_result[constants.NV_NODELIST]:
791
          feedback_fn("  - ERROR: ssh communication with node '%s': %s" %
792
                          (node, node_result[constants.NV_NODELIST][node]))
793

    
794
    if constants.NV_NODENETTEST not in node_result:
795
      bad = True
796
      feedback_fn("  - ERROR: node hasn't returned node tcp connectivity data")
797
    else:
798
      if node_result[constants.NV_NODENETTEST]:
799
        bad = True
800
        nlist = utils.NiceSort(node_result[constants.NV_NODENETTEST].keys())
801
        for node in nlist:
802
          feedback_fn("  - ERROR: tcp communication with node '%s': %s" %
803
                          (node, node_result[constants.NV_NODENETTEST][node]))
804

    
805
    hyp_result = node_result.get(constants.NV_HYPERVISOR, None)
806
    if isinstance(hyp_result, dict):
807
      for hv_name, hv_result in hyp_result.iteritems():
808
        if hv_result is not None:
809
          feedback_fn("  - ERROR: hypervisor %s verify failure: '%s'" %
810
                      (hv_name, hv_result))
811

    
812
    # check used drbd list
813
    if vg_name is not None:
814
      used_minors = node_result.get(constants.NV_DRBDLIST, [])
815
      if not isinstance(used_minors, (tuple, list)):
816
        feedback_fn("  - ERROR: cannot parse drbd status file: %s" %
817
                    str(used_minors))
818
      else:
819
        for minor, (iname, must_exist) in drbd_map.items():
820
          if minor not in used_minors and must_exist:
821
            feedback_fn("  - ERROR: drbd minor %d of instance %s is"
822
                        " not active" % (minor, iname))
823
            bad = True
824
        for minor in used_minors:
825
          if minor not in drbd_map:
826
            feedback_fn("  - ERROR: unallocated drbd minor %d is in use" %
827
                        minor)
828
            bad = True
829

    
830
    return bad
831

    
832
  def _VerifyInstance(self, instance, instanceconfig, node_vol_is,
833
                      node_instance, feedback_fn, n_offline):
834
    """Verify an instance.
835

836
    This function checks to see if the required block devices are
837
    available on the instance's node.
838

839
    """
840
    bad = False
841

    
842
    node_current = instanceconfig.primary_node
843

    
844
    node_vol_should = {}
845
    instanceconfig.MapLVsByNode(node_vol_should)
846

    
847
    for node in node_vol_should:
848
      if node in n_offline:
849
        # ignore missing volumes on offline nodes
850
        continue
851
      for volume in node_vol_should[node]:
852
        if node not in node_vol_is or volume not in node_vol_is[node]:
853
          feedback_fn("  - ERROR: volume %s missing on node %s" %
854
                          (volume, node))
855
          bad = True
856

    
857
    if instanceconfig.admin_up:
858
      if ((node_current not in node_instance or
859
          not instance in node_instance[node_current]) and
860
          node_current not in n_offline):
861
        feedback_fn("  - ERROR: instance %s not running on node %s" %
862
                        (instance, node_current))
863
        bad = True
864

    
865
    for node in node_instance:
866
      if (not node == node_current):
867
        if instance in node_instance[node]:
868
          feedback_fn("  - ERROR: instance %s should not run on node %s" %
869
                          (instance, node))
870
          bad = True
871

    
872
    return bad
873

    
874
  def _VerifyOrphanVolumes(self, node_vol_should, node_vol_is, feedback_fn):
875
    """Verify if there are any unknown volumes in the cluster.
876

877
    The .os, .swap and backup volumes are ignored. All other volumes are
878
    reported as unknown.
879

880
    """
881
    bad = False
882

    
883
    for node in node_vol_is:
884
      for volume in node_vol_is[node]:
885
        if node not in node_vol_should or volume not in node_vol_should[node]:
886
          feedback_fn("  - ERROR: volume %s on node %s should not exist" %
887
                      (volume, node))
888
          bad = True
889
    return bad
890

    
891
  def _VerifyOrphanInstances(self, instancelist, node_instance, feedback_fn):
892
    """Verify the list of running instances.
893

894
    This checks what instances are running but unknown to the cluster.
895

896
    """
897
    bad = False
898
    for node in node_instance:
899
      for runninginstance in node_instance[node]:
900
        if runninginstance not in instancelist:
901
          feedback_fn("  - ERROR: instance %s on node %s should not exist" %
902
                          (runninginstance, node))
903
          bad = True
904
    return bad
905

    
906
  def _VerifyNPlusOneMemory(self, node_info, instance_cfg, feedback_fn):
907
    """Verify N+1 Memory Resilience.
908

909
    Check that if one single node dies we can still start all the instances it
910
    was primary for.
911

912
    """
913
    bad = False
914

    
915
    for node, nodeinfo in node_info.iteritems():
916
      # This code checks that every node which is now listed as secondary has
917
      # enough memory to host all instances it is supposed to should a single
918
      # other node in the cluster fail.
919
      # FIXME: not ready for failover to an arbitrary node
920
      # FIXME: does not support file-backed instances
921
      # WARNING: we currently take into account down instances as well as up
922
      # ones, considering that even if they're down someone might want to start
923
      # them even in the event of a node failure.
924
      for prinode, instances in nodeinfo['sinst-by-pnode'].iteritems():
925
        needed_mem = 0
926
        for instance in instances:
927
          bep = self.cfg.GetClusterInfo().FillBE(instance_cfg[instance])
928
          if bep[constants.BE_AUTO_BALANCE]:
929
            needed_mem += bep[constants.BE_MEMORY]
930
        if nodeinfo['mfree'] < needed_mem:
931
          feedback_fn("  - ERROR: not enough memory on node %s to accomodate"
932
                      " failovers should node %s fail" % (node, prinode))
933
          bad = True
934
    return bad
935

    
936
  def CheckPrereq(self):
937
    """Check prerequisites.
938

939
    Transform the list of checks we're going to skip into a set and check that
940
    all its members are valid.
941

942
    """
943
    self.skip_set = frozenset(self.op.skip_checks)
944
    if not constants.VERIFY_OPTIONAL_CHECKS.issuperset(self.skip_set):
945
      raise errors.OpPrereqError("Invalid checks to be skipped specified")
946

    
947
  def BuildHooksEnv(self):
948
    """Build hooks env.
949

950
    Cluster-Verify hooks just rone in the post phase and their failure makes
951
    the output be logged in the verify output and the verification to fail.
952

953
    """
954
    all_nodes = self.cfg.GetNodeList()
955
    env = {
956
      "CLUSTER_TAGS": " ".join(self.cfg.GetClusterInfo().GetTags())
957
      }
958
    for node in self.cfg.GetAllNodesInfo().values():
959
      env["NODE_TAGS_%s" % node.name] = " ".join(node.GetTags())
960

    
961
    return env, [], all_nodes
962

    
963
  def Exec(self, feedback_fn):
964
    """Verify integrity of cluster, performing various test on nodes.
965

966
    """
967
    bad = False
968
    feedback_fn("* Verifying global settings")
969
    for msg in self.cfg.VerifyConfig():
970
      feedback_fn("  - ERROR: %s" % msg)
971

    
972
    vg_name = self.cfg.GetVGName()
973
    hypervisors = self.cfg.GetClusterInfo().enabled_hypervisors
974
    nodelist = utils.NiceSort(self.cfg.GetNodeList())
975
    nodeinfo = [self.cfg.GetNodeInfo(nname) for nname in nodelist]
976
    instancelist = utils.NiceSort(self.cfg.GetInstanceList())
977
    instanceinfo = dict((iname, self.cfg.GetInstanceInfo(iname))
978
                        for iname in instancelist)
979
    i_non_redundant = [] # Non redundant instances
980
    i_non_a_balanced = [] # Non auto-balanced instances
981
    n_offline = [] # List of offline nodes
982
    n_drained = [] # List of nodes being drained
983
    node_volume = {}
984
    node_instance = {}
985
    node_info = {}
986
    instance_cfg = {}
987

    
988
    # FIXME: verify OS list
989
    # do local checksums
990
    master_files = [constants.CLUSTER_CONF_FILE]
991

    
992
    file_names = ssconf.SimpleStore().GetFileList()
993
    file_names.append(constants.SSL_CERT_FILE)
994
    file_names.append(constants.RAPI_CERT_FILE)
995
    file_names.extend(master_files)
996

    
997
    local_checksums = utils.FingerprintFiles(file_names)
998

    
999
    feedback_fn("* Gathering data (%d nodes)" % len(nodelist))
1000
    node_verify_param = {
1001
      constants.NV_FILELIST: file_names,
1002
      constants.NV_NODELIST: [node.name for node in nodeinfo
1003
                              if not node.offline],
1004
      constants.NV_HYPERVISOR: hypervisors,
1005
      constants.NV_NODENETTEST: [(node.name, node.primary_ip,
1006
                                  node.secondary_ip) for node in nodeinfo
1007
                                 if not node.offline],
1008
      constants.NV_INSTANCELIST: hypervisors,
1009
      constants.NV_VERSION: None,
1010
      constants.NV_HVINFO: self.cfg.GetHypervisorType(),
1011
      }
1012
    if vg_name is not None:
1013
      node_verify_param[constants.NV_VGLIST] = None
1014
      node_verify_param[constants.NV_LVLIST] = vg_name
1015
      node_verify_param[constants.NV_DRBDLIST] = None
1016
    all_nvinfo = self.rpc.call_node_verify(nodelist, node_verify_param,
1017
                                           self.cfg.GetClusterName())
1018

    
1019
    cluster = self.cfg.GetClusterInfo()
1020
    master_node = self.cfg.GetMasterNode()
1021
    all_drbd_map = self.cfg.ComputeDRBDMap()
1022

    
1023
    for node_i in nodeinfo:
1024
      node = node_i.name
1025

    
1026
      if node_i.offline:
1027
        feedback_fn("* Skipping offline node %s" % (node,))
1028
        n_offline.append(node)
1029
        continue
1030

    
1031
      if node == master_node:
1032
        ntype = "master"
1033
      elif node_i.master_candidate:
1034
        ntype = "master candidate"
1035
      elif node_i.drained:
1036
        ntype = "drained"
1037
        n_drained.append(node)
1038
      else:
1039
        ntype = "regular"
1040
      feedback_fn("* Verifying node %s (%s)" % (node, ntype))
1041

    
1042
      msg = all_nvinfo[node].RemoteFailMsg()
1043
      if msg:
1044
        feedback_fn("  - ERROR: while contacting node %s: %s" % (node, msg))
1045
        bad = True
1046
        continue
1047

    
1048
      nresult = all_nvinfo[node].payload
1049
      node_drbd = {}
1050
      for minor, instance in all_drbd_map[node].items():
1051
        if instance not in instanceinfo:
1052
          feedback_fn("  - ERROR: ghost instance '%s' in temporary DRBD map" %
1053
                      instance)
1054
          # ghost instance should not be running, but otherwise we
1055
          # don't give double warnings (both ghost instance and
1056
          # unallocated minor in use)
1057
          node_drbd[minor] = (instance, False)
1058
        else:
1059
          instance = instanceinfo[instance]
1060
          node_drbd[minor] = (instance.name, instance.admin_up)
1061
      result = self._VerifyNode(node_i, file_names, local_checksums,
1062
                                nresult, feedback_fn, master_files,
1063
                                node_drbd, vg_name)
1064
      bad = bad or result
1065

    
1066
      lvdata = nresult.get(constants.NV_LVLIST, "Missing LV data")
1067
      if vg_name is None:
1068
        node_volume[node] = {}
1069
      elif isinstance(lvdata, basestring):
1070
        feedback_fn("  - ERROR: LVM problem on node %s: %s" %
1071
                    (node, utils.SafeEncode(lvdata)))
1072
        bad = True
1073
        node_volume[node] = {}
1074
      elif not isinstance(lvdata, dict):
1075
        feedback_fn("  - ERROR: connection to %s failed (lvlist)" % (node,))
1076
        bad = True
1077
        continue
1078
      else:
1079
        node_volume[node] = lvdata
1080

    
1081
      # node_instance
1082
      idata = nresult.get(constants.NV_INSTANCELIST, None)
1083
      if not isinstance(idata, list):
1084
        feedback_fn("  - ERROR: connection to %s failed (instancelist)" %
1085
                    (node,))
1086
        bad = True
1087
        continue
1088

    
1089
      node_instance[node] = idata
1090

    
1091
      # node_info
1092
      nodeinfo = nresult.get(constants.NV_HVINFO, None)
1093
      if not isinstance(nodeinfo, dict):
1094
        feedback_fn("  - ERROR: connection to %s failed (hvinfo)" % (node,))
1095
        bad = True
1096
        continue
1097

    
1098
      try:
1099
        node_info[node] = {
1100
          "mfree": int(nodeinfo['memory_free']),
1101
          "pinst": [],
1102
          "sinst": [],
1103
          # dictionary holding all instances this node is secondary for,
1104
          # grouped by their primary node. Each key is a cluster node, and each
1105
          # value is a list of instances which have the key as primary and the
1106
          # current node as secondary.  this is handy to calculate N+1 memory
1107
          # availability if you can only failover from a primary to its
1108
          # secondary.
1109
          "sinst-by-pnode": {},
1110
        }
1111
        # FIXME: devise a free space model for file based instances as well
1112
        if vg_name is not None:
1113
          if (constants.NV_VGLIST not in nresult or
1114
              vg_name not in nresult[constants.NV_VGLIST]):
1115
            feedback_fn("  - ERROR: node %s didn't return data for the"
1116
                        " volume group '%s' - it is either missing or broken" %
1117
                        (node, vg_name))
1118
            bad = True
1119
            continue
1120
          node_info[node]["dfree"] = int(nresult[constants.NV_VGLIST][vg_name])
1121
      except (ValueError, KeyError):
1122
        feedback_fn("  - ERROR: invalid nodeinfo value returned"
1123
                    " from node %s" % (node,))
1124
        bad = True
1125
        continue
1126

    
1127
    node_vol_should = {}
1128

    
1129
    for instance in instancelist:
1130
      feedback_fn("* Verifying instance %s" % instance)
1131
      inst_config = instanceinfo[instance]
1132
      result =  self._VerifyInstance(instance, inst_config, node_volume,
1133
                                     node_instance, feedback_fn, n_offline)
1134
      bad = bad or result
1135
      inst_nodes_offline = []
1136

    
1137
      inst_config.MapLVsByNode(node_vol_should)
1138

    
1139
      instance_cfg[instance] = inst_config
1140

    
1141
      pnode = inst_config.primary_node
1142
      if pnode in node_info:
1143
        node_info[pnode]['pinst'].append(instance)
1144
      elif pnode not in n_offline:
1145
        feedback_fn("  - ERROR: instance %s, connection to primary node"
1146
                    " %s failed" % (instance, pnode))
1147
        bad = True
1148

    
1149
      if pnode in n_offline:
1150
        inst_nodes_offline.append(pnode)
1151

    
1152
      # If the instance is non-redundant we cannot survive losing its primary
1153
      # node, so we are not N+1 compliant. On the other hand we have no disk
1154
      # templates with more than one secondary so that situation is not well
1155
      # supported either.
1156
      # FIXME: does not support file-backed instances
1157
      if len(inst_config.secondary_nodes) == 0:
1158
        i_non_redundant.append(instance)
1159
      elif len(inst_config.secondary_nodes) > 1:
1160
        feedback_fn("  - WARNING: multiple secondaries for instance %s"
1161
                    % instance)
1162

    
1163
      if not cluster.FillBE(inst_config)[constants.BE_AUTO_BALANCE]:
1164
        i_non_a_balanced.append(instance)
1165

    
1166
      for snode in inst_config.secondary_nodes:
1167
        if snode in node_info:
1168
          node_info[snode]['sinst'].append(instance)
1169
          if pnode not in node_info[snode]['sinst-by-pnode']:
1170
            node_info[snode]['sinst-by-pnode'][pnode] = []
1171
          node_info[snode]['sinst-by-pnode'][pnode].append(instance)
1172
        elif snode not in n_offline:
1173
          feedback_fn("  - ERROR: instance %s, connection to secondary node"
1174
                      " %s failed" % (instance, snode))
1175
          bad = True
1176
        if snode in n_offline:
1177
          inst_nodes_offline.append(snode)
1178

    
1179
      if inst_nodes_offline:
1180
        # warn that the instance lives on offline nodes, and set bad=True
1181
        feedback_fn("  - ERROR: instance lives on offline node(s) %s" %
1182
                    ", ".join(inst_nodes_offline))
1183
        bad = True
1184

    
1185
    feedback_fn("* Verifying orphan volumes")
1186
    result = self._VerifyOrphanVolumes(node_vol_should, node_volume,
1187
                                       feedback_fn)
1188
    bad = bad or result
1189

    
1190
    feedback_fn("* Verifying remaining instances")
1191
    result = self._VerifyOrphanInstances(instancelist, node_instance,
1192
                                         feedback_fn)
1193
    bad = bad or result
1194

    
1195
    if constants.VERIFY_NPLUSONE_MEM not in self.skip_set:
1196
      feedback_fn("* Verifying N+1 Memory redundancy")
1197
      result = self._VerifyNPlusOneMemory(node_info, instance_cfg, feedback_fn)
1198
      bad = bad or result
1199

    
1200
    feedback_fn("* Other Notes")
1201
    if i_non_redundant:
1202
      feedback_fn("  - NOTICE: %d non-redundant instance(s) found."
1203
                  % len(i_non_redundant))
1204

    
1205
    if i_non_a_balanced:
1206
      feedback_fn("  - NOTICE: %d non-auto-balanced instance(s) found."
1207
                  % len(i_non_a_balanced))
1208

    
1209
    if n_offline:
1210
      feedback_fn("  - NOTICE: %d offline node(s) found." % len(n_offline))
1211

    
1212
    if n_drained:
1213
      feedback_fn("  - NOTICE: %d drained node(s) found." % len(n_drained))
1214

    
1215
    return not bad
1216

    
1217
  def HooksCallBack(self, phase, hooks_results, feedback_fn, lu_result):
1218
    """Analize the post-hooks' result
1219

1220
    This method analyses the hook result, handles it, and sends some
1221
    nicely-formatted feedback back to the user.
1222

1223
    @param phase: one of L{constants.HOOKS_PHASE_POST} or
1224
        L{constants.HOOKS_PHASE_PRE}; it denotes the hooks phase
1225
    @param hooks_results: the results of the multi-node hooks rpc call
1226
    @param feedback_fn: function used send feedback back to the caller
1227
    @param lu_result: previous Exec result
1228
    @return: the new Exec result, based on the previous result
1229
        and hook results
1230

1231
    """
1232
    # We only really run POST phase hooks, and are only interested in
1233
    # their results
1234
    if phase == constants.HOOKS_PHASE_POST:
1235
      # Used to change hooks' output to proper indentation
1236
      indent_re = re.compile('^', re.M)
1237
      feedback_fn("* Hooks Results")
1238
      if not hooks_results:
1239
        feedback_fn("  - ERROR: general communication failure")
1240
        lu_result = 1
1241
      else:
1242
        for node_name in hooks_results:
1243
          show_node_header = True
1244
          res = hooks_results[node_name]
1245
          if res.failed or res.data is False or not isinstance(res.data, list):
1246
            if res.offline:
1247
              # no need to warn or set fail return value
1248
              continue
1249
            feedback_fn("    Communication failure in hooks execution")
1250
            lu_result = 1
1251
            continue
1252
          for script, hkr, output in res.data:
1253
            if hkr == constants.HKR_FAIL:
1254
              # The node header is only shown once, if there are
1255
              # failing hooks on that node
1256
              if show_node_header:
1257
                feedback_fn("  Node %s:" % node_name)
1258
                show_node_header = False
1259
              feedback_fn("    ERROR: Script %s failed, output:" % script)
1260
              output = indent_re.sub('      ', output)
1261
              feedback_fn("%s" % output)
1262
              lu_result = 1
1263

    
1264
      return lu_result
1265

    
1266

    
1267
class LUVerifyDisks(NoHooksLU):
1268
  """Verifies the cluster disks status.
1269

1270
  """
1271
  _OP_REQP = []
1272
  REQ_BGL = False
1273

    
1274
  def ExpandNames(self):
1275
    self.needed_locks = {
1276
      locking.LEVEL_NODE: locking.ALL_SET,
1277
      locking.LEVEL_INSTANCE: locking.ALL_SET,
1278
    }
1279
    self.share_locks = dict(((i, 1) for i in locking.LEVELS))
1280

    
1281
  def CheckPrereq(self):
1282
    """Check prerequisites.
1283

1284
    This has no prerequisites.
1285

1286
    """
1287
    pass
1288

    
1289
  def Exec(self, feedback_fn):
1290
    """Verify integrity of cluster disks.
1291

1292
    @rtype: tuple of three items
1293
    @return: a tuple of (dict of node-to-node_error, list of instances
1294
        which need activate-disks, dict of instance: (node, volume) for
1295
        missing volumes
1296

1297
    """
1298
    result = res_nodes, res_instances, res_missing = {}, [], {}
1299

    
1300
    vg_name = self.cfg.GetVGName()
1301
    nodes = utils.NiceSort(self.cfg.GetNodeList())
1302
    instances = [self.cfg.GetInstanceInfo(name)
1303
                 for name in self.cfg.GetInstanceList()]
1304

    
1305
    nv_dict = {}
1306
    for inst in instances:
1307
      inst_lvs = {}
1308
      if (not inst.admin_up or
1309
          inst.disk_template not in constants.DTS_NET_MIRROR):
1310
        continue
1311
      inst.MapLVsByNode(inst_lvs)
1312
      # transform { iname: {node: [vol,],},} to {(node, vol): iname}
1313
      for node, vol_list in inst_lvs.iteritems():
1314
        for vol in vol_list:
1315
          nv_dict[(node, vol)] = inst
1316

    
1317
    if not nv_dict:
1318
      return result
1319

    
1320
    node_lvs = self.rpc.call_volume_list(nodes, vg_name)
1321

    
1322
    to_act = set()
1323
    for node in nodes:
1324
      # node_volume
1325
      node_res = node_lvs[node]
1326
      if node_res.offline:
1327
        continue
1328
      msg = node_res.RemoteFailMsg()
1329
      if msg:
1330
        logging.warning("Error enumerating LVs on node %s: %s", node, msg)
1331
        res_nodes[node] = msg
1332
        continue
1333

    
1334
      lvs = node_res.payload
1335
      for lv_name, (_, lv_inactive, lv_online) in lvs.items():
1336
        inst = nv_dict.pop((node, lv_name), None)
1337
        if (not lv_online and inst is not None
1338
            and inst.name not in res_instances):
1339
          res_instances.append(inst.name)
1340

    
1341
    # any leftover items in nv_dict are missing LVs, let's arrange the
1342
    # data better
1343
    for key, inst in nv_dict.iteritems():
1344
      if inst.name not in res_missing:
1345
        res_missing[inst.name] = []
1346
      res_missing[inst.name].append(key)
1347

    
1348
    return result
1349

    
1350

    
1351
class LURenameCluster(LogicalUnit):
1352
  """Rename the cluster.
1353

1354
  """
1355
  HPATH = "cluster-rename"
1356
  HTYPE = constants.HTYPE_CLUSTER
1357
  _OP_REQP = ["name"]
1358

    
1359
  def BuildHooksEnv(self):
1360
    """Build hooks env.
1361

1362
    """
1363
    env = {
1364
      "OP_TARGET": self.cfg.GetClusterName(),
1365
      "NEW_NAME": self.op.name,
1366
      }
1367
    mn = self.cfg.GetMasterNode()
1368
    return env, [mn], [mn]
1369

    
1370
  def CheckPrereq(self):
1371
    """Verify that the passed name is a valid one.
1372

1373
    """
1374
    hostname = utils.HostInfo(self.op.name)
1375

    
1376
    new_name = hostname.name
1377
    self.ip = new_ip = hostname.ip
1378
    old_name = self.cfg.GetClusterName()
1379
    old_ip = self.cfg.GetMasterIP()
1380
    if new_name == old_name and new_ip == old_ip:
1381
      raise errors.OpPrereqError("Neither the name nor the IP address of the"
1382
                                 " cluster has changed")
1383
    if new_ip != old_ip:
1384
      if utils.TcpPing(new_ip, constants.DEFAULT_NODED_PORT):
1385
        raise errors.OpPrereqError("The given cluster IP address (%s) is"
1386
                                   " reachable on the network. Aborting." %
1387
                                   new_ip)
1388

    
1389
    self.op.name = new_name
1390

    
1391
  def Exec(self, feedback_fn):
1392
    """Rename the cluster.
1393

1394
    """
1395
    clustername = self.op.name
1396
    ip = self.ip
1397

    
1398
    # shutdown the master IP
1399
    master = self.cfg.GetMasterNode()
1400
    result = self.rpc.call_node_stop_master(master, False)
1401
    if result.failed or not result.data:
1402
      raise errors.OpExecError("Could not disable the master role")
1403

    
1404
    try:
1405
      cluster = self.cfg.GetClusterInfo()
1406
      cluster.cluster_name = clustername
1407
      cluster.master_ip = ip
1408
      self.cfg.Update(cluster)
1409

    
1410
      # update the known hosts file
1411
      ssh.WriteKnownHostsFile(self.cfg, constants.SSH_KNOWN_HOSTS_FILE)
1412
      node_list = self.cfg.GetNodeList()
1413
      try:
1414
        node_list.remove(master)
1415
      except ValueError:
1416
        pass
1417
      result = self.rpc.call_upload_file(node_list,
1418
                                         constants.SSH_KNOWN_HOSTS_FILE)
1419
      for to_node, to_result in result.iteritems():
1420
         msg = to_result.RemoteFailMsg()
1421
         if msg:
1422
           msg = ("Copy of file %s to node %s failed: %s" %
1423
                   (constants.SSH_KNOWN_HOSTS_FILE, to_node, msg))
1424
           self.proc.LogWarning(msg)
1425

    
1426
    finally:
1427
      result = self.rpc.call_node_start_master(master, False)
1428
      msg = result.RemoteFailMsg()
1429
      if msg:
1430
        self.LogWarning("Could not re-enable the master role on"
1431
                        " the master, please restart manually: %s", msg)
1432

    
1433

    
1434
def _RecursiveCheckIfLVMBased(disk):
1435
  """Check if the given disk or its children are lvm-based.
1436

1437
  @type disk: L{objects.Disk}
1438
  @param disk: the disk to check
1439
  @rtype: booleean
1440
  @return: boolean indicating whether a LD_LV dev_type was found or not
1441

1442
  """
1443
  if disk.children:
1444
    for chdisk in disk.children:
1445
      if _RecursiveCheckIfLVMBased(chdisk):
1446
        return True
1447
  return disk.dev_type == constants.LD_LV
1448

    
1449

    
1450
class LUSetClusterParams(LogicalUnit):
1451
  """Change the parameters of the cluster.
1452

1453
  """
1454
  HPATH = "cluster-modify"
1455
  HTYPE = constants.HTYPE_CLUSTER
1456
  _OP_REQP = []
1457
  REQ_BGL = False
1458

    
1459
  def CheckArguments(self):
1460
    """Check parameters
1461

1462
    """
1463
    if not hasattr(self.op, "candidate_pool_size"):
1464
      self.op.candidate_pool_size = None
1465
    if self.op.candidate_pool_size is not None:
1466
      try:
1467
        self.op.candidate_pool_size = int(self.op.candidate_pool_size)
1468
      except (ValueError, TypeError), err:
1469
        raise errors.OpPrereqError("Invalid candidate_pool_size value: %s" %
1470
                                   str(err))
1471
      if self.op.candidate_pool_size < 1:
1472
        raise errors.OpPrereqError("At least one master candidate needed")
1473

    
1474
  def ExpandNames(self):
1475
    # FIXME: in the future maybe other cluster params won't require checking on
1476
    # all nodes to be modified.
1477
    self.needed_locks = {
1478
      locking.LEVEL_NODE: locking.ALL_SET,
1479
    }
1480
    self.share_locks[locking.LEVEL_NODE] = 1
1481

    
1482
  def BuildHooksEnv(self):
1483
    """Build hooks env.
1484

1485
    """
1486
    env = {
1487
      "OP_TARGET": self.cfg.GetClusterName(),
1488
      "NEW_VG_NAME": self.op.vg_name,
1489
      }
1490
    mn = self.cfg.GetMasterNode()
1491
    return env, [mn], [mn]
1492

    
1493
  def CheckPrereq(self):
1494
    """Check prerequisites.
1495

1496
    This checks whether the given params don't conflict and
1497
    if the given volume group is valid.
1498

1499
    """
1500
    if self.op.vg_name is not None and not self.op.vg_name:
1501
      instances = self.cfg.GetAllInstancesInfo().values()
1502
      for inst in instances:
1503
        for disk in inst.disks:
1504
          if _RecursiveCheckIfLVMBased(disk):
1505
            raise errors.OpPrereqError("Cannot disable lvm storage while"
1506
                                       " lvm-based instances exist")
1507

    
1508
    node_list = self.acquired_locks[locking.LEVEL_NODE]
1509

    
1510
    # if vg_name not None, checks given volume group on all nodes
1511
    if self.op.vg_name:
1512
      vglist = self.rpc.call_vg_list(node_list)
1513
      for node in node_list:
1514
        msg = vglist[node].RemoteFailMsg()
1515
        if msg:
1516
          # ignoring down node
1517
          self.LogWarning("Error while gathering data on node %s"
1518
                          " (ignoring node): %s", node, msg)
1519
          continue
1520
        vgstatus = utils.CheckVolumeGroupSize(vglist[node].payload,
1521
                                              self.op.vg_name,
1522
                                              constants.MIN_VG_SIZE)
1523
        if vgstatus:
1524
          raise errors.OpPrereqError("Error on node '%s': %s" %
1525
                                     (node, vgstatus))
1526

    
1527
    self.cluster = cluster = self.cfg.GetClusterInfo()
1528
    # validate params changes
1529
    if self.op.beparams:
1530
      utils.ForceDictType(self.op.beparams, constants.BES_PARAMETER_TYPES)
1531
      self.new_beparams = objects.FillDict(
1532
        cluster.beparams[constants.PP_DEFAULT], self.op.beparams)
1533

    
1534
    if self.op.nicparams:
1535
      utils.ForceDictType(self.op.nicparams, constants.NICS_PARAMETER_TYPES)
1536
      self.new_nicparams = objects.FillDict(
1537
        cluster.nicparams[constants.PP_DEFAULT], self.op.nicparams)
1538
      objects.NIC.CheckParameterSyntax(self.new_nicparams)
1539

    
1540
    # hypervisor list/parameters
1541
    self.new_hvparams = objects.FillDict(cluster.hvparams, {})
1542
    if self.op.hvparams:
1543
      if not isinstance(self.op.hvparams, dict):
1544
        raise errors.OpPrereqError("Invalid 'hvparams' parameter on input")
1545
      for hv_name, hv_dict in self.op.hvparams.items():
1546
        if hv_name not in self.new_hvparams:
1547
          self.new_hvparams[hv_name] = hv_dict
1548
        else:
1549
          self.new_hvparams[hv_name].update(hv_dict)
1550

    
1551
    if self.op.enabled_hypervisors is not None:
1552
      self.hv_list = self.op.enabled_hypervisors
1553
    else:
1554
      self.hv_list = cluster.enabled_hypervisors
1555

    
1556
    if self.op.hvparams or self.op.enabled_hypervisors is not None:
1557
      # either the enabled list has changed, or the parameters have, validate
1558
      for hv_name, hv_params in self.new_hvparams.items():
1559
        if ((self.op.hvparams and hv_name in self.op.hvparams) or
1560
            (self.op.enabled_hypervisors and
1561
             hv_name in self.op.enabled_hypervisors)):
1562
          # either this is a new hypervisor, or its parameters have changed
1563
          hv_class = hypervisor.GetHypervisor(hv_name)
1564
          utils.ForceDictType(hv_params, constants.HVS_PARAMETER_TYPES)
1565
          hv_class.CheckParameterSyntax(hv_params)
1566
          _CheckHVParams(self, node_list, hv_name, hv_params)
1567

    
1568
  def Exec(self, feedback_fn):
1569
    """Change the parameters of the cluster.
1570

1571
    """
1572
    if self.op.vg_name is not None:
1573
      new_volume = self.op.vg_name
1574
      if not new_volume:
1575
        new_volume = None
1576
      if new_volume != self.cfg.GetVGName():
1577
        self.cfg.SetVGName(new_volume)
1578
      else:
1579
        feedback_fn("Cluster LVM configuration already in desired"
1580
                    " state, not changing")
1581
    if self.op.hvparams:
1582
      self.cluster.hvparams = self.new_hvparams
1583
    if self.op.enabled_hypervisors is not None:
1584
      self.cluster.enabled_hypervisors = self.op.enabled_hypervisors
1585
    if self.op.beparams:
1586
      self.cluster.beparams[constants.PP_DEFAULT] = self.new_beparams
1587
    if self.op.nicparams:
1588
      self.cluster.nicparams[constants.PP_DEFAULT] = self.new_nicparams
1589

    
1590
    if self.op.candidate_pool_size is not None:
1591
      self.cluster.candidate_pool_size = self.op.candidate_pool_size
1592

    
1593
    self.cfg.Update(self.cluster)
1594

    
1595
    # we want to update nodes after the cluster so that if any errors
1596
    # happen, we have recorded and saved the cluster info
1597
    if self.op.candidate_pool_size is not None:
1598
      _AdjustCandidatePool(self)
1599

    
1600

    
1601
def _RedistributeAncillaryFiles(lu, additional_nodes=None):
1602
  """Distribute additional files which are part of the cluster configuration.
1603

1604
  ConfigWriter takes care of distributing the config and ssconf files, but
1605
  there are more files which should be distributed to all nodes. This function
1606
  makes sure those are copied.
1607

1608
  @param lu: calling logical unit
1609
  @param additional_nodes: list of nodes not in the config to distribute to
1610

1611
  """
1612
  # 1. Gather target nodes
1613
  myself = lu.cfg.GetNodeInfo(lu.cfg.GetMasterNode())
1614
  dist_nodes = lu.cfg.GetNodeList()
1615
  if additional_nodes is not None:
1616
    dist_nodes.extend(additional_nodes)
1617
  if myself.name in dist_nodes:
1618
    dist_nodes.remove(myself.name)
1619
  # 2. Gather files to distribute
1620
  dist_files = set([constants.ETC_HOSTS,
1621
                    constants.SSH_KNOWN_HOSTS_FILE,
1622
                    constants.RAPI_CERT_FILE,
1623
                    constants.RAPI_USERS_FILE,
1624
                   ])
1625

    
1626
  enabled_hypervisors = lu.cfg.GetClusterInfo().enabled_hypervisors
1627
  for hv_name in enabled_hypervisors:
1628
    hv_class = hypervisor.GetHypervisor(hv_name)
1629
    dist_files.update(hv_class.GetAncillaryFiles())
1630

    
1631
  # 3. Perform the files upload
1632
  for fname in dist_files:
1633
    if os.path.exists(fname):
1634
      result = lu.rpc.call_upload_file(dist_nodes, fname)
1635
      for to_node, to_result in result.items():
1636
         msg = to_result.RemoteFailMsg()
1637
         if msg:
1638
           msg = ("Copy of file %s to node %s failed: %s" %
1639
                   (fname, to_node, msg))
1640
           lu.proc.LogWarning(msg)
1641

    
1642

    
1643
class LURedistributeConfig(NoHooksLU):
1644
  """Force the redistribution of cluster configuration.
1645

1646
  This is a very simple LU.
1647

1648
  """
1649
  _OP_REQP = []
1650
  REQ_BGL = False
1651

    
1652
  def ExpandNames(self):
1653
    self.needed_locks = {
1654
      locking.LEVEL_NODE: locking.ALL_SET,
1655
    }
1656
    self.share_locks[locking.LEVEL_NODE] = 1
1657

    
1658
  def CheckPrereq(self):
1659
    """Check prerequisites.
1660

1661
    """
1662

    
1663
  def Exec(self, feedback_fn):
1664
    """Redistribute the configuration.
1665

1666
    """
1667
    self.cfg.Update(self.cfg.GetClusterInfo())
1668
    _RedistributeAncillaryFiles(self)
1669

    
1670

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

1674
  """
1675
  if not instance.disks:
1676
    return True
1677

    
1678
  if not oneshot:
1679
    lu.proc.LogInfo("Waiting for instance %s to sync disks." % instance.name)
1680

    
1681
  node = instance.primary_node
1682

    
1683
  for dev in instance.disks:
1684
    lu.cfg.SetDiskID(dev, node)
1685

    
1686
  retries = 0
1687
  while True:
1688
    max_time = 0
1689
    done = True
1690
    cumul_degraded = False
1691
    rstats = lu.rpc.call_blockdev_getmirrorstatus(node, instance.disks)
1692
    msg = rstats.RemoteFailMsg()
1693
    if msg:
1694
      lu.LogWarning("Can't get any data from node %s: %s", node, msg)
1695
      retries += 1
1696
      if retries >= 10:
1697
        raise errors.RemoteError("Can't contact node %s for mirror data,"
1698
                                 " aborting." % node)
1699
      time.sleep(6)
1700
      continue
1701
    rstats = rstats.payload
1702
    retries = 0
1703
    for i, mstat in enumerate(rstats):
1704
      if mstat is None:
1705
        lu.LogWarning("Can't compute data for node %s/%s",
1706
                           node, instance.disks[i].iv_name)
1707
        continue
1708
      # we ignore the ldisk parameter
1709
      perc_done, est_time, is_degraded, _ = mstat
1710
      cumul_degraded = cumul_degraded or (is_degraded and perc_done is None)
1711
      if perc_done is not None:
1712
        done = False
1713
        if est_time is not None:
1714
          rem_time = "%d estimated seconds remaining" % est_time
1715
          max_time = est_time
1716
        else:
1717
          rem_time = "no time estimate"
1718
        lu.proc.LogInfo("- device %s: %5.2f%% done, %s" %
1719
                        (instance.disks[i].iv_name, perc_done, rem_time))
1720
    if done or oneshot:
1721
      break
1722

    
1723
    time.sleep(min(60, max_time))
1724

    
1725
  if done:
1726
    lu.proc.LogInfo("Instance %s's disks are in sync." % instance.name)
1727
  return not cumul_degraded
1728

    
1729

    
1730
def _CheckDiskConsistency(lu, dev, node, on_primary, ldisk=False):
1731
  """Check that mirrors are not degraded.
1732

1733
  The ldisk parameter, if True, will change the test from the
1734
  is_degraded attribute (which represents overall non-ok status for
1735
  the device(s)) to the ldisk (representing the local storage status).
1736

1737
  """
1738
  lu.cfg.SetDiskID(dev, node)
1739
  if ldisk:
1740
    idx = 6
1741
  else:
1742
    idx = 5
1743

    
1744
  result = True
1745
  if on_primary or dev.AssembleOnSecondary():
1746
    rstats = lu.rpc.call_blockdev_find(node, dev)
1747
    msg = rstats.RemoteFailMsg()
1748
    if msg:
1749
      lu.LogWarning("Can't find disk on node %s: %s", node, msg)
1750
      result = False
1751
    elif not rstats.payload:
1752
      lu.LogWarning("Can't find disk on node %s", node)
1753
      result = False
1754
    else:
1755
      result = result and (not rstats.payload[idx])
1756
  if dev.children:
1757
    for child in dev.children:
1758
      result = result and _CheckDiskConsistency(lu, child, node, on_primary)
1759

    
1760
  return result
1761

    
1762

    
1763
class LUDiagnoseOS(NoHooksLU):
1764
  """Logical unit for OS diagnose/query.
1765

1766
  """
1767
  _OP_REQP = ["output_fields", "names"]
1768
  REQ_BGL = False
1769
  _FIELDS_STATIC = utils.FieldSet()
1770
  _FIELDS_DYNAMIC = utils.FieldSet("name", "valid", "node_status")
1771

    
1772
  def ExpandNames(self):
1773
    if self.op.names:
1774
      raise errors.OpPrereqError("Selective OS query not supported")
1775

    
1776
    _CheckOutputFields(static=self._FIELDS_STATIC,
1777
                       dynamic=self._FIELDS_DYNAMIC,
1778
                       selected=self.op.output_fields)
1779

    
1780
    # Lock all nodes, in shared mode
1781
    # Temporary removal of locks, should be reverted later
1782
    # TODO: reintroduce locks when they are lighter-weight
1783
    self.needed_locks = {}
1784
    #self.share_locks[locking.LEVEL_NODE] = 1
1785
    #self.needed_locks[locking.LEVEL_NODE] = locking.ALL_SET
1786

    
1787
  def CheckPrereq(self):
1788
    """Check prerequisites.
1789

1790
    """
1791

    
1792
  @staticmethod
1793
  def _DiagnoseByOS(node_list, rlist):
1794
    """Remaps a per-node return list into an a per-os per-node dictionary
1795

1796
    @param node_list: a list with the names of all nodes
1797
    @param rlist: a map with node names as keys and OS objects as values
1798

1799
    @rtype: dict
1800
    @return: a dictionary with osnames as keys and as value another map, with
1801
        nodes as keys and list of OS objects as values, eg::
1802

1803
          {"debian-etch": {"node1": [<object>,...],
1804
                           "node2": [<object>,]}
1805
          }
1806

1807
    """
1808
    all_os = {}
1809
    # we build here the list of nodes that didn't fail the RPC (at RPC
1810
    # level), so that nodes with a non-responding node daemon don't
1811
    # make all OSes invalid
1812
    good_nodes = [node_name for node_name in rlist
1813
                  if not rlist[node_name].failed]
1814
    for node_name, nr in rlist.iteritems():
1815
      if nr.failed or not nr.data:
1816
        continue
1817
      for os_obj in nr.data:
1818
        if os_obj.name not in all_os:
1819
          # build a list of nodes for this os containing empty lists
1820
          # for each node in node_list
1821
          all_os[os_obj.name] = {}
1822
          for nname in good_nodes:
1823
            all_os[os_obj.name][nname] = []
1824
        all_os[os_obj.name][node_name].append(os_obj)
1825
    return all_os
1826

    
1827
  def Exec(self, feedback_fn):
1828
    """Compute the list of OSes.
1829

1830
    """
1831
    valid_nodes = [node for node in self.cfg.GetOnlineNodeList()]
1832
    node_data = self.rpc.call_os_diagnose(valid_nodes)
1833
    if node_data == False:
1834
      raise errors.OpExecError("Can't gather the list of OSes")
1835
    pol = self._DiagnoseByOS(valid_nodes, node_data)
1836
    output = []
1837
    for os_name, os_data in pol.iteritems():
1838
      row = []
1839
      for field in self.op.output_fields:
1840
        if field == "name":
1841
          val = os_name
1842
        elif field == "valid":
1843
          val = utils.all([osl and osl[0] for osl in os_data.values()])
1844
        elif field == "node_status":
1845
          val = {}
1846
          for node_name, nos_list in os_data.iteritems():
1847
            val[node_name] = [(v.status, v.path) for v in nos_list]
1848
        else:
1849
          raise errors.ParameterError(field)
1850
        row.append(val)
1851
      output.append(row)
1852

    
1853
    return output
1854

    
1855

    
1856
class LURemoveNode(LogicalUnit):
1857
  """Logical unit for removing a node.
1858

1859
  """
1860
  HPATH = "node-remove"
1861
  HTYPE = constants.HTYPE_NODE
1862
  _OP_REQP = ["node_name"]
1863

    
1864
  def BuildHooksEnv(self):
1865
    """Build hooks env.
1866

1867
    This doesn't run on the target node in the pre phase as a failed
1868
    node would then be impossible to remove.
1869

1870
    """
1871
    env = {
1872
      "OP_TARGET": self.op.node_name,
1873
      "NODE_NAME": self.op.node_name,
1874
      }
1875
    all_nodes = self.cfg.GetNodeList()
1876
    all_nodes.remove(self.op.node_name)
1877
    return env, all_nodes, all_nodes
1878

    
1879
  def CheckPrereq(self):
1880
    """Check prerequisites.
1881

1882
    This checks:
1883
     - the node exists in the configuration
1884
     - it does not have primary or secondary instances
1885
     - it's not the master
1886

1887
    Any errors are signalled by raising errors.OpPrereqError.
1888

1889
    """
1890
    node = self.cfg.GetNodeInfo(self.cfg.ExpandNodeName(self.op.node_name))
1891
    if node is None:
1892
      raise errors.OpPrereqError, ("Node '%s' is unknown." % self.op.node_name)
1893

    
1894
    instance_list = self.cfg.GetInstanceList()
1895

    
1896
    masternode = self.cfg.GetMasterNode()
1897
    if node.name == masternode:
1898
      raise errors.OpPrereqError("Node is the master node,"
1899
                                 " you need to failover first.")
1900

    
1901
    for instance_name in instance_list:
1902
      instance = self.cfg.GetInstanceInfo(instance_name)
1903
      if node.name in instance.all_nodes:
1904
        raise errors.OpPrereqError("Instance %s is still running on the node,"
1905
                                   " please remove first." % instance_name)
1906
    self.op.node_name = node.name
1907
    self.node = node
1908

    
1909
  def Exec(self, feedback_fn):
1910
    """Removes the node from the cluster.
1911

1912
    """
1913
    node = self.node
1914
    logging.info("Stopping the node daemon and removing configs from node %s",
1915
                 node.name)
1916

    
1917
    self.context.RemoveNode(node.name)
1918

    
1919
    self.rpc.call_node_leave_cluster(node.name)
1920

    
1921
    # Promote nodes to master candidate as needed
1922
    _AdjustCandidatePool(self)
1923

    
1924

    
1925
class LUQueryNodes(NoHooksLU):
1926
  """Logical unit for querying nodes.
1927

1928
  """
1929
  _OP_REQP = ["output_fields", "names", "use_locking"]
1930
  REQ_BGL = False
1931
  _FIELDS_DYNAMIC = utils.FieldSet(
1932
    "dtotal", "dfree",
1933
    "mtotal", "mnode", "mfree",
1934
    "bootid",
1935
    "ctotal", "cnodes", "csockets",
1936
    )
1937

    
1938
  _FIELDS_STATIC = utils.FieldSet(
1939
    "name", "pinst_cnt", "sinst_cnt",
1940
    "pinst_list", "sinst_list",
1941
    "pip", "sip", "tags",
1942
    "serial_no",
1943
    "master_candidate",
1944
    "master",
1945
    "offline",
1946
    "drained",
1947
    )
1948

    
1949
  def ExpandNames(self):
1950
    _CheckOutputFields(static=self._FIELDS_STATIC,
1951
                       dynamic=self._FIELDS_DYNAMIC,
1952
                       selected=self.op.output_fields)
1953

    
1954
    self.needed_locks = {}
1955
    self.share_locks[locking.LEVEL_NODE] = 1
1956

    
1957
    if self.op.names:
1958
      self.wanted = _GetWantedNodes(self, self.op.names)
1959
    else:
1960
      self.wanted = locking.ALL_SET
1961

    
1962
    self.do_node_query = self._FIELDS_STATIC.NonMatching(self.op.output_fields)
1963
    self.do_locking = self.do_node_query and self.op.use_locking
1964
    if self.do_locking:
1965
      # if we don't request only static fields, we need to lock the nodes
1966
      self.needed_locks[locking.LEVEL_NODE] = self.wanted
1967

    
1968

    
1969
  def CheckPrereq(self):
1970
    """Check prerequisites.
1971

1972
    """
1973
    # The validation of the node list is done in the _GetWantedNodes,
1974
    # if non empty, and if empty, there's no validation to do
1975
    pass
1976

    
1977
  def Exec(self, feedback_fn):
1978
    """Computes the list of nodes and their attributes.
1979

1980
    """
1981
    all_info = self.cfg.GetAllNodesInfo()
1982
    if self.do_locking:
1983
      nodenames = self.acquired_locks[locking.LEVEL_NODE]
1984
    elif self.wanted != locking.ALL_SET:
1985
      nodenames = self.wanted
1986
      missing = set(nodenames).difference(all_info.keys())
1987
      if missing:
1988
        raise errors.OpExecError(
1989
          "Some nodes were removed before retrieving their data: %s" % missing)
1990
    else:
1991
      nodenames = all_info.keys()
1992

    
1993
    nodenames = utils.NiceSort(nodenames)
1994
    nodelist = [all_info[name] for name in nodenames]
1995

    
1996
    # begin data gathering
1997

    
1998
    if self.do_node_query:
1999
      live_data = {}
2000
      node_data = self.rpc.call_node_info(nodenames, self.cfg.GetVGName(),
2001
                                          self.cfg.GetHypervisorType())
2002
      for name in nodenames:
2003
        nodeinfo = node_data[name]
2004
        if not nodeinfo.RemoteFailMsg() and nodeinfo.payload:
2005
          nodeinfo = nodeinfo.payload
2006
          fn = utils.TryConvert
2007
          live_data[name] = {
2008
            "mtotal": fn(int, nodeinfo.get('memory_total', None)),
2009
            "mnode": fn(int, nodeinfo.get('memory_dom0', None)),
2010
            "mfree": fn(int, nodeinfo.get('memory_free', None)),
2011
            "dtotal": fn(int, nodeinfo.get('vg_size', None)),
2012
            "dfree": fn(int, nodeinfo.get('vg_free', None)),
2013
            "ctotal": fn(int, nodeinfo.get('cpu_total', None)),
2014
            "bootid": nodeinfo.get('bootid', None),
2015
            "cnodes": fn(int, nodeinfo.get('cpu_nodes', None)),
2016
            "csockets": fn(int, nodeinfo.get('cpu_sockets', None)),
2017
            }
2018
        else:
2019
          live_data[name] = {}
2020
    else:
2021
      live_data = dict.fromkeys(nodenames, {})
2022

    
2023
    node_to_primary = dict([(name, set()) for name in nodenames])
2024
    node_to_secondary = dict([(name, set()) for name in nodenames])
2025

    
2026
    inst_fields = frozenset(("pinst_cnt", "pinst_list",
2027
                             "sinst_cnt", "sinst_list"))
2028
    if inst_fields & frozenset(self.op.output_fields):
2029
      instancelist = self.cfg.GetInstanceList()
2030

    
2031
      for instance_name in instancelist:
2032
        inst = self.cfg.GetInstanceInfo(instance_name)
2033
        if inst.primary_node in node_to_primary:
2034
          node_to_primary[inst.primary_node].add(inst.name)
2035
        for secnode in inst.secondary_nodes:
2036
          if secnode in node_to_secondary:
2037
            node_to_secondary[secnode].add(inst.name)
2038

    
2039
    master_node = self.cfg.GetMasterNode()
2040

    
2041
    # end data gathering
2042

    
2043
    output = []
2044
    for node in nodelist:
2045
      node_output = []
2046
      for field in self.op.output_fields:
2047
        if field == "name":
2048
          val = node.name
2049
        elif field == "pinst_list":
2050
          val = list(node_to_primary[node.name])
2051
        elif field == "sinst_list":
2052
          val = list(node_to_secondary[node.name])
2053
        elif field == "pinst_cnt":
2054
          val = len(node_to_primary[node.name])
2055
        elif field == "sinst_cnt":
2056
          val = len(node_to_secondary[node.name])
2057
        elif field == "pip":
2058
          val = node.primary_ip
2059
        elif field == "sip":
2060
          val = node.secondary_ip
2061
        elif field == "tags":
2062
          val = list(node.GetTags())
2063
        elif field == "serial_no":
2064
          val = node.serial_no
2065
        elif field == "master_candidate":
2066
          val = node.master_candidate
2067
        elif field == "master":
2068
          val = node.name == master_node
2069
        elif field == "offline":
2070
          val = node.offline
2071
        elif field == "drained":
2072
          val = node.drained
2073
        elif self._FIELDS_DYNAMIC.Matches(field):
2074
          val = live_data[node.name].get(field, None)
2075
        else:
2076
          raise errors.ParameterError(field)
2077
        node_output.append(val)
2078
      output.append(node_output)
2079

    
2080
    return output
2081

    
2082

    
2083
class LUQueryNodeVolumes(NoHooksLU):
2084
  """Logical unit for getting volumes on node(s).
2085

2086
  """
2087
  _OP_REQP = ["nodes", "output_fields"]
2088
  REQ_BGL = False
2089
  _FIELDS_DYNAMIC = utils.FieldSet("phys", "vg", "name", "size", "instance")
2090
  _FIELDS_STATIC = utils.FieldSet("node")
2091

    
2092
  def ExpandNames(self):
2093
    _CheckOutputFields(static=self._FIELDS_STATIC,
2094
                       dynamic=self._FIELDS_DYNAMIC,
2095
                       selected=self.op.output_fields)
2096

    
2097
    self.needed_locks = {}
2098
    self.share_locks[locking.LEVEL_NODE] = 1
2099
    if not self.op.nodes:
2100
      self.needed_locks[locking.LEVEL_NODE] = locking.ALL_SET
2101
    else:
2102
      self.needed_locks[locking.LEVEL_NODE] = \
2103
        _GetWantedNodes(self, self.op.nodes)
2104

    
2105
  def CheckPrereq(self):
2106
    """Check prerequisites.
2107

2108
    This checks that the fields required are valid output fields.
2109

2110
    """
2111
    self.nodes = self.acquired_locks[locking.LEVEL_NODE]
2112

    
2113
  def Exec(self, feedback_fn):
2114
    """Computes the list of nodes and their attributes.
2115

2116
    """
2117
    nodenames = self.nodes
2118
    volumes = self.rpc.call_node_volumes(nodenames)
2119

    
2120
    ilist = [self.cfg.GetInstanceInfo(iname) for iname
2121
             in self.cfg.GetInstanceList()]
2122

    
2123
    lv_by_node = dict([(inst, inst.MapLVsByNode()) for inst in ilist])
2124

    
2125
    output = []
2126
    for node in nodenames:
2127
      if node not in volumes or volumes[node].failed or not volumes[node].data:
2128
        continue
2129

    
2130
      node_vols = volumes[node].data[:]
2131
      node_vols.sort(key=lambda vol: vol['dev'])
2132

    
2133
      for vol in node_vols:
2134
        node_output = []
2135
        for field in self.op.output_fields:
2136
          if field == "node":
2137
            val = node
2138
          elif field == "phys":
2139
            val = vol['dev']
2140
          elif field == "vg":
2141
            val = vol['vg']
2142
          elif field == "name":
2143
            val = vol['name']
2144
          elif field == "size":
2145
            val = int(float(vol['size']))
2146
          elif field == "instance":
2147
            for inst in ilist:
2148
              if node not in lv_by_node[inst]:
2149
                continue
2150
              if vol['name'] in lv_by_node[inst][node]:
2151
                val = inst.name
2152
                break
2153
            else:
2154
              val = '-'
2155
          else:
2156
            raise errors.ParameterError(field)
2157
          node_output.append(str(val))
2158

    
2159
        output.append(node_output)
2160

    
2161
    return output
2162

    
2163

    
2164
class LUAddNode(LogicalUnit):
2165
  """Logical unit for adding node to the cluster.
2166

2167
  """
2168
  HPATH = "node-add"
2169
  HTYPE = constants.HTYPE_NODE
2170
  _OP_REQP = ["node_name"]
2171

    
2172
  def BuildHooksEnv(self):
2173
    """Build hooks env.
2174

2175
    This will run on all nodes before, and on all nodes + the new node after.
2176

2177
    """
2178
    env = {
2179
      "OP_TARGET": self.op.node_name,
2180
      "NODE_NAME": self.op.node_name,
2181
      "NODE_PIP": self.op.primary_ip,
2182
      "NODE_SIP": self.op.secondary_ip,
2183
      }
2184
    nodes_0 = self.cfg.GetNodeList()
2185
    nodes_1 = nodes_0 + [self.op.node_name, ]
2186
    return env, nodes_0, nodes_1
2187

    
2188
  def CheckPrereq(self):
2189
    """Check prerequisites.
2190

2191
    This checks:
2192
     - the new node is not already in the config
2193
     - it is resolvable
2194
     - its parameters (single/dual homed) matches the cluster
2195

2196
    Any errors are signalled by raising errors.OpPrereqError.
2197

2198
    """
2199
    node_name = self.op.node_name
2200
    cfg = self.cfg
2201

    
2202
    dns_data = utils.HostInfo(node_name)
2203

    
2204
    node = dns_data.name
2205
    primary_ip = self.op.primary_ip = dns_data.ip
2206
    secondary_ip = getattr(self.op, "secondary_ip", None)
2207
    if secondary_ip is None:
2208
      secondary_ip = primary_ip
2209
    if not utils.IsValidIP(secondary_ip):
2210
      raise errors.OpPrereqError("Invalid secondary IP given")
2211
    self.op.secondary_ip = secondary_ip
2212

    
2213
    node_list = cfg.GetNodeList()
2214
    if not self.op.readd and node in node_list:
2215
      raise errors.OpPrereqError("Node %s is already in the configuration" %
2216
                                 node)
2217
    elif self.op.readd and node not in node_list:
2218
      raise errors.OpPrereqError("Node %s is not in the configuration" % node)
2219

    
2220
    for existing_node_name in node_list:
2221
      existing_node = cfg.GetNodeInfo(existing_node_name)
2222

    
2223
      if self.op.readd and node == existing_node_name:
2224
        if (existing_node.primary_ip != primary_ip or
2225
            existing_node.secondary_ip != secondary_ip):
2226
          raise errors.OpPrereqError("Readded node doesn't have the same IP"
2227
                                     " address configuration as before")
2228
        continue
2229

    
2230
      if (existing_node.primary_ip == primary_ip or
2231
          existing_node.secondary_ip == primary_ip or
2232
          existing_node.primary_ip == secondary_ip or
2233
          existing_node.secondary_ip == secondary_ip):
2234
        raise errors.OpPrereqError("New node ip address(es) conflict with"
2235
                                   " existing node %s" % existing_node.name)
2236

    
2237
    # check that the type of the node (single versus dual homed) is the
2238
    # same as for the master
2239
    myself = cfg.GetNodeInfo(self.cfg.GetMasterNode())
2240
    master_singlehomed = myself.secondary_ip == myself.primary_ip
2241
    newbie_singlehomed = secondary_ip == primary_ip
2242
    if master_singlehomed != newbie_singlehomed:
2243
      if master_singlehomed:
2244
        raise errors.OpPrereqError("The master has no private ip but the"
2245
                                   " new node has one")
2246
      else:
2247
        raise errors.OpPrereqError("The master has a private ip but the"
2248
                                   " new node doesn't have one")
2249

    
2250
    # checks reachablity
2251
    if not utils.TcpPing(primary_ip, constants.DEFAULT_NODED_PORT):
2252
      raise errors.OpPrereqError("Node not reachable by ping")
2253

    
2254
    if not newbie_singlehomed:
2255
      # check reachability from my secondary ip to newbie's secondary ip
2256
      if not utils.TcpPing(secondary_ip, constants.DEFAULT_NODED_PORT,
2257
                           source=myself.secondary_ip):
2258
        raise errors.OpPrereqError("Node secondary ip not reachable by TCP"
2259
                                   " based ping to noded port")
2260

    
2261
    cp_size = self.cfg.GetClusterInfo().candidate_pool_size
2262
    mc_now, _ = self.cfg.GetMasterCandidateStats()
2263
    master_candidate = mc_now < cp_size
2264

    
2265
    self.new_node = objects.Node(name=node,
2266
                                 primary_ip=primary_ip,
2267
                                 secondary_ip=secondary_ip,
2268
                                 master_candidate=master_candidate,
2269
                                 offline=False, drained=False)
2270

    
2271
  def Exec(self, feedback_fn):
2272
    """Adds the new node to the cluster.
2273

2274
    """
2275
    new_node = self.new_node
2276
    node = new_node.name
2277

    
2278
    # check connectivity
2279
    result = self.rpc.call_version([node])[node]
2280
    result.Raise()
2281
    if result.data:
2282
      if constants.PROTOCOL_VERSION == result.data:
2283
        logging.info("Communication to node %s fine, sw version %s match",
2284
                     node, result.data)
2285
      else:
2286
        raise errors.OpExecError("Version mismatch master version %s,"
2287
                                 " node version %s" %
2288
                                 (constants.PROTOCOL_VERSION, result.data))
2289
    else:
2290
      raise errors.OpExecError("Cannot get version from the new node")
2291

    
2292
    # setup ssh on node
2293
    logging.info("Copy ssh key to node %s", node)
2294
    priv_key, pub_key, _ = ssh.GetUserFiles(constants.GANETI_RUNAS)
2295
    keyarray = []
2296
    keyfiles = [constants.SSH_HOST_DSA_PRIV, constants.SSH_HOST_DSA_PUB,
2297
                constants.SSH_HOST_RSA_PRIV, constants.SSH_HOST_RSA_PUB,
2298
                priv_key, pub_key]
2299

    
2300
    for i in keyfiles:
2301
      f = open(i, 'r')
2302
      try:
2303
        keyarray.append(f.read())
2304
      finally:
2305
        f.close()
2306

    
2307
    result = self.rpc.call_node_add(node, keyarray[0], keyarray[1],
2308
                                    keyarray[2],
2309
                                    keyarray[3], keyarray[4], keyarray[5])
2310

    
2311
    msg = result.RemoteFailMsg()
2312
    if msg:
2313
      raise errors.OpExecError("Cannot transfer ssh keys to the"
2314
                               " new node: %s" % msg)
2315

    
2316
    # Add node to our /etc/hosts, and add key to known_hosts
2317
    if self.cfg.GetClusterInfo().modify_etc_hosts:
2318
      utils.AddHostToEtcHosts(new_node.name)
2319

    
2320
    if new_node.secondary_ip != new_node.primary_ip:
2321
      result = self.rpc.call_node_has_ip_address(new_node.name,
2322
                                                 new_node.secondary_ip)
2323
      msg = result.RemoteFailMsg()
2324
      if msg:
2325
        raise errors.OpPrereqError("Failure checking secondary ip"
2326
                                   " on node %s: %s" % (new_node.name, msg))
2327
      if not result.payload:
2328
        raise errors.OpExecError("Node claims it doesn't have the secondary ip"
2329
                                 " you gave (%s). Please fix and re-run this"
2330
                                 " command." % new_node.secondary_ip)
2331

    
2332
    node_verify_list = [self.cfg.GetMasterNode()]
2333
    node_verify_param = {
2334
      'nodelist': [node],
2335
      # TODO: do a node-net-test as well?
2336
    }
2337

    
2338
    result = self.rpc.call_node_verify(node_verify_list, node_verify_param,
2339
                                       self.cfg.GetClusterName())
2340
    for verifier in node_verify_list:
2341
      msg = result[verifier].RemoteFailMsg()
2342
      if msg:
2343
        raise errors.OpExecError("Cannot communicate with node %s: %s" %
2344
                                 (verifier, msg))
2345
      nl_payload = result[verifier].payload['nodelist']
2346
      if nl_payload:
2347
        for failed in nl_payload:
2348
          feedback_fn("ssh/hostname verification failed %s -> %s" %
2349
                      (verifier, nl_payload[failed]))
2350
        raise errors.OpExecError("ssh/hostname verification failed.")
2351

    
2352
    if self.op.readd:
2353
      _RedistributeAncillaryFiles(self)
2354
      self.context.ReaddNode(new_node)
2355
    else:
2356
      _RedistributeAncillaryFiles(self, additional_nodes=[node])
2357
      self.context.AddNode(new_node)
2358

    
2359

    
2360
class LUSetNodeParams(LogicalUnit):
2361
  """Modifies the parameters of a node.
2362

2363
  """
2364
  HPATH = "node-modify"
2365
  HTYPE = constants.HTYPE_NODE
2366
  _OP_REQP = ["node_name"]
2367
  REQ_BGL = False
2368

    
2369
  def CheckArguments(self):
2370
    node_name = self.cfg.ExpandNodeName(self.op.node_name)
2371
    if node_name is None:
2372
      raise errors.OpPrereqError("Invalid node name '%s'" % self.op.node_name)
2373
    self.op.node_name = node_name
2374
    _CheckBooleanOpField(self.op, 'master_candidate')
2375
    _CheckBooleanOpField(self.op, 'offline')
2376
    _CheckBooleanOpField(self.op, 'drained')
2377
    all_mods = [self.op.offline, self.op.master_candidate, self.op.drained]
2378
    if all_mods.count(None) == 3:
2379
      raise errors.OpPrereqError("Please pass at least one modification")
2380
    if all_mods.count(True) > 1:
2381
      raise errors.OpPrereqError("Can't set the node into more than one"
2382
                                 " state at the same time")
2383

    
2384
  def ExpandNames(self):
2385
    self.needed_locks = {locking.LEVEL_NODE: self.op.node_name}
2386

    
2387
  def BuildHooksEnv(self):
2388
    """Build hooks env.
2389

2390
    This runs on the master node.
2391

2392
    """
2393
    env = {
2394
      "OP_TARGET": self.op.node_name,
2395
      "MASTER_CANDIDATE": str(self.op.master_candidate),
2396
      "OFFLINE": str(self.op.offline),
2397
      "DRAINED": str(self.op.drained),
2398
      }
2399
    nl = [self.cfg.GetMasterNode(),
2400
          self.op.node_name]
2401
    return env, nl, nl
2402

    
2403
  def CheckPrereq(self):
2404
    """Check prerequisites.
2405

2406
    This only checks the instance list against the existing names.
2407

2408
    """
2409
    node = self.node = self.cfg.GetNodeInfo(self.op.node_name)
2410

    
2411
    if ((self.op.master_candidate == False or self.op.offline == True or
2412
         self.op.drained == True) and node.master_candidate):
2413
      # we will demote the node from master_candidate
2414
      if self.op.node_name == self.cfg.GetMasterNode():
2415
        raise errors.OpPrereqError("The master node has to be a"
2416
                                   " master candidate, online and not drained")
2417
      cp_size = self.cfg.GetClusterInfo().candidate_pool_size
2418
      num_candidates, _ = self.cfg.GetMasterCandidateStats()
2419
      if num_candidates <= cp_size:
2420
        msg = ("Not enough master candidates (desired"
2421
               " %d, new value will be %d)" % (cp_size, num_candidates-1))
2422
        if self.op.force:
2423
          self.LogWarning(msg)
2424
        else:
2425
          raise errors.OpPrereqError(msg)
2426

    
2427
    if (self.op.master_candidate == True and
2428
        ((node.offline and not self.op.offline == False) or
2429
         (node.drained and not self.op.drained == False))):
2430
      raise errors.OpPrereqError("Node '%s' is offline or drained, can't set"
2431
                                 " to master_candidate" % node.name)
2432

    
2433
    return
2434

    
2435
  def Exec(self, feedback_fn):
2436
    """Modifies a node.
2437

2438
    """
2439
    node = self.node
2440

    
2441
    result = []
2442
    changed_mc = False
2443

    
2444
    if self.op.offline is not None:
2445
      node.offline = self.op.offline
2446
      result.append(("offline", str(self.op.offline)))
2447
      if self.op.offline == True:
2448
        if node.master_candidate:
2449
          node.master_candidate = False
2450
          changed_mc = True
2451
          result.append(("master_candidate", "auto-demotion due to offline"))
2452
        if node.drained:
2453
          node.drained = False
2454
          result.append(("drained", "clear drained status due to offline"))
2455

    
2456
    if self.op.master_candidate is not None:
2457
      node.master_candidate = self.op.master_candidate
2458
      changed_mc = True
2459
      result.append(("master_candidate", str(self.op.master_candidate)))
2460
      if self.op.master_candidate == False:
2461
        rrc = self.rpc.call_node_demote_from_mc(node.name)
2462
        msg = rrc.RemoteFailMsg()
2463
        if msg:
2464
          self.LogWarning("Node failed to demote itself: %s" % msg)
2465

    
2466
    if self.op.drained is not None:
2467
      node.drained = self.op.drained
2468
      result.append(("drained", str(self.op.drained)))
2469
      if self.op.drained == True:
2470
        if node.master_candidate:
2471
          node.master_candidate = False
2472
          changed_mc = True
2473
          result.append(("master_candidate", "auto-demotion due to drain"))
2474
        if node.offline:
2475
          node.offline = False
2476
          result.append(("offline", "clear offline status due to drain"))
2477

    
2478
    # this will trigger configuration file update, if needed
2479
    self.cfg.Update(node)
2480
    # this will trigger job queue propagation or cleanup
2481
    if changed_mc:
2482
      self.context.ReaddNode(node)
2483

    
2484
    return result
2485

    
2486

    
2487
class LUPowercycleNode(NoHooksLU):
2488
  """Powercycles a node.
2489

2490
  """
2491
  _OP_REQP = ["node_name", "force"]
2492
  REQ_BGL = False
2493

    
2494
  def CheckArguments(self):
2495
    node_name = self.cfg.ExpandNodeName(self.op.node_name)
2496
    if node_name is None:
2497
      raise errors.OpPrereqError("Invalid node name '%s'" % self.op.node_name)
2498
    self.op.node_name = node_name
2499
    if node_name == self.cfg.GetMasterNode() and not self.op.force:
2500
      raise errors.OpPrereqError("The node is the master and the force"
2501
                                 " parameter was not set")
2502

    
2503
  def ExpandNames(self):
2504
    """Locking for PowercycleNode.
2505

2506
    This is a last-resource option and shouldn't block on other
2507
    jobs. Therefore, we grab no locks.
2508

2509
    """
2510
    self.needed_locks = {}
2511

    
2512
  def CheckPrereq(self):
2513
    """Check prerequisites.
2514

2515
    This LU has no prereqs.
2516

2517
    """
2518
    pass
2519

    
2520
  def Exec(self, feedback_fn):
2521
    """Reboots a node.
2522

2523
    """
2524
    result = self.rpc.call_node_powercycle(self.op.node_name,
2525
                                           self.cfg.GetHypervisorType())
2526
    msg = result.RemoteFailMsg()
2527
    if msg:
2528
      raise errors.OpExecError("Failed to schedule the reboot: %s" % msg)
2529
    return result.payload
2530

    
2531

    
2532
class LUQueryClusterInfo(NoHooksLU):
2533
  """Query cluster configuration.
2534

2535
  """
2536
  _OP_REQP = []
2537
  REQ_BGL = False
2538

    
2539
  def ExpandNames(self):
2540
    self.needed_locks = {}
2541

    
2542
  def CheckPrereq(self):
2543
    """No prerequsites needed for this LU.
2544

2545
    """
2546
    pass
2547

    
2548
  def Exec(self, feedback_fn):
2549
    """Return cluster config.
2550

2551
    """
2552
    cluster = self.cfg.GetClusterInfo()
2553
    result = {
2554
      "software_version": constants.RELEASE_VERSION,
2555
      "protocol_version": constants.PROTOCOL_VERSION,
2556
      "config_version": constants.CONFIG_VERSION,
2557
      "os_api_version": constants.OS_API_VERSION,
2558
      "export_version": constants.EXPORT_VERSION,
2559
      "architecture": (platform.architecture()[0], platform.machine()),
2560
      "name": cluster.cluster_name,
2561
      "master": cluster.master_node,
2562
      "default_hypervisor": cluster.default_hypervisor,
2563
      "enabled_hypervisors": cluster.enabled_hypervisors,
2564
      "hvparams": dict([(hypervisor, cluster.hvparams[hypervisor])
2565
                        for hypervisor in cluster.enabled_hypervisors]),
2566
      "beparams": cluster.beparams,
2567
      "nicparams": cluster.nicparams,
2568
      "candidate_pool_size": cluster.candidate_pool_size,
2569
      "master_netdev": cluster.master_netdev,
2570
      "volume_group_name": cluster.volume_group_name,
2571
      "file_storage_dir": cluster.file_storage_dir,
2572
      }
2573

    
2574
    return result
2575

    
2576

    
2577
class LUQueryConfigValues(NoHooksLU):
2578
  """Return configuration values.
2579

2580
  """
2581
  _OP_REQP = []
2582
  REQ_BGL = False
2583
  _FIELDS_DYNAMIC = utils.FieldSet()
2584
  _FIELDS_STATIC = utils.FieldSet("cluster_name", "master_node", "drain_flag")
2585

    
2586
  def ExpandNames(self):
2587
    self.needed_locks = {}
2588

    
2589
    _CheckOutputFields(static=self._FIELDS_STATIC,
2590
                       dynamic=self._FIELDS_DYNAMIC,
2591
                       selected=self.op.output_fields)
2592

    
2593
  def CheckPrereq(self):
2594
    """No prerequisites.
2595

2596
    """
2597
    pass
2598

    
2599
  def Exec(self, feedback_fn):
2600
    """Dump a representation of the cluster config to the standard output.
2601

2602
    """
2603
    values = []
2604
    for field in self.op.output_fields:
2605
      if field == "cluster_name":
2606
        entry = self.cfg.GetClusterName()
2607
      elif field == "master_node":
2608
        entry = self.cfg.GetMasterNode()
2609
      elif field == "drain_flag":
2610
        entry = os.path.exists(constants.JOB_QUEUE_DRAIN_FILE)
2611
      else:
2612
        raise errors.ParameterError(field)
2613
      values.append(entry)
2614
    return values
2615

    
2616

    
2617
class LUActivateInstanceDisks(NoHooksLU):
2618
  """Bring up an instance's disks.
2619

2620
  """
2621
  _OP_REQP = ["instance_name"]
2622
  REQ_BGL = False
2623

    
2624
  def ExpandNames(self):
2625
    self._ExpandAndLockInstance()
2626
    self.needed_locks[locking.LEVEL_NODE] = []
2627
    self.recalculate_locks[locking.LEVEL_NODE] = constants.LOCKS_REPLACE
2628

    
2629
  def DeclareLocks(self, level):
2630
    if level == locking.LEVEL_NODE:
2631
      self._LockInstancesNodes()
2632

    
2633
  def CheckPrereq(self):
2634
    """Check prerequisites.
2635

2636
    This checks that the instance is in the cluster.
2637

2638
    """
2639
    self.instance = self.cfg.GetInstanceInfo(self.op.instance_name)
2640
    assert self.instance is not None, \
2641
      "Cannot retrieve locked instance %s" % self.op.instance_name
2642
    _CheckNodeOnline(self, self.instance.primary_node)
2643

    
2644
  def Exec(self, feedback_fn):
2645
    """Activate the disks.
2646

2647
    """
2648
    disks_ok, disks_info = _AssembleInstanceDisks(self, self.instance)
2649
    if not disks_ok:
2650
      raise errors.OpExecError("Cannot activate block devices")
2651

    
2652
    return disks_info
2653

    
2654

    
2655
def _AssembleInstanceDisks(lu, instance, ignore_secondaries=False):
2656
  """Prepare the block devices for an instance.
2657

2658
  This sets up the block devices on all nodes.
2659

2660
  @type lu: L{LogicalUnit}
2661
  @param lu: the logical unit on whose behalf we execute
2662
  @type instance: L{objects.Instance}
2663
  @param instance: the instance for whose disks we assemble
2664
  @type ignore_secondaries: boolean
2665
  @param ignore_secondaries: if true, errors on secondary nodes
2666
      won't result in an error return from the function
2667
  @return: False if the operation failed, otherwise a list of
2668
      (host, instance_visible_name, node_visible_name)
2669
      with the mapping from node devices to instance devices
2670

2671
  """
2672
  device_info = []
2673
  disks_ok = True
2674
  iname = instance.name
2675
  # With the two passes mechanism we try to reduce the window of
2676
  # opportunity for the race condition of switching DRBD to primary
2677
  # before handshaking occured, but we do not eliminate it
2678

    
2679
  # The proper fix would be to wait (with some limits) until the
2680
  # connection has been made and drbd transitions from WFConnection
2681
  # into any other network-connected state (Connected, SyncTarget,
2682
  # SyncSource, etc.)
2683

    
2684
  # 1st pass, assemble on all nodes in secondary mode
2685
  for inst_disk in instance.disks:
2686
    for node, node_disk in inst_disk.ComputeNodeTree(instance.primary_node):
2687
      lu.cfg.SetDiskID(node_disk, node)
2688
      result = lu.rpc.call_blockdev_assemble(node, node_disk, iname, False)
2689
      msg = result.RemoteFailMsg()
2690
      if msg:
2691
        lu.proc.LogWarning("Could not prepare block device %s on node %s"
2692
                           " (is_primary=False, pass=1): %s",
2693
                           inst_disk.iv_name, node, msg)
2694
        if not ignore_secondaries:
2695
          disks_ok = False
2696

    
2697
  # FIXME: race condition on drbd migration to primary
2698

    
2699
  # 2nd pass, do only the primary node
2700
  for inst_disk in instance.disks:
2701
    for node, node_disk in inst_disk.ComputeNodeTree(instance.primary_node):
2702
      if node != instance.primary_node:
2703
        continue
2704
      lu.cfg.SetDiskID(node_disk, node)
2705
      result = lu.rpc.call_blockdev_assemble(node, node_disk, iname, True)
2706
      msg = result.RemoteFailMsg()
2707
      if msg:
2708
        lu.proc.LogWarning("Could not prepare block device %s on node %s"
2709
                           " (is_primary=True, pass=2): %s",
2710
                           inst_disk.iv_name, node, msg)
2711
        disks_ok = False
2712
    device_info.append((instance.primary_node, inst_disk.iv_name,
2713
                        result.payload))
2714

    
2715
  # leave the disks configured for the primary node
2716
  # this is a workaround that would be fixed better by
2717
  # improving the logical/physical id handling
2718
  for disk in instance.disks:
2719
    lu.cfg.SetDiskID(disk, instance.primary_node)
2720

    
2721
  return disks_ok, device_info
2722

    
2723

    
2724
def _StartInstanceDisks(lu, instance, force):
2725
  """Start the disks of an instance.
2726

2727
  """
2728
  disks_ok, dummy = _AssembleInstanceDisks(lu, instance,
2729
                                           ignore_secondaries=force)
2730
  if not disks_ok:
2731
    _ShutdownInstanceDisks(lu, instance)
2732
    if force is not None and not force:
2733
      lu.proc.LogWarning("", hint="If the message above refers to a"
2734
                         " secondary node,"
2735
                         " you can retry the operation using '--force'.")
2736
    raise errors.OpExecError("Disk consistency error")
2737

    
2738

    
2739
class LUDeactivateInstanceDisks(NoHooksLU):
2740
  """Shutdown an instance's disks.
2741

2742
  """
2743
  _OP_REQP = ["instance_name"]
2744
  REQ_BGL = False
2745

    
2746
  def ExpandNames(self):
2747
    self._ExpandAndLockInstance()
2748
    self.needed_locks[locking.LEVEL_NODE] = []
2749
    self.recalculate_locks[locking.LEVEL_NODE] = constants.LOCKS_REPLACE
2750

    
2751
  def DeclareLocks(self, level):
2752
    if level == locking.LEVEL_NODE:
2753
      self._LockInstancesNodes()
2754

    
2755
  def CheckPrereq(self):
2756
    """Check prerequisites.
2757

2758
    This checks that the instance is in the cluster.
2759

2760
    """
2761
    self.instance = self.cfg.GetInstanceInfo(self.op.instance_name)
2762
    assert self.instance is not None, \
2763
      "Cannot retrieve locked instance %s" % self.op.instance_name
2764

    
2765
  def Exec(self, feedback_fn):
2766
    """Deactivate the disks
2767

2768
    """
2769
    instance = self.instance
2770
    _SafeShutdownInstanceDisks(self, instance)
2771

    
2772

    
2773
def _SafeShutdownInstanceDisks(lu, instance):
2774
  """Shutdown block devices of an instance.
2775

2776
  This function checks if an instance is running, before calling
2777
  _ShutdownInstanceDisks.
2778

2779
  """
2780
  pnode = instance.primary_node
2781
  ins_l = lu.rpc.call_instance_list([pnode], [instance.hypervisor])
2782
  ins_l = ins_l[pnode]
2783
  msg = ins_l.RemoteFailMsg()
2784
  if msg:
2785
    raise errors.OpExecError("Can't contact node %s: %s" % (pnode, msg))
2786

    
2787
  if instance.name in ins_l.payload:
2788
    raise errors.OpExecError("Instance is running, can't shutdown"
2789
                             " block devices.")
2790

    
2791
  _ShutdownInstanceDisks(lu, instance)
2792

    
2793

    
2794
def _ShutdownInstanceDisks(lu, instance, ignore_primary=False):
2795
  """Shutdown block devices of an instance.
2796

2797
  This does the shutdown on all nodes of the instance.
2798

2799
  If the ignore_primary is false, errors on the primary node are
2800
  ignored.
2801

2802
  """
2803
  all_result = True
2804
  for disk in instance.disks:
2805
    for node, top_disk in disk.ComputeNodeTree(instance.primary_node):
2806
      lu.cfg.SetDiskID(top_disk, node)
2807
      result = lu.rpc.call_blockdev_shutdown(node, top_disk)
2808
      msg = result.RemoteFailMsg()
2809
      if msg:
2810
        lu.LogWarning("Could not shutdown block device %s on node %s: %s",
2811
                      disk.iv_name, node, msg)
2812
        if not ignore_primary or node != instance.primary_node:
2813
          all_result = False
2814
  return all_result
2815

    
2816

    
2817
def _CheckNodeFreeMemory(lu, node, reason, requested, hypervisor_name):
2818
  """Checks if a node has enough free memory.
2819

2820
  This function check if a given node has the needed amount of free
2821
  memory. In case the node has less memory or we cannot get the
2822
  information from the node, this function raise an OpPrereqError
2823
  exception.
2824

2825
  @type lu: C{LogicalUnit}
2826
  @param lu: a logical unit from which we get configuration data
2827
  @type node: C{str}
2828
  @param node: the node to check
2829
  @type reason: C{str}
2830
  @param reason: string to use in the error message
2831
  @type requested: C{int}
2832
  @param requested: the amount of memory in MiB to check for
2833
  @type hypervisor_name: C{str}
2834
  @param hypervisor_name: the hypervisor to ask for memory stats
2835
  @raise errors.OpPrereqError: if the node doesn't have enough memory, or
2836
      we cannot check the node
2837

2838
  """
2839
  nodeinfo = lu.rpc.call_node_info([node], lu.cfg.GetVGName(), hypervisor_name)
2840
  msg = nodeinfo[node].RemoteFailMsg()
2841
  if msg:
2842
    raise errors.OpPrereqError("Can't get data from node %s: %s" % (node, msg))
2843
  free_mem = nodeinfo[node].payload.get('memory_free', None)
2844
  if not isinstance(free_mem, int):
2845
    raise errors.OpPrereqError("Can't compute free memory on node %s, result"
2846
                               " was '%s'" % (node, free_mem))
2847
  if requested > free_mem:
2848
    raise errors.OpPrereqError("Not enough memory on node %s for %s:"
2849
                               " needed %s MiB, available %s MiB" %
2850
                               (node, reason, requested, free_mem))
2851

    
2852

    
2853
class LUStartupInstance(LogicalUnit):
2854
  """Starts an instance.
2855

2856
  """
2857
  HPATH = "instance-start"
2858
  HTYPE = constants.HTYPE_INSTANCE
2859
  _OP_REQP = ["instance_name", "force"]
2860
  REQ_BGL = False
2861

    
2862
  def ExpandNames(self):
2863
    self._ExpandAndLockInstance()
2864

    
2865
  def BuildHooksEnv(self):
2866
    """Build hooks env.
2867

2868
    This runs on master, primary and secondary nodes of the instance.
2869

2870
    """
2871
    env = {
2872
      "FORCE": self.op.force,
2873
      }
2874
    env.update(_BuildInstanceHookEnvByObject(self, self.instance))
2875
    nl = [self.cfg.GetMasterNode()] + list(self.instance.all_nodes)
2876
    return env, nl, nl
2877

    
2878
  def CheckPrereq(self):
2879
    """Check prerequisites.
2880

2881
    This checks that the instance is in the cluster.
2882

2883
    """
2884
    self.instance = instance = self.cfg.GetInstanceInfo(self.op.instance_name)
2885
    assert self.instance is not None, \
2886
      "Cannot retrieve locked instance %s" % self.op.instance_name
2887

    
2888
    # extra beparams
2889
    self.beparams = getattr(self.op, "beparams", {})
2890
    if self.beparams:
2891
      if not isinstance(self.beparams, dict):
2892
        raise errors.OpPrereqError("Invalid beparams passed: %s, expected"
2893
                                   " dict" % (type(self.beparams), ))
2894
      # fill the beparams dict
2895
      utils.ForceDictType(self.beparams, constants.BES_PARAMETER_TYPES)
2896
      self.op.beparams = self.beparams
2897

    
2898
    # extra hvparams
2899
    self.hvparams = getattr(self.op, "hvparams", {})
2900
    if self.hvparams:
2901
      if not isinstance(self.hvparams, dict):
2902
        raise errors.OpPrereqError("Invalid hvparams passed: %s, expected"
2903
                                   " dict" % (type(self.hvparams), ))
2904

    
2905
      # check hypervisor parameter syntax (locally)
2906
      cluster = self.cfg.GetClusterInfo()
2907
      utils.ForceDictType(self.hvparams, constants.HVS_PARAMETER_TYPES)
2908
      filled_hvp = objects.FillDict(cluster.hvparams[instance.hypervisor],
2909
                                    instance.hvparams)
2910
      filled_hvp.update(self.hvparams)
2911
      hv_type = hypervisor.GetHypervisor(instance.hypervisor)
2912
      hv_type.CheckParameterSyntax(filled_hvp)
2913
      _CheckHVParams(self, instance.all_nodes, instance.hypervisor, filled_hvp)
2914
      self.op.hvparams = self.hvparams
2915

    
2916
    _CheckNodeOnline(self, instance.primary_node)
2917

    
2918
    bep = self.cfg.GetClusterInfo().FillBE(instance)
2919
    # check bridges existance
2920
    _CheckInstanceBridgesExist(self, instance)
2921

    
2922
    remote_info = self.rpc.call_instance_info(instance.primary_node,
2923
                                              instance.name,
2924
                                              instance.hypervisor)
2925
    msg = remote_info.RemoteFailMsg()
2926
    if msg:
2927
      raise errors.OpPrereqError("Error checking node %s: %s" %
2928
                                 (instance.primary_node, msg))
2929
    if not remote_info.payload: # not running already
2930
      _CheckNodeFreeMemory(self, instance.primary_node,
2931
                           "starting instance %s" % instance.name,
2932
                           bep[constants.BE_MEMORY], instance.hypervisor)
2933

    
2934
  def Exec(self, feedback_fn):
2935
    """Start the instance.
2936

2937
    """
2938
    instance = self.instance
2939
    force = self.op.force
2940

    
2941
    self.cfg.MarkInstanceUp(instance.name)
2942

    
2943
    node_current = instance.primary_node
2944

    
2945
    _StartInstanceDisks(self, instance, force)
2946

    
2947
    result = self.rpc.call_instance_start(node_current, instance,
2948
                                          self.hvparams, self.beparams)
2949
    msg = result.RemoteFailMsg()
2950
    if msg:
2951
      _ShutdownInstanceDisks(self, instance)
2952
      raise errors.OpExecError("Could not start instance: %s" % msg)
2953

    
2954

    
2955
class LURebootInstance(LogicalUnit):
2956
  """Reboot an instance.
2957

2958
  """
2959
  HPATH = "instance-reboot"
2960
  HTYPE = constants.HTYPE_INSTANCE
2961
  _OP_REQP = ["instance_name", "ignore_secondaries", "reboot_type"]
2962
  REQ_BGL = False
2963

    
2964
  def ExpandNames(self):
2965
    if self.op.reboot_type not in [constants.INSTANCE_REBOOT_SOFT,
2966
                                   constants.INSTANCE_REBOOT_HARD,
2967
                                   constants.INSTANCE_REBOOT_FULL]:
2968
      raise errors.ParameterError("reboot type not in [%s, %s, %s]" %
2969
                                  (constants.INSTANCE_REBOOT_SOFT,
2970
                                   constants.INSTANCE_REBOOT_HARD,
2971
                                   constants.INSTANCE_REBOOT_FULL))
2972
    self._ExpandAndLockInstance()
2973

    
2974
  def BuildHooksEnv(self):
2975
    """Build hooks env.
2976

2977
    This runs on master, primary and secondary nodes of the instance.
2978

2979
    """
2980
    env = {
2981
      "IGNORE_SECONDARIES": self.op.ignore_secondaries,
2982
      "REBOOT_TYPE": self.op.reboot_type,
2983
      }
2984
    env.update(_BuildInstanceHookEnvByObject(self, self.instance))
2985
    nl = [self.cfg.GetMasterNode()] + list(self.instance.all_nodes)
2986
    return env, nl, nl
2987

    
2988
  def CheckPrereq(self):
2989
    """Check prerequisites.
2990

2991
    This checks that the instance is in the cluster.
2992

2993
    """
2994
    self.instance = instance = self.cfg.GetInstanceInfo(self.op.instance_name)
2995
    assert self.instance is not None, \
2996
      "Cannot retrieve locked instance %s" % self.op.instance_name
2997

    
2998
    _CheckNodeOnline(self, instance.primary_node)
2999

    
3000
    # check bridges existance
3001
    _CheckInstanceBridgesExist(self, instance)
3002

    
3003
  def Exec(self, feedback_fn):
3004
    """Reboot the instance.
3005

3006
    """
3007
    instance = self.instance
3008
    ignore_secondaries = self.op.ignore_secondaries
3009
    reboot_type = self.op.reboot_type
3010

    
3011
    node_current = instance.primary_node
3012

    
3013
    if reboot_type in [constants.INSTANCE_REBOOT_SOFT,
3014
                       constants.INSTANCE_REBOOT_HARD]:
3015
      for disk in instance.disks:
3016
        self.cfg.SetDiskID(disk, node_current)
3017
      result = self.rpc.call_instance_reboot(node_current, instance,
3018
                                             reboot_type)
3019
      msg = result.RemoteFailMsg()
3020
      if msg:
3021
        raise errors.OpExecError("Could not reboot instance: %s" % msg)
3022
    else:
3023
      result = self.rpc.call_instance_shutdown(node_current, instance)
3024
      msg = result.RemoteFailMsg()
3025
      if msg:
3026
        raise errors.OpExecError("Could not shutdown instance for"
3027
                                 " full reboot: %s" % msg)
3028
      _ShutdownInstanceDisks(self, instance)
3029
      _StartInstanceDisks(self, instance, ignore_secondaries)
3030
      result = self.rpc.call_instance_start(node_current, instance, None, None)
3031
      msg = result.RemoteFailMsg()
3032
      if msg:
3033
        _ShutdownInstanceDisks(self, instance)
3034
        raise errors.OpExecError("Could not start instance for"
3035
                                 " full reboot: %s" % msg)
3036

    
3037
    self.cfg.MarkInstanceUp(instance.name)
3038

    
3039

    
3040
class LUShutdownInstance(LogicalUnit):
3041
  """Shutdown an instance.
3042

3043
  """
3044
  HPATH = "instance-stop"
3045
  HTYPE = constants.HTYPE_INSTANCE
3046
  _OP_REQP = ["instance_name"]
3047
  REQ_BGL = False
3048

    
3049
  def ExpandNames(self):
3050
    self._ExpandAndLockInstance()
3051

    
3052
  def BuildHooksEnv(self):
3053
    """Build hooks env.
3054

3055
    This runs on master, primary and secondary nodes of the instance.
3056

3057
    """
3058
    env = _BuildInstanceHookEnvByObject(self, self.instance)
3059
    nl = [self.cfg.GetMasterNode()] + list(self.instance.all_nodes)
3060
    return env, nl, nl
3061

    
3062
  def CheckPrereq(self):
3063
    """Check prerequisites.
3064

3065
    This checks that the instance is in the cluster.
3066

3067
    """
3068
    self.instance = self.cfg.GetInstanceInfo(self.op.instance_name)
3069
    assert self.instance is not None, \
3070
      "Cannot retrieve locked instance %s" % self.op.instance_name
3071
    _CheckNodeOnline(self, self.instance.primary_node)
3072

    
3073
  def Exec(self, feedback_fn):
3074
    """Shutdown the instance.
3075

3076
    """
3077
    instance = self.instance
3078
    node_current = instance.primary_node
3079
    self.cfg.MarkInstanceDown(instance.name)
3080
    result = self.rpc.call_instance_shutdown(node_current, instance)
3081
    msg = result.RemoteFailMsg()
3082
    if msg:
3083
      self.proc.LogWarning("Could not shutdown instance: %s" % msg)
3084

    
3085
    _ShutdownInstanceDisks(self, instance)
3086

    
3087

    
3088
class LUReinstallInstance(LogicalUnit):
3089
  """Reinstall an instance.
3090

3091
  """
3092
  HPATH = "instance-reinstall"
3093
  HTYPE = constants.HTYPE_INSTANCE
3094
  _OP_REQP = ["instance_name"]
3095
  REQ_BGL = False
3096

    
3097
  def ExpandNames(self):
3098
    self._ExpandAndLockInstance()
3099

    
3100
  def BuildHooksEnv(self):
3101
    """Build hooks env.
3102

3103
    This runs on master, primary and secondary nodes of the instance.
3104

3105
    """
3106
    env = _BuildInstanceHookEnvByObject(self, self.instance)
3107
    nl = [self.cfg.GetMasterNode()] + list(self.instance.all_nodes)
3108
    return env, nl, nl
3109

    
3110
  def CheckPrereq(self):
3111
    """Check prerequisites.
3112

3113
    This checks that the instance is in the cluster and is not running.
3114

3115
    """
3116
    instance = self.cfg.GetInstanceInfo(self.op.instance_name)
3117
    assert instance is not None, \
3118
      "Cannot retrieve locked instance %s" % self.op.instance_name
3119
    _CheckNodeOnline(self, instance.primary_node)
3120

    
3121
    if instance.disk_template == constants.DT_DISKLESS:
3122
      raise errors.OpPrereqError("Instance '%s' has no disks" %
3123
                                 self.op.instance_name)
3124
    if instance.admin_up:
3125
      raise errors.OpPrereqError("Instance '%s' is marked to be up" %
3126
                                 self.op.instance_name)
3127
    remote_info = self.rpc.call_instance_info(instance.primary_node,
3128
                                              instance.name,
3129
                                              instance.hypervisor)
3130
    msg = remote_info.RemoteFailMsg()
3131
    if msg:
3132
      raise errors.OpPrereqError("Error checking node %s: %s" %
3133
                                 (instance.primary_node, msg))
3134
    if remote_info.payload:
3135
      raise errors.OpPrereqError("Instance '%s' is running on the node %s" %
3136
                                 (self.op.instance_name,
3137
                                  instance.primary_node))
3138

    
3139
    self.op.os_type = getattr(self.op, "os_type", None)
3140
    if self.op.os_type is not None:
3141
      # OS verification
3142
      pnode = self.cfg.GetNodeInfo(
3143
        self.cfg.ExpandNodeName(instance.primary_node))
3144
      if pnode is None:
3145
        raise errors.OpPrereqError("Primary node '%s' is unknown" %
3146
                                   self.op.pnode)
3147
      result = self.rpc.call_os_get(pnode.name, self.op.os_type)
3148
      result.Raise()
3149
      if not isinstance(result.data, objects.OS):
3150
        raise errors.OpPrereqError("OS '%s' not in supported OS list for"
3151
                                   " primary node"  % self.op.os_type)
3152

    
3153
    self.instance = instance
3154

    
3155
  def Exec(self, feedback_fn):
3156
    """Reinstall the instance.
3157

3158
    """
3159
    inst = self.instance
3160

    
3161
    if self.op.os_type is not None:
3162
      feedback_fn("Changing OS to '%s'..." % self.op.os_type)
3163
      inst.os = self.op.os_type
3164
      self.cfg.Update(inst)
3165

    
3166
    _StartInstanceDisks(self, inst, None)
3167
    try:
3168
      feedback_fn("Running the instance OS create scripts...")
3169
      result = self.rpc.call_instance_os_add(inst.primary_node, inst, True)
3170
      msg = result.RemoteFailMsg()
3171
      if msg:
3172
        raise errors.OpExecError("Could not install OS for instance %s"
3173
                                 " on node %s: %s" %
3174
                                 (inst.name, inst.primary_node, msg))
3175
    finally:
3176
      _ShutdownInstanceDisks(self, inst)
3177

    
3178

    
3179
class LURenameInstance(LogicalUnit):
3180
  """Rename an instance.
3181

3182
  """
3183
  HPATH = "instance-rename"
3184
  HTYPE = constants.HTYPE_INSTANCE
3185
  _OP_REQP = ["instance_name", "new_name"]
3186

    
3187
  def BuildHooksEnv(self):
3188
    """Build hooks env.
3189

3190
    This runs on master, primary and secondary nodes of the instance.
3191

3192
    """
3193
    env = _BuildInstanceHookEnvByObject(self, self.instance)
3194
    env["INSTANCE_NEW_NAME"] = self.op.new_name
3195
    nl = [self.cfg.GetMasterNode()] + list(self.instance.all_nodes)
3196
    return env, nl, nl
3197

    
3198
  def CheckPrereq(self):
3199
    """Check prerequisites.
3200

3201
    This checks that the instance is in the cluster and is not running.
3202

3203
    """
3204
    instance = self.cfg.GetInstanceInfo(
3205
      self.cfg.ExpandInstanceName(self.op.instance_name))
3206
    if instance is None:
3207
      raise errors.OpPrereqError("Instance '%s' not known" %
3208
                                 self.op.instance_name)
3209
    _CheckNodeOnline(self, instance.primary_node)
3210

    
3211
    if instance.admin_up:
3212
      raise errors.OpPrereqError("Instance '%s' is marked to be up" %
3213
                                 self.op.instance_name)
3214
    remote_info = self.rpc.call_instance_info(instance.primary_node,
3215
                                              instance.name,
3216
                                              instance.hypervisor)
3217
    msg = remote_info.RemoteFailMsg()
3218
    if msg:
3219
      raise errors.OpPrereqError("Error checking node %s: %s" %
3220
                                 (instance.primary_node, msg))
3221
    if remote_info.payload:
3222
      raise errors.OpPrereqError("Instance '%s' is running on the node %s" %
3223
                                 (self.op.instance_name,
3224
                                  instance.primary_node))
3225
    self.instance = instance
3226

    
3227
    # new name verification
3228
    name_info = utils.HostInfo(self.op.new_name)
3229

    
3230
    self.op.new_name = new_name = name_info.name
3231
    instance_list = self.cfg.GetInstanceList()
3232
    if new_name in instance_list:
3233
      raise errors.OpPrereqError("Instance '%s' is already in the cluster" %
3234
                                 new_name)
3235

    
3236
    if not getattr(self.op, "ignore_ip", False):
3237
      if utils.TcpPing(name_info.ip, constants.DEFAULT_NODED_PORT):
3238
        raise errors.OpPrereqError("IP %s of instance %s already in use" %
3239
                                   (name_info.ip, new_name))
3240

    
3241

    
3242
  def Exec(self, feedback_fn):
3243
    """Reinstall the instance.
3244

3245
    """
3246
    inst = self.instance
3247
    old_name = inst.name
3248

    
3249
    if inst.disk_template == constants.DT_FILE:
3250
      old_file_storage_dir = os.path.dirname(inst.disks[0].logical_id[1])
3251

    
3252
    self.cfg.RenameInstance(inst.name, self.op.new_name)
3253
    # Change the instance lock. This is definitely safe while we hold the BGL
3254
    self.context.glm.remove(locking.LEVEL_INSTANCE, old_name)
3255
    self.context.glm.add(locking.LEVEL_INSTANCE, self.op.new_name)
3256

    
3257
    # re-read the instance from the configuration after rename
3258
    inst = self.cfg.GetInstanceInfo(self.op.new_name)
3259

    
3260
    if inst.disk_template == constants.DT_FILE:
3261
      new_file_storage_dir = os.path.dirname(inst.disks[0].logical_id[1])
3262
      result = self.rpc.call_file_storage_dir_rename(inst.primary_node,
3263
                                                     old_file_storage_dir,
3264
                                                     new_file_storage_dir)
3265
      result.Raise()
3266
      if not result.data:
3267
        raise errors.OpExecError("Could not connect to node '%s' to rename"
3268
                                 " directory '%s' to '%s' (but the instance"
3269
                                 " has been renamed in Ganeti)" % (
3270
                                 inst.primary_node, old_file_storage_dir,
3271
                                 new_file_storage_dir))
3272

    
3273
      if not result.data[0]:
3274
        raise errors.OpExecError("Could not rename directory '%s' to '%s'"
3275
                                 " (but the instance has been renamed in"
3276
                                 " Ganeti)" % (old_file_storage_dir,
3277
                                               new_file_storage_dir))
3278

    
3279
    _StartInstanceDisks(self, inst, None)
3280
    try:
3281
      result = self.rpc.call_instance_run_rename(inst.primary_node, inst,
3282
                                                 old_name)
3283
      msg = result.RemoteFailMsg()
3284
      if msg:
3285
        msg = ("Could not run OS rename script for instance %s on node %s"
3286
               " (but the instance has been renamed in Ganeti): %s" %
3287
               (inst.name, inst.primary_node, msg))
3288
        self.proc.LogWarning(msg)
3289
    finally:
3290
      _ShutdownInstanceDisks(self, inst)
3291

    
3292

    
3293
class LURemoveInstance(LogicalUnit):
3294
  """Remove an instance.
3295

3296
  """
3297
  HPATH = "instance-remove"
3298
  HTYPE = constants.HTYPE_INSTANCE
3299
  _OP_REQP = ["instance_name", "ignore_failures"]
3300
  REQ_BGL = False
3301

    
3302
  def ExpandNames(self):
3303
    self._ExpandAndLockInstance()
3304
    self.needed_locks[locking.LEVEL_NODE] = []
3305
    self.recalculate_locks[locking.LEVEL_NODE] = constants.LOCKS_REPLACE
3306

    
3307
  def DeclareLocks(self, level):
3308
    if level == locking.LEVEL_NODE:
3309
      self._LockInstancesNodes()
3310

    
3311
  def BuildHooksEnv(self):
3312
    """Build hooks env.
3313

3314
    This runs on master, primary and secondary nodes of the instance.
3315

3316
    """
3317
    env = _BuildInstanceHookEnvByObject(self, self.instance)
3318
    nl = [self.cfg.GetMasterNode()]
3319
    return env, nl, nl
3320

    
3321
  def CheckPrereq(self):
3322
    """Check prerequisites.
3323

3324
    This checks that the instance is in the cluster.
3325

3326
    """
3327
    self.instance = self.cfg.GetInstanceInfo(self.op.instance_name)
3328
    assert self.instance is not None, \
3329
      "Cannot retrieve locked instance %s" % self.op.instance_name
3330

    
3331
  def Exec(self, feedback_fn):
3332
    """Remove the instance.
3333

3334
    """
3335
    instance = self.instance
3336
    logging.info("Shutting down instance %s on node %s",
3337
                 instance.name, instance.primary_node)
3338

    
3339
    result = self.rpc.call_instance_shutdown(instance.primary_node, instance)
3340
    msg = result.RemoteFailMsg()
3341
    if msg:
3342
      if self.op.ignore_failures:
3343
        feedback_fn("Warning: can't shutdown instance: %s" % msg)
3344
      else:
3345
        raise errors.OpExecError("Could not shutdown instance %s on"
3346
                                 " node %s: %s" %
3347
                                 (instance.name, instance.primary_node, msg))
3348

    
3349
    logging.info("Removing block devices for instance %s", instance.name)
3350

    
3351
    if not _RemoveDisks(self, instance):
3352
      if self.op.ignore_failures:
3353
        feedback_fn("Warning: can't remove instance's disks")
3354
      else:
3355
        raise errors.OpExecError("Can't remove instance's disks")
3356

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

    
3359
    self.cfg.RemoveInstance(instance.name)
3360
    self.remove_locks[locking.LEVEL_INSTANCE] = instance.name
3361

    
3362

    
3363
class LUQueryInstances(NoHooksLU):
3364
  """Logical unit for querying instances.
3365

3366
  """
3367
  _OP_REQP = ["output_fields", "names", "use_locking"]
3368
  REQ_BGL = False
3369
  _FIELDS_STATIC = utils.FieldSet(*["name", "os", "pnode", "snodes",
3370
                                    "admin_state",
3371
                                    "disk_template", "ip", "mac", "bridge",
3372
                                    "sda_size", "sdb_size", "vcpus", "tags",
3373
                                    "network_port", "beparams",
3374
                                    r"(disk)\.(size)/([0-9]+)",
3375
                                    r"(disk)\.(sizes)", "disk_usage",
3376
                                    r"(nic)\.(mac|ip|bridge)/([0-9]+)",
3377
                                    r"(nic)\.(macs|ips|bridges)",
3378
                                    r"(disk|nic)\.(count)",
3379
                                    "serial_no", "hypervisor", "hvparams",] +
3380
                                  ["hv/%s" % name
3381
                                   for name in constants.HVS_PARAMETERS] +
3382
                                  ["be/%s" % name
3383
                                   for name in constants.BES_PARAMETERS])
3384
  _FIELDS_DYNAMIC = utils.FieldSet("oper_state", "oper_ram", "status")
3385

    
3386

    
3387
  def ExpandNames(self):
3388
    _CheckOutputFields(static=self._FIELDS_STATIC,
3389
                       dynamic=self._FIELDS_DYNAMIC,
3390
                       selected=self.op.output_fields)
3391

    
3392
    self.needed_locks = {}
3393
    self.share_locks[locking.LEVEL_INSTANCE] = 1
3394
    self.share_locks[locking.LEVEL_NODE] = 1
3395

    
3396
    if self.op.names:
3397
      self.wanted = _GetWantedInstances(self, self.op.names)
3398
    else:
3399
      self.wanted = locking.ALL_SET
3400

    
3401
    self.do_node_query = self._FIELDS_STATIC.NonMatching(self.op.output_fields)
3402
    self.do_locking = self.do_node_query and self.op.use_locking
3403
    if self.do_locking:
3404
      self.needed_locks[locking.LEVEL_INSTANCE] = self.wanted
3405
      self.needed_locks[locking.LEVEL_NODE] = []
3406
      self.recalculate_locks[locking.LEVEL_NODE] = constants.LOCKS_REPLACE
3407

    
3408
  def DeclareLocks(self, level):
3409
    if level == locking.LEVEL_NODE and self.do_locking:
3410
      self._LockInstancesNodes()
3411

    
3412
  def CheckPrereq(self):
3413
    """Check prerequisites.
3414

3415
    """
3416
    pass
3417

    
3418
  def Exec(self, feedback_fn):
3419
    """Computes the list of nodes and their attributes.
3420

3421
    """
3422
    all_info = self.cfg.GetAllInstancesInfo()
3423
    if self.wanted == locking.ALL_SET:
3424
      # caller didn't specify instance names, so ordering is not important
3425
      if self.do_locking:
3426
        instance_names = self.acquired_locks[locking.LEVEL_INSTANCE]
3427
      else:
3428
        instance_names = all_info.keys()
3429
      instance_names = utils.NiceSort(instance_names)
3430
    else:
3431
      # caller did specify names, so we must keep the ordering
3432
      if self.do_locking:
3433
        tgt_set = self.acquired_locks[locking.LEVEL_INSTANCE]
3434
      else:
3435
        tgt_set = all_info.keys()
3436
      missing = set(self.wanted).difference(tgt_set)
3437
      if missing:
3438
        raise errors.OpExecError("Some instances were removed before"
3439
                                 " retrieving their data: %s" % missing)
3440
      instance_names = self.wanted
3441

    
3442
    instance_list = [all_info[iname] for iname in instance_names]
3443

    
3444
    # begin data gathering
3445

    
3446
    nodes = frozenset([inst.primary_node for inst in instance_list])
3447
    hv_list = list(set([inst.hypervisor for inst in instance_list]))
3448

    
3449
    bad_nodes = []
3450
    off_nodes = []
3451
    if self.do_node_query:
3452
      live_data = {}
3453
      node_data = self.rpc.call_all_instances_info(nodes, hv_list)
3454
      for name in nodes:
3455
        result = node_data[name]
3456
        if result.offline:
3457
          # offline nodes will be in both lists
3458
          off_nodes.append(name)
3459
        if result.failed or result.RemoteFailMsg():
3460
          bad_nodes.append(name)
3461
        else:
3462
          if result.payload:
3463
            live_data.update(result.payload)
3464
          # else no instance is alive
3465
    else:
3466
      live_data = dict([(name, {}) for name in instance_names])
3467

    
3468
    # end data gathering
3469

    
3470
    HVPREFIX = "hv/"
3471
    BEPREFIX = "be/"
3472
    output = []
3473
    for instance in instance_list:
3474
      iout = []
3475
      i_hv = self.cfg.GetClusterInfo().FillHV(instance)
3476
      i_be = self.cfg.GetClusterInfo().FillBE(instance)
3477
      for field in self.op.output_fields:
3478
        st_match = self._FIELDS_STATIC.Matches(field)
3479
        if field == "name":
3480
          val = instance.name
3481
        elif field == "os":
3482
          val = instance.os
3483
        elif field == "pnode":
3484
          val = instance.primary_node
3485
        elif field == "snodes":
3486
          val = list(instance.secondary_nodes)
3487
        elif field == "admin_state":
3488
          val = instance.admin_up
3489
        elif field == "oper_state":
3490
          if instance.primary_node in bad_nodes:
3491
            val = None
3492
          else:
3493
            val = bool(live_data.get(instance.name))
3494
        elif field == "status":
3495
          if instance.primary_node in off_nodes:
3496
            val = "ERROR_nodeoffline"
3497
          elif instance.primary_node in bad_nodes:
3498
            val = "ERROR_nodedown"
3499
          else:
3500
            running = bool(live_data.get(instance.name))
3501
            if running:
3502
              if instance.admin_up:
3503
                val = "running"
3504
              else:
3505
                val = "ERROR_up"
3506
            else:
3507
              if instance.admin_up:
3508
                val = "ERROR_down"
3509
              else:
3510
                val = "ADMIN_down"
3511
        elif field == "oper_ram":
3512
          if instance.primary_node in bad_nodes:
3513
            val = None
3514
          elif instance.name in live_data:
3515
            val = live_data[instance.name].get("memory", "?")
3516
          else:
3517
            val = "-"
3518
        elif field == "disk_template":
3519
          val = instance.disk_template
3520
        elif field == "ip":
3521
          val = instance.nics[0].ip
3522
        elif field == "bridge":
3523
          val = instance.nics[0].bridge
3524
        elif field == "mac":
3525
          val = instance.nics[0].mac
3526
        elif field == "sda_size" or field == "sdb_size":
3527
          idx = ord(field[2]) - ord('a')
3528
          try:
3529
            val = instance.FindDisk(idx).size
3530
          except errors.OpPrereqError:
3531
            val = None
3532
        elif field == "disk_usage": # total disk usage per node
3533
          disk_sizes = [{'size': disk.size} for disk in instance.disks]
3534
          val = _ComputeDiskSize(instance.disk_template, disk_sizes)
3535
        elif field == "tags":
3536
          val = list(instance.GetTags())
3537
        elif field == "serial_no":
3538
          val = instance.serial_no
3539
        elif field == "network_port":
3540
          val = instance.network_port
3541
        elif field == "hypervisor":
3542
          val = instance.hypervisor
3543
        elif field == "hvparams":
3544
          val = i_hv
3545
        elif (field.startswith(HVPREFIX) and
3546
              field[len(HVPREFIX):] in constants.HVS_PARAMETERS):
3547
          val = i_hv.get(field[len(HVPREFIX):], None)
3548
        elif field == "beparams":
3549
          val = i_be
3550
        elif (field.startswith(BEPREFIX) and
3551
              field[len(BEPREFIX):] in constants.BES_PARAMETERS):
3552
          val = i_be.get(field[len(BEPREFIX):], None)
3553
        elif st_match and st_match.groups():
3554
          # matches a variable list
3555
          st_groups = st_match.groups()
3556
          if st_groups and st_groups[0] == "disk":
3557
            if st_groups[1] == "count":
3558
              val = len(instance.disks)
3559
            elif st_groups[1] == "sizes":
3560
              val = [disk.size for disk in instance.disks]
3561
            elif st_groups[1] == "size":
3562
              try:
3563
                val = instance.FindDisk(st_groups[2]).size
3564
              except errors.OpPrereqError:
3565
                val = None
3566
            else:
3567
              assert False, "Unhandled disk parameter"
3568
          elif st_groups[0] == "nic":
3569
            if st_groups[1] == "count":
3570
              val = len(instance.nics)
3571
            elif st_groups[1] == "macs":
3572
              val = [nic.mac for nic in instance.nics]
3573
            elif st_groups[1] == "ips":
3574
              val = [nic.ip for nic in instance.nics]
3575
            elif st_groups[1] == "bridges":
3576
              val = [nic.bridge for nic in instance.nics]
3577
            else:
3578
              # index-based item
3579
              nic_idx = int(st_groups[2])
3580
              if nic_idx >= len(instance.nics):
3581
                val = None
3582
              else:
3583
                if st_groups[1] == "mac":
3584
                  val = instance.nics[nic_idx].mac
3585
                elif st_groups[1] == "ip":
3586
                  val = instance.nics[nic_idx].ip
3587
                elif st_groups[1] == "bridge":
3588
                  val = instance.nics[nic_idx].bridge
3589
                else:
3590
                  assert False, "Unhandled NIC parameter"
3591
          else:
3592
            assert False, "Unhandled variable parameter"
3593
        else:
3594
          raise errors.ParameterError(field)
3595
        iout.append(val)
3596
      output.append(iout)
3597

    
3598
    return output
3599

    
3600

    
3601
class LUFailoverInstance(LogicalUnit):
3602
  """Failover an instance.
3603

3604
  """
3605
  HPATH = "instance-failover"
3606
  HTYPE = constants.HTYPE_INSTANCE
3607
  _OP_REQP = ["instance_name", "ignore_consistency"]
3608
  REQ_BGL = False
3609

    
3610
  def ExpandNames(self):
3611
    self._ExpandAndLockInstance()
3612
    self.needed_locks[locking.LEVEL_NODE] = []
3613
    self.recalculate_locks[locking.LEVEL_NODE] = constants.LOCKS_REPLACE
3614

    
3615
  def DeclareLocks(self, level):
3616
    if level == locking.LEVEL_NODE:
3617
      self._LockInstancesNodes()
3618

    
3619
  def BuildHooksEnv(self):
3620
    """Build hooks env.
3621

3622
    This runs on master, primary and secondary nodes of the instance.
3623

3624
    """
3625
    env = {
3626
      "IGNORE_CONSISTENCY": self.op.ignore_consistency,
3627
      }
3628
    env.update(_BuildInstanceHookEnvByObject(self, self.instance))
3629
    nl = [self.cfg.GetMasterNode()] + list(self.instance.secondary_nodes)
3630
    return env, nl, nl
3631

    
3632
  def CheckPrereq(self):
3633
    """Check prerequisites.
3634

3635
    This checks that the instance is in the cluster.
3636

3637
    """
3638
    self.instance = instance = self.cfg.GetInstanceInfo(self.op.instance_name)
3639
    assert self.instance is not None, \
3640
      "Cannot retrieve locked instance %s" % self.op.instance_name
3641

    
3642
    bep = self.cfg.GetClusterInfo().FillBE(instance)
3643
    if instance.disk_template not in constants.DTS_NET_MIRROR:
3644
      raise errors.OpPrereqError("Instance's disk layout is not"
3645
                                 " network mirrored, cannot failover.")
3646

    
3647
    secondary_nodes = instance.secondary_nodes
3648
    if not secondary_nodes:
3649
      raise errors.ProgrammerError("no secondary node but using "
3650
                                   "a mirrored disk template")
3651

    
3652
    target_node = secondary_nodes[0]
3653
    _CheckNodeOnline(self, target_node)
3654
    _CheckNodeNotDrained(self, target_node)
3655
    # check memory requirements on the secondary node
3656
    _CheckNodeFreeMemory(self, target_node, "failing over instance %s" %
3657
                         instance.name, bep[constants.BE_MEMORY],
3658
                         instance.hypervisor)
3659
    # check bridge existance
3660
    _CheckInstanceBridgesExist(self, instance, node=target_node)
3661

    
3662
  def Exec(self, feedback_fn):
3663
    """Failover an instance.
3664

3665
    The failover is done by shutting it down on its present node and
3666
    starting it on the secondary.
3667

3668
    """
3669
    instance = self.instance
3670

    
3671
    source_node = instance.primary_node
3672
    target_node = instance.secondary_nodes[0]
3673

    
3674
    feedback_fn("* checking disk consistency between source and target")
3675
    for dev in instance.disks:
3676
      # for drbd, these are drbd over lvm
3677
      if not _CheckDiskConsistency(self, dev, target_node, False):
3678
        if instance.admin_up and not self.op.ignore_consistency:
3679
          raise errors.OpExecError("Disk %s is degraded on target node,"
3680
                                   " aborting failover." % dev.iv_name)
3681

    
3682
    feedback_fn("* shutting down instance on source node")
3683
    logging.info("Shutting down instance %s on node %s",
3684
                 instance.name, source_node)
3685

    
3686
    result = self.rpc.call_instance_shutdown(source_node, instance)
3687
    msg = result.RemoteFailMsg()
3688
    if msg:
3689
      if self.op.ignore_consistency:
3690
        self.proc.LogWarning("Could not shutdown instance %s on node %s."
3691
                             " Proceeding anyway. Please make sure node"
3692
                             " %s is down. Error details: %s",
3693
                             instance.name, source_node, source_node, msg)
3694
      else:
3695
        raise errors.OpExecError("Could not shutdown instance %s on"
3696
                                 " node %s: %s" %
3697
                                 (instance.name, source_node, msg))
3698

    
3699
    feedback_fn("* deactivating the instance's disks on source node")
3700
    if not _ShutdownInstanceDisks(self, instance, ignore_primary=True):
3701
      raise errors.OpExecError("Can't shut down the instance's disks.")
3702

    
3703
    instance.primary_node = target_node
3704
    # distribute new instance config to the other nodes
3705
    self.cfg.Update(instance)
3706

    
3707
    # Only start the instance if it's marked as up
3708
    if instance.admin_up:
3709
      feedback_fn("* activating the instance's disks on target node")
3710
      logging.info("Starting instance %s on node %s",
3711
                   instance.name, target_node)
3712

    
3713
      disks_ok, dummy = _AssembleInstanceDisks(self, instance,
3714
                                               ignore_secondaries=True)
3715
      if not disks_ok:
3716
        _ShutdownInstanceDisks(self, instance)
3717
        raise errors.OpExecError("Can't activate the instance's disks")
3718

    
3719
      feedback_fn("* starting the instance on the target node")
3720
      result = self.rpc.call_instance_start(target_node, instance, None, None)
3721
      msg = result.RemoteFailMsg()
3722
      if msg:
3723
        _ShutdownInstanceDisks(self, instance)
3724
        raise errors.OpExecError("Could not start instance %s on node %s: %s" %
3725
                                 (instance.name, target_node, msg))
3726

    
3727

    
3728
class LUMigrateInstance(LogicalUnit):
3729
  """Migrate an instance.
3730

3731
  This is migration without shutting down, compared to the failover,
3732
  which is done with shutdown.
3733

3734
  """
3735
  HPATH = "instance-migrate"
3736
  HTYPE = constants.HTYPE_INSTANCE
3737
  _OP_REQP = ["instance_name", "live", "cleanup"]
3738

    
3739
  REQ_BGL = False
3740

    
3741
  def ExpandNames(self):
3742
    self._ExpandAndLockInstance()
3743
    self.needed_locks[locking.LEVEL_NODE] = []
3744
    self.recalculate_locks[locking.LEVEL_NODE] = constants.LOCKS_REPLACE
3745

    
3746
  def DeclareLocks(self, level):
3747
    if level == locking.LEVEL_NODE:
3748
      self._LockInstancesNodes()
3749

    
3750
  def BuildHooksEnv(self):
3751
    """Build hooks env.
3752

3753
    This runs on master, primary and secondary nodes of the instance.
3754

3755
    """
3756
    env = _BuildInstanceHookEnvByObject(self, self.instance)
3757
    env["MIGRATE_LIVE"] = self.op.live
3758
    env["MIGRATE_CLEANUP"] = self.op.cleanup
3759
    nl = [self.cfg.GetMasterNode()] + list(self.instance.secondary_nodes)
3760
    return env, nl, nl
3761

    
3762
  def CheckPrereq(self):
3763
    """Check prerequisites.
3764

3765
    This checks that the instance is in the cluster.
3766

3767
    """
3768
    instance = self.cfg.GetInstanceInfo(
3769
      self.cfg.ExpandInstanceName(self.op.instance_name))
3770
    if instance is None:
3771
      raise errors.OpPrereqError("Instance '%s' not known" %
3772
                                 self.op.instance_name)
3773

    
3774
    if instance.disk_template != constants.DT_DRBD8:
3775
      raise errors.OpPrereqError("Instance's disk layout is not"
3776
                                 " drbd8, cannot migrate.")
3777

    
3778
    secondary_nodes = instance.secondary_nodes
3779
    if not secondary_nodes:
3780
      raise errors.ConfigurationError("No secondary node but using"
3781
                                      " drbd8 disk template")
3782

    
3783
    i_be = self.cfg.GetClusterInfo().FillBE(instance)
3784

    
3785
    target_node = secondary_nodes[0]
3786
    # check memory requirements on the secondary node
3787
    _CheckNodeFreeMemory(self, target_node, "migrating instance %s" %
3788
                         instance.name, i_be[constants.BE_MEMORY],
3789
                         instance.hypervisor)
3790

    
3791
    # check bridge existance
3792
    _CheckInstanceBridgesExist(self, instance, node=target_node)
3793

    
3794
    if not self.op.cleanup:
3795
      _CheckNodeNotDrained(self, target_node)
3796
      result = self.rpc.call_instance_migratable(instance.primary_node,
3797
                                                 instance)
3798
      msg = result.RemoteFailMsg()
3799
      if msg:
3800
        raise errors.OpPrereqError("Can't migrate: %s - please use failover" %
3801
                                   msg)
3802

    
3803
    self.instance = instance
3804

    
3805
  def _WaitUntilSync(self):
3806
    """Poll with custom rpc for disk sync.
3807

3808
    This uses our own step-based rpc call.
3809

3810
    """
3811
    self.feedback_fn("* wait until resync is done")
3812
    all_done = False
3813
    while not all_done:
3814
      all_done = True
3815
      result = self.rpc.call_drbd_wait_sync(self.all_nodes,
3816
                                            self.nodes_ip,
3817
                                            self.instance.disks)
3818
      min_percent = 100
3819
      for node, nres in result.items():
3820
        msg = nres.RemoteFailMsg()
3821
        if msg:
3822
          raise errors.OpExecError("Cannot resync disks on node %s: %s" %
3823
                                   (node, msg))
3824
        node_done, node_percent = nres.payload
3825
        all_done = all_done and node_done
3826
        if node_percent is not None:
3827
          min_percent = min(min_percent, node_percent)
3828
      if not all_done:
3829
        if min_percent < 100:
3830
          self.feedback_fn("   - progress: %.1f%%" % min_percent)
3831
        time.sleep(2)
3832

    
3833
  def _EnsureSecondary(self, node):
3834
    """Demote a node to secondary.
3835

3836
    """
3837
    self.feedback_fn("* switching node %s to secondary mode" % node)
3838

    
3839
    for dev in self.instance.disks:
3840
      self.cfg.SetDiskID(dev, node)
3841

    
3842
    result = self.rpc.call_blockdev_close(node, self.instance.name,
3843
                                          self.instance.disks)
3844
    msg = result.RemoteFailMsg()
3845
    if msg:
3846
      raise errors.OpExecError("Cannot change disk to secondary on node %s,"
3847
                               " error %s" % (node, msg))
3848

    
3849
  def _GoStandalone(self):
3850
    """Disconnect from the network.
3851

3852
    """
3853
    self.feedback_fn("* changing into standalone mode")
3854
    result = self.rpc.call_drbd_disconnect_net(self.all_nodes, self.nodes_ip,
3855
                                               self.instance.disks)
3856
    for node, nres in result.items():
3857
      msg = nres.RemoteFailMsg()
3858
      if msg:
3859
        raise errors.OpExecError("Cannot disconnect disks node %s,"
3860
                                 " error %s" % (node, msg))
3861

    
3862
  def _GoReconnect(self, multimaster):
3863
    """Reconnect to the network.
3864

3865
    """
3866
    if multimaster:
3867
      msg = "dual-master"
3868
    else:
3869
      msg = "single-master"
3870
    self.feedback_fn("* changing disks into %s mode" % msg)
3871
    result = self.rpc.call_drbd_attach_net(self.all_nodes, self.nodes_ip,
3872
                                           self.instance.disks,
3873
                                           self.instance.name, multimaster)
3874
    for node, nres in result.items():
3875
      msg = nres.RemoteFailMsg()
3876
      if msg:
3877
        raise errors.OpExecError("Cannot change disks config on node %s,"
3878
                                 " error: %s" % (node, msg))
3879

    
3880
  def _ExecCleanup(self):
3881
    """Try to cleanup after a failed migration.
3882

3883
    The cleanup is done by:
3884
      - check that the instance is running only on one node
3885
        (and update the config if needed)
3886
      - change disks on its secondary node to secondary
3887
      - wait until disks are fully synchronized
3888
      - disconnect from the network
3889
      - change disks into single-master mode
3890
      - wait again until disks are fully synchronized
3891

3892
    """
3893
    instance = self.instance
3894
    target_node = self.target_node
3895
    source_node = self.source_node
3896

    
3897
    # check running on only one node
3898
    self.feedback_fn("* checking where the instance actually runs"
3899
                     " (if this hangs, the hypervisor might be in"
3900
                     " a bad state)")
3901
    ins_l = self.rpc.call_instance_list(self.all_nodes, [instance.hypervisor])
3902
    for node, result in ins_l.items():
3903
      msg = result.RemoteFailMsg()
3904
      if msg:
3905
        raise errors.OpExecError("Can't contact node %s: %s" % (node, msg))
3906

    
3907
    runningon_source = instance.name in ins_l[source_node].payload
3908
    runningon_target = instance.name in ins_l[target_node].payload
3909

    
3910
    if runningon_source and runningon_target:
3911
      raise errors.OpExecError("Instance seems to be running on two nodes,"
3912
                               " or the hypervisor is confused. You will have"
3913
                               " to ensure manually that it runs only on one"
3914
                               " and restart this operation.")
3915

    
3916
    if not (runningon_source or runningon_target):
3917
      raise errors.OpExecError("Instance does not seem to be running at all."
3918
                               " In this case, it's safer to repair by"
3919
                               " running 'gnt-instance stop' to ensure disk"
3920
                               " shutdown, and then restarting it.")
3921

    
3922
    if runningon_target:
3923
      # the migration has actually succeeded, we need to update the config
3924
      self.feedback_fn("* instance running on secondary node (%s),"
3925
                       " updating config" % target_node)
3926
      instance.primary_node = target_node
3927
      self.cfg.Update(instance)
3928
      demoted_node = source_node
3929
    else:
3930
      self.feedback_fn("* instance confirmed to be running on its"
3931
                       " primary node (%s)" % source_node)
3932
      demoted_node = target_node
3933

    
3934
    self._EnsureSecondary(demoted_node)
3935
    try:
3936
      self._WaitUntilSync()
3937
    except errors.OpExecError:
3938
      # we ignore here errors, since if the device is standalone, it
3939
      # won't be able to sync
3940
      pass
3941
    self._GoStandalone()
3942
    self._GoReconnect(False)
3943
    self._WaitUntilSync()
3944

    
3945
    self.feedback_fn("* done")
3946

    
3947
  def _RevertDiskStatus(self):
3948
    """Try to revert the disk status after a failed migration.
3949

3950
    """
3951
    target_node = self.target_node
3952
    try:
3953
      self._EnsureSecondary(target_node)
3954
      self._GoStandalone()
3955
      self._GoReconnect(False)
3956
      self._WaitUntilSync()
3957
    except errors.OpExecError, err:
3958
      self.LogWarning("Migration failed and I can't reconnect the"
3959
                      " drives: error '%s'\n"
3960
                      "Please look and recover the instance status" %
3961
                      str(err))
3962

    
3963
  def _AbortMigration(self):
3964
    """Call the hypervisor code to abort a started migration.
3965

3966
    """
3967
    instance = self.instance
3968
    target_node = self.target_node
3969
    migration_info = self.migration_info
3970

    
3971
    abort_result = self.rpc.call_finalize_migration(target_node,
3972
                                                    instance,
3973
                                                    migration_info,
3974
                                                    False)
3975
    abort_msg = abort_result.RemoteFailMsg()
3976
    if abort_msg:
3977
      logging.error("Aborting migration failed on target node %s: %s" %
3978
                    (target_node, abort_msg))
3979
      # Don't raise an exception here, as we stil have to try to revert the
3980
      # disk status, even if this step failed.
3981

    
3982
  def _ExecMigration(self):
3983
    """Migrate an instance.
3984

3985
    The migrate is done by:
3986
      - change the disks into dual-master mode
3987
      - wait until disks are fully synchronized again
3988
      - migrate the instance
3989
      - change disks on the new secondary node (the old primary) to secondary
3990
      - wait until disks are fully synchronized
3991
      - change disks into single-master mode
3992

3993
    """
3994
    instance = self.instance
3995
    target_node = self.target_node
3996
    source_node = self.source_node
3997

    
3998
    self.feedback_fn("* checking disk consistency between source and target")
3999
    for dev in instance.disks:
4000
      if not _CheckDiskConsistency(self, dev, target_node, False):
4001
        raise errors.OpExecError("Disk %s is degraded or not fully"
4002
                                 " synchronized on target node,"
4003
                                 " aborting migrate." % dev.iv_name)
4004

    
4005
    # First get the migration information from the remote node
4006
    result = self.rpc.call_migration_info(source_node, instance)
4007
    msg = result.RemoteFailMsg()
4008
    if msg:
4009
      log_err = ("Failed fetching source migration information from %s: %s" %
4010
                 (source_node, msg))
4011
      logging.error(log_err)
4012