¡@

Home 

OpenStack Study: block_device.py

OpenStack Index

**** CubicPower OpenStack Study ****

# Copyright (c) 2013 Mirantis, Inc.

# All Rights Reserved.

#

# Licensed under the Apache License, Version 2.0 (the "License"); you may

# not use this file except in compliance with the License. You may obtain

# a copy of the License at

#

# http://www.apache.org/licenses/LICENSE-2.0

#

# Unless required by applicable law or agreed to in writing, software

# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT

# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the

# License for the specific language governing permissions and limitations

# under the License.

import os

from oslo.config import cfg

from cinder import context

from cinder.db.sqlalchemy import api

from cinder import exception

from cinder.image import image_utils

from cinder.openstack.common import log as logging

from cinder.volume import driver

from cinder.volume import utils as volutils

LOG = logging.getLogger(__name__)

volume_opts = [

cfg.ListOpt('available_devices',

default=[],

help='List of all available devices'),

]

CONF = cfg.CONF

CONF.register_opts(volume_opts)

**** CubicPower OpenStack Study ****

class BlockDeviceDriver(driver.ISCSIDriver):

VERSION = '1.0.0'

**** CubicPower OpenStack Study ****

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

        self.target_helper = self.get_target_helper(kwargs.get('db'))

        super(BlockDeviceDriver, self).__init__(*args, **kwargs)

        self.configuration.append_config_values(volume_opts)

**** CubicPower OpenStack Study ****

    def set_execute(self, execute):

        super(BlockDeviceDriver, self).set_execute(execute)

        if self.target_helper is not None:

            self.target_helper.set_execute(execute)

**** CubicPower OpenStack Study ****

    def check_for_setup_error(self):

        pass

**** CubicPower OpenStack Study ****

    def create_volume(self, volume):

        device = self.find_appropriate_size_device(volume['size'])

        LOG.info("Create %s on %s" % (volume['name'], device))

        return {

            'provider_location': device,

        }

**** CubicPower OpenStack Study ****

    def initialize_connection(self, volume, connector):

        if connector['host'] != volume['host']:

            return super(BlockDeviceDriver, self). \

                initialize_connection(volume, connector)

        else:

            return {

                'driver_volume_type': 'local',

                'data': {'device_path': self.local_path(volume)},

            }

**** CubicPower OpenStack Study ****

    def terminate_connection(self, volume, connector, **kwargs):

        pass

**** CubicPower OpenStack Study ****

    def create_export(self, context, volume):

        """Creates an export for a logical volume."""

        volume_path = self.local_path(volume)

        data = self.target_helper.create_export(context, volume, volume_path)

        return {

            'provider_location': data['location'] + ' ' + volume_path,

            'provider_auth': data['auth'],

        }

**** CubicPower OpenStack Study ****

    def remove_export(self, context, volume):

        self.target_helper.remove_export(context, volume)

**** CubicPower OpenStack Study ****

    def ensure_export(self, context, volume):

        volume_name = volume['name']

        iscsi_name = "%s%s" % (self.configuration.iscsi_target_prefix,

                               volume_name)

        volume_path = self.local_path(volume)

        # NOTE(jdg): For TgtAdm case iscsi_name is the ONLY param we need

        # should clean this all up at some point in the future

        self.target_helper.ensure_export(context, volume, iscsi_name,

                                         volume_path)

**** CubicPower OpenStack Study ****

    def delete_volume(self, volume):

        """Deletes a logical volume."""

        dev_path = self.local_path(volume)

        if not dev_path or dev_path not in \

                self.configuration.available_devices:

            return

        if os.path.exists(dev_path) and \

                self.configuration.volume_clear != 'none':

            volutils.clear_volume(

                self._get_device_size(dev_path), dev_path,

                volume_clear=self.configuration.volume_clear,

                volume_clear_size=self.configuration.volume_clear_size)

