cinder/releasenotes/source/ocata.rst

Ocata Series Release Notes

10.0.8-20

New Features

• When using the RBD pool exclusively for Cinder we can now set rbd_exclusive_cinder_pool to true and Cinder will use DB information to calculate provisioned size instead of querying all volumes in the backend, which will reduce the load on the Ceph cluster and the volume service.

• Generic group is added into quota management.

• Dell EMC Unity Driver: Adds support for removing empty host. The new option named remove_empty_host could be configured as True to notify Unity driver to remove the host after the last LUN is detached from it.

• Add support to force detach a volume from all hosts on VNX.

Known Issues

• If RBD stats collection is taking too long in your environment maybe even leading to the service appearing as down you'll want to use the rbd_exclusive_cinder_pool = true configuration option if you are using the pool exclusively for Cinder and maybe even if you are not and can live with the innacuracy.

Bug Fixes

• Dell EMC Unity: Fixes bug 1775518 to make sure driver succeed to initialize even though the value of unity_io_ports and unity_storage_pool_names are empty

• Dell EMC Unity Driver: Fixes bug 1759175 to detach the lun correctly when auto zone was enabled and the lun was the last one attached to the host.

• Kaminario FC and iSCSI drivers: Fixed bug 1829398 where force detach would fail.

• Corrected support to force detach a volume from all hosts on Unity.

• Dell EMC VNX Driver: Fixes bug 1817385 to make sure the sg can be created again after it was destroyed under destroy_empty_storage_group setting to True.

10.0.8

Security Issues

• Removed the ability to create volumes in a ScaleIO Storage Pool that has zero-padding disabled. A new configuration option sio_allow_non_padded_volumes has been added to override this new behavior and allow unpadded volumes, but should not be enabled if multiple tenants will utilize volumes from a shared Storage Pool.

Bug Fixes

• NetApp ONTAP NFS (bug 1690954): Fix wrong usage of export path as volume name when deleting volumes and snapshots.

• NetApp ONTAP (bug 1762424): Fix ONTAP NetApp driver not being able to extend a volume to a size greater than the corresponding LUN max geometry.

• We no longer leave orphaned chunks on the backup backend or leave a temporary volume/snapshot when aborting a backup.

• NetApp cDOT block and file drivers have improved support for SVM scoped user accounts. Features not supported for SVM scoped users include QoS, aggregate usage reporting, and dedupe usage reporting.

10.0.7

New Features

