Synnefo » snf-ganeti » ganeti-local

#

#

# Copyright (C) 2006, 2007, 2010, 2011, 2012 Google Inc.

#

# This program is free software; you can redistribute it and/or modify

# it under the terms of the GNU General Public License as published by

# the Free Software Foundation; either version 2 of the License, or

# (at your option) any later version.

#

# This program is distributed in the hope that it will be useful, but

# WITHOUT ANY WARRANTY; without even the implied warranty of

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU

# General Public License for more details.

#

# You should have received a copy of the GNU General Public License

# along with this program; if not, write to the Free Software

# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA

# 02110-1301, USA.

"""Ganeti node daemon"""

# pylint: disable=C0103,W0142

# C0103: Functions in this module need to have a given name structure,

# and the name of the daemon doesn't match

# W0142: Used * or ** magic, since we do use it extensively in this

# module

import os

import sys

import logging

import signal

import codecs

from optparse import OptionParser

from ganeti import backend

from ganeti import constants

from ganeti import objects

from ganeti import errors

from ganeti import jstore

from ganeti import daemon

from ganeti import http

from ganeti import utils

from ganeti import storage

from ganeti import serializer

from ganeti import netutils

from ganeti import pathutils

from ganeti import ssconf

import ganeti.http.server # pylint: disable=W0611

queue_lock = None

def _extendReasonTrail(trail, source, reason=""):

  """Extend the reason trail with noded information

  The trail is extended by appending the name of the noded functionality

  """

  assert trail is not None

  trail_source = "%s:%s" % (constants.OPCODE_REASON_SRC_NODED, source)

  trail.append((trail_source, reason, utils.EpochNano()))

def _PrepareQueueLock():

  """Try to prepare the queue lock.

  @return: None for success, otherwise an exception object

  """

  global queue_lock # pylint: disable=W0603

  if queue_lock is not None:

    return None

  # Prepare job queue

  try:

    queue_lock = jstore.InitAndVerifyQueue(must_lock=False)

    return None

  except EnvironmentError, err:

    return err

def _RequireJobQueueLock(fn):

  """Decorator for job queue manipulating functions.

  """

  QUEUE_LOCK_TIMEOUT = 10

  def wrapper(*args, **kwargs):

    # Locking in exclusive, blocking mode because there could be several

    # children running at the same time. Waiting up to 10 seconds.

    if _PrepareQueueLock() is not None:

      raise errors.JobQueueError("Job queue failed initialization,"

                                 " cannot update jobs")

    queue_lock.Exclusive(blocking=True, timeout=QUEUE_LOCK_TIMEOUT)

    try:

      return fn(*args, **kwargs)

    finally:

      queue_lock.Unlock()

  return wrapper

def _DecodeImportExportIO(ieio, ieioargs):

  """Decodes import/export I/O information.

  """

  if ieio == constants.IEIO_RAW_DISK:

    assert len(ieioargs) == 1

    return (objects.Disk.FromDict(ieioargs[0]), )

  if ieio == constants.IEIO_SCRIPT:

    assert len(ieioargs) == 2

    return (objects.Disk.FromDict(ieioargs[0]), ieioargs[1])

  return ieioargs

def _DefaultAlternative(value, default):

  """Returns value or, if evaluating to False, a default value.

  Returns the given value, unless it evaluates to False. In the latter case the

  default value is returned.

  @param value: Value to return if it doesn't evaluate to False

  @param default: Default value

  @return: Given value or the default

  """

  if value:

    return value

  return default

class MlockallRequestExecutor(http.server.HttpServerRequestExecutor):

  """Subclass ensuring request handlers are locked in RAM.

  """

  def __init__(self, *args, **kwargs):

    utils.Mlockall()

    http.server.HttpServerRequestExecutor.__init__(self, *args, **kwargs)

