Open Stack

We enthusiastically announce the release of:

manila 12.1.0: Shared Storage for OpenStack

This release is part of the wallaby stable release series.

The source is available from:

    https://opendev.org/openstack/manila

Download the package from:

    https://tarballs.openstack.org/manila/

Please report issues through:

    https://bugs.launchpad.net/manila/+bugs

For more details, please see below.

12.1.0
^^^^^^


Upgrade Notes
*************

* MON write caps are not longer needed to interact with the backend
  on the Ceph drivers. The capabilities of the driver user (configured
  with "cephfs_auth_id") can hence be reduced. See the administrator
  docs
  (https://docs.openstack.org/manila/wallaby/admin/cephfs_driver.html
  #authorizing-the-driver-to-communicate-with-ceph) for the
  capabilities required.


Bug Fixes
*********

* An issue with RPC handling on service restart was addressed by
  ensuring proper initialization before creating the RPC consumer. See
  bug 1271568 (https://bugs.launchpad.net/manila/+bug/1271568) for
  more details.

* Authentication errors when loading service clients of OpenStack
  Compute (nova), OpenStack Image (glance), OpenStack Volume (cinder)
  and OpenStack Networking (neutron) services are now handled in a
  better manner.

* Fixed bug #1922075
  (https://bugs.launchpad.net/manila/+bug/1922075) Fixed the problem
  that "gluster volume set nfs.rpc-auth-reject '*'" failed when the
  glusterfs driver created an instance from a snapshot.

* mgr-commands are now directed to the mgr-daemon instead of the
  mon- daemon in the CephFS drivers

* Fixed NotFound error in share replica periodic tasks. It could
  happen that the parent share of the replica that was being worked on
  had already been deleted.

* Corrected an error message for attempts to create snapshots from
  shares that do not support this operation.  The message said that
  the share backend has no such support but that is not always true.
  The original share for the snapshot does not support snapshots
  because it was created with a share type without the
  "snapshot_support" extra-spec set, irrespective of whether the back
  end used can itself support snapshots or not.

* Fixed an issue that made migrated shares with replication support
  to do not have a share instance with its *replica_state* set to
  active. Now, when the share supports replication, the destination
  share instance will have its replica state set as active right after
  the migration gets completed. For more details, please refer to bug
  1927060 (https://bugs.launchpad.net/manila/+bug/1927060)

* Filtering shares by share-type "extra_specs" as key=value now
  returns the expected output.

* A Ceph version check has been added as part of this change to
  address the absense of the mon-mgr target in Ceph Nautilus. With
  this change, Ceph Nautilus users can leverage their storage backend
  with the OpenStack manila Wallaby release.

* The Infinidat driver's been fixed to process single IP Addresses
  (/32) correctly. See bug 1934345
  (https://launchpad.net/bugs/1934345) for more details.

* NetApp driver: fixed an issue with the ONTAP 9.8 and older, for
  scoped account users, where the operation of deleting a replica was
  not working, but returned a message of success. For more details,
  please refer to launchpad bug #1934889
  (https://bugs.launchpad.net/manila/+bug/1934889)

* New user message now alerts users when attempting to create a new
  share without identifying a share type, either through request body
  or by setting a default share type. See bug #1870280
  (https://bugs.launchpad.net/manila/+bug/1870280) for more details.

Changes in manila 12.0.0..12.1.0
--------------------------------

7eca10bc Add missing share-type user message
b7ec1f88 Add missing [oslo_reports] options
9749a0a9 handle replica state on migration complete
2e4ac3f4 Add documentation for share server limits
24545ad9 [NetApp] Fixed scoped account replica delete
92b8330f Add missing oslo.service options
5a19c632 Use oslo-config-generator conf to load options from libraries
274073fc Add documentation for per share gigabytes quotas
2433bca5 Updates CephFS drivers docs
887c4bf4 init_host should be called before RPC consumer is created
113dc287 Handle service client authorization errors
59a0c147 Filter shares by share type "extra_specs"
9c723d0e fixes  availability zone filter when creating a share from snapshot
16d88864 Add Ceph version check
2a632595 Adds a clear error message to operator-set limits
f1822cf4 TrivialFix: Fix the filter name in config helper
d015399a Fix ipaddress issues in the infinidat driver
de8b5c3d PowerMax Manila - version change for Wallaby
377fbc3a Fix PDF build
1f4214d8 Update IRC references
7116f839 Fix with_entities usage in db queries
3532f5d6 Replace deprecated SQLAlchemy "with_lockmode"
2a24b3f6 [stable/wallaby-only] Set max api version via plugin.sh
fb5a4f93 Fix api error message for snapshot creation failure
3635ade6 [Glusterfs] Fix create share from snapshot failed
9a9a2c24 Direct mgr commands to the mgr daemon
5bd8e46d Reuse _set_instances_share_data for replicas.
af91420c Document policy rule using the description parameter
010454e7 [doc] Annotate max api microversion in Wallaby
46c9ec69 Update TOX_CONSTRAINTS_FILE for stable/wallaby
75341113 Update .gitreview for stable/wallaby


Diffstat (except docs and test files)
-------------------------------------

.gitreview                                         |  1 +
api-ref/source/parameters.yaml                     | 36 ++++++++++
api-ref/source/quota-classes.inc                   |  5 ++
api-ref/source/quota-sets.inc                      |  9 +++
.../samples/quota-classes-show-response.json       |  3 +-
.../samples/quota-classes-update-response.json     |  3 +-
.../source/samples/quota-show-detail-response.json |  6 +-
api-ref/source/samples/quota-show-response.json    |  3 +-
api-ref/source/samples/quota-update-request.json   |  3 +-
api-ref/source/samples/quota-update-response.json  |  3 +-
contrib/ci/post_test_hook.sh                       | 17 -----
devstack/plugin.sh                                 |  5 ++
...ared-file-systems-manage-and-unmanage-share.rst |  2 +
...shared-file-systems-share-server-management.rst | 22 ++++++
.../configuration/shared-file-systems/overview.rst |  2 +
.../shared-file-systems/samples/sample_policy.rst  | 11 ++-
etc/oslo-config-generator/manila.conf              | 13 +++-
manila/api/openstack/rest_api_version_history.rst  |  4 +-
manila/api/v1/share_snapshots.py                   |  4 +-
manila/api/v1/shares.py                            | 11 +--
manila/common/client_auth.py                       |  5 +-
manila/compute/nova.py                             |  4 +-
manila/db/sqlalchemy/api.py                        | 57 +++++++--------
...dd-explicit-error-message-c33c7b75a7e49257.yaml |  7 ++
manila/image/glance.py                             |  5 +-
manila/manager.py                                  | 14 +++-
manila/message/message_field.py                    |  5 ++
manila/network/neutron/api.py                      |  4 +-
manila/opts.py                                     | 11 ---
manila/policies/base.py                            | 32 +++++----
manila/scheduler/drivers/filter.py                 | 10 +++
manila/scheduler/manager.py                        |  2 +-
manila/service.py                                  |  4 +-
manila/share/api.py                                |  2 +-
manila/share/drivers/cephfs/driver.py              | 59 +++++++++++++--
.../dell_emc/plugins/powermax/connection.py        |  3 +-
manila/share/drivers/glusterfs/layout_volume.py    | 33 +++++++--
manila/share/drivers/infinidat/infinibox.py        |  2 +-
.../netapp/dataontap/client/client_cmode.py        | 57 +++++++++------
manila/share/manager.py                            | 32 +++++----
.../share/drivers/glusterfs/test_layout_volume.py  | 13 ++--
.../netapp/dataontap/client/test_client_cmode.py   | 60 +++++++++++-----
manila/volume/cinder.py                            |  4 +-
...ix-rpc-init-host-with-rpc-6e76afa553b4f2af.yaml |  6 ++
...t-unauthorized-exceptions-b2ebc08a072f7e12.yaml |  6 ++
...hare-from-snapshot-failed-053a583522a6fc0e.yaml |  6 ++
...irect-mgr-commands-monmgr-5e8babb4a1067e92.yaml | 11 +++
...ound-replica-parent-share-d8e50659c02b941a.yaml |  5 ++
...hot-support-api-error-msg-eaf5fd2b1df97d15.yaml | 10 +++
...ate-on-migration-complete-4fb4d8ba59b58505.yaml |  9 +++
...ing-shares-by-extra-specs-b79235301306bcf2.yaml |  5 ++
...59-add-ceph-version-check-88eee324bc6134ea.yaml |  7 ++
...paddress-hosts-invocation-80d419d7e62a5f51.yaml |  6 ++
...delete-for-scoped-account-8fa193c0424af9b1.yaml |  7 ++
...0-share-type-user-message-902275047410bdbf.yaml |  7 ++
tox.ini                                            |  6 +-
zuul.d/project.yaml                                |  6 --
72 files changed, 700 insertions(+), 240 deletions(-)