• Kaminario K2 iSCSI driver now supports non discovery multipathing (Nova and Cinder won't use iSCSI sendtargets) which can be enabled by setting disable_discovery to true in the configuration.

• RBD driver supports returning a static total capacity value instead of a dynamic value like it's been doing. Configurable with report_dynamic_total_capacity configuration option.

Known Issues

• Kaminario K2 now supports networks with duplicated FQDNs via configuration option unique_fqdn_network so attaching in these networks will work (bug #1720147).

Upgrade Notes

• If using the NetApp ONTAP drivers (7mode/cmode), the configuration value for "max_over_subscription_ratio" may need to be increased to avoid scheduling problems where storage pools that previously were valid to schedule new volumes suddenly appear to be out of space to the Cinder scheduler. See documentation here.

• RBD/Ceph backends should adjust max_over_subscription_ratio to take into account that the driver is no longer reporting volume's physical usage but it's provisioned size.

Bug Fixes

• Fixed bug 1632333 with the NetApp ONTAP Driver. Now the copy offload method is invoked early to avoid downloading Glance images twice.

• The ONTAP drivers ("7mode" and "cmode") have been fixed to not report consumed space as "provisioned_capacity_gb". They instead rely on the cinder scheduler's calculation of "provisioned_capacity_gb". This fixes the oversubscription miscalculations with the ONTAP drivers. This bugfix affects all three protocols supported by these drivers (iSCSI/FC/NFS).

• Dell EMC SC driver correctly returns initialize_connection data when more than one IQN is attached to a volume. This fixes some random Nova Live Migration failures where the connection information being returned was for an IQN other than the one for which it was being requested.

• Fixed bug #1731474 on NetApp Data ONTAP driver that was causing LUNs to be created with larger size than requested. This fix requires version 9.1 of ONTAP or later.

• Dell EMC PS Series Driver code was creating duplicate ACL records during live migration. Fixes the initialize_connection code to not create access record for a host if one exists previously. This change fixes bug 1726591.

• Dell EMC PS Series Driver was creating unmanaged snapshots when extending volumes. Fixed it by adding the missing no-snap parameter. This change fixes bug 1720454.

• Dell EMC PS Series Driver code reporting volume stats is now optimized to return the information earlier and accelerate the process. This change fixes bug 1661154.

• Dell EMC PS Driver stats report has been fixed, now reports the provisioned_capacity_gb properly. Fixes bug 1719659.

• RBD stats report has been fixed, now properly reports allocated_capacity_gb and provisioned_capacity_gb with the sum of the sizes of the volumes (not physical sizes) for volumes created by Cinder and all available in the pool respectively. Free capacity will now properly handle quota size restrictions of the pool.

10.0.5

Bug Fixes

• Prohibit the deletion of group if group snapshot exists.

10.0.4

Bug Fixes

• Add all_tenants, project_id support in attachment list&detail APIs.

10.0.3

Bug Fixes

• Fix NFS backup driver, we now support multiple backups on the same container, they are no longer overwritten.

10.0.1

Bug Fixes

• Fixed consistency groups API which was always returning groups scoped to project ID from user context instead of given input project ID.

10.0.0

New Features

• Dell SC - Compression and Dedupe support added for Storage Centers that support the options.

• Dell SC - Volume and Group QOS support added for Storage Centers that support and have enabled the option.

• Added ability to query backups by project ID.

• Add support to configure IO ports option in Dell EMC Unity driver.

• Added reset status API to group snapshot.

• Added reset status API to generic volume group.

• Add v2.1 volume replication support in VMAX driver.

• The IBM_Storage driver has been open sourced. This means that there is no more need to download the package from the IBM site. The only requirement remaining is to install pyxcli, which is available through pypi:

  ``sudo pip install pyxcli``

• Cinder is now collecting capacity data, including virtual free capacity etc from the backends. A notification which includes that data is periodically emitted.

• Added update-host command for consistency groups in cinder-manage.

• Added Datera EDF API 2.1 support.

• Added Datera Multi-Tenancy Support.

• Added Datera Template Support.

• Broke Datera driver up into modules.

• The force boolean parameter has been added to the volume delete API. It may be used in combination with cascade. This also means that volume force delete is available in the base volume API rather than only in the volume_admin_actions extension.

• Added backend driver for Dell EMC Unity storage.

• Add consistent group capability to generic volume groups in VNX driver.

• Added new Hitachi VSP FC Driver. The VSP driver supports all Hitachi VSP Family and HUSVM.

• Adds new Hitachi VSP iSCSI Driver.

• Hitachi VSP drivers have a new config option vsp_compute_target_ports to specify IDs of the storage ports used to attach volumes to compute nodes. The default is the value specified for the existing vsp_target_ports option. Either or both of vsp_compute_target_ports and vsp_target_ports must be specified.

• Hitachi VSP drivers have a new config option vsp_horcm_pair_target_ports to specify IDs of the storage ports used to copy volumes by Shadow Image or Thin Image. The default is the value specified for the existing vsp_target_ports option. Either or both of vsp_horcm_pair_target_ports and vsp_target_ports must be specified.

• Added the ability to list manageable volumes and snapshots to HNAS NFS driver.

• Optimize backend reporting capabilities for Huawei drivers.

• Added support for querying group details with volume ids which are in this group. For example, "groups/{group_id}?list_volume=True".

• Added driver for the InfiniBox storage array.

• Added backend FC and iSCSI drivers for NEC Storage.

• The NetApp cDOT drivers report to the scheduler, for each FlexVol pool, the fraction of the shared block limit that has been consumed by dedupe and cloning operations. This value, netapp_dedupe_used_percent, may be used in the filter & goodness functions for better placement of new Cinder volumes.

• Added extend method to NFS driver for NexentaStor 5.

• Added secure HTTP support for REST API calls in the NexentaStor5 driver. Use of HTTPS is set True by default with option nexenta_use_https.

• Added support for snapshots in the NFS driver. This functionality is only enabled if nfs_snapshot_support is set to True in cinder.conf. Cloning volumes is only supported if the source volume is not attached.

• Added Nimble Storage Fibre Channel backend driver.

• Add Support for QoS in the Nimble Storage driver. QoS is available from Nimble OS release 4.x and above.

• Add Support for deduplication of volumes in the Nimble Storage driver.

• The Nimble backend driver has been updated to use REST for array communication.

• Add consistent group capability to generic volume groups in Pure drivers.

• Allow the RBD driver to work with max_over_subscription_ratio.

• Added v2.1 replication support to RBD driver.

• Added backend ISCSI driver for Reduxio.

• Add provider_id in the detailed view of a volume for admin.

• Added volume driver for QNAP ES Storage Driver.

• The SolidFire driver will recognize 4 new QoS spec keys to allow an administrator to specify QoS settings which are scaled by the size of the volume. 'ScaledIOPS' is a flag which will tell the driver to look for 'scaleMin', 'scaleMax' and 'scaleBurst' which provide the scaling factor from the minimum values specified by the previous QoS keys ('minIOPS', 'maxIOPS', 'burstIOPS'). The administrator must take care to assure that no matter what the final calculated QoS values follow minIOPS <= maxIOPS <= burstIOPS. A exception will be thrown if not. The QoS settings are also checked against the cluster min and max allowed and truncated at the min or max if they exceed.

• Add multipath enhancement to Storwize iSCSI driver.

• Added support to querying snapshots filtered by metadata key/value using 'metadata' optional URL parameter. For example, "/v3/snapshots?metadata=={'key1':'value1'}".

• Added support for ZMQ messaging layer in multibackend configuration.

• Add support to backup volume using snapshot in the Unity driver.

• Enable backup snapshot optimal path by implementing attach and detach snapshot in the VMAX driver.

• Added the ability to create a CG from a source CG with the VMAX driver.

• Support for compression on VMAX All Flash in the VMAX driver.

• Storage assisted volume migration from one Pool/SLO/Workload combination to another, on the same array, via retype, for the VMAX driver. Both All Flash and Hybrid VMAX3 arrays are supported. VMAX2 is not supported.

• VNX cinder driver now supports async migration during volume cloning. By default, the cloned volume will be available after the migration starts in the VNX instead of waiting for the completion of migration. This greatly accelerates the cloning process. If user wants to disable this, he could add --metadata async_migrate=False when creating volume from source volume/snapshot.

• Add consistent group capability to generic volume groups in the XtremIO driver.

Known Issues

• With the Dell SC Cinder Driver if a volume is retyped to a new storage profile all volumes created via snapshots from this volume will also change to the new storage profile.

• With the Dell SC Cinder Driver retyping from one replication type to another type (ex. regular replication to live volume replication) is not supported.

• Dell SC Cinder driver has limited support in a failed over state so thaw_backend has been implemented to reject the thaw call when in such a state.

Upgrade Notes

• In certain environments (Kubernetes for example) indirect calls to the LVM commands result in file descriptor leak warning messages which in turn cause the process_execution method to raise and exception.

  To accommodate these environments, and to maintain backward compatibility in Newton we add a lvm_suppress_fd_warnings bool config to the LVM driver. Setting this to True will append the LVM env vars to include the variable LVM_SUPPRESS_FD_WARNINGS=1.

  This is made an optional configuration because it only applies to very specific environments. If we were to make this global that would require a rootwrap/privsep update that could break compatibility when trying to do rolling upgrades of the volume service.

• Previous installations of IBM Storage must be un-installed first and the new driver should be installed on top. In addition the cinder.conf values should be updated to reflect the new paths. For example the proxy setting of storage.proxy.IBMStorageProxy should be updated to cinder.volume.drivers.ibm.ibm_storage.proxy.IBMStorageProxy.

• Removed deprecated option osapi_max_request_body_size.

• To get rid of long running DB data migrations that must be run offline, Cinder will now be able to execute them online, on a live cloud. Before upgrading from Ocata to Pike, operator needs to perform all the Newton data migrations. To achieve that he needs to perform cinder-manage db online_data_migrations until there are no records to be updated. To limit DB performance impact migrations can be performed in chunks limited by --max_number option. If your intent is to upgrade Cinder in a non-live manner, you can use --ignore_state option safely. Please note that finishing all the Newton data migrations will be enforced by the first schema migration in Pike, so you won't be able to upgrade to Pike without that.

• Datera driver location has changed from cinder.volume.drivers .datera.DateraDriver to cinder.volume.drivers.datera.datera_iscsi .DateraDriver.

• The Cinder database can now only be upgraded from changes since the Liberty release. In order to upgrade from a version prior to that, you must now upgrade to at least Liberty first, then to Ocata or later.

• The v1 API was deprecated in the Juno release and is now defaulted to disabled. In order to still use the v1 API, you must now set enable_v1_api to True in your cinder.conf file.

• There is a new policy option volume:force_delete which controls access to the ability to specify force delete via the volume delete API. This is separate from the pre-existing volume-admin-actions:force_delete policy check.

• The Hitachi NAS iSCSI driver has been marked as unsupported and is now deprecated. enable_unsupported_drivers will need to be set to True in cinder.conf to continue to use it.

• Removed deprecated option kaminario_nodedup_substring in Kaminario FC and iSCSI Cinder drivers.

• The CloudByte driver has been marked as unsupported and is now deprecated. enable_unsupported_drivers will need to be set to True in cinder.conf to continue to use it.

• The DotHill drivers have been marked as unsupported and are now deprecated. enable_unsupported_drivers will need to be set to True in cinder.conf to continue to use it.

• The HPE XP driver has been marked as unsupported and is now deprecated. enable_unsupported_drivers will need to be set to True in cinder.conf to continue to use it.

• The Nexenta Edge drivers have been marked as unsupported and are now deprecated. enable_unsupported_drivers will need to be set to True in cinder.conf to continue to use it.

• Operator needs to perform cinder-manage db online_data_migrations to migrate existing consistency groups to generic volume groups.

• The EqualLogic driver is moved to the dell_emc directory and has been rebranded to its current Dell EMC PS Series name. The volume_driver entry in cinder.conf needs to be changed to cinder.volume.drivers.dell_emc.ps.PSSeriesISCSIDriver.

• The ScaleIO driver is moved to the dell_emc directory. volume_driver entry in cinder.conf needs to be changed to cinder.volume.drivers.dell_emc.scaleio.driver.ScaleIODriver.

• The XtremIO driver is moved to the dell_emc directory. volume_driver entry in cinder.conf needs to be changed to cinder.volume.drivers.dell_emc.xtremio.XtremIOISCSIDriver or cinder.volume.drivers.dell_emc.xtremio.XtremIOFCDriver.

• New config option added. "connection_string" in [profiler] section is used to specify OSProfiler driver connection string, for example, "connection_string = messaging://", "connection_string = mongodb://localhost:27017"

• After running the migration script to migrate CGs to generic volume groups, CG and group APIs work as follows.
  • Create CG only creates in the groups table.
  • Modify CG modifies in the CG table if the CG is in the CG table, otherwise it modifies in the groups table.
  • Delete CG deletes from the CG or the groups table depending on where the CG is.
  • List CG checks both CG and groups tables.
  • List CG Snapshots checks both the CG and the groups tables.
  • Show CG checks both tables.
  • Show CG Snapshot checks both tables.
  • Create CG Snapshot creates either in the CG or the groups table depending on where the CG is.
  • Create CG from Source creates in either the CG or the groups table depending on the source.
  • Create Volume adds the volume either to the CG or the group.
  • default_cgsnapshot_type is reserved for migrating CGs.
  • Group APIs will only write/read in/from the groups table.
  • Group APIs will not work on groups with default_cgsnapshot_type.
  • Groups with default_cgsnapshot_type can only be operated by CG APIs.
  • After CG tables are removed, we will allow default_cgsnapshot_type to be used by group APIs.

• EMC VNX driver have been rebranded to Dell EMC VNX driver. Existing configurations will continue to work with the legacy name, but will need to be updated by the next release. User needs update volume_driver to cinder.volume.drivers.dell_emc.vnx.driver.VNXDriver.

• Old driver paths have been removed since they have been through our alloted deprecation period. Make sure if you have any of these paths being set in your cinder.conf for the volume_driver option, to update to the new driver path listed here.
  • Old path - cinder.volume.drivers.huawei.huawei_18000.Huawei18000ISCSIDriver
  • New path - cinder.volume.drivers.huawei.huawei_driver.HuaweiISCSIDriver
  • Old path - cinder.volume.drivers.huawei.huawei_driver.Huawei18000ISCSIDriver
  • New path - cinder.volume.drivers.huawei.huawei_driver.HuaweiISCSIDriver
  • Old path - cinder.volume.drivers.huawei.huawei_18000.Huawei18000FCDriver
  • New path - cinder.volume.drivers.huawei.huawei_driver.HuaweiFCDriver
  • Old path - cinder.volume.drivers.huawei.huawei_driver.Huawei18000FCDriver
  • New path - cinder.volume.drivers.huawei.huawei_driver.HuaweiFCDriver
  • Old path - cinder.volume.drivers.san.hp.hp_3par_fc.HP3PARFCDriver
  • New path - cinder.volume.drivers.hpe.hpe_3par_fc.HPE3PARFCDriver
  • Old path - cinder.volume.drivers.san.hp.hp_3par_iscsi.HP3PARISCSIDriver
  • New path - cinder.volume.drivers.hpe.hpe_3par_iscsi.HPE3PARISCSIDriver
  • Old path - cinder.volume.drivers.san.hp.hp_lefthand_iscsi.HPLeftHandISCSIDriver
  • New path - cinder.volume.drivers.hpe.hpe_lefthand_iscsi.HPELeftHandISCSIDriver
  • Old path - cinder.volume.drivers.san.hp.hp_xp_fc.HPXPFCDriver
  • New path - cinder.volume.drivers.hpe.hpe_xp_fc.HPEXPFCDriver

• Removing the Dell EqualLogic driver's deprecated configuration options. Please replace old options in your cinder.conf with the new one.
  • Removed - eqlx_cli_timeout
  • Replaced with - ssh_conn_timeout
  • Removed - eqlx_use_chap
  • Replaced with - use_chap_auth
  • Removed - eqlx_chap_login
  • Replaced with - chap_username
  • Removed - eqlx_chap_password
  • Replaced with - chap_password

• The Scality backend volume driver was marked as not supported in the previous release and has now been removed.

• Configurations that are setting backend config in [DEFAULT] section are now not supported. You should use enabled_backends option to set up backends.

• The volume_clear option to use shred was deprecated in the Newton release and has now been removed. Since deprecation, this option has performed the same action as the zero option. Config settings for shred should be updated to be set to zero for continued operation.

• The GlusterFS volume driver, which was deprecated in the Newton release, has been removed.

• The RBD driver no longer uses the "volume_tmp_dir" option to set where temporary files for image conversion are stored. Set "image_conversion_dir" to configure this in Ocata.

• Removing cinder-all binary. Instead use the individual binaries like cinder-api, cinder-backup, cinder-volume, cinder-scheduler.

• The VMAX driver is moved to the dell_emc directory. volume_driver entry in cinder.conf needs to be changed to cinder.volume.drivers.dell_emc.vmax.iscsi.VMAXISCSIDriver or cinder.volume.drivers.dell_emc.vmax.fc.VMAXFCDriver.

• Added config option vmware_connection_pool_size in the VMware VMDK driver to specify the maximum number of connections (to vCenter) in the http connection pool.

• In VNX Cinder driver, replication_device keys, backend_id and san_ip are mandatory now. If you prefer security file authentication, please append storage_vnx_security_file_dir in replication_device, otherwise, append san_login, san_password, storage_vnx_authentication_type in replication_device.

Deprecation Notes

• Deprecated datera_api_version option.

• Removed datera_acl_allow_all option.

• Removed datera_num_replicas option.

• The block_driver is deprecated as of the Ocata release and will be removed in the Queens release of Cinder. Instead the LVM driver with the LIO iSCSI target should be used. For those that desire higher performance, they should use LVM striping.

• The Cinder Linux SMBFS driver is now deprecated and will be removed during the following release. Deployers are encouraged to use the Windows SMBFS driver instead.

• The HBSD (Hitachi Block Storage Driver) volume drivers which supports Hitachi Storages HUS100 and VSP family are deprecated. Support for HUS110 family will be no longer provided. Support on VSP will be provided as hitachi.vsp* drivers.

• Support for snapshots named in the backend as snapshot-<snapshot-id> is deprecated. Snapshots are now named in the backend as <volume-name>.<snapshot-id>.

• The Hitachi NAS iSCSI driver has been marked as unsupported and is now deprecated. enable_unsupported_drivers will need to be set to True in cinder.conf to continue to use it. The driver will be removed in the next release.

• Deprecated the configuration option hnas_svcX_volume_type. Use option hnas_svcX_pool_name to indicate the name of the services (pools).

• The CloudByte driver has been marked as unsupported and is now deprecated. enable_unsupported_drivers will need to be set to True in cinder.conf to continue to use it. If its support status does not change it will be removed in the next release.

• The DotHill drivers has been marked as unsupported and are now deprecated. enable_unsupported_drivers will need to be set to True in cinder.conf to continue to use it. If its support status does not change it will be removed in the next release.

• The HPE XP driver has been marked as unsupported and is now deprecated. enable_unsupported_drivers will need to be set to True in cinder.conf to continue to use it. If its support status does not change it will be removed in the next release.

• The Nexenta Edge drivers has been marked as unsupported and are now deprecated. enable_unsupported_drivers will need to be set to True in cinder.conf to continue to use it. If its support status does not change it will be removed in the next release.

• The 7-Mode Data ONTAP configuration of the NetApp Unified driver is deprecated as of the Ocata release and will be removed in the Queens release. Other configurations of the NetApp Unified driver, including Clustered Data ONTAP and E-series, are unaffected.

• Marked the ITRI DISCO driver option disco_wsdl_path as deprecated. The new preferred protocol for array communication is REST and SOAP support will be removed.

Security Issues

• The qemu-img tool now has resource limits applied which prevent it from using more than 1GB of address space or more than 2 seconds of CPU time. This provides protection against denial of service attacks from maliciously crafted or corrupted disk images.

Bug Fixes

• With the Dell SC Cinder Driver retyping to or from a replicated type should now work.

• With the Dell SC Cinder Driver retype failed to return a tuple if it had to return an update to the volume state.

• The NetApp cDOT driver now sets the replication_status attribute appropriately on volumes created within replicated backends when using host level replication.

• Fixed an issue where the NetApp cDOT NFS driver failed to clone new volumes from the image cache.

• Fixed volume extend issue that allowed a tenant with enough quota to extend the volume to limits greater than what the volume backend supported.

• Fixed HNAS bug that placed a cloned volume in the same pool as its source, even if the clone had a different pool specification. Driver will not allow to make clones using a different volume type anymore.

• Fixed Non-WAN port filter issue in Kaminario iSCSI driver.

• Fixed issue of managing a VG with more than one volume in Kaminario FC and iSCSI Cinder drivers.

• For SolidFire, QoS specs are now checked to make sure they fall within the min and max constraints. If not the QoS specs are capped at the min or max (i.e. if spec says 50 and minimum supported is 100, the driver will set it to 100).

Other Notes

• Now extend won't work on disabled services because it's going through the scheduler, unlike how it worked before.