942 lines
36 KiB
Python
942 lines
36 KiB
Python
# Copyright 2013 SolidFire 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 base64
|
|
import httplib
|
|
import json
|
|
import random
|
|
import socket
|
|
import string
|
|
import time
|
|
import uuid
|
|
|
|
from oslo.config import cfg
|
|
|
|
from cinder import context
|
|
from cinder import exception
|
|
from cinder.i18n import _
|
|
from cinder.openstack.common import log as logging
|
|
from cinder.openstack.common import timeutils
|
|
from cinder.openstack.common import units
|
|
from cinder.volume.drivers.san.san import SanISCSIDriver
|
|
from cinder.volume import qos_specs
|
|
from cinder.volume import volume_types
|
|
|
|
LOG = logging.getLogger(__name__)
|
|
|
|
sf_opts = [
|
|
cfg.BoolOpt('sf_emulate_512',
|
|
default=True,
|
|
help='Set 512 byte emulation on volume creation; '),
|
|
|
|
cfg.BoolOpt('sf_allow_tenant_qos',
|
|
default=False,
|
|
help='Allow tenants to specify QOS on create'),
|
|
|
|
cfg.StrOpt('sf_account_prefix',
|
|
default=None,
|
|
help='Create SolidFire accounts with this prefix. Any string '
|
|
'can be used here, but the string \"hostname\" is special '
|
|
'and will create a prefix using the cinder node hostsname '
|
|
'(previous default behavior). The default is NO prefix.'),
|
|
|
|
cfg.IntOpt('sf_api_port',
|
|
default=443,
|
|
help='SolidFire API port. Useful if the device api is behind '
|
|
'a proxy on a different port.'), ]
|
|
|
|
|
|
CONF = cfg.CONF
|
|
CONF.register_opts(sf_opts)
|
|
|
|
|
|
class SolidFireDriver(SanISCSIDriver):
|
|
"""OpenStack driver to enable SolidFire cluster.
|
|
|
|
Version history:
|
|
1.0 - Initial driver
|
|
1.1 - Refactor, clone support, qos by type and minor bug fixes
|
|
1.2 - Add xfr and retype support
|
|
1.2.1 - Add export/import support
|
|
1.2.2 - Catch VolumeNotFound on accept xfr
|
|
|
|
"""
|
|
|
|
VERSION = '1.2.2'
|
|
|
|
sf_qos_dict = {'slow': {'minIOPS': 100,
|
|
'maxIOPS': 200,
|
|
'burstIOPS': 200},
|
|
'medium': {'minIOPS': 200,
|
|
'maxIOPS': 400,
|
|
'burstIOPS': 400},
|
|
'fast': {'minIOPS': 500,
|
|
'maxIOPS': 1000,
|
|
'burstIOPS': 1000},
|
|
'performant': {'minIOPS': 2000,
|
|
'maxIOPS': 4000,
|
|
'burstIOPS': 4000},
|
|
'off': None}
|
|
|
|
sf_qos_keys = ['minIOPS', 'maxIOPS', 'burstIOPS']
|
|
cluster_stats = {}
|
|
|
|
def __init__(self, *args, **kwargs):
|
|
super(SolidFireDriver, self).__init__(*args, **kwargs)
|
|
self.configuration.append_config_values(sf_opts)
|
|
try:
|
|
self._update_cluster_status()
|
|
except exception.SolidFireAPIException:
|
|
pass
|
|
|
|
def _issue_api_request(self, method_name, params, version='1.0'):
|
|
"""All API requests to SolidFire device go through this method.
|
|
|
|
Simple json-rpc web based API calls.
|
|
each call takes a set of parameters (dict)
|
|
and returns results in a dict as well.
|
|
|
|
"""
|
|
max_simultaneous_clones = ['xMaxSnapshotsPerVolumeExceeded',
|
|
'xMaxClonesPerVolumeExceeded',
|
|
'xMaxSnapshotsPerNodeExceeded',
|
|
'xMaxClonesPerNodeExceeded']
|
|
host = self.configuration.san_ip
|
|
port = self.configuration.sf_api_port
|
|
|
|
cluster_admin = self.configuration.san_login
|
|
cluster_password = self.configuration.san_password
|
|
|
|
# NOTE(jdg): We're wrapping a retry loop for a know XDB issue
|
|
# Shows up in very high request rates (ie create 1000 volumes)
|
|
# we have to wrap the whole sequence because the request_id
|
|
# can't be re-used
|
|
retry_count = 5
|
|
while retry_count > 0:
|
|
request_id = hash(uuid.uuid4()) # just generate a random number
|
|
command = {'method': method_name,
|
|
'id': request_id}
|
|
|
|
if params is not None:
|
|
command['params'] = params
|
|
|
|
json_string = json.dumps(command,
|
|
ensure_ascii=False).encode('utf-8')
|
|
header = {'Content-Type': 'application/json-rpc; charset=utf-8'}
|
|
|
|
if cluster_password is not None:
|
|
# base64.encodestring includes a newline character
|
|
# in the result, make sure we strip it off
|
|
auth_key = base64.encodestring('%s:%s' % (cluster_admin,
|
|
cluster_password))[:-1]
|
|
header['Authorization'] = 'Basic %s' % auth_key
|
|
|
|
LOG.debug("Payload for SolidFire API call: %s", json_string)
|
|
|
|
api_endpoint = '/json-rpc/%s' % version
|
|
connection = httplib.HTTPSConnection(host, port)
|
|
try:
|
|
connection.request('POST', api_endpoint, json_string, header)
|
|
except Exception as ex:
|
|
LOG.error(_('Failed to make httplib connection '
|
|
'SolidFire Cluster: %s (verify san_ip '
|
|
'settings)') % ex.message)
|
|
msg = _("Failed to make httplib connection: %s") % ex.message
|
|
raise exception.SolidFireAPIException(msg)
|
|
response = connection.getresponse()
|
|
|
|
data = {}
|
|
if response.status != 200:
|
|
connection.close()
|
|
LOG.error(_('Request to SolidFire cluster returned '
|
|
'bad status: %(status)s / %(reason)s (check '
|
|
'san_login/san_password settings)') %
|
|
{'status': response.status,
|
|
'reason': response.reason})
|
|
msg = (_("HTTP request failed, with status: %(status)s "
|
|
"and reason: %(reason)s") %
|
|
{'status': response.status, 'reason': response.reason})
|
|
raise exception.SolidFireAPIException(msg)
|
|
|
|
else:
|
|
data = response.read()
|
|
try:
|
|
data = json.loads(data)
|
|
except (TypeError, ValueError) as exc:
|
|
connection.close()
|
|
msg = _("Call to json.loads() raised "
|
|
"an exception: %s") % exc
|
|
raise exception.SfJsonEncodeFailure(msg)
|
|
|
|
connection.close()
|
|
|
|
LOG.debug("Results of SolidFire API call: %s", data)
|
|
|
|
if 'error' in data:
|
|
if data['error']['name'] in max_simultaneous_clones:
|
|
LOG.warning(_('Clone operation '
|
|
'encountered: %s') % data['error']['name'])
|
|
LOG.warning(_(
|
|
'Waiting for outstanding operation '
|
|
'before retrying snapshot: %s') % params['name'])
|
|
time.sleep(5)
|
|
# Don't decrement the retry count for this one
|
|
elif 'xDBVersionMismatch' in data['error']['name']:
|
|
LOG.warning(_('Detected xDBVersionMismatch, '
|
|
'retry %s of 5') % (5 - retry_count))
|
|
time.sleep(1)
|
|
retry_count -= 1
|
|
elif 'xUnknownAccount' in data['error']['name']:
|
|
retry_count = 0
|
|
else:
|
|
msg = _("API response: %s") % data
|
|
raise exception.SolidFireAPIException(msg)
|
|
else:
|
|
retry_count = 0
|
|
|
|
return data
|
|
|
|
def _get_volumes_by_sfaccount(self, account_id):
|
|
"""Get all volumes on cluster for specified account."""
|
|
params = {'accountID': account_id}
|
|
data = self._issue_api_request('ListVolumesForAccount', params)
|
|
if 'result' in data:
|
|
return data['result']['volumes']
|
|
|
|
def _get_sfaccount_by_name(self, sf_account_name):
|
|
"""Get SolidFire account object by name."""
|
|
sfaccount = None
|
|
params = {'username': sf_account_name}
|
|
data = self._issue_api_request('GetAccountByName', params)
|
|
if 'result' in data and 'account' in data['result']:
|
|
LOG.debug('Found solidfire account: %s', sf_account_name)
|
|
sfaccount = data['result']['account']
|
|
return sfaccount
|
|
|
|
def _get_sf_account_name(self, project_id):
|
|
"""Build the SolidFire account name to use."""
|
|
prefix = self.configuration.sf_account_prefix or ''
|
|
if prefix == 'hostname':
|
|
prefix = socket.gethostname()
|
|
return '%s%s%s' % (prefix, '-' if prefix else '', project_id)
|
|
|
|
def _get_sfaccount(self, project_id):
|
|
sf_account_name = self._get_sf_account_name(project_id)
|
|
sfaccount = self._get_sfaccount_by_name(sf_account_name)
|
|
if sfaccount is None:
|
|
raise exception.SolidFireAccountNotFound(
|
|
account_name=sf_account_name)
|
|
|
|
return sfaccount
|
|
|
|
def _create_sfaccount(self, project_id):
|
|
"""Create account on SolidFire device if it doesn't already exist.
|
|
|
|
We're first going to check if the account already exits, if it does
|
|
just return it. If not, then create it.
|
|
|
|
"""
|
|
|
|
sf_account_name = self._get_sf_account_name(project_id)
|
|
sfaccount = self._get_sfaccount_by_name(sf_account_name)
|
|
if sfaccount is None:
|
|
LOG.debug('solidfire account: %s does not exist, create it...',
|
|
sf_account_name)
|
|
chap_secret = self._generate_random_string(12)
|
|
params = {'username': sf_account_name,
|
|
'initiatorSecret': chap_secret,
|
|
'targetSecret': chap_secret,
|
|
'attributes': {}}
|
|
data = self._issue_api_request('AddAccount', params)
|
|
if 'result' in data:
|
|
sfaccount = self._get_sfaccount_by_name(sf_account_name)
|
|
|
|
return sfaccount
|
|
|
|
def _get_cluster_info(self):
|
|
"""Query the SolidFire cluster for some property info."""
|
|
params = {}
|
|
data = self._issue_api_request('GetClusterInfo', params)
|
|
if 'result' not in data:
|
|
msg = _("API response: %s") % data
|
|
raise exception.SolidFireAPIException(msg)
|
|
|
|
return data['result']
|
|
|
|
def _do_export(self, volume):
|
|
"""Gets the associated account, retrieves CHAP info and updates."""
|
|
sfaccount = self._get_sfaccount(volume['project_id'])
|
|
|
|
model_update = {}
|
|
model_update['provider_auth'] = ('CHAP %s %s'
|
|
% (sfaccount['username'],
|
|
sfaccount['targetSecret']))
|
|
|
|
return model_update
|
|
|
|
def _generate_random_string(self, length):
|
|
"""Generates random_string to use for CHAP password."""
|
|
|
|
char_set = string.ascii_uppercase + string.digits
|
|
return ''.join(random.sample(char_set, length))
|
|
|
|
def _get_model_info(self, sfaccount, sf_volume_id):
|
|
"""Gets the connection info for specified account and volume."""
|
|
cluster_info = self._get_cluster_info()
|
|
iscsi_portal = cluster_info['clusterInfo']['svip'] + ':3260'
|
|
chap_secret = sfaccount['targetSecret']
|
|
|
|
found_volume = False
|
|
iteration_count = 0
|
|
while not found_volume and iteration_count < 600:
|
|
volume_list = self._get_volumes_by_sfaccount(
|
|
sfaccount['accountID'])
|
|
iqn = None
|
|
for v in volume_list:
|
|
if v['volumeID'] == sf_volume_id:
|
|
iqn = v['iqn']
|
|
found_volume = True
|
|
break
|
|
if not found_volume:
|
|
time.sleep(2)
|
|
iteration_count += 1
|
|
|
|
if not found_volume:
|
|
LOG.error(_('Failed to retrieve volume SolidFire-'
|
|
'ID: %s in get_by_account!') % sf_volume_id)
|
|
raise exception.VolumeNotFound(volume_id=sf_volume_id)
|
|
|
|
model_update = {}
|
|
# NOTE(john-griffith): SF volumes are always at lun 0
|
|
model_update['provider_location'] = ('%s %s %s'
|
|
% (iscsi_portal, iqn, 0))
|
|
model_update['provider_auth'] = ('CHAP %s %s'
|
|
% (sfaccount['username'],
|
|
chap_secret))
|
|
if not self.configuration.sf_emulate_512:
|
|
model_update['provider_geometry'] = ('%s %s' % (4096, 4096))
|
|
|
|
return model_update
|
|
|
|
def _do_clone_volume(self, src_uuid, src_project_id, v_ref):
|
|
"""Create a clone of an existing volume.
|
|
|
|
Currently snapshots are the same as clones on the SF cluster.
|
|
Due to the way the SF cluster works there's no loss in efficiency
|
|
or space usage between the two. The only thing different right
|
|
now is the restore snapshot functionality which has not been
|
|
implemented in the pre-release version of the SolidFire Cluster.
|
|
|
|
"""
|
|
attributes = {}
|
|
qos = {}
|
|
|
|
sfaccount = self._get_sfaccount(src_project_id)
|
|
params = {'accountID': sfaccount['accountID']}
|
|
|
|
sf_vol = self._get_sf_volume(src_uuid, params)
|
|
if sf_vol is None:
|
|
raise exception.VolumeNotFound(volume_id=src_uuid)
|
|
|
|
if src_project_id != v_ref['project_id']:
|
|
sfaccount = self._create_sfaccount(v_ref['project_id'])
|
|
|
|
if v_ref.get('size', None):
|
|
new_size = v_ref['size']
|
|
else:
|
|
new_size = v_ref['volume_size']
|
|
|
|
params = {'volumeID': int(sf_vol['volumeID']),
|
|
'name': 'UUID-%s' % v_ref['id'],
|
|
'newSize': int(new_size * units.Gi),
|
|
'newAccountID': sfaccount['accountID']}
|
|
data = self._issue_api_request('CloneVolume', params)
|
|
|
|
if (('result' not in data) or ('volumeID' not in data['result'])):
|
|
msg = _("API response: %s") % data
|
|
raise exception.SolidFireAPIException(msg)
|
|
sf_volume_id = data['result']['volumeID']
|
|
|
|
if (self.configuration.sf_allow_tenant_qos and
|
|
v_ref.get('volume_metadata')is not None):
|
|
qos = self._set_qos_presets(v_ref)
|
|
|
|
ctxt = context.get_admin_context()
|
|
type_id = v_ref.get('volume_type_id', None)
|
|
if type_id is not None:
|
|
qos = self._set_qos_by_volume_type(ctxt, type_id)
|
|
|
|
# NOTE(jdg): all attributes are copied via clone, need to do an update
|
|
# to set any that were provided
|
|
params = {'volumeID': sf_volume_id}
|
|
|
|
create_time = timeutils.strtime(v_ref['created_at'])
|
|
attributes = {'uuid': v_ref['id'],
|
|
'is_clone': 'True',
|
|
'src_uuid': src_uuid,
|
|
'created_at': create_time}
|
|
if qos:
|
|
params['qos'] = qos
|
|
for k, v in qos.items():
|
|
attributes[k] = str(v)
|
|
|
|
params['attributes'] = attributes
|
|
data = self._issue_api_request('ModifyVolume', params)
|
|
|
|
model_update = self._get_model_info(sfaccount, sf_volume_id)
|
|
if model_update is None:
|
|
mesg = _('Failed to get model update from clone')
|
|
raise exception.SolidFireAPIException(mesg)
|
|
|
|
return (data, sfaccount, model_update)
|
|
|
|
def _do_volume_create(self, project_id, params):
|
|
sfaccount = self._create_sfaccount(project_id)
|
|
|
|
params['accountID'] = sfaccount['accountID']
|
|
data = self._issue_api_request('CreateVolume', params)
|
|
|
|
if (('result' not in data) or ('volumeID' not in data['result'])):
|
|
msg = _("Failed volume create: %s") % data
|
|
raise exception.SolidFireAPIException(msg)
|
|
|
|
sf_volume_id = data['result']['volumeID']
|
|
return self._get_model_info(sfaccount, sf_volume_id)
|
|
|
|
def _set_qos_presets(self, volume):
|
|
qos = {}
|
|
valid_presets = self.sf_qos_dict.keys()
|
|
|
|
# First look to see if they included a preset
|
|
presets = [i.value for i in volume.get('volume_metadata')
|
|
if i.key == 'sf-qos' and i.value in valid_presets]
|
|
if len(presets) > 0:
|
|
if len(presets) > 1:
|
|
LOG.warning(_('More than one valid preset was '
|
|
'detected, using %s') % presets[0])
|
|
qos = self.sf_qos_dict[presets[0]]
|
|
else:
|
|
# look for explicit settings
|
|
for i in volume.get('volume_metadata'):
|
|
if i.key in self.sf_qos_keys:
|
|
qos[i.key] = int(i.value)
|
|
return qos
|
|
|
|
def _set_qos_by_volume_type(self, ctxt, type_id):
|
|
qos = {}
|
|
volume_type = volume_types.get_volume_type(ctxt, type_id)
|
|
qos_specs_id = volume_type.get('qos_specs_id')
|
|
specs = volume_type.get('extra_specs')
|
|
|
|
# NOTE(jdg): We prefer the qos_specs association
|
|
# and over-ride any existing
|
|
# extra-specs settings if present
|
|
if qos_specs_id is not None:
|
|
kvs = qos_specs.get_qos_specs(ctxt, qos_specs_id)['specs']
|
|
else:
|
|
kvs = specs
|
|
|
|
for key, value in kvs.iteritems():
|
|
if ':' in key:
|
|
fields = key.split(':')
|
|
key = fields[1]
|
|
if key in self.sf_qos_keys:
|
|
qos[key] = int(value)
|
|
return qos
|
|
|
|
def _get_sf_volume(self, uuid, params):
|
|
# TODO(jdg): Going to fix this shortly to not iterate
|
|
# but instead use the cinder UUID and our internal
|
|
# mapping to get this more efficiently
|
|
data = self._issue_api_request('ListVolumesForAccount', params)
|
|
if 'result' not in data:
|
|
msg = _("Failed to get SolidFire Volume: %s") % data
|
|
raise exception.SolidFireAPIException(msg)
|
|
|
|
found_count = 0
|
|
sf_volref = None
|
|
for v in data['result']['volumes']:
|
|
# NOTE(jdg): In the case of "name" we can't
|
|
# update that on manage/import, so we use
|
|
# the uuid attribute
|
|
meta = v.get('attributes')
|
|
alt_id = meta.get('uuid', 'empty')
|
|
|
|
if uuid in v['name'] or uuid in alt_id:
|
|
found_count += 1
|
|
sf_volref = v
|
|
LOG.debug("Mapped SolidFire volumeID %(sfid)s "
|
|
"to cinder ID %(uuid)s." %
|
|
{'sfid': v['volumeID'],
|
|
'uuid': uuid})
|
|
|
|
if found_count == 0:
|
|
# NOTE(jdg): Previously we would raise here, but there are cases
|
|
# where this might be a cleanup for a failed delete.
|
|
# Until we get better states we'll just log an error
|
|
LOG.error(_("Volume %s, not found on SF Cluster."), uuid)
|
|
|
|
if found_count > 1:
|
|
LOG.error(_("Found %(count)s volumes mapped to id: %(uuid)s.") %
|
|
{'count': found_count,
|
|
'uuid': uuid})
|
|
raise exception.DuplicateSfVolumeNames(vol_name=uuid)
|
|
|
|
return sf_volref
|
|
|
|
def create_volume(self, volume):
|
|
"""Create volume on SolidFire device.
|
|
|
|
The account is where CHAP settings are derived from, volume is
|
|
created and exported. Note that the new volume is immediately ready
|
|
for use.
|
|
|
|
One caveat here is that an existing user account must be specified
|
|
in the API call to create a new volume. We use a set algorithm to
|
|
determine account info based on passed in cinder volume object. First
|
|
we check to see if the account already exists (and use it), or if it
|
|
does not already exist, we'll go ahead and create it.
|
|
|
|
"""
|
|
slice_count = 1
|
|
attributes = {}
|
|
qos = {}
|
|
|
|
if (self.configuration.sf_allow_tenant_qos and
|
|
volume.get('volume_metadata')is not None):
|
|
qos = self._set_qos_presets(volume)
|
|
|
|
ctxt = context.get_admin_context()
|
|
type_id = volume['volume_type_id']
|
|
if type_id is not None:
|
|
qos = self._set_qos_by_volume_type(ctxt, type_id)
|
|
|
|
create_time = timeutils.strtime(volume['created_at'])
|
|
attributes = {'uuid': volume['id'],
|
|
'is_clone': 'False',
|
|
'created_at': create_time}
|
|
if qos:
|
|
for k, v in qos.items():
|
|
attributes[k] = str(v)
|
|
|
|
params = {'name': 'UUID-%s' % volume['id'],
|
|
'accountID': None,
|
|
'sliceCount': slice_count,
|
|
'totalSize': int(volume['size'] * units.Gi),
|
|
'enable512e': self.configuration.sf_emulate_512,
|
|
'attributes': attributes,
|
|
'qos': qos}
|
|
|
|
return self._do_volume_create(volume['project_id'], params)
|
|
|
|
def create_cloned_volume(self, volume, src_vref):
|
|
"""Create a clone of an existing volume."""
|
|
(data, sfaccount, model) = self._do_clone_volume(
|
|
src_vref['id'],
|
|
src_vref['project_id'],
|
|
volume)
|
|
|
|
return model
|
|
|
|
def delete_volume(self, volume):
|
|
"""Delete SolidFire Volume from device.
|
|
|
|
SolidFire allows multiple volumes with same name,
|
|
volumeID is what's guaranteed unique.
|
|
|
|
"""
|
|
|
|
LOG.debug("Enter SolidFire delete_volume...")
|
|
|
|
sfaccount = self._get_sfaccount(volume['project_id'])
|
|
if sfaccount is None:
|
|
LOG.error(_("Account for Volume ID %s was not found on "
|
|
"the SolidFire Cluster while attempting "
|
|
"delete_volume operation!") % volume['id'])
|
|
LOG.error(_("This usually means the volume was never "
|
|
"successfully created."))
|
|
return
|
|
|
|
params = {'accountID': sfaccount['accountID']}
|
|
|
|
sf_vol = self._get_sf_volume(volume['id'], params)
|
|
|
|
if sf_vol is not None:
|
|
params = {'volumeID': sf_vol['volumeID']}
|
|
data = self._issue_api_request('DeleteVolume', params)
|
|
|
|
if 'result' not in data:
|
|
msg = _("Failed to delete SolidFire Volume: %s") % data
|
|
raise exception.SolidFireAPIException(msg)
|
|
else:
|
|
LOG.error(_("Volume ID %s was not found on "
|
|
"the SolidFire Cluster while attempting "
|
|
"delete_volume operation!"), volume['id'])
|
|
|
|
LOG.debug("Leaving SolidFire delete_volume")
|
|
|
|
def ensure_export(self, context, volume):
|
|
"""Verify the iscsi export info."""
|
|
LOG.debug("Executing SolidFire ensure_export...")
|
|
try:
|
|
return self._do_export(volume)
|
|
except exception.SolidFireAPIException:
|
|
return None
|
|
|
|
def create_export(self, context, volume):
|
|
"""Setup the iscsi export info."""
|
|
LOG.debug("Executing SolidFire create_export...")
|
|
return self._do_export(volume)
|
|
|
|
def delete_snapshot(self, snapshot):
|
|
"""Delete the specified snapshot from the SolidFire cluster."""
|
|
self.delete_volume(snapshot)
|
|
|
|
def create_snapshot(self, snapshot):
|
|
"""Create a snapshot of a volume on the SolidFire cluster.
|
|
|
|
Note that for SolidFire Clusters currently there is no snapshot
|
|
implementation. Due to the way SF does cloning there's no performance
|
|
hit or extra space used. The only thing that's lacking from this is
|
|
the abilit to restore snaps.
|
|
|
|
After GA a true snapshot implementation will be available with
|
|
restore at which time we'll rework this appropriately.
|
|
|
|
"""
|
|
(data, sfaccount, model) = self._do_clone_volume(
|
|
snapshot['volume_id'],
|
|
snapshot['project_id'],
|
|
snapshot)
|
|
|
|
def create_volume_from_snapshot(self, volume, snapshot):
|
|
"""Create a volume from the specified snapshot."""
|
|
(data, sfaccount, model) = self._do_clone_volume(
|
|
snapshot['id'],
|
|
snapshot['project_id'],
|
|
volume)
|
|
|
|
return model
|
|
|
|
def get_volume_stats(self, refresh=False):
|
|
"""Get volume status.
|
|
|
|
If 'refresh' is True, run update first.
|
|
The name is a bit misleading as
|
|
the majority of the data here is cluster
|
|
data
|
|
"""
|
|
if refresh:
|
|
try:
|
|
self._update_cluster_status()
|
|
except exception.SolidFireAPIException:
|
|
pass
|
|
|
|
return self.cluster_stats
|
|
|
|
def extend_volume(self, volume, new_size):
|
|
"""Extend an existing volume."""
|
|
LOG.debug("Entering SolidFire extend_volume...")
|
|
|
|
sfaccount = self._get_sfaccount(volume['project_id'])
|
|
params = {'accountID': sfaccount['accountID']}
|
|
|
|
sf_vol = self._get_sf_volume(volume['id'], params)
|
|
|
|
if sf_vol is None:
|
|
LOG.error(_("Volume ID %s was not found on "
|
|
"the SolidFire Cluster while attempting "
|
|
"extend_volume operation!"), volume['id'])
|
|
raise exception.VolumeNotFound(volume_id=volume['id'])
|
|
|
|
params = {
|
|
'volumeID': sf_vol['volumeID'],
|
|
'totalSize': int(new_size * units.Gi)
|
|
}
|
|
data = self._issue_api_request('ModifyVolume',
|
|
params, version='5.0')
|
|
|
|
if 'result' not in data:
|
|
raise exception.SolidFireAPIDataException(data=data)
|
|
|
|
LOG.debug("Leaving SolidFire extend_volume")
|
|
|
|
def _update_cluster_status(self):
|
|
"""Retrieve status info for the Cluster."""
|
|
|
|
LOG.debug("Updating cluster status info")
|
|
|
|
params = {}
|
|
|
|
# NOTE(jdg): The SF api provides an UNBELIEVABLE amount
|
|
# of stats data, this is just one of the calls
|
|
results = self._issue_api_request('GetClusterCapacity', params)
|
|
if 'result' not in results:
|
|
LOG.error(_('Failed to get updated stats'))
|
|
|
|
results = results['result']['clusterCapacity']
|
|
free_capacity =\
|
|
results['maxProvisionedSpace'] - results['usedSpace']
|
|
|
|
data = {}
|
|
backend_name = self.configuration.safe_get('volume_backend_name')
|
|
data["volume_backend_name"] = backend_name or self.__class__.__name__
|
|
data["vendor_name"] = 'SolidFire Inc'
|
|
data["driver_version"] = self.VERSION
|
|
data["storage_protocol"] = 'iSCSI'
|
|
|
|
data['total_capacity_gb'] =\
|
|
float(results['maxProvisionedSpace'] / units.Gi)
|
|
|
|
data['free_capacity_gb'] = float(free_capacity / units.Gi)
|
|
data['reserved_percentage'] = self.configuration.reserved_percentage
|
|
data['QoS_support'] = True
|
|
data['compression_percent'] =\
|
|
results['compressionPercent']
|
|
data['deduplicaton_percent'] =\
|
|
results['deDuplicationPercent']
|
|
data['thin_provision_percent'] =\
|
|
results['thinProvisioningPercent']
|
|
self.cluster_stats = data
|
|
|
|
def attach_volume(self, context, volume,
|
|
instance_uuid, host_name,
|
|
mountpoint):
|
|
|
|
LOG.debug("Entering SolidFire attach_volume...")
|
|
sfaccount = self._get_sfaccount(volume['project_id'])
|
|
params = {'accountID': sfaccount['accountID']}
|
|
|
|
sf_vol = self._get_sf_volume(volume['id'], params)
|
|
if sf_vol is None:
|
|
LOG.error(_("Volume ID %s was not found on "
|
|
"the SolidFire Cluster while attempting "
|
|
"attach_volume operation!"), volume['id'])
|
|
raise exception.VolumeNotFound(volume_id=volume['id'])
|
|
|
|
attributes = sf_vol['attributes']
|
|
attributes['attach_time'] = volume.get('attach_time', None)
|
|
attributes['attached_to'] = instance_uuid
|
|
params = {
|
|
'volumeID': sf_vol['volumeID'],
|
|
'attributes': attributes
|
|
}
|
|
|
|
data = self._issue_api_request('ModifyVolume', params)
|
|
|
|
if 'result' not in data:
|
|
raise exception.SolidFireAPIDataException(data=data)
|
|
|
|
def detach_volume(self, context, volume):
|
|
|
|
LOG.debug("Entering SolidFire attach_volume...")
|
|
sfaccount = self._get_sfaccount(volume['project_id'])
|
|
params = {'accountID': sfaccount['accountID']}
|
|
|
|
sf_vol = self._get_sf_volume(volume['id'], params)
|
|
if sf_vol is None:
|
|
LOG.error(_("Volume ID %s was not found on "
|
|
"the SolidFire Cluster while attempting "
|
|
"detach_volume operation!"), volume['id'])
|
|
raise exception.VolumeNotFound(volume_id=volume['id'])
|
|
|
|
attributes = sf_vol['attributes']
|
|
attributes['attach_time'] = None
|
|
attributes['attached_to'] = None
|
|
params = {
|
|
'volumeID': sf_vol['volumeID'],
|
|
'attributes': attributes
|
|
}
|
|
|
|
data = self._issue_api_request('ModifyVolume', params)
|
|
|
|
if 'result' not in data:
|
|
raise exception.SolidFireAPIDataException(data=data)
|
|
|
|
def accept_transfer(self, context, volume,
|
|
new_user, new_project):
|
|
|
|
sfaccount = self._get_sfaccount(volume['project_id'])
|
|
params = {'accountID': sfaccount['accountID']}
|
|
sf_vol = self._get_sf_volume(volume['id'], params)
|
|
if sf_vol is None:
|
|
LOG.error(_("Volume ID %s was not found on "
|
|
"the SolidFire Cluster while attempting "
|
|
"accept_transfer operation!"), volume['id'])
|
|
raise exception.VolumeNotFound(volume_id=volume['id'])
|
|
if new_project != volume['project_id']:
|
|
# do a create_sfaccount here as this tenant
|
|
# may not exist on the cluster yet
|
|
sfaccount = self._create_sfaccount(new_project)
|
|
|
|
params = {
|
|
'volumeID': sf_vol['volumeID'],
|
|
'accountID': sfaccount['accountID']
|
|
}
|
|
data = self._issue_api_request('ModifyVolume',
|
|
params, version='5.0')
|
|
|
|
if 'result' not in data:
|
|
raise exception.SolidFireAPIDataException(data=data)
|
|
|
|
volume['project_id'] = new_project
|
|
volume['user_id'] = new_user
|
|
model_update = self._do_export(volume)
|
|
LOG.debug("Leaving SolidFire transfer volume")
|
|
return model_update
|
|
|
|
def retype(self, ctxt, volume, new_type, diff, host):
|
|
"""Convert the volume to be of the new type.
|
|
|
|
Returns a boolean indicating whether the retype occurred.
|
|
|
|
:param ctxt: Context
|
|
:param volume: A dictionary describing the volume to migrate
|
|
:param new_type: A dictionary describing the volume type to convert to
|
|
:param diff: A dictionary with the difference between the two types
|
|
:param host: A dictionary describing the host to migrate to, where
|
|
host['host'] is its name, and host['capabilities'] is a
|
|
dictionary of its reported capabilities (Not Used).
|
|
|
|
"""
|
|
qos = {}
|
|
attributes = {}
|
|
|
|
sfaccount = self._get_sfaccount(volume['project_id'])
|
|
params = {'accountID': sfaccount['accountID']}
|
|
sf_vol = self._get_sf_volume(volume['id'], params)
|
|
|
|
if sf_vol is None:
|
|
raise exception.VolumeNotFound(volume_id=volume['id'])
|
|
|
|
attributes = sf_vol['attributes']
|
|
attributes['retyped_at'] = timeutils.strtime()
|
|
params = {'volumeID': sf_vol['volumeID']}
|
|
qos = self._set_qos_by_volume_type(ctxt, new_type['id'])
|
|
|
|
if qos:
|
|
params['qos'] = qos
|
|
for k, v in qos.items():
|
|
attributes[k] = str(v)
|
|
params['attributes'] = attributes
|
|
|
|
self._issue_api_request('ModifyVolume', params)
|
|
return True
|
|
|
|
def manage_existing(self, volume, external_ref):
|
|
"""Manages an existing SolidFire Volume (import to Cinder).
|
|
|
|
Renames the Volume to match the expected name for the volume.
|
|
Also need to consider things like QoS, Emulation, account/tenant.
|
|
"""
|
|
|
|
sfid = external_ref.get('source-id', None)
|
|
sfname = external_ref.get('name', None)
|
|
if sfid is None:
|
|
raise exception.SolidFireAPIException("Manage existing volume "
|
|
"requires 'source-id'.")
|
|
|
|
# First get the volume on the SF cluster (MUST be active)
|
|
params = {'startVolumeID': sfid,
|
|
'limit': 1}
|
|
data = self._issue_api_request('ListActiveVolumes', params)
|
|
if 'result' not in data:
|
|
raise exception.SolidFireAPIDataException(data=data)
|
|
sf_ref = data['result']['volumes'][0]
|
|
|
|
sfaccount = self._create_sfaccount(volume['project_id'])
|
|
|
|
attributes = {}
|
|
qos = {}
|
|
if (self.configuration.sf_allow_tenant_qos and
|
|
volume.get('volume_metadata')is not None):
|
|
qos = self._set_qos_presets(volume)
|
|
|
|
ctxt = context.get_admin_context()
|
|
type_id = volume.get('volume_type_id', None)
|
|
if type_id is not None:
|
|
qos = self._set_qos_by_volume_type(ctxt, type_id)
|
|
|
|
import_time = timeutils.strtime(volume['created_at'])
|
|
attributes = {'uuid': volume['id'],
|
|
'is_clone': 'False',
|
|
'os_imported_at': import_time,
|
|
'old_name': sfname}
|
|
if qos:
|
|
for k, v in qos.items():
|
|
attributes[k] = str(v)
|
|
|
|
params = {'name': volume['name'],
|
|
'volumeID': sf_ref['volumeID'],
|
|
'accountID': sfaccount['accountID'],
|
|
'enable512e': self.configuration.sf_emulate_512,
|
|
'attributes': attributes,
|
|
'qos': qos}
|
|
|
|
data = self._issue_api_request('ModifyVolume',
|
|
params, version='5.0')
|
|
if 'result' not in data:
|
|
raise exception.SolidFireAPIDataException(data=data)
|
|
|
|
return self._get_model_info(sfaccount, sf_ref['volumeID'])
|
|
|
|
def manage_existing_get_size(self, volume, external_ref):
|
|
"""Return size of an existing LV for manage_existing.
|
|
|
|
existing_ref is a dictionary of the form:
|
|
{'name': <name of existing volume on SF Cluster>}
|
|
"""
|
|
|
|
sfid = external_ref.get('source-id', None)
|
|
if sfid is None:
|
|
raise exception.SolidFireAPIException("Manage existing get size "
|
|
"requires 'id'.")
|
|
|
|
params = {'startVolumeID': int(sfid),
|
|
'limit': 1}
|
|
data = self._issue_api_request('ListActiveVolumes', params)
|
|
if 'result' not in data:
|
|
raise exception.SolidFireAPIDataException(data=data)
|
|
sf_ref = data['result']['volumes'][0]
|
|
return int(sf_ref['totalSize']) / int(units.Gi)
|
|
|
|
def unmanage(self, volume):
|
|
"""Mark SolidFire Volume as unmanaged (export from Cinder)."""
|
|
|
|
LOG.debug("Enter SolidFire unmanage...")
|
|
sfaccount = self._get_sfaccount(volume['project_id'])
|
|
if sfaccount is None:
|
|
LOG.error(_("Account for Volume ID %s was not found on "
|
|
"the SolidFire Cluster while attempting "
|
|
"unmanage operation!") % volume['id'])
|
|
raise exception.SolidFireAPIException("Failed to find account "
|
|
"for volume.")
|
|
|
|
params = {'accountID': sfaccount['accountID']}
|
|
sf_vol = self._get_sf_volume(volume['id'], params)
|
|
if sf_vol is None:
|
|
raise exception.VolumeNotFound(volume_id=volume['id'])
|
|
|
|
export_time = timeutils.strtime()
|
|
attributes = sf_vol['attributes']
|
|
attributes['os_exported_at'] = export_time
|
|
params = {'volumeID': int(sf_vol['volumeID']),
|
|
'attributes': attributes}
|
|
|
|
data = self._issue_api_request('ModifyVolume',
|
|
params, version='5.0')
|
|
if 'result' not in data:
|
|
raise exception.SolidFireAPIDataException(data=data)
|