559 lines
25 KiB
Python
559 lines
25 KiB
Python
# Copyright (c) 2014 NetApp 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.
|
|
"""NAS share manager managers creating shares and access rights.
|
|
|
|
**Related Flags**
|
|
|
|
:share_driver: Used by :class:`ShareManager`.
|
|
"""
|
|
|
|
from oslo_config import cfg
|
|
from oslo_log import log
|
|
from oslo_utils import excutils
|
|
from oslo_utils import importutils
|
|
from oslo_utils import timeutils
|
|
import six
|
|
|
|
from manila.common import constants
|
|
from manila import context
|
|
from manila import exception
|
|
from manila.i18n import _LE
|
|
from manila.i18n import _LI
|
|
from manila.i18n import _LW
|
|
from manila import manager
|
|
from manila import quota
|
|
import manila.share.configuration
|
|
from manila.share import utils as share_utils
|
|
from manila import utils
|
|
|
|
LOG = log.getLogger(__name__)
|
|
|
|
share_manager_opts = [
|
|
cfg.StrOpt('share_driver',
|
|
default='manila.share.drivers.generic.GenericShareDriver',
|
|
help='Driver to use for share creation.'),
|
|
cfg.BoolOpt('delete_share_server_with_last_share',
|
|
default=False,
|
|
help='Whether share servers will '
|
|
'be deleted on deletion of the last share.'),
|
|
]
|
|
|
|
CONF = cfg.CONF
|
|
CONF.register_opts(share_manager_opts)
|
|
|
|
# Drivers that need to change module paths or class names can add their
|
|
# old/new path here to maintain backward compatibility.
|
|
MAPPING = {
|
|
'manila.share.drivers.netapp.cluster_mode.NetAppClusteredShareDriver':
|
|
'manila.share.drivers.netapp.common.NetAppDriver', }
|
|
|
|
QUOTAS = quota.QUOTAS
|
|
|
|
|
|
class ShareManager(manager.SchedulerDependentManager):
|
|
"""Manages NAS storages."""
|
|
|
|
def __init__(self, share_driver=None, service_name=None, *args, **kwargs):
|
|
"""Load the driver from args, or from flags."""
|
|
self.configuration = manila.share.configuration.Configuration(
|
|
share_manager_opts,
|
|
config_group=service_name)
|
|
super(ShareManager, self).__init__(service_name='share',
|
|
*args, **kwargs)
|
|
|
|
if not share_driver:
|
|
share_driver = self.configuration.share_driver
|
|
if share_driver in MAPPING:
|
|
msg_args = {'old': share_driver, 'new': MAPPING[share_driver]}
|
|
LOG.warning(_LW("Driver path %(old)s is deprecated, update your "
|
|
"configuration to the new path %(new)s"),
|
|
msg_args)
|
|
share_driver = MAPPING[share_driver]
|
|
|
|
self.driver = importutils.import_object(
|
|
share_driver, self.db, configuration=self.configuration)
|
|
|
|
def _ensure_share_has_pool(self, ctxt, share):
|
|
pool = share_utils.extract_host(share['host'], 'pool')
|
|
if pool is None:
|
|
# No pool name encoded in host, so this is a legacy
|
|
# share created before pool is introduced, ask
|
|
# driver to provide pool info if it has such
|
|
# knowledge and update the DB.
|
|
try:
|
|
pool = self.driver.get_pool(share)
|
|
except Exception as err:
|
|
LOG.error(_LE("Failed to fetch pool name for share: "
|
|
"%(share)s. Error: %(error)s."),
|
|
{'share': share['id'], 'error': err})
|
|
return
|
|
|
|
if pool:
|
|
new_host = share_utils.append_host(share['host'], pool)
|
|
self.db.share_update(ctxt, share['id'], {'host': new_host})
|
|
|
|
return pool
|
|
|
|
def init_host(self):
|
|
"""Initialization for a standalone service."""
|
|
|
|
ctxt = context.get_admin_context()
|
|
self.driver.do_setup(ctxt)
|
|
self.driver.check_for_setup_error()
|
|
|
|
shares = self.db.share_get_all_by_host(ctxt, self.host)
|
|
LOG.debug("Re-exporting %s shares", len(shares))
|
|
for share in shares:
|
|
if share['status'] == 'available':
|
|
self._ensure_share_has_pool(ctxt, share)
|
|
share_server = self._get_share_server(ctxt, share)
|
|
try:
|
|
self.driver.ensure_share(
|
|
ctxt, share, share_server=share_server)
|
|
except Exception as e:
|
|
LOG.error(
|
|
_LE("Caught exception trying ensure share '%(s_id)s'. "
|
|
"Exception: \n%(e)s."),
|
|
{'s_id': share['id'], 'e': six.text_type(e)},
|
|
)
|
|
continue
|
|
rules = self.db.share_access_get_all_for_share(ctxt,
|
|
share['id'])
|
|
for access_ref in rules:
|
|
if access_ref['state'] == access_ref.STATE_ACTIVE:
|
|
try:
|
|
self.driver.allow_access(ctxt, share,
|
|
access_ref,
|
|
share_server=share_server)
|
|
except exception.ShareAccessExists:
|
|
pass
|
|
except Exception as e:
|
|
LOG.error(
|
|
_LE("Unexpected exception during share access"
|
|
" allow operation. Share id is '%(s_id)s'"
|
|
", access rule type is '%(ar_type)s', "
|
|
"access rule id is '%(ar_id)s', exception"
|
|
" is '%(e)s'."),
|
|
{'s_id': share['id'],
|
|
'ar_type': access_ref['access_type'],
|
|
'ar_id': access_ref['id'],
|
|
'e': six.text_type(e)},
|
|
)
|
|
else:
|
|
LOG.info(
|
|
_LI("Share %(name)s: skipping export, because it has "
|
|
"'%(status)s' status."),
|
|
{'name': share['name'], 'status': share['status']},
|
|
)
|
|
|
|
self.publish_service_capabilities(ctxt)
|
|
|
|
def _provide_share_server_for_share(self, context, share_network_id,
|
|
share_id):
|
|
"""Gets or creates share_server and updates share with its id.
|
|
|
|
Active share_server can be deleted if there are no dependent shares
|
|
on it.
|
|
So we need avoid possibility to delete share_server in time gap
|
|
between reaching active state for share_server and setting up
|
|
share_server_id for share. It is possible, for example, with first
|
|
share creation, which starts share_server creation.
|
|
For this purpose used shared lock between this method and the one
|
|
with deletion of share_server.
|
|
|
|
:returns: dict, dict -- first value is share_server, that
|
|
has been chosen for share schedule. Second value is
|
|
share updated with share_server_id.
|
|
"""
|
|
|
|
@utils.synchronized("share_manager_%s" % share_network_id)
|
|
def _provide_share_server_for_share():
|
|
exist = False
|
|
try:
|
|
share_server = \
|
|
self.db.share_server_get_by_host_and_share_net_valid(
|
|
context, self.host, share_network_id)
|
|
exist = True
|
|
except exception.ShareServerNotFound:
|
|
share_server = self.db.share_server_create(
|
|
context,
|
|
{
|
|
'host': self.host,
|
|
'share_network_id': share_network_id,
|
|
'status': constants.STATUS_CREATING
|
|
}
|
|
)
|
|
|
|
LOG.debug("Using share_server %s for share %s" % (
|
|
share_server['id'], share_id))
|
|
share_ref = self.db.share_update(
|
|
context,
|
|
share_id,
|
|
{'share_server_id': share_server['id']},
|
|
)
|
|
|
|
if not exist:
|
|
# Create share server on backend with data from db
|
|
share_server = self._setup_server(context, share_server)
|
|
LOG.info(_LI("Share server created successfully."))
|
|
else:
|
|
LOG.info(_LI("Used already existed share server "
|
|
"'%(share_server_id)s'"),
|
|
{'share_server_id': share_server['id']})
|
|
return share_server, share_ref
|
|
|
|
return _provide_share_server_for_share()
|
|
|
|
def _get_share_server(self, context, share):
|
|
if share['share_server_id']:
|
|
return self.db.share_server_get(
|
|
context, share['share_server_id'])
|
|
else:
|
|
return None
|
|
|
|
def create_share(self, context, share_id, request_spec=None,
|
|
filter_properties=None, snapshot_id=None):
|
|
"""Creates a share."""
|
|
context = context.elevated()
|
|
if filter_properties is None:
|
|
filter_properties = {}
|
|
|
|
share_ref = self.db.share_get(context, share_id)
|
|
share_network_id = share_ref.get('share_network_id', None)
|
|
|
|
if share_network_id and not self.driver.driver_handles_share_servers:
|
|
self.db.share_update(context, share_id, {'status': 'error'})
|
|
raise exception.ManilaException(
|
|
"Driver does not expect share-network to be provided "
|
|
"with current configuration.")
|
|
|
|
if snapshot_id is not None:
|
|
snapshot_ref = self.db.share_snapshot_get(context, snapshot_id)
|
|
parent_share_server_id = snapshot_ref['share']['share_server_id']
|
|
else:
|
|
snapshot_ref = None
|
|
parent_share_server_id = None
|
|
|
|
if parent_share_server_id:
|
|
try:
|
|
share_server = self.db.share_server_get(context,
|
|
parent_share_server_id)
|
|
LOG.debug("Using share_server "
|
|
"%s for share %s" % (share_server['id'], share_id))
|
|
share_ref = self.db.share_update(
|
|
context, share_id, {'share_server_id': share_server['id']})
|
|
except exception.ShareServerNotFound:
|
|
with excutils.save_and_reraise_exception():
|
|
LOG.error(_LE("Share server %s does not exist."),
|
|
parent_share_server_id)
|
|
self.db.share_update(context, share_id,
|
|
{'status': 'error'})
|
|
elif share_network_id:
|
|
try:
|
|
share_server, share_ref = self._provide_share_server_for_share(
|
|
context, share_network_id, share_id)
|
|
except Exception:
|
|
with excutils.save_and_reraise_exception():
|
|
LOG.error(_LE("Failed to get share server"
|
|
" for share creation."))
|
|
self.db.share_update(context, share_id,
|
|
{'status': 'error'})
|
|
else:
|
|
share_server = None
|
|
|
|
try:
|
|
if snapshot_ref:
|
|
export_location = self.driver.create_share_from_snapshot(
|
|
context, share_ref, snapshot_ref,
|
|
share_server=share_server)
|
|
else:
|
|
export_location = self.driver.create_share(
|
|
context, share_ref, share_server=share_server)
|
|
self.db.share_update(context, share_id,
|
|
{'export_location': export_location})
|
|
except Exception as e:
|
|
with excutils.save_and_reraise_exception():
|
|
LOG.error(_LE("Share %s failed on creation."), share_id)
|
|
detail_data = getattr(e, 'detail_data', {})
|
|
if (isinstance(detail_data, dict) and
|
|
detail_data.get('export_location')):
|
|
self.db.share_update(
|
|
context, share_id,
|
|
{'export_location': detail_data['export_location']})
|
|
else:
|
|
LOG.warning(_LW('Share information in exception '
|
|
'can not be written to db because it '
|
|
'contains %s and it is not a dictionary.'),
|
|
detail_data)
|
|
self.db.share_update(context, share_id, {'status': 'error'})
|
|
else:
|
|
LOG.info(_LI("Share created successfully."))
|
|
self.db.share_update(context, share_id,
|
|
{'status': 'available',
|
|
'launched_at': timeutils.utcnow()})
|
|
|
|
def delete_share(self, context, share_id):
|
|
"""Delete a share."""
|
|
context = context.elevated()
|
|
share_ref = self.db.share_get(context, share_id)
|
|
share_server = self._get_share_server(context, share_ref)
|
|
|
|
if context.project_id != share_ref['project_id']:
|
|
project_id = share_ref['project_id']
|
|
else:
|
|
project_id = context.project_id
|
|
rules = self.db.share_access_get_all_for_share(context, share_id)
|
|
try:
|
|
for access_ref in rules:
|
|
self._deny_access(context, access_ref, share_ref, share_server)
|
|
self.driver.delete_share(context, share_ref,
|
|
share_server=share_server)
|
|
except Exception:
|
|
with excutils.save_and_reraise_exception():
|
|
self.db.share_update(context, share_id,
|
|
{'status': 'error_deleting'})
|
|
try:
|
|
reservations = QUOTAS.reserve(context,
|
|
project_id=project_id,
|
|
shares=-1,
|
|
gigabytes=-share_ref['size'])
|
|
except Exception:
|
|
reservations = None
|
|
LOG.exception(_LE("Failed to update usages deleting share"))
|
|
|
|
self.db.share_delete(context, share_id)
|
|
LOG.info(_LI("Share %s: deleted successfully."), share_ref['name'])
|
|
|
|
if reservations:
|
|
QUOTAS.commit(context, reservations, project_id=project_id)
|
|
|
|
if CONF.delete_share_server_with_last_share:
|
|
share_server = self._get_share_server(context, share_ref)
|
|
if share_server and not share_server.shares:
|
|
LOG.debug("Scheduled deletion of share-server "
|
|
"with id '%s' automatically by "
|
|
"deletion of last share.", share_server['id'])
|
|
self.delete_share_server(context, share_server)
|
|
|
|
def create_snapshot(self, context, share_id, snapshot_id):
|
|
"""Create snapshot for share."""
|
|
snapshot_ref = self.db.share_snapshot_get(context, snapshot_id)
|
|
share_server = self._get_share_server(context,
|
|
snapshot_ref['share'])
|
|
try:
|
|
model_update = self.driver.create_snapshot(
|
|
context, snapshot_ref, share_server=share_server)
|
|
|
|
if model_update:
|
|
model_dict = model_update.to_dict()
|
|
self.db.share_snapshot_update(context, snapshot_ref['id'],
|
|
model_dict)
|
|
|
|
except Exception:
|
|
with excutils.save_and_reraise_exception():
|
|
self.db.share_snapshot_update(context,
|
|
snapshot_ref['id'],
|
|
{'status': 'error'})
|
|
|
|
self.db.share_snapshot_update(context,
|
|
snapshot_ref['id'],
|
|
{'status': 'available',
|
|
'progress': '100%'})
|
|
return snapshot_id
|
|
|
|
def delete_snapshot(self, context, snapshot_id):
|
|
"""Delete share snapshot."""
|
|
context = context.elevated()
|
|
snapshot_ref = self.db.share_snapshot_get(context, snapshot_id)
|
|
|
|
share_server = self._get_share_server(context,
|
|
snapshot_ref['share'])
|
|
|
|
if context.project_id != snapshot_ref['project_id']:
|
|
project_id = snapshot_ref['project_id']
|
|
else:
|
|
project_id = context.project_id
|
|
|
|
try:
|
|
self.driver.delete_snapshot(context, snapshot_ref,
|
|
share_server=share_server)
|
|
except exception.ShareSnapshotIsBusy:
|
|
self.db.share_snapshot_update(context, snapshot_ref['id'],
|
|
{'status': 'available'})
|
|
except Exception:
|
|
with excutils.save_and_reraise_exception():
|
|
self.db.share_snapshot_update(context, snapshot_ref['id'],
|
|
{'status': 'error_deleting'})
|
|
else:
|
|
self.db.share_snapshot_destroy(context, snapshot_id)
|
|
try:
|
|
reservations = QUOTAS.reserve(
|
|
context, project_id=project_id, snapshots=-1,
|
|
snapshot_gigabytes=-snapshot_ref['size'])
|
|
except Exception:
|
|
reservations = None
|
|
LOG.exception(_LE("Failed to update usages deleting snapshot"))
|
|
|
|
if reservations:
|
|
QUOTAS.commit(context, reservations, project_id=project_id)
|
|
|
|
def allow_access(self, context, access_id):
|
|
"""Allow access to some share."""
|
|
try:
|
|
access_ref = self.db.share_access_get(context, access_id)
|
|
share_ref = self.db.share_get(context, access_ref['share_id'])
|
|
share_server = self._get_share_server(context,
|
|
share_ref)
|
|
if access_ref['state'] == access_ref.STATE_NEW:
|
|
self.driver.allow_access(context, share_ref, access_ref,
|
|
share_server=share_server)
|
|
self.db.share_access_update(
|
|
context, access_id, {'state': access_ref.STATE_ACTIVE})
|
|
except Exception:
|
|
with excutils.save_and_reraise_exception():
|
|
self.db.share_access_update(
|
|
context, access_id, {'state': access_ref.STATE_ERROR})
|
|
|
|
def deny_access(self, context, access_id):
|
|
"""Deny access to some share."""
|
|
access_ref = self.db.share_access_get(context, access_id)
|
|
share_ref = self.db.share_get(context, access_ref['share_id'])
|
|
share_server = self._get_share_server(context,
|
|
share_ref)
|
|
self._deny_access(context, access_ref, share_ref, share_server)
|
|
|
|
def _deny_access(self, context, access_ref, share_ref, share_server):
|
|
access_id = access_ref['id']
|
|
try:
|
|
self.driver.deny_access(context, share_ref, access_ref,
|
|
share_server=share_server)
|
|
except Exception:
|
|
with excutils.save_and_reraise_exception():
|
|
self.db.share_access_update(
|
|
context, access_id, {'state': access_ref.STATE_ERROR})
|
|
self.db.share_access_delete(context, access_id)
|
|
|
|
@manager.periodic_task
|
|
def _report_driver_status(self, context):
|
|
LOG.info(_LI('Updating share status'))
|
|
share_stats = self.driver.get_share_stats(refresh=True)
|
|
if share_stats:
|
|
self.update_service_capabilities(share_stats)
|
|
|
|
def publish_service_capabilities(self, context):
|
|
"""Collect driver status and then publish it."""
|
|
self._report_driver_status(context)
|
|
self._publish_service_capabilities(context)
|
|
|
|
def _form_server_setup_info(self, context, share_server, share_network):
|
|
# Network info is used by driver for setting up share server
|
|
# and getting server info on share creation.
|
|
network_allocations = self.db.network_allocations_get_for_share_server(
|
|
context, share_server['id'])
|
|
network_info = {
|
|
'server_id': share_server['id'],
|
|
'segmentation_id': share_network['segmentation_id'],
|
|
'cidr': share_network['cidr'],
|
|
'neutron_net_id': share_network['neutron_net_id'],
|
|
'neutron_subnet_id': share_network['neutron_subnet_id'],
|
|
'security_services': share_network['security_services'],
|
|
'network_allocations': network_allocations,
|
|
'backend_details': share_server.get('backend_details'),
|
|
}
|
|
return network_info
|
|
|
|
def _setup_server(self, context, share_server, metadata=None):
|
|
try:
|
|
share_network = self.db.share_network_get(
|
|
context, share_server['share_network_id'])
|
|
self.driver.allocate_network(context, share_server, share_network)
|
|
|
|
# Get share_network again in case it was updated.
|
|
share_network = self.db.share_network_get(
|
|
context, share_server['share_network_id'])
|
|
|
|
network_info = self._form_server_setup_info(context, share_server,
|
|
share_network)
|
|
server_info = self.driver.setup_server(network_info,
|
|
metadata=metadata)
|
|
if server_info and isinstance(server_info, dict):
|
|
self.db.share_server_backend_details_set(context,
|
|
share_server['id'],
|
|
server_info)
|
|
return self.db.share_server_update(
|
|
context, share_server['id'],
|
|
{'status': constants.STATUS_ACTIVE})
|
|
except Exception as e:
|
|
with excutils.save_and_reraise_exception():
|
|
detail_data = getattr(e, 'detail_data', {})
|
|
if (type(detail_data) is dict and
|
|
detail_data.get('server_details')):
|
|
|
|
server_details = detail_data['server_details']
|
|
|
|
if isinstance(server_details, dict):
|
|
self.db.share_server_backend_details_set(
|
|
context, share_server['id'], server_details)
|
|
else:
|
|
LOG.warning(_LW('Server Information in '
|
|
'exception can not be written to db '
|
|
'because it contains %s and it is not '
|
|
'a dictionary.'), server_details)
|
|
|
|
self.db.share_server_update(context, share_server['id'],
|
|
{'status': constants.STATUS_ERROR})
|
|
self.driver.deallocate_network(context, share_server['id'])
|
|
|
|
def delete_share_server(self, context, share_server):
|
|
|
|
@utils.synchronized(
|
|
"share_manager_%s" % share_server['share_network_id'])
|
|
def _teardown_server():
|
|
# NOTE(vponomaryov): Verify that there are no dependent shares.
|
|
# Without this verification we can get here exception in next case:
|
|
# share-server-delete API was called after share creation scheduled
|
|
# and share_server reached ACTIVE status, but before update
|
|
# of share_server_id field for share. If so, after lock realese
|
|
# this method starts executing when amount of dependent shares
|
|
# has been changed.
|
|
shares = self.db.share_get_all_by_share_server(
|
|
context, share_server['id'])
|
|
if shares:
|
|
raise exception.ShareServerInUse(
|
|
share_server_id=share_server['id'])
|
|
|
|
self.db.share_server_update(context, share_server['id'],
|
|
{'status': constants.STATUS_DELETING})
|
|
sec_services = self.db.share_network_get(
|
|
context,
|
|
share_server['share_network_id'])['security_services']
|
|
try:
|
|
LOG.debug("Deleting share server")
|
|
self.driver.teardown_server(share_server['backend_details'],
|
|
security_services=sec_services)
|
|
except Exception:
|
|
with excutils.save_and_reraise_exception():
|
|
LOG.error(_LE("Share server %s failed on deletion."),
|
|
share_server['id'])
|
|
self.db.share_server_update(
|
|
context, share_server['id'],
|
|
{'status': constants.STATUS_ERROR})
|
|
else:
|
|
self.db.share_server_delete(context, share_server['id'])
|
|
|
|
_teardown_server()
|
|
LOG.info(_LI("Share server deleted successfully."))
|
|
self.driver.deallocate_network(context, share_server['id'])
|