manila/releasenotes/notes/bug-1890833-fix-cephfs-incorrect-capacity-report-3a9bdaffcc62ec71.yaml
Goutham Pacha Ravi 22d6fe98a3 Fix capacity calculations in the CephFS driver
The driver inflated total and available capacity
due to an incorrect calculation. The driver was
also ignoring the configuration option
"reserved_share_percentage" that allows
deployers to set aside space from scheduling
to prevent oversubscription.

While this bugfix may have an upgrade impact,
some things must be clarified:
- Inflating the total, free space will allow
  manila to schedule workloads that may run
  out of space - this may cause end user
  downtime and frustration, because shares are
  created (empty subvolumes on ceph occupy no
  space) easily, but they could get throttled
  as they start to fill up.
- CephFS shares are always thinly provisioned
  but, the driver does not support oversubscription
  via manila. So, real free space is what
  determines capacity based scheduler decisions.
  Users however expect share sizes to be honored,
  and manila will allow provisioning as long
  as there is free space on the cluster. This
  means that Ceph cluster administrators
  must manage oversubscription outside of manila
  to prevent misbehavior.

Depends-On: Ic96b65d2caab788afca8bfc45575f3c05dc88008
Change-Id: I6ab157d6d099fe910ec1d90193783b55053ce8f6
Closes-Bug: #1890833
Signed-off-by: Goutham Pacha Ravi <gouthampravi@gmail.com>
2020-09-17 19:27:04 +00:00

23 lines
1.1 KiB
YAML

---
upgrade:
- |
This version includes a fix to the CephFS drivers to address `an issue
<https://launchpad.net/bugs/1890833>`_ with total and free space calculation
in the CephFS driver. When you update, you will notice that the space
calculations reflect reality in your Ceph clusters, and provisioning may
fail if the share sizes exceed the cluster's free space. CephFS shares are
always thin provisioned, and the driver does not support oversubscription
via Manila; so space can be claimed for new shares as long as there is free
space on the cluster. Use the "reserved_share_percentage" back end
configuration option to ensure there's always space left aside for
provisioned workloads to grow over time.
fixes:
- |
The CephFS driver has now been fixed to report total and available space on
the storage system correctly. See `Launchpad bug#1890833
<https://launchpad.net/bugs/1890833>`_ for more details.
- |
The CephFS driver now honors the configuration option
"reserved_share_percentage", and it can be used to prevent save
space for provisioned workloads to grow over time.