cinder.volume.drivers.dell_emc.vmax.fc
Module¶VMAXFCDriver
(*args, **kwargs)¶Bases: cinder.volume.drivers.san.san.SanDriver
, cinder.volume.driver.FibreChannelDriver
FC Drivers for VMAX using REST.
Version history:
1.0.0 - Initial driver
1.1.0 - Multiple pools and thick/thin provisioning,
performance enhancement.
2.0.0 - Add driver requirement functions
2.1.0 - Add consistency group functions
2.1.1 - Fixed issue with mismatched config (bug #1442376)
2.1.2 - Clean up failed clones (bug #1440154)
2.1.3 - Fixed a problem with FAST support (bug #1435069)
2.2.0 - Add manage/unmanage
2.2.1 - Support for SE 8.0.3
2.2.2 - Update Consistency Group
2.2.3 - Pool aware scheduler(multi-pool) support
2.2.4 - Create CG from CG snapshot
2.3.0 - Name change for MV and SG for FAST (bug #1515181)
- Fix for randomly choosing port group. (bug #1501919)
- get_short_host_name needs to be called in find_device_number
(bug #1520635)
- Proper error handling for invalid SLOs (bug #1512795)
- Extend Volume for VMAX3, SE8.1.0.3
https://blueprints.launchpad.net/cinder/+spec/vmax3-extend-volume
- Incorrect SG selected on an attach (#1515176)
- Cleanup Zoning (bug #1501938) NOTE: FC only
- Last volume in SG fix
- _remove_last_vol_and_delete_sg is not being called
for VMAX3 (bug #1520549)
- necessary updates for CG changes (#1534616)
- Changing PercentSynced to CopyState (bug #1517103)
- Getting iscsi ip from port in existing masking view
- Replacement of EMCGetTargetEndpoints api (bug #1512791)
- VMAX3 snapvx improvements (bug #1522821)
- Operations and timeout issues (bug #1538214)
2.4.0 - EMC VMAX - locking SG for concurrent threads (bug #1554634)
- SnapVX licensing checks for VMAX3 (bug #1587017)
- VMAX oversubscription Support (blueprint vmax-oversubscription)
- QoS support (blueprint vmax-qos)
2.5.0 - Attach and detach snapshot (blueprint vmax-attach-snapshot)
- MVs and SGs not reflecting correct protocol (bug #1640222)
- Storage assisted volume migration via retype
(bp vmax-volume-migration)
- Support for compression on All Flash
- Volume replication 2.1 (bp add-vmax-replication)
- rename and restructure driver (bp vmax-rename-dell-emc)
3.0.0 - REST based driver
- Retype (storage-assisted migration)
- QoS support
- Support for compression on All Flash
- Support for volume replication
- Support for live migration
- Support for Generic Volume Group
3.1.0 - Support for replication groups (Tiramisu)
- Deprecate backend xml configuration
- Support for async replication (vmax-replication-enhancements)
- Support for SRDF/Metro (vmax-replication-enhancements)
- Support for manage/unmanage snapshots
(vmax-manage-unmanage-snapshot)
- Support for revert to volume snapshot
CI_WIKI_NAME
= 'EMC_VMAX_CI'¶VERSION
= '3.1.0'¶check_for_export
(context, volume_id)¶Make sure volume is exported.
Parameters: |
|
---|
check_for_setup_error
()¶create_cloned_volume
(volume, src_vref)¶Creates a cloned volume.
Parameters: |
|
---|---|
Returns: | provider location dict |
create_export
(context, volume, connector)¶Driver entry point to get the export info for a new volume.
Parameters: |
|
---|
create_group
(context, group)¶Creates a generic volume group.
Parameters: |
|
---|---|
Returns: | model_update |
create_group_from_src
(context, group, volumes, group_snapshot=None, snapshots=None, source_group=None, source_vols=None)¶Creates the volume group from source.
Parameters: |
|
---|
create_group_snapshot
(context, group_snapshot, snapshots)¶Creates a group snapshot.
Parameters: |
|
---|
create_snapshot
(snapshot)¶Creates a snapshot.
Parameters: | snapshot – the cinder snapshot object |
---|---|
Returns: | provider location dict |
create_volume
(volume)¶Creates a VMAX volume.
Parameters: | volume – the cinder volume object |
---|---|
Returns: | provider location dict |
create_volume_from_snapshot
(volume, snapshot)¶Creates a volume from a snapshot.
Parameters: |
|
---|---|
Returns: | provider location dict |
delete_group
(context, group, volumes)¶Deletes a generic volume group.
Parameters: |
|
---|
delete_group_snapshot
(context, group_snapshot, snapshots)¶Deletes a group snapshot.
Parameters: |
|
---|
delete_snapshot
(snapshot)¶Deletes a snapshot.
Parameters: | snapshot – the cinder snapshot object |
---|
delete_volume
(volume)¶Deletes a VMAX volume.
Parameters: | volume – the cinder volume object |
---|
disable_replication
(context, group, volumes)¶Disable replication for a group.
Parameters: |
|
---|---|
Returns: | model_update, None |
enable_replication
(context, group, volumes)¶Enable replication for a group.
Parameters: |
|
---|---|
Returns: | model_update, None |
ensure_export
(context, volume)¶Driver entry point to get the export info for an existing volume.
Parameters: |
|
---|
extend_volume
(volume, new_size)¶Extend an existing volume.
Parameters: |
|
---|
failover_host
(context, volumes, secondary_id=None, groups=None)¶Failover volumes to a secondary host/ backend.
Parameters: |
|
---|---|
Returns: | secondary_id, volume_update_list, group_update_list |
failover_replication
(context, group, volumes, secondary_backend_id=None)¶Failover replication for a group.
Parameters: |
|
---|---|
Returns: | model_update, vol_model_updates |
get_volume_stats
(refresh=False)¶Get volume stats.
Parameters: | refresh – boolean – If True, run update the stats first. |
---|---|
Returns: | dict – the stats dict |
initialize_connection
(*args, **kwargs)¶manage_existing
(volume, external_ref)¶Manages an existing VMAX 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. :param volume: the volume object :param external_ref: the reference for the VMAX volume :returns: model_update
manage_existing_get_size
(volume, external_ref)¶Return size of an existing VMAX volume to manage_existing.
Parameters: |
|
---|---|
Returns: | size of the volume in GB |
manage_existing_snapshot
(snapshot, existing_ref)¶Manage an existing VMAX Snapshot (import to Cinder).
Renames the Snapshot to prefix it with OS- to indicate it is managed by Cinder.
Parameters: |
|
---|---|
Returns: | model_update |
manage_existing_snapshot_get_size
(snapshot, existing_ref)¶Return the size of the source volume for manage-existing-snapshot.
Parameters: |
|
---|---|
Returns: | size of the source volume in GB |
populate_data
(device_info, volume, connector)¶Populate data dict.
Add relevant data to data dict, target_lun, target_wwn and initiator_target_map. :param device_info: device_info :param volume: the volume object :param connector: the connector object :returns: dict – the target_wwns and initiator_target_map
remove_export
(context, volume)¶Driver entry point to remove an export for a volume.
Parameters: |
|
---|
retype
(ctxt, volume, new_type, diff, host)¶Migrate volume to another host using retype.
Parameters: |
|
---|---|
Returns: | boolean – True if retype succeeded, False if error |
revert_to_snapshot
(context, volume, snapshot)¶Revert volume to snapshot
Parameters: |
|
---|
terminate_connection
(*args, **kwargs)¶unmanage
(volume)¶Export VMAX volume from Cinder.
Leave the volume intact on the backend array.
unmanage_snapshot
(snapshot)¶Export VMAX Snapshot from Cinder.
Leaves the snapshot intact on the backend VMAX.
Parameters: | snapshot – the snapshot object |
---|
update_group
(context, group, add_volumes=None, remove_volumes=None)¶Updates LUNs in generic volume group.
Parameters: |
|
---|
update_volume_stats
()¶Retrieve stats info from volume group.
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.