connector
– Connector¶
Brick Connector objects for each supported transport protocol.
The connectors here are responsible for discovering and removing volumes for each of the supported transport protocols.
- class os_brick.initiator.connector.InitiatorConnector¶
- static factory(protocol, root_helper, driver=None, use_multipath=False, device_scan_attempts=3, arch=None, *args, **kwargs)¶
Build a Connector object based upon protocol and architecture.
- class os_brick.initiator.connector.ISCSIConnector(root_helper: str, driver=None, execute=None, use_multipath: bool = False, device_scan_attempts: int = 3, transport='default', *args, **kwargs)¶
Connector class to attach/detach iSCSI volumes.
- connect_volume(connection_properties: dict)¶
Attach the volume to instance_name.
- Parameters
connection_properties (dict) – The valid dictionary that describes all of the target volume attributes.
- Returns
dict
connection_properties for iSCSI must include: target_portal(s) - ip and optional port target_iqn(s) - iSCSI Qualified Name target_lun(s) - LUN id of the volume Note that plural keys may be used when use_multipath=True
- disconnect_volume(connection_properties, device_info, force=False, ignore_errors=False)¶
Detach the volume from instance_name.
- Parameters
connection_properties (dict that must include: target_portal(s) - IP and optional port target_iqn(s) - iSCSI Qualified Name target_lun(s) - LUN id of the volume) – The dictionary that describes all of the target volume attributes.
device_info (dict) – historical difference, but same as connection_props
force (bool) – Whether to forcefully disconnect even if flush fails.
ignore_errors (bool) – When force is True, this will decide whether to ignore errors or raise an exception once finished the operation. Default is False.
- class os_brick.initiator.connector.FibreChannelConnector(root_helper, driver=None, execute=None, use_multipath=False, device_scan_attempts=3, *args, **kwargs)¶
Connector class to attach/detach Fibre Channel volumes.
- connect_volume(connection_properties)¶
Attach the volume to instance_name.
- Parameters
connection_properties (dict) – The dictionary that describes all of the target volume attributes.
- Returns
dict
connection_properties for Fibre Channel must include: target_wwn - World Wide Name target_lun - LUN id of the volume
- disconnect_volume(connection_properties, device_info, force=False, ignore_errors=False)¶
Detach the volume from instance_name.
- Parameters
connection_properties (dict) – The dictionary that describes all of the target volume attributes.
device_info (dict) – historical difference, but same as connection_props
connection_properties for Fibre Channel must include: target_wwn - World Wide Name target_lun - LUN id of the volume
- class os_brick.initiator.connector.LocalConnector(root_helper, driver=None, *args, **kwargs)¶
“Connector class to attach/detach File System backed volumes.
- connect_volume(connection_properties)¶
Connect to a volume.
- Parameters
connection_properties (dict) –
The dictionary that describes all of the target volume attributes.
connection_properties
must include:device_path
- path to the volume to be connected
- Returns
dict
- disconnect_volume(connection_properties, device_info, force=False, ignore_errors=False)¶
Disconnect a volume from the local host.
- Parameters
connection_properties (dict) – The dictionary that describes all of the target volume attributes.
device_info (dict) – historical difference, but same as connection_props
- class os_brick.initiator.connector.HuaweiStorHyperConnector(root_helper, driver=None, *args, **kwargs)¶
“Connector class to attach/detach SDSHypervisor volumes.
- connect_volume(connection_properties)¶
Connect to a volume.
- Parameters
connection_properties (dict) – The dictionary that describes all of the target volume attributes.
- Returns
dict
- disconnect_volume(connection_properties, device_info, force=False, ignore_errors=False)¶
Disconnect a volume from the local host.
- Parameters
connection_properties (dict) – The dictionary that describes all of the target volume attributes.
device_info (dict) – historical difference, but same as connection_props