The cinder.volume.drivers.hitachi.hnas_iscsi Module

iSCSI Cinder Volume driver for Hitachi Unified Storage (HUS-HNAS) platform.

class HNASISCSIDriver(*args, **kwargs)

Bases: cinder.volume.driver.ISCSIDriver

HNAS iSCSI volume driver.

Version history:

code-block:: none

Version 1.0.0: Initial driver version Version 2.2.0: Added support to SSH authentication Version 3.2.0: Added pool aware scheduling

Fixed concurrency errors

Version 3.3.0: Fixed iSCSI target limitation error Version 4.0.0: Added manage/unmanage features Version 4.1.0: Fixed XML parser checks on blank options Version 4.2.0: Fixed SSH and cluster_admin_ip0 verification Version 4.3.0: Fixed attachment with os-brick 1.0.0 Version 5.0.0: 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 HNASISCSIDriver Deprecated XML config file Fixed driver stats reporting
CI_WIKI_NAME = 'Hitachi_HNAS_CI'
SUPPORTED = False
VERSION = '5.0.0'
check_for_setup_error()
create_cloned_volume(*args, **kwargs)

Creates a clone of a volume.

Parameters:
  • dst – dictionary destination volume reference
  • src – dictionary source volume reference
Returns:

the provider location of the extended volume
create_export(context, volume, connector)
create_snapshot(*args, **kwargs)

Creates a snapshot.

Parameters:snapshot – dictionary snapshot reference
Returns:the provider location of the snapshot
create_volume(*args, **kwargs)

Creates a LU on HNAS.

Parameters:volume – dictionary volume reference
Returns:the volume provider location
create_volume_from_snapshot(*args, **kwargs)

Creates a volume from a snapshot.

Parameters:
  • volume – dictionary volume reference
  • snapshot – dictionary snapshot reference
Returns:

the provider location of the snapshot
delete_snapshot(*args, **kwargs)

Deletes a snapshot.

Parameters:snapshot – dictionary snapshot reference
delete_volume(*args, **kwargs)

Deletes the volume on HNAS.

Parameters:volume – dictionary volume reference
do_setup(context)

Sets up and verify Hitachi HNAS storage connection.

ensure_export(context, volume)
extend_volume(*args, **kwargs)

Extends an existing volume.

Parameters:
  • volume – dictionary volume reference
  • new_size – int size in GB to extend
get_volume_stats(refresh=False)

Gets the volume driver stats.

Parameters:refresh – if refresh is True, the driver_stats is updated
Returns:the driver stats
initialize_connection(*args, **kwargs)

Maps the created volume to connector[‘initiator’].

Parameters:
  • volume – dictionary volume reference
  • connector – dictionary connector reference
Returns:

The connection information
Raises:

ISCSITargetAttachFailed
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 a File System and some volume_name; e.g., openstack/vol_to_manage

Parameters:
  • volume – cinder volume to manage
  • existing_vol_ref – driver specific information used to identify a volume
Returns:

the provider location of the volume managed
manage_existing_get_size(*args, **kwargs)

Gets the size to manage_existing.

Returns the size of volume to be managed by manage_existing.

Parameters:
  • volume – cinder volume to manage
  • existing_vol_ref – existing volume to take under management
Returns:

the size of the volume to be managed or raises error
Raises:

ManageExistingInvalidReference
remove_export(context, volume)
terminate_connection(*args, **kwargs)

Terminate a connection to a volume.

Parameters:
  • volume – dictionary volume reference
  • connector – dictionary connector reference
unmanage(*args, **kwargs)

Unmanages a volume from cinder.

Removes the specified volume from Cinder management. 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