The cinder.volume.drivers.san.hp.hp_3par_fc Module

Volume driver for HP 3PAR Storage array. This driver requires 3.1.3 firmware on the 3PAR array, using the 3.x version of the hp3parclient.

You will need to install the python hp3parclient. sudo pip install –upgrade “hp3parclient>=3.0”

Set the following in the cinder.conf file to enable the 3PAR Fibre Channel Driver along with the required flags:

volume_driver=cinder.volume.drivers.san.hp.hp_3par_fc.HP3PARFCDriver

class HP3PARFCDriver(*args, **kwargs)

Bases: cinder.volume.driver.TransferVD, cinder.volume.driver.ManageableVD, cinder.volume.driver.ExtendVD, cinder.volume.driver.CloneableVD, cinder.volume.driver.SnapshotVD, cinder.volume.driver.MigrateVD, cinder.volume.driver.ConsistencyGroupVD, cinder.volume.driver.BaseVD

OpenStack Fibre Channel driver to enable 3PAR storage array.

Version history:

1.0 - Initial driver 1.1 - QoS, extend volume, multiple iscsi ports, remove domain,

session changes, faster clone, requires 3.1.2 MU2 firmware, copy volume <–> Image.

1.2.0 - Updated the use of the hp3parclient to 2.0.0 and refactored

the drivers to use the new APIs.

1.2.1 - Synchronized extend_volume method. 1.2.2 - Added try/finally around client login/logout. 1.2.3 - Added ability to add WWNs to host. 1.2.4 - Added metadata during attach/detach bug #1258033. 1.3.0 - Removed all SSH code. We rely on the hp3parclient now. 2.0.0 - Update hp3parclient API uses 3.0.x 2.0.2 - Add back-end assisted volume migrate 2.0.3 - Added initiator-target map for FC Zone Manager 2.0.4 - Added support for managing/unmanaging of volumes 2.0.5 - Only remove FC Zone on last volume detach 2.0.6 - Added support for volume retype 2.0.7 - Only one FC port is used when a single FC path

is present. bug #1360001

2.0.8 - Fixing missing login/logout around attach/detach bug #1367429 2.0.9 - Add support for pools with model update 2.0.10 - Migrate without losing type settings bug #1356608 2.0.11 - Removing locks bug #1381190 2.0.12 - Fix queryHost call to specify wwns bug #1398206 2.0.13 - Fix missing host name during attach bug #1398206 2.0.14 - Removed usage of host name cache #1398914 2.0.15 - Added support for updated detach_volume attachment. 2.0.16 - Added encrypted property to initialize_connection #1439917 2.0.17 - Improved VLUN creation and deletion logic. #1469816 2.0.18 - Changed initialize_connection to use getHostVLUNs. #1475064 2.0.19 - Adds consistency group support 2.0.20 - Update driver to use ABC metaclasses 2.0.21 - Added update_migrated_volume. bug # 1492023

VERSION = '2.0.21'

attach_volume(context, volume, instance_uuid, host_name, mountpoint)

check_for_setup_error()

Setup errors are already checked for in do_setup so return pass.

create_cgsnapshot(context, cgsnapshot)

create_cloned_volume(volume, src_vref)

create_consistencygroup(context, group)

create_consistencygroup_from_src(context, group, volumes, cgsnapshot=None, snapshots=None, source_cg=None, source_vols=None)

create_export(context, volume, connector)

create_snapshot(snapshot)

create_volume(volume)

create_volume_from_snapshot(volume, snapshot)

Create a volume from a snapshot.

TODO: support using the size from the user.

delete_cgsnapshot(context, cgsnapshot)

delete_consistencygroup(context, group)

delete_snapshot(snapshot)

delete_volume(volume)

detach_volume(context, volume, attachment=None)

do_setup(context)

ensure_export(context, volume)

extend_volume(volume, new_size)

get_pool(volume)

get_volume_stats(refresh=False)

initialize_connection(*args, **kwargs)

manage_existing(volume, existing_ref)

manage_existing_get_size(volume, existing_ref)

migrate_volume(context, volume, host)

remove_export(context, volume)

retype(context, volume, new_type, diff, host)

Convert the volume to be of the new type.

terminate_connection(*args, **kwargs)

unmanage(volume)

update_consistencygroup(context, group, add_volumes=None, remove_volumes=None)

update_migrated_volume(context, volume, new_volume, original_volume_status)

Update the name of the migrated volume to it’s new ID.