Current Series Release Notes

19.0.0.0rc1-75

New Features

  • OpenStack operators can now make use of a new config option named driver_updatable_subnet_metadata to determine which share network subnet metadata updates the back end driver needs to be notified about. The config option contains list of share network subnet metadata keys. When the share network subnet’s metadata gets updated and Manila identifies that the new metadata keys match the metadata keys from the provided list, the share back end will be notified and it will apply the necessary changes. The result will be communicated through user messages. This feature is supported from microversion ‘2.89’. Since, with share network migration, metadata belonging to the old share network subnet is ignored when moving to a new share network, updates will not be passed to new share servers.

  • Allow using an empty prefix for shares created with mount_point_name.

  • Allow configuring default mount_point_name prefix through an option.

  • The NetApp ONTAP driver now supports Certificate-Based-Authentication (CBA) for operators that desire certificate based authentication instead of user and password. Please check the NetApp Deployment and Operations Guide for more instructions.

Upgrade Notes

  • Administrator can now configure new policy list_all_projects for share and share snapshot. This policy is applicable for listing of respective resources in all projects. Please check launchpad bug 2084532 for more details.

  • Removed the check for the last transfer size during updating replica state in the ONTAP driver. Also removed the corresponding option netapp_snapmirror_last_transfer_size_limit. See launchpad bug 2066031 for more details.

  • Support for Python 3.8 has been removed. Now the minimum python version supported is 3.9 .

Deprecation Notes

  • The following options of the CephFS driver have been deprecated, because these are used only by the deprecated NFSProtocolHelper.

    • cephfs_ganesha_server_is_remote

    • cephfs_ganesha_server_username

    • cephfs_ganesha_path_to_private_key

    • cephfs_ganesha_server_password

Bug Fixes

  • The service instance module, used by some drivers supporting driver_handles_share_servers=True mode, now checks for login instead of polling the SSH port for connectivity. This is expected to improve robustness of share creation operations that need a new share server. See bug 1748139 for more details.

  • NetApp driver bug #2080951: Fixed the share creation workflow via REST. Changed the order of dedupe/compression to disable compression first followed by disabling dedupe so that the share creation workflow goes through.

  • Fixed a scheduling issue that affected the CephFS Native and NFS drivers when a Ceph storage back end was configured with multiple filesystems. The share driver will now provide the necessary information so Manila can evenly distribute the shares between the different configured storage back ends. For more details, please refer to Launchpad bug #2049538.

  • Netapp ONTAP driver now allows migration of share server even if one or more shares on share server has replicas. For more details, please check Launchpad bug #2052785

  • The CephFS driver used to set the “preferred” export path incorrectly. It is now fixed to set it as part of export location metadata. See Launchpad bug 2053100 for more details.

  • Share manager drivers can now update export location metadata (such as the preferred attribute) during the ensure_shares routine. (Launchpad bug: 2053100)

  • When performing a share server migration without new share network, reused allocations are properly updated with new share_server_id.

  • In NetApp driver functions related to share server migration, vserver_name is now retrieved directly from backend_details instead of templating. This way, vserver_name is correct even for share servers that have already been migrated once.

  • Since microversion 2.88, Manila will allow to update access_level of access rule using openstack share access update API. Currently this is supported only for NetApp ONTAP backend. For more details, please check Launchpad bug #2066871

  • When deferred deletion is enabled, Manila will attempt regular deletion. While quota is released, and these objects (shares, snapshots) are hidden from the user. Any error during deferred deletion will put resource in error_deferred_deleting state. After that, it will be handled in periodic task. Also, Manila will make sure snapshot instances are deleted before share instance delete. For more details, please check Launchpad bug 2068043

  • Added db_retry on deadlock for various database update methods. Please check launchpad bug 2084529 for more details.

  • Share instance/replica get with share data query is being optimized to improve the performance. Please check launchpad bug 2084783 for more details.

  • The NetApp ONTAP driver now supports user configurable volume delete retention period (netapp_volume_delete_retention_hours). The max value of config option unused_share_server_cleanup_interval is updated to possible max value of retention period because if a share server gets deleted, the volume recovery queue also gets purged. For more details, please check Launchpad bug #2085112

  • Launchpad bug #2037422: Fixed an issue within the VASTData driver that made only one export path available for mounting, regardless if more mount paths were available. Now, the amount of export locations will correspond to the way the storage is configured for better load balancing.

  • While displaying and deleting access rules, manila was limiting the search for locks to the context of the request. Now, manila will search within all of the projects for locks and properly apply visibility and deletion restrictions. For more details, please refer to launchpad bug #2089061.

  • Manila will no longer fail while attempting to delete a neutron port that already has been deleted. Instead, a log warning will be created. For more details, please check Launchpad bug #2098083

  • Launchpad bug 2099273 <https://bugs.launchpad.net/manila/+bug/2099273> has been addressed by removing the NFS protocol override within the request sent to the Ceph Manager API. This allows users to mount shares exported by the Ceph NFS service with any NFS protocol version exposed by that service.

  • Generic driver - volumes mounted to the service instance are now mounted via its uuid (/dev/disk/by-uuid/…) instead of canonical paths (/dev/vdb) to prevent messing up the shares after restarts.

  • The NetApp ONTAP driver is now able to update the showmount and pnfs configurations in a pre-created share server. Please use the share network subnet metadata set feature to update these values. The valid values for those metadata keys are ‘true/false’. Also note, earlier support of updating showmount using share metadata is removed since its supported now by share network subnet metadata.

  • NetApp driver bug #2029467: When creating a share from a snapshot, the clone split operation is delayed until the share creation is complete. This ensures that the share creation operation is not blocked by the clone split operation.

  • NetApp driver bug #2100835: The NetApp driver can now prevent the creation of a share server if the total number of data LIFs on one node of HA pair, including those that can be migrated in case of failure,exceeds the maximum number data LIFs supported by the node. This option guarantees that, in the event of a node failure, the partner node will be able to takeover all data LIFs.

Other Notes

  • A new configuration option named cephfs_cached_allocated_capacity_update_interval has been added to the CephFS Native and NFS drivers, so that OpenStack Operators are able to define the amount in seconds for the cached allocation capacity gigabytes timeout to be renewed. The cache validity is measured by a stop watch that is not thread-safe.