¡@

Home 

OpenStack Study: emc_smis_fc.py

OpenStack Index

**** CubicPower OpenStack Study ****

# Copyright (c) 2014 EMC Corporation.

# 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.

"""

FC Drivers for EMC VNX and VMAX arrays based on SMI-S.

"""

from cinder import context

from cinder.openstack.common import log as logging

from cinder.volume import driver

from cinder.volume.drivers.emc import emc_smis_common

LOG = logging.getLogger(__name__)

**** CubicPower OpenStack Study ****

class EMCSMISFCDriver(driver.FibreChannelDriver):

"""EMC FC Drivers for VMAX and VNX using SMI-S.

Version history:

1.0.0 - Initial driver

1.1.0 - Multiple pools and thick/thin provisioning,

performance enhancement.

"""

VERSION = "1.1.0"

**** CubicPower OpenStack Study ****

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

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

        self.common = emc_smis_common.EMCSMISCommon(

            'FC',

            configuration=self.configuration)

**** CubicPower OpenStack Study ****

    def check_for_setup_error(self):

        pass

**** CubicPower OpenStack Study ****

    def create_volume(self, volume):

        """Creates a EMC(VMAX/VNX) volume."""

        volpath = self.common.create_volume(volume)

        ctxt = context.get_admin_context()

        model_update = {}

        volume['provider_location'] = str(volpath)

        model_update['provider_location'] = volume['provider_location']

        return model_update

**** CubicPower OpenStack Study ****

    def create_volume_from_snapshot(self, volume, snapshot):

        """Creates a volume from a snapshot."""

        volpath = self.common.create_volume_from_snapshot(volume, snapshot)

        ctxt = context.get_admin_context()

        model_update = {}

        volume['provider_location'] = str(volpath)

        model_update['provider_location'] = volume['provider_location']

        return model_update

**** CubicPower OpenStack Study ****

    def create_cloned_volume(self, volume, src_vref):

        """Creates a cloned volume."""

        volpath = self.common.create_cloned_volume(volume, src_vref)

        ctxt = context.get_admin_context()

        model_update = {}

        volume['provider_location'] = str(volpath)

        model_update['provider_location'] = volume['provider_location']

        return model_update

**** CubicPower OpenStack Study ****

    def delete_volume(self, volume):

        """Deletes an EMC volume."""

        self.common.delete_volume(volume)

**** CubicPower OpenStack Study ****

    def create_snapshot(self, snapshot):

        """Creates a snapshot."""

        ctxt = context.get_admin_context()

        volumename = snapshot['volume_name']

        index = volumename.index('-')

        volumeid = volumename[index + 1:]

        volume = self.db.volume_get(ctxt, volumeid)

        volpath = self.common.create_snapshot(snapshot, volume)

        model_update = {}

        snapshot['provider_location'] = str(volpath)

        model_update['provider_location'] = snapshot['provider_location']

        return model_update

**** CubicPower OpenStack Study ****

    def delete_snapshot(self, snapshot):

        """Deletes a snapshot."""

        ctxt = context.get_admin_context()

        volumename = snapshot['volume_name']

        index = volumename.index('-')

        volumeid = volumename[index + 1:]

        volume = self.db.volume_get(ctxt, volumeid)

        self.common.delete_snapshot(snapshot, volume)

**** CubicPower OpenStack Study ****

    def ensure_export(self, context, volume):

        """Driver entry point to get the export info for an existing volume."""

        pass

**** CubicPower OpenStack Study ****

    def create_export(self, context, volume):

        """Driver entry point to get the export info for a new volume."""

        pass

**** CubicPower OpenStack Study ****

    def remove_export(self, context, volume):

        """Driver entry point to remove an export for a volume."""

        pass

**** CubicPower OpenStack Study ****

    def check_for_export(self, context, volume_id):

        """Make sure volume is exported."""

        pass

**** CubicPower OpenStack Study ****

    def initialize_connection(self, volume, connector):

        """Initializes the connection and returns connection info.

        Assign any created volume to a compute node/host so that it can be

        used from that host.

        The  driver returns a driver_volume_type of 'fibre_channel'.

        The target_wwn can be a single entry or a list of wwns that

        correspond to the list of remote wwn(s) that will export the volume.

        Example return values:

            {

                'driver_volume_type': 'fibre_channel'

                'data': {

                    'target_discovered': True,

                    'target_lun': 1,

                    'target_wwn': '1234567890123',

                }

            }

            or

             {

                'driver_volume_type': 'fibre_channel'

                'data': {

                    'target_discovered': True,

                    'target_lun': 1,

                    'target_wwn': ['1234567890123', '0987654321321'],

                }

            }

        """

        device_info = self.common.initialize_connection(volume,

                                                        connector)

        device_number = device_info['hostlunid']

        storage_system = device_info['storagesystem']

        target_wwns, init_targ_map = self._build_initiator_target_map(

            storage_system, connector)

        data = {'driver_volume_type': 'fibre_channel',

                'data': {'target_lun': device_number,

                         'target_discovered': True,

                         'target_wwn': target_wwns,

                         'initiator_target_map': init_targ_map}}

        LOG.debug(_('Return FC data: %(data)s.')

                  % {'data': data})

        return data

**** CubicPower OpenStack Study ****

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

        """Disallow connection from connector."""

        self.common.terminate_connection(volume, connector)

        loc = volume['provider_location']

        name = eval(loc)

        storage_system = name['keybindings']['SystemName']

        target_wwns, init_targ_map = self._build_initiator_target_map(

            storage_system, connector)

        data = {'driver_volume_type': 'fibre_channel',

                'data': {'target_wwn': target_wwns,

                         'initiator_target_map': init_targ_map}}

        LOG.debug(_('Return FC data: %(data)s.')

                  % {'data': data})

        return data

**** CubicPower OpenStack Study ****

    def _build_initiator_target_map(self, storage_system, connector):

        """Build the target_wwns and the initiator target map."""

        target_wwns = self.common.get_target_wwns(storage_system, connector)

        initiator_wwns = connector['wwpns']

        init_targ_map = {}

        for initiator in initiator_wwns:

            init_targ_map[initiator] = target_wwns

        return target_wwns, init_targ_map

**** CubicPower OpenStack Study ****

    def extend_volume(self, volume, new_size):

        """Extend an existing volume."""

        self.common.extend_volume(volume, new_size)

**** CubicPower OpenStack Study ****

    def get_volume_stats(self, refresh=False):

        """Get volume stats.

        If 'refresh' is True, run update the stats first.

        """

        if refresh:

            self.update_volume_stats()

        return self._stats

**** CubicPower OpenStack Study ****

    def update_volume_stats(self):

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

        LOG.debug(_("Updating volume stats"))

        data = self.common.update_volume_stats()

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

        data['volume_backend_name'] = backend_name or 'EMCSMISFCDriver'

        data['storage_protocol'] = 'FC'

        data['driver_version'] = self.VERSION

        self._stats = data