**** CubicPower OpenStack Study ****

    def local_path(self, volume):

        if volume['provider_location']:

            path = volume['provider_location'].rsplit(" ", 1)

            return path[-1]

        else:

            return None

**** CubicPower OpenStack Study ****

    def copy_image_to_volume(self, context, volume, image_service, image_id):

        """Fetch the image from image_service and write it to the volume."""

        image_utils.fetch_to_raw(context,

                                 image_service,

                                 image_id,

                                 self.local_path(volume),

                                 self.configuration.volume_dd_blocksize,

                                 size=volume['size'])

**** CubicPower OpenStack Study ****

    def copy_volume_to_image(self, context, volume, image_service, image_meta):

        """Copy the volume to the specified image."""

        image_utils.upload_volume(context,

                                  image_service,

                                  image_meta,

                                  self.local_path(volume))

**** CubicPower OpenStack Study ****

    def create_cloned_volume(self, volume, src_vref):

        LOG.info(_('Creating clone of volume: %s') % src_vref['id'])

        device = self.find_appropriate_size_device(src_vref['size'])

        volutils.copy_volume(

            self.local_path(src_vref), device,

            self._get_device_size(device) * 2048,

            self.configuration.volume_dd_blocksize,

            execute=self._execute)

        return {

            'provider_location': device,

        }

**** CubicPower OpenStack Study ****

    def get_volume_stats(self, refresh=False):

        if refresh:

            self._update_volume_stats()

        return self._stats

**** CubicPower OpenStack Study ****

    def _update_volume_stats(self):

        """Retrieve stats info from volume group."""

        dict_of_devices_sizes = self._devices_sizes()

        used_devices = self._get_used_devices()

        total_size = 0

        free_size = 0

        for device, size in dict_of_devices_sizes.iteritems():

            if device not in used_devices:

                free_size += size

            total_size += size

        LOG.debug("Updating volume stats")

        backend_name = self.configuration.safe_get('volume_backend_name')

        data = {'total_capacity_gb': total_size / 1024,

                'free_capacity_gb': free_size / 1024,

                'reserved_percentage': self.configuration.reserved_percentage,

                'QoS_support': False,

                'volume_backend_name': backend_name or self.__class__.__name__,

                'vendor_name': "Open Source",

                'driver_version': self.VERSION,

                'storage_protocol': 'unknown'}

        self._stats = data

**** CubicPower OpenStack Study ****

    def _get_used_devices(self):

        lst = api.volume_get_all_by_host(context.get_admin_context(),

                                         self.configuration.host)

        used_devices = set()

        for volume in lst:

            local_path = self.local_path(volume)

            if local_path:

                used_devices.add(local_path)

        return used_devices

**** CubicPower OpenStack Study ****

    def _get_device_size(self, dev_path):

        out, err = self._execute('blockdev', '--getsz', dev_path,

                                 run_as_root=True)

        size_in_m = int(out)

        return size_in_m / 2048

**** CubicPower OpenStack Study ****

    def _devices_sizes(self):

        available_devices = self.configuration.available_devices

        dict_of_devices_sizes = {}

        for device in available_devices:

            dict_of_devices_sizes[device] = self._get_device_size(device)

        return dict_of_devices_sizes

**** CubicPower OpenStack Study ****

    def find_appropriate_size_device(self, size):

        dict_of_devices_sizes = self._devices_sizes()

        free_devices = (set(self.configuration.available_devices) -

                        self._get_used_devices())

        if not free_devices:

            raise exception.CinderException(_("No free disk"))

        possible_device = None

        possible_device_size = None

        for device in free_devices:

            dev_size = dict_of_devices_sizes[device]

            if size * 1024 <= dev_size and (possible_device is None or

                                            dev_size < possible_device_size):

                possible_device = device

                possible_device_size = dev_size

        if possible_device:

            return possible_device

        else:

            raise exception.CinderException(_("No big enough free disk"))