class NodeRequestHandler(http.server.HttpServerHandler):

  """The server implementation.

  This class holds all methods exposed over the RPC interface.

  """

  # too many public methods, and unused args - all methods get params

  # due to the API

  # pylint: disable=R0904,W0613

  def __init__(self):

    http.server.HttpServerHandler.__init__(self)

    self.noded_pid = os.getpid()

  def HandleRequest(self, req):

    """Handle a request.

    """

    if req.request_method.upper() != http.HTTP_POST:

      raise http.HttpBadRequest("Only the POST method is supported")

    path = req.request_path

    if path.startswith("/"):

      path = path[1:]

    method = getattr(self, "perspective_%s" % path, None)

    if method is None:

      raise http.HttpNotFound()

    try:

      result = (True, method(serializer.LoadJson(req.request_body)))

    except backend.RPCFail, err:

      # our custom failure exception; str(err) works fine if the

      # exception was constructed with a single argument, and in

      # this case, err.message == err.args[0] == str(err)

      result = (False, str(err))

    except errors.QuitGanetiException, err:

      # Tell parent to quit

      logging.info("Shutting down the node daemon, arguments: %s",

                   str(err.args))

      os.kill(self.noded_pid, signal.SIGTERM)

      # And return the error's arguments, which must be already in

      # correct tuple format

      result = err.args

    except Exception, err:

      logging.exception("Error in RPC call")

      result = (False, "Error while executing backend function: %s" % str(err))

    return serializer.DumpJson(result)

  # the new block devices  --------------------------

  @staticmethod

  def perspective_blockdev_create(params):

    """Create a block device.

    """

    (bdev_s, size, owner, on_primary, info, excl_stor) = params

    bdev = objects.Disk.FromDict(bdev_s)

    if bdev is None:

      raise ValueError("can't unserialize data!")

    return backend.BlockdevCreate(bdev, size, owner, on_primary, info,

                                  excl_stor)

  @staticmethod

  def perspective_blockdev_pause_resume_sync(params):

    """Pause/resume sync of a block device.

    """

    disks_s, pause = params

    disks = [objects.Disk.FromDict(bdev_s) for bdev_s in disks_s]

    return backend.BlockdevPauseResumeSync(disks, pause)

  @staticmethod

  def perspective_blockdev_wipe(params):

    """Wipe a block device.

    """

    bdev_s, offset, size = params

    bdev = objects.Disk.FromDict(bdev_s)

    return backend.BlockdevWipe(bdev, offset, size)

  @staticmethod

  def perspective_blockdev_remove(params):

    """Remove a block device.

    """

    bdev_s = params[0]

    bdev = objects.Disk.FromDict(bdev_s)

    return backend.BlockdevRemove(bdev)

  @staticmethod

  def perspective_blockdev_rename(params):

    """Remove a block device.

    """

    devlist = [(objects.Disk.FromDict(ds), uid) for ds, uid in params[0]]

    return backend.BlockdevRename(devlist)

  @staticmethod

  def perspective_blockdev_assemble(params):

    """Assemble a block device.

    """

    bdev_s, owner, on_primary, idx = params

    bdev = objects.Disk.FromDict(bdev_s)

    if bdev is None:

      raise ValueError("can't unserialize data!")

    return backend.BlockdevAssemble(bdev, owner, on_primary, idx)

  @staticmethod

  def perspective_blockdev_shutdown(params):

    """Shutdown a block device.

    """

    bdev_s = params[0]

    bdev = objects.Disk.FromDict(bdev_s)

    if bdev is None:

      raise ValueError("can't unserialize data!")

    return backend.BlockdevShutdown(bdev)

  @staticmethod

  def perspective_blockdev_addchildren(params):

    """Add a child to a mirror device.

    Note: this is only valid for mirror devices. It's the caller's duty

    to send a correct disk, otherwise we raise an error.

    """

    bdev_s, ndev_s = params

    bdev = objects.Disk.FromDict(bdev_s)

    ndevs = [objects.Disk.FromDict(disk_s) for disk_s in ndev_s]

    if bdev is None or ndevs.count(None) > 0:

      raise ValueError("can't unserialize data!")

    return backend.BlockdevAddchildren(bdev, ndevs)

  @staticmethod

  def perspective_blockdev_removechildren(params):

    """Remove a child from a mirror device.

    This is only valid for mirror devices, of course. It's the callers

    duty to send a correct disk, otherwise we raise an error.

    """

    bdev_s, ndev_s = params

    bdev = objects.Disk.FromDict(bdev_s)

    ndevs = [objects.Disk.FromDict(disk_s) for disk_s in ndev_s]

    if bdev is None or ndevs.count(None) > 0:

      raise ValueError("can't unserialize data!")

    return backend.BlockdevRemovechildren(bdev, ndevs)

  @staticmethod

  def perspective_blockdev_getmirrorstatus(params):

    """Return the mirror status for a list of disks.

    """

    disks = [objects.Disk.FromDict(dsk_s)

             for dsk_s in params[0]]

    return [status.ToDict()

            for status in backend.BlockdevGetmirrorstatus(disks)]

  @staticmethod

  def perspective_blockdev_getmirrorstatus_multi(params):

    """Return the mirror status for a list of disks.

    """

    (node_disks, ) = params

    disks = [objects.Disk.FromDict(dsk_s) for dsk_s in node_disks]

    result = []

    for (success, status) in backend.BlockdevGetmirrorstatusMulti(disks):

      if success:

        result.append((success, status.ToDict()))

      else:

        result.append((success, status))

    return result

  @staticmethod

  def perspective_blockdev_find(params):

    """Expose the FindBlockDevice functionality for a disk.

    This will try to find but not activate a disk.

    """

    disk = objects.Disk.FromDict(params[0])

    result = backend.BlockdevFind(disk)

    if result is None:

      return None

    return result.ToDict()

  @staticmethod

  def perspective_blockdev_snapshot(params):

    """Create a snapshot device.

    Note that this is only valid for LVM disks, if we get passed

    something else we raise an exception. The snapshot device can be

    remove by calling the generic block device remove call.

    """

    cfbd = objects.Disk.FromDict(params[0])

    return backend.BlockdevSnapshot(cfbd)

  @staticmethod

  def perspective_blockdev_grow(params):

    """Grow a stack of devices.

    """

    if len(params) < 4:

      raise ValueError("Received only 3 parameters in blockdev_grow,"

                       " old master?")

    cfbd = objects.Disk.FromDict(params[0])

    amount = params[1]

    dryrun = params[2]

    backingstore = params[3]

    return backend.BlockdevGrow(cfbd, amount, dryrun, backingstore)

  @staticmethod

  def perspective_blockdev_close(params):

    """Closes the given block devices.

    """

    disks = [objects.Disk.FromDict(cf) for cf in params[1]]

    return backend.BlockdevClose(params[0], disks)

  @staticmethod

  def perspective_blockdev_getsize(params):

    """Compute the sizes of the given block devices.

    """

    disks = [objects.Disk.FromDict(cf) for cf in params[0]]

    return backend.BlockdevGetsize(disks)

  @staticmethod

  def perspective_blockdev_export(params):

    """Compute the sizes of the given block devices.

    """

    disk = objects.Disk.FromDict(params[0])

    dest_node, dest_path, cluster_name = params[1:]

    return backend.BlockdevExport(disk, dest_node, dest_path, cluster_name)

  @staticmethod

  def perspective_blockdev_setinfo(params):

    """Sets metadata information on the given block device.

    """

    (disk, info) = params

    disk = objects.Disk.FromDict(disk)

    return backend.BlockdevSetInfo(disk, info)

  # blockdev/drbd specific methods ----------

  @staticmethod

  def perspective_drbd_disconnect_net(params):

    """Disconnects the network connection of drbd disks.

    Note that this is only valid for drbd disks, so the members of the

    disk list must all be drbd devices.

    """

    nodes_ip, disks = params

    disks = [objects.Disk.FromDict(cf) for cf in disks]

    return backend.DrbdDisconnectNet(nodes_ip, disks)

  @staticmethod

  def perspective_drbd_attach_net(params):

    """Attaches the network connection of drbd disks.

    Note that this is only valid for drbd disks, so the members of the

    disk list must all be drbd devices.

    """

    nodes_ip, disks, instance_name, multimaster = params

    disks = [objects.Disk.FromDict(cf) for cf in disks]

    return backend.DrbdAttachNet(nodes_ip, disks,

                                     instance_name, multimaster)

  @staticmethod

  def perspective_drbd_wait_sync(params):

    """Wait until DRBD disks are synched.

    Note that this is only valid for drbd disks, so the members of the

    disk list must all be drbd devices.

    """

    nodes_ip, disks = params

    disks = [objects.Disk.FromDict(cf) for cf in disks]

    return backend.DrbdWaitSync(nodes_ip, disks)

  @staticmethod

  def perspective_drbd_helper(params):

    """Query drbd helper.

    """

    return backend.GetDrbdUsermodeHelper()

  # export/import  --------------------------

  @staticmethod

  def perspective_finalize_export(params):

    """Expose the finalize export functionality.

    """

    instance = objects.Instance.FromDict(params[0])

    snap_disks = []

    for disk in params[1]:

      if isinstance(disk, bool):

        snap_disks.append(disk)

      else:

        snap_disks.append(objects.Disk.FromDict(disk))

    return backend.FinalizeExport(instance, snap_disks)

  @staticmethod

  def perspective_export_info(params):

    """Query information about an existing export on this node.

    The given path may not contain an export, in which case we return

    None.

    """

    path = params[0]

    return backend.ExportInfo(path)

  @staticmethod

  def perspective_export_list(params):

    """List the available exports on this node.

    Note that as opposed to export_info, which may query data about an

    export in any path, this only queries the standard Ganeti path

    (pathutils.EXPORT_DIR).

    """

    return backend.ListExports()

  @staticmethod

  def perspective_export_remove(params):

    """Remove an export.

    """

    export = params[0]

    return backend.RemoveExport(export)

  # block device ---------------------

  @staticmethod

  def perspective_bdev_sizes(params):

    """Query the list of block devices

    """

    devices = params[0]

    return backend.GetBlockDevSizes(devices)

  # volume  --------------------------

  @staticmethod

  def perspective_lv_list(params):

    """Query the list of logical volumes in a given volume group.

    """

    vgname = params[0]

    return backend.GetVolumeList(vgname)

  @staticmethod

  def perspective_vg_list(params):

    """Query the list of volume groups.

    """

    return backend.ListVolumeGroups()

  # Storage --------------------------

  @staticmethod

  def perspective_storage_list(params):

    """Get list of storage units.

    """

    (su_name, su_args, name, fields) = params

    return storage.GetStorage(su_name, *su_args).List(name, fields)

  @staticmethod

  def perspective_storage_modify(params):

    """Modify a storage unit.

    """

    (su_name, su_args, name, changes) = params

    return storage.GetStorage(su_name, *su_args).Modify(name, changes)

  @staticmethod

  def perspective_storage_execute(params):

    """Execute an operation on a storage unit.

    """

    (su_name, su_args, name, op) = params

    return storage.GetStorage(su_name, *su_args).Execute(name, op)

  # bridge  --------------------------

  @staticmethod

  def perspective_bridges_exist(params):

    """Check if all bridges given exist on this node.

    """

    bridges_list = params[0]

    return backend.BridgesExist(bridges_list)

  # instance  --------------------------

  @staticmethod

  def perspective_instance_os_add(params):

    """Install an OS on a given instance.

    """

    inst_s = params[0]

    inst = objects.Instance.FromDict(inst_s)

    reinstall = params[1]

    debug = params[2]

    return backend.InstanceOsAdd(inst, reinstall, debug)

  @staticmethod

  def perspective_instance_run_rename(params):

    """Runs the OS rename script for an instance.

    """

    inst_s, old_name, debug = params

    inst = objects.Instance.FromDict(inst_s)

    return backend.RunRenameInstance(inst, old_name, debug)

  @staticmethod

  def perspective_instance_shutdown(params):

    """Shutdown an instance.

    """

    instance = objects.Instance.FromDict(params[0])

    timeout = params[1]

    trail = params[2]

    _extendReasonTrail(trail, "shutdown")

    return backend.InstanceShutdown(instance, timeout, trail)

  @staticmethod

  def perspective_instance_start(params):

    """Start an instance.

    """

    (instance_name, startup_paused, trail) = params

    instance = objects.Instance.FromDict(instance_name)

    _extendReasonTrail(trail, "start")

    return backend.StartInstance(instance, startup_paused, trail)

  @staticmethod

  def perspective_migration_info(params):

    """Gather information about an instance to be migrated.

    """

    instance = objects.Instance.FromDict(params[0])

    return backend.MigrationInfo(instance)

  @staticmethod

  def perspective_accept_instance(params):

    """Prepare the node to accept an instance.

    """

    instance, info, target = params

    instance = objects.Instance.FromDict(instance)

    return backend.AcceptInstance(instance, info, target)

  @staticmethod

  def perspective_instance_finalize_migration_dst(params):

    """Finalize the instance migration on the destination node.

    """

    instance, info, success = params

    instance = objects.Instance.FromDict(instance)

    return backend.FinalizeMigrationDst(instance, info, success)

  @staticmethod

  def perspective_instance_migrate(params):

    """Migrates an instance.

    """

    instance, target, live = params

    instance = objects.Instance.FromDict(instance)

    return backend.MigrateInstance(instance, target, live)

  @staticmethod

  def perspective_instance_finalize_migration_src(params):

    """Finalize the instance migration on the source node.

    """

    instance, success, live = params

    instance = objects.Instance.FromDict(instance)

    return backend.FinalizeMigrationSource(instance, success, live)

  @staticmethod

  def perspective_instance_get_migration_status(params):

    """Reports migration status.

    """

    instance = objects.Instance.FromDict(params[0])

    return backend.GetMigrationStatus(instance).ToDict()

  @staticmethod

  def perspective_instance_reboot(params):

    """Reboot an instance.

    """

    instance = objects.Instance.FromDict(params[0])

    reboot_type = params[1]

    shutdown_timeout = params[2]

    trail = params[3]

    _extendReasonTrail(trail, "reboot")

    return backend.InstanceReboot(instance, reboot_type, shutdown_timeout,

                                  trail)

  @staticmethod

  def perspective_instance_balloon_memory(params):

    """Modify instance runtime memory.

    """

    instance_dict, memory = params

    instance = objects.Instance.FromDict(instance_dict)

    return backend.InstanceBalloonMemory(instance, memory)

  @staticmethod

  def perspective_instance_info(params):

    """Query instance information.

    """

    return backend.GetInstanceInfo(params[0], params[1])

  @staticmethod

  def perspective_instance_migratable(params):

    """Query whether the specified instance can be migrated.

    """

    instance = objects.Instance.FromDict(params[0])

    return backend.GetInstanceMigratable(instance)

  @staticmethod

  def perspective_all_instances_info(params):

    """Query information about all instances.

    """

    return backend.GetAllInstancesInfo(params[0])

  @staticmethod

  def perspective_instance_list(params):

    """Query the list of running instances.

    """

    return backend.GetInstanceList(params[0])

  # node --------------------------

  @staticmethod

  def perspective_node_has_ip_address(params):

    """Checks if a node has the given ip address.

    """

    return netutils.IPAddress.Own(params[0])

  @staticmethod

  def perspective_node_info(params):

    """Query node information.

    """

    (vg_names, hv_names, excl_stor) = params

    return backend.GetNodeInfo(vg_names, hv_names, excl_stor)

  @staticmethod

  def perspective_etc_hosts_modify(params):

    """Modify a node entry in /etc/hosts.

    """

    backend.EtcHostsModify(params[0], params[1], params[2])

    return True

  @staticmethod

  def perspective_node_verify(params):

    """Run a verify sequence on this node.

    """

    return backend.VerifyNode(params[0], params[1])

  @classmethod

  def perspective_node_verify_light(cls, params):

    """Run a light verify sequence on this node.

    """

    # So far it's the same as the normal node_verify

    return cls.perspective_node_verify(params)

  @staticmethod

  def perspective_node_start_master_daemons(params):

    """Start the master daemons on this node.

    """

    return backend.StartMasterDaemons(params[0])

  @staticmethod

  def perspective_node_activate_master_ip(params):

    """Activate the master IP on this node.

    """

    master_params = objects.MasterNetworkParameters.FromDict(params[0])

    return backend.ActivateMasterIp(master_params, params[1])

  @staticmethod

  def perspective_node_deactivate_master_ip(params):

    """Deactivate the master IP on this node.

    """

    master_params = objects.MasterNetworkParameters.FromDict(params[0])

    return backend.DeactivateMasterIp(master_params, params[1])

  @staticmethod

  def perspective_node_stop_master(params):

    """Stops master daemons on this node.

    """

    return backend.StopMasterDaemons()