The cinder.volume.drivers.nexenta.iscsi Module

class NexentaISCSIDriver(*args, **kwargs)

Bases: cinder.volume.driver.ISCSIDriver

Executes volume driver commands on Nexenta Appliance.

Version history:

1.0.0 - Initial driver version.
1.0.1 - Fixed bug #1236626: catch "does not exist" exception of
        lu_exists.
1.1.0 - Changed class name to NexentaISCSIDriver.
1.1.1 - Ignore "does not exist" exception of nms.snapshot.destroy.
1.1.2 - Optimized create_cloned_volume, replaced zfs send recv with zfs
        clone.
1.1.3 - Extended volume stats provided by _update_volume_stats method.
1.2.0 - Added volume migration with storage assist method.
1.2.1 - Fixed bug #1263258: now migrate_volume update provider_location
        of migrated volume; after migrating volume migrate_volume
        destroy snapshot on migration destination.
1.3.0 - Added retype method.
1.3.0.1 - Target creation refactor.
1.3.1 - Added ZFS cleanup.
CI_WIKI_NAME = ‘Nexenta_CI’
VERSION = ‘1.3.1’
backend_name
check_for_setup_error()

Verify that the volume for our zvols exists.

Raise:LookupError
create_cloned_volume(volume, src_vref)

Creates a clone of the specified volume.

Parameters:
  • volume – new volume reference
  • src_vref – source volume reference
create_export(_ctx, volume, connector)

Create new export for zvol.

Parameters:volume – reference of volume to be exported
Returns:iscsiadm-formatted provider location string
create_snapshot(snapshot)

Create snapshot of existing zvol on appliance.

Parameters:snapshot – snapshot reference
create_volume(volume)

Create a zvol on appliance.

Parameters:volume – volume reference
Returns:model update dict for volume reference
create_volume_from_snapshot(volume, snapshot)

Create new volume from other’s snapshot on appliance.

Parameters:
  • volume – reference of volume to be created
  • snapshot – reference of source snapshot
delete_snapshot(snapshot)

Delete volume’s snapshot on appliance.

Parameters:snapshot – snapshot reference
delete_volume(volume)

Destroy a zvol on appliance.

Parameters:volume – volume reference
do_setup(context)
ensure_export(_ctx, volume)
extend_volume(volume, new_size)

Extend an existing volume.

Parameters:
  • volume – volume reference
  • new_size – volume new size in GB
static get_nms_for_url(url)

Returns initialized nms object for url.

get_volume_stats(refresh=False)

Get volume stats.

If ‘refresh’ is True, run update the stats first.

local_path(volume)

Return local path to existing local volume.

We never have local volumes, so it raises NotImplementedError.

Raise:NotImplementedError
migrate_volume(ctxt, volume, host)

Migrate if volume and host are managed by Nexenta appliance.

Parameters:
  • ctxt – context
  • volume – a dictionary describing the volume to migrate
  • host – a dictionary describing the host to migrate to
remove_export(_ctx, volume)

Destroy all resources created to export zvol.

Parameters:volume – reference of volume to be unexported
retype(context, volume, new_type, diff, host)

Convert the volume to be of the new type.

Parameters:
  • context – Context
  • volume – A dictionary describing the volume to migrate
  • new_type – A dictionary describing the volume type to convert to
  • diff – A dictionary with the difference between the two types
  • host – A dictionary describing the host to migrate to, where host[‘host’] is its name, and host[‘capabilities’] is a dictionary of its reported capabilities.