c5e3d8affb
This is a larger refactor of the connector.py file. The goal is to simplfy the file by moving the vendor connector classes to their own files, and keep only the InitiatorConnector in the connector.py file. The vendor specific connector tests are also split out into their own files. Change-Id: I020e75ca8cd8bec2ad1b38f3ade5cc1f63a4fee5 Implements: bp connector-refactor
112 lines
4.2 KiB
Python
112 lines
4.2 KiB
Python
# Copyright 2016 Cloudbase Solutions Srl
|
|
# 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.
|
|
|
|
from os_win import utilsfactory
|
|
from oslo_log import log as logging
|
|
|
|
from os_brick import exception
|
|
from os_brick import initiator
|
|
from os_brick.i18n import _, _LE
|
|
from os_brick.initiator import initiator_connector
|
|
from os_brick import utils
|
|
|
|
LOG = logging.getLogger(__name__)
|
|
|
|
|
|
class BaseWindowsConnector(initiator_connector.InitiatorConnector):
|
|
platform = initiator.PLATFORM_ALL
|
|
os_type = initiator.OS_TYPE_WINDOWS
|
|
|
|
def __init__(self, root_helper=None, *args, **kwargs):
|
|
super(BaseWindowsConnector, self).__init__(root_helper,
|
|
*args, **kwargs)
|
|
self._diskutils = utilsfactory.get_diskutils()
|
|
|
|
@staticmethod
|
|
def check_multipath_support(enforce_multipath):
|
|
hostutils = utilsfactory.get_hostutils()
|
|
mpio_enabled = hostutils.check_server_feature(
|
|
hostutils.FEATURE_MPIO)
|
|
if not mpio_enabled:
|
|
err_msg = _LE(
|
|
"Using multipath connections for iSCSI and FC disks "
|
|
"requires the Multipath IO Windows feature to be "
|
|
"enabled. MPIO must be configured to claim such devices.")
|
|
LOG.error(err_msg)
|
|
if enforce_multipath:
|
|
raise exception.BrickException(err_msg)
|
|
return False
|
|
return True
|
|
|
|
@staticmethod
|
|
def get_connector_properties(*args, **kwargs):
|
|
multipath = kwargs['multipath']
|
|
enforce_multipath = kwargs['enforce_multipath']
|
|
|
|
props = {}
|
|
props['multipath'] = (
|
|
multipath and
|
|
BaseWindowsConnector.check_multipath_support(enforce_multipath))
|
|
return props
|
|
|
|
def _get_scsi_wwn(self, device_number):
|
|
# NOTE(lpetrut): The Linux connectors use scsi_id to retrieve the
|
|
# disk unique id, which prepends the identifier type to the unique id
|
|
# retrieved from the page 83 SCSI inquiry data. We'll do the same
|
|
# to remain consistent.
|
|
disk_uid, uid_type = self._diskutils.get_disk_uid_and_uid_type(
|
|
device_number)
|
|
scsi_wwn = '%s%s' % (uid_type, disk_uid)
|
|
return scsi_wwn
|
|
|
|
def check_valid_device(self, path, *args, **kwargs):
|
|
try:
|
|
with open(path, 'r') as dev:
|
|
dev.read(1)
|
|
except IOError:
|
|
LOG.exception(
|
|
_LE("Failed to access the device on the path "
|
|
"%(path)s"), {"path": path})
|
|
return False
|
|
return True
|
|
|
|
def get_all_available_volumes(self):
|
|
# TODO(lpetrut): query for disks based on the protocol used.
|
|
return []
|
|
|
|
def _check_device_paths(self, device_paths):
|
|
if len(device_paths) > 1:
|
|
err_msg = _("Multiple volume paths were found: %s. This can "
|
|
"occur if multipath is used and MPIO is not "
|
|
"properly configured, thus not claiming the device "
|
|
"paths. This issue must be addressed urgently as "
|
|
"it can lead to data corruption.")
|
|
raise exception.BrickException(err_msg % device_paths)
|
|
|
|
@utils.trace
|
|
def extend_volume(self, connection_properties):
|
|
volume_paths = self.get_volume_paths(connection_properties)
|
|
if not volume_paths:
|
|
err_msg = _("Could not find the disk. Extend failed.")
|
|
raise exception.NotFound(err_msg)
|
|
|
|
device_path = volume_paths[0]
|
|
device_number = self._diskutils.get_device_number_from_device_name(
|
|
device_path)
|
|
self._diskutils.refresh_disk(device_number)
|
|
|
|
def get_search_path(self):
|
|
return None
|