cinder/cinder/tests/unit/volume/drivers/netapp/dataontap/utils/test_capabilities.py

575 lines
21 KiB
Python

# Copyright (c) 2016 Clinton Knight
# 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 collections
import copy
from unittest import mock
import ddt
import six
from cinder.tests.unit import test
from cinder.tests.unit.volume.drivers.netapp.dataontap.client import (
fakes as fake_client)
import cinder.tests.unit.volume.drivers.netapp.dataontap.utils.fakes as fake
import cinder.tests.unit.volume.drivers.netapp.fakes as na_fakes
from cinder.volume.drivers.netapp.dataontap.utils import capabilities
@ddt.ddt
class CapabilitiesLibraryTestCase(test.TestCase):
def setUp(self):
super(CapabilitiesLibraryTestCase, self).setUp()
self.zapi_client = mock.Mock()
self.configuration = self.get_config_cmode()
self.ssc_library = capabilities.CapabilitiesLibrary(
'iSCSI', fake.SSC_VSERVER, self.zapi_client, self.configuration)
self.ssc_library.ssc = fake.SSC
def get_config_cmode(self):
config = na_fakes.create_configuration_cmode()
config.volume_backend_name = 'fake_backend'
return config
def test_get_ssc(self):
result = self.ssc_library.get_ssc()
self.assertEqual(fake.SSC, result)
self.assertIsNot(fake.SSC, result)
def test_get_ssc_flexvol_names(self):
result = self.ssc_library.get_ssc_flexvol_names()
self.assertCountEqual(fake.SSC_VOLUMES, result)
def test_get_ssc_for_flexvol(self):
result = self.ssc_library.get_ssc_for_flexvol(fake.SSC_VOLUMES[0])
self.assertEqual(fake.SSC.get(fake.SSC_VOLUMES[0]), result)
self.assertIsNot(fake.SSC.get(fake.SSC_VOLUMES[0]), result)
def test_get_ssc_for_flexvol_not_found(self):
result = self.ssc_library.get_ssc_for_flexvol('invalid')
self.assertEqual({}, result)
def test_get_ssc_aggregates(self):
result = self.ssc_library.get_ssc_aggregates()
six.assertCountEqual(self, list(fake.SSC_AGGREGATES), result)
def test_is_qos_min_supported(self):
ssc_pool = fake.SSC.get(fake.SSC_VOLUMES[0])
is_qos_min = ssc_pool['netapp_qos_min_support'] == 'true'
result = self.ssc_library.is_qos_min_supported(ssc_pool['pool_name'])
self.assertEqual(is_qos_min, result)
def test_is_qos_min_supported_not_found(self):
result = self.ssc_library.is_qos_min_supported('invalid_pool')
self.assertFalse(result)
def test_update_ssc(self):
mock_get_ssc_flexvol_info = self.mock_object(
self.ssc_library, '_get_ssc_flexvol_info',
side_effect=[fake.SSC_FLEXVOL_INFO['volume1'],
fake.SSC_FLEXVOL_INFO['volume2']])
mock_get_ssc_dedupe_info = self.mock_object(
self.ssc_library, '_get_ssc_dedupe_info',
side_effect=[fake.SSC_DEDUPE_INFO['volume1'],
fake.SSC_DEDUPE_INFO['volume2']])
mock_get_ssc_mirror_info = self.mock_object(
self.ssc_library, '_get_ssc_mirror_info',
side_effect=[fake.SSC_MIRROR_INFO['volume1'],
fake.SSC_MIRROR_INFO['volume2']])
mock_get_ssc_aggregate_info = self.mock_object(
self.ssc_library, '_get_ssc_aggregate_info',
side_effect=[fake.SSC_AGGREGATE_INFO['volume1'],
fake.SSC_AGGREGATE_INFO['volume2']])
mock_get_ssc_encryption_info = self.mock_object(
self.ssc_library, '_get_ssc_encryption_info',
side_effect=[fake.SSC_ENCRYPTION_INFO['volume1'],
fake.SSC_ENCRYPTION_INFO['volume2']])
mock_get_ssc_qos_min_info = self.mock_object(
self.ssc_library, '_get_ssc_qos_min_info',
side_effect=[fake.SSC_QOS_MIN_INFO['volume1'],
fake.SSC_QOS_MIN_INFO['volume2']])
ordered_ssc = collections.OrderedDict()
ordered_ssc['volume1'] = fake.SSC_VOLUME_MAP['volume1']
ordered_ssc['volume2'] = fake.SSC_VOLUME_MAP['volume2']
result = self.ssc_library.update_ssc(ordered_ssc)
self.assertIsNone(result)
self.assertEqual(fake.SSC, self.ssc_library.ssc)
mock_get_ssc_flexvol_info.assert_has_calls([
mock.call('volume1'), mock.call('volume2')])
mock_get_ssc_dedupe_info.assert_has_calls([
mock.call('volume1'), mock.call('volume2')])
mock_get_ssc_mirror_info.assert_has_calls([
mock.call('volume1'), mock.call('volume2')])
mock_get_ssc_aggregate_info.assert_has_calls([
mock.call('aggr1', is_flexgroup=False),
mock.call('aggr2', is_flexgroup=False)])
mock_get_ssc_encryption_info.assert_has_calls([
mock.call('volume1'), mock.call('volume2')])
mock_get_ssc_qos_min_info.assert_has_calls([
mock.call('node1'), mock.call('node2')])
def test__update_for_failover(self):
self.mock_object(self.ssc_library, 'update_ssc')
flexvol_map = {'volume1': fake.SSC_VOLUME_MAP['volume1']}
mock_client = mock.Mock(name='FAKE_ZAPI_CLIENT')
self.ssc_library._update_for_failover(mock_client, flexvol_map)
self.assertEqual(mock_client, self.ssc_library.zapi_client)
self.ssc_library.update_ssc.assert_called_once_with(flexvol_map)
@ddt.data({'lun_space_guarantee': True},
{'lun_space_guarantee': False})
@ddt.unpack
def test_get_ssc_flexvol_info_thin_block(self, lun_space_guarantee):
self.ssc_library.configuration.netapp_lun_space_reservation = \
'enabled' if lun_space_guarantee else 'disabled'
self.mock_object(self.ssc_library.zapi_client,
'get_flexvol',
return_value=fake_client.VOLUME_INFO_SSC)
result = self.ssc_library._get_ssc_flexvol_info(
fake_client.VOLUME_NAMES[0])
expected = {
'netapp_thin_provisioned': 'true',
'thick_provisioning_support': False,
'thin_provisioning_support': True,
'netapp_aggregate': 'fake_aggr1',
'netapp_is_flexgroup': 'false',
}
self.assertEqual(expected, result)
self.zapi_client.get_flexvol.assert_called_once_with(
flexvol_name=fake_client.VOLUME_NAMES[0])
@ddt.data({'vol_space_guarantee': 'file', 'lun_space_guarantee': True},
{'vol_space_guarantee': 'volume', 'lun_space_guarantee': True})
@ddt.unpack
def test_get_ssc_flexvol_info_thick_block(self, vol_space_guarantee,
lun_space_guarantee):
self.ssc_library.configuration.netapp_lun_space_reservation = \
'enabled' if lun_space_guarantee else 'disabled'
fake_volume_info_ssc = copy.deepcopy(fake_client.VOLUME_INFO_SSC)
fake_volume_info_ssc['space-guarantee'] = vol_space_guarantee
self.mock_object(self.ssc_library.zapi_client,
'get_flexvol',
return_value=fake_volume_info_ssc)
result = self.ssc_library._get_ssc_flexvol_info(
fake_client.VOLUME_NAMES[0])
expected = {
'netapp_thin_provisioned': 'false',
'thick_provisioning_support': lun_space_guarantee,
'thin_provisioning_support': not lun_space_guarantee,
'netapp_aggregate': 'fake_aggr1',
'netapp_is_flexgroup': 'false',
}
self.assertEqual(expected, result)
self.zapi_client.get_flexvol.assert_called_once_with(
flexvol_name=fake_client.VOLUME_NAMES[0])
@ddt.data({'nfs_sparsed_volumes': True},
{'nfs_sparsed_volumes': False})
@ddt.unpack
def test_get_ssc_flexvol_info_thin_file(self, nfs_sparsed_volumes):
self.ssc_library.protocol = 'nfs'
self.ssc_library.configuration.nfs_sparsed_volumes = \
nfs_sparsed_volumes
self.mock_object(self.ssc_library.zapi_client,
'get_flexvol',
return_value=fake_client.VOLUME_INFO_SSC)
result = self.ssc_library._get_ssc_flexvol_info(
fake_client.VOLUME_NAMES[0])
expected = {
'netapp_thin_provisioned': 'true',
'thick_provisioning_support': False,
'thin_provisioning_support': True,
'netapp_aggregate': 'fake_aggr1',
'netapp_is_flexgroup': 'false',
}
self.assertEqual(expected, result)
self.zapi_client.get_flexvol.assert_called_once_with(
flexvol_name=fake_client.VOLUME_NAMES[0])
@ddt.data({'vol_space_guarantee': 'file', 'nfs_sparsed_volumes': True},
{'vol_space_guarantee': 'volume', 'nfs_sparsed_volumes': False})
@ddt.unpack
def test_get_ssc_flexvol_info_thick_file(self, vol_space_guarantee,
nfs_sparsed_volumes):
self.ssc_library.protocol = 'nfs'
self.ssc_library.configuration.nfs_sparsed_volumes = \
nfs_sparsed_volumes
fake_volume_info_ssc = copy.deepcopy(fake_client.VOLUME_INFO_SSC)
fake_volume_info_ssc['space-guarantee'] = vol_space_guarantee
self.mock_object(self.ssc_library.zapi_client,
'get_flexvol',
return_value=fake_volume_info_ssc)
result = self.ssc_library._get_ssc_flexvol_info(
fake_client.VOLUME_NAMES[0])
expected = {
'netapp_thin_provisioned': 'false',
'thick_provisioning_support': not nfs_sparsed_volumes,
'thin_provisioning_support': nfs_sparsed_volumes,
'netapp_aggregate': 'fake_aggr1',
'netapp_is_flexgroup': 'false',
}
self.assertEqual(expected, result)
self.zapi_client.get_flexvol.assert_called_once_with(
flexvol_name=fake_client.VOLUME_NAMES[0])
@ddt.data([], ['netapp_dedup'], ['netapp_compression'])
def test_get_ssc_dedupe_info(self, invalid_extra_specs):
self.ssc_library.invalid_extra_specs = invalid_extra_specs
self.mock_object(
self.ssc_library.zapi_client, 'get_flexvol_dedupe_info',
return_value=fake_client.VOLUME_DEDUPE_INFO_SSC)
result = self.ssc_library._get_ssc_dedupe_info(
fake_client.VOLUME_NAMES[0])
if invalid_extra_specs:
expected = {
'netapp_dedup': 'false',
'netapp_compression': 'false',
}
self.zapi_client.get_flexvol_dedupe_info.assert_not_called()
else:
expected = {
'netapp_dedup': 'true',
'netapp_compression': 'false',
}
self.zapi_client.get_flexvol_dedupe_info.assert_called_once_with(
fake_client.VOLUME_NAMES[0])
self.assertEqual(expected, result)
def test_get_ssc_encryption_info(self):
self.mock_object(
self.ssc_library.zapi_client, 'is_flexvol_encrypted',
return_value=True)
result = self.ssc_library._get_ssc_encryption_info(
fake_client.VOLUME_NAMES[0])
expected = {
'netapp_flexvol_encryption': 'true',
}
self.assertEqual(expected, result)
self.zapi_client.is_flexvol_encrypted.assert_called_once_with(
fake_client.VOLUME_NAMES[0], fake_client.VOLUME_VSERVER_NAME)
@ddt.data(True, False)
def test_get_ssc_mirror_info(self, mirrored):
self.mock_object(
self.ssc_library.zapi_client, 'is_flexvol_mirrored',
return_value=mirrored)
result = self.ssc_library._get_ssc_mirror_info(
fake_client.VOLUME_NAMES[0])
expected = {'netapp_mirrored': 'true' if mirrored else 'false'}
self.assertEqual(expected, result)
self.zapi_client.is_flexvol_mirrored.assert_called_once_with(
fake_client.VOLUME_NAMES[0], fake.SSC_VSERVER)
@ddt.data({'invalid_extra_specs': [], 'is_fg': False},
{'invalid_extra_specs': ['netapp_raid_type'],
'is_fg': False},
{'invalid_extra_specs': [], 'is_fg': True})
@ddt.unpack
def test_get_ssc_aggregate_info(self, invalid_extra_specs, is_fg):
self.ssc_library.invalid_extra_specs = invalid_extra_specs
self.mock_object(
self.ssc_library.zapi_client, 'get_aggregate',
return_value=fake_client.AGGR_INFO_SSC)
self.mock_object(
self.ssc_library.zapi_client, 'get_aggregate_disk_types',
return_value=fake_client.AGGREGATE_DISK_TYPES)
aggr_name = fake_client.VOLUME_AGGREGATE_NAME
if is_fg:
aggr_name = [fake_client.VOLUME_AGGREGATE_NAME]
result = self.ssc_library._get_ssc_aggregate_info(aggr_name,
is_flexgroup=is_fg)
if invalid_extra_specs:
expected = {
'netapp_disk_type': None,
'netapp_raid_type': None,
'netapp_hybrid_aggregate': None,
'netapp_node_name': None,
}
self.zapi_client.get_aggregate.assert_not_called()
self.zapi_client.get_aggregate_disk_types.assert_not_called()
else:
expected = {
'netapp_disk_type': fake_client.AGGREGATE_DISK_TYPES,
'netapp_raid_type': fake_client.AGGREGATE_RAID_TYPE,
'netapp_hybrid_aggregate': 'true',
'netapp_node_name': fake_client.NODE_NAME,
}
if is_fg:
result['netapp_disk_type'] = sorted(
result['netapp_disk_type'])
expected['netapp_disk_type'] = sorted(
expected['netapp_disk_type'])
expected['netapp_raid_type'] = [
fake_client.AGGREGATE_RAID_TYPE]
expected['netapp_node_name'] = [
fake_client.NODE_NAME]
expected['netapp_hybrid_aggregate'] = ['true']
self.zapi_client.get_aggregate.assert_called_once_with(
fake_client.VOLUME_AGGREGATE_NAME)
self.zapi_client.get_aggregate_disk_types.assert_called_once_with(
fake_client.VOLUME_AGGREGATE_NAME)
self.assertEqual(expected, result)
def test_get_ssc_aggregate_info_not_found(self):
self.ssc_library.invalid_extra_specs = ['netapp_raid_type']
self.mock_object(
self.ssc_library.zapi_client, 'get_aggregate', return_value={})
self.mock_object(
self.ssc_library.zapi_client, 'get_aggregate_disk_types',
return_value=None)
result = self.ssc_library._get_ssc_aggregate_info(
fake_client.VOLUME_AGGREGATE_NAME)
expected = {
'netapp_disk_type': None,
'netapp_raid_type': None,
'netapp_hybrid_aggregate': None,
'netapp_node_name': None,
}
self.assertEqual(expected, result)
def test_get_matching_flexvols_for_extra_specs(self):
specs = {
'thick_provisioning_support': '<is> False',
'netapp_compression': 'true',
'netapp_dedup': 'true',
'netapp_mirrored': 'true',
'netapp_raid_type': 'raid_dp',
'netapp_disk_type': 'FCAL',
'non_ssc_key': 'fake_value',
}
result = self.ssc_library.get_matching_flexvols_for_extra_specs(specs)
self.assertEqual(['volume2'], result)
@ddt.data(
{
'flexvol_info': {
'netapp_dedup': 'true',
},
'extra_specs': {
'netapp_dedup': 'true',
'non_ssc_key': 'fake_value',
}
},
{
'flexvol_info': fake.SSC['volume1'],
'extra_specs': {
'netapp_disk_type': 'SSD',
'pool_name': 'volume1',
}
},
{
'flexvol_info': fake.SSC['volume2'],
'extra_specs': {
'netapp_disk_type': 'SSD',
'netapp_hybrid_aggregate': 'true',
}
}
)
@ddt.unpack
def test_flexvol_matches_extra_specs(self, flexvol_info, extra_specs):
result = self.ssc_library._flexvol_matches_extra_specs(flexvol_info,
extra_specs)
self.assertTrue(result)
@ddt.data(
{
'flexvol_info': {
'netapp_dedup': 'true',
},
'extra_specs': {
'netapp_dedup': 'false',
'non_ssc_key': 'fake_value',
}
},
{
'flexvol_info': fake.SSC['volume2'],
'extra_specs': {
'netapp_disk_type': 'SSD',
'pool_name': 'volume1',
}
},
{
'flexvol_info': fake.SSC['volume2'],
'extra_specs': {
'netapp_disk_type': 'SATA',
}
}
)
@ddt.unpack
def test_flexvol_matches_extra_specs_no_match(self, flexvol_info,
extra_specs):
result = self.ssc_library._flexvol_matches_extra_specs(flexvol_info,
extra_specs)
self.assertFalse(result)
@ddt.data(('SSD', 'SSD'), ('SSD', ['SSD', 'FCAL']))
@ddt.unpack
def test_extra_spec_matches(self, extra_spec_value, ssc_flexvol_value):
result = self.ssc_library._extra_spec_matches(extra_spec_value,
ssc_flexvol_value)
self.assertTrue(result)
@ddt.data(('SSD', 'FCAL'), ('SSD', ['FCAL']))
@ddt.unpack
def test_extra_spec_matches_no_match(self, extra_spec_value,
ssc_flexvol_value):
result = self.ssc_library._extra_spec_matches(extra_spec_value,
ssc_flexvol_value)
self.assertFalse(result)
def test_modify_extra_specs_for_comparison(self):
specs = {
'thick_provisioning_support': '<is> False',
'thin_provisioning_support': '<is> true',
'netapp_compression': 'true',
}
result = self.ssc_library._modify_extra_specs_for_comparison(specs)
expected = {
'thick_provisioning_support': False,
'thin_provisioning_support': True,
'netapp_compression': 'true',
}
self.assertEqual(expected, result)
@ddt.data([], ['netapp_dedup'], ['netapp_compression'])
def test_cluster_user_supported(self, invalid_extra_specs):
self.ssc_library.invalid_extra_specs = invalid_extra_specs
if invalid_extra_specs:
self.assertFalse(self.ssc_library.cluster_user_supported())
else:
self.assertTrue(self.ssc_library.cluster_user_supported())
def test_get_ssc_qos_min_info(self):
self.mock_object(
self.ssc_library.zapi_client, 'is_qos_min_supported',
return_value=True)
result = self.ssc_library._get_ssc_qos_min_info('node')
expected = {
'netapp_qos_min_support': 'true',
}
self.assertEqual(expected, result)
self.zapi_client.is_qos_min_supported.assert_called_once_with(False,
'node')
@ddt.data(False, True)
def test_get_ssc_qos_min_info_flexgroup(self, qos_min_support):
self.mock_object(
self.ssc_library.zapi_client, 'is_qos_min_supported',
return_value=qos_min_support)
result = self.ssc_library._get_ssc_qos_min_info(['node'])
expected = {
'netapp_qos_min_support': 'true' if qos_min_support else 'false',
}
self.assertEqual(expected, result)
self.zapi_client.is_qos_min_supported.assert_called_once_with(False,
'node')
@ddt.data(True, False)
def test_is_flexgroup(self, is_fg):
pool_name = 'fake_pool'
self.ssc_library.ssc = {
pool_name: {
'pool_name': pool_name,
'netapp_is_flexgroup': 'true' if is_fg else 'false',
},
}
if not is_fg:
pool_name = 'no_pool'
is_fg_returned = self.ssc_library.is_flexgroup(pool_name)
self.assertEqual(is_fg_returned, is_fg)
@ddt.data(True, False)
def test_contains_flexgroup(self, contains_fg):
self.ssc_library.ssc = {
'fake_pool': {
'netapp_is_flexgroup': 'true' if contains_fg else 'false',
},
}
contains_fg_returned = self.ssc_library.contains_flexgroup_pool()
self.assertEqual(contains_fg_returned, contains_fg)