The cinder.volume.drivers.hitachi.hnas_nfs
Module¶
Volume driver for HNAS NFS storage.
-
class
HNASNFSDriver
(*args, **kwargs)¶ Bases:
cinder.volume.drivers.nfs.NfsDriver
Base class for Hitachi NFS driver.
Executes commands relating to Volumes.
Version history:
Version 1.0.0: Initial driver version Version 2.2.0: Added support to SSH authentication Version 3.0.0: Added pool aware scheduling Version 4.0.0: Added manage/unmanage features Version 4.1.0: Fixed XML parser checks on blank options Version 5.0.0: Remove looping in driver initialization Code cleaning up New communication interface between the driver and HNAS Removed the option to use local SSC (ssh_enabled=False) Updated to use versioned objects Changed the class name to HNASNFSDriver Deprecated XML config file Added support to manage/unmanage snapshots features Fixed driver stats reporting Version 6.0.0: Deprecated hnas_svcX_vol_type configuration Added list-manageable volumes/snapshots support Rename snapshots to link with its original volume
-
CI_WIKI_NAME
= ‘Hitachi_HNAS_CI’¶
-
SUPPORTED
= False¶
-
VERSION
= ‘6.0.0’¶
-
create_cloned_volume
(*args, **kwargs)¶ Creates a clone of the specified volume.
Parameters: - volume – reference to the volume being created
- src_vref – reference to the source volume
Returns: the provider_location of the cloned volume
-
create_snapshot
(*args, **kwargs)¶ Create a snapshot.
Parameters: snapshot – dictionary snapshot reference Returns: the provider_location of the snapshot created
-
create_volume
(*args, **kwargs)¶ Creates a volume.
Parameters: volume – volume reference Returns: the volume provider_location
-
create_volume_from_snapshot
(*args, **kwargs)¶ Creates a volume from a snapshot.
Parameters: - volume – volume to be created
- snapshot – source snapshot
Returns: the provider_location of the volume created
-
delete_snapshot
(*args, **kwargs)¶ Deletes a snapshot.
Parameters: snapshot – dictionary snapshot reference
-
do_setup
(context)¶ Perform internal driver setup.
-
extend_volume
(*args, **kwargs)¶ Extend an existing volume.
Parameters: - volume – dictionary volume reference
- new_size – int size in GB to extend
Raises:
-
get_manageable_snapshots
(*args, **kwargs)¶ List snapshots on the backend available for management by Cinder.
-
get_manageable_volumes
(*args, **kwargs)¶ List volumes on the backend available for management by Cinder.
-
get_volume_stats
(refresh=False)¶ Get volume stats.
Parameters: refresh – if it is True, update the stats first. Returns: dictionary with the stats from HNAS - _stats[‘pools’] = {
- ‘total_capacity_gb’: total size of the pool, ‘free_capacity_gb’: the available size, ‘QoS_support’: bool to indicate if QoS is supported, ‘reserved_percentage’: percentage of size reserved, ‘max_over_subscription_ratio’: oversubscription rate, ‘thin_provisioning_support’: thin support (True), }
-
manage_existing
(*args, **kwargs)¶ Manages an existing volume.
The specified Cinder volume is to be taken into Cinder management. The driver will verify its existence and then rename it to the new Cinder volume name. It is expected that the existing volume reference is an NFS share point and some [/path]/volume; e.g., 10.10.32.1:/openstack/vol_to_manage or 10.10.32.1:/openstack/some_directory/vol_to_manage
Parameters: - volume – cinder volume to manage
- existing_vol_ref – driver-specific information used to identify a
volume :returns: the provider location :raises VolumeBackendAPIException:
-
manage_existing_get_size
(*args, **kwargs)¶ Returns the size of volume to be managed by manage_existing.
When calculating the size, round up to the next GB.
Parameters: - volume – cinder volume to manage
- existing_vol_ref – existing volume to take under management
Returns: the size of the volume or raise error
Raises:
-
manage_existing_snapshot
(*args, **kwargs)¶ Brings an existing backend storage object under Cinder management.
Parameters: - snapshot – Cinder volume snapshot to manage
- existing_ref – Driver-specific information used to identify a volume snapshot
-
manage_existing_snapshot_get_size
(*args, **kwargs)¶
-
unmanage
(*args, **kwargs)¶ Removes the specified volume from Cinder management.
It does not delete the underlying backend storage object. A log entry will be made to notify the Admin that the volume is no longer being managed.
Parameters: volume – cinder volume to unmanage
-
unmanage_snapshot
(*args, **kwargs)¶ Removes the specified snapshot from Cinder management.
Does not delete the underlying backend storage object.
Parameters: snapshot – Cinder volume snapshot to unmanage
-