Commit Graph

18 Commits

Author SHA1 Message Date
Goutham Pacha Ravi 26ec5dadb6 [doc] Update CephFS admin guide
There's a new driver mode supported since
Antelope (introduced in Zed) that supports
ceph orchestrator deployed CephFS NFS clusters.
We were missing documentation regarding this.

Also consolidate the admin/configuration references
for this driver; this deletes all the outdated
information in the existing config guide.

Partially-implements: bp use-cephadm-nfs-ganesha
Change-Id: I43952d890629e60465059a5b4242817becb198b1
Signed-off-by: Goutham Pacha Ravi <gouthampravi@gmail.com>
2024-03-11 20:38:10 +00:00
Victoria Martinez de la Cruz cf4af61638 Deprecate create snapshot from share group in CephFS
Deprecate the create snapshot from share group feature
in CephFS drivers (both Native and NFS Ganesha).

This needs to be done since the subvolume group snapshot
feature is no longer supported in mainline CephFS, meaning that,
if we leave the call in place, an exception will be raised
from the backend and lead to an error status for the attempted
snapshot from share group.

Existing group snapshots can still be listed and deleted, so these
operations stay the same.

Closes-Bug: #1925332
Change-Id: I49efb7042d38257416875f40c03923e974b2eb8e
2021-07-19 14:50:05 +00:00
Victoria Martinez de la Cruz 992ec82575 Updates CephFS drivers docs
As part of our work on updating CephFS drivers
to use the ceph-mgr interface, the related docs
on the admin guide need to be updated

- Updates ceph caps for manila to include mgr caps,
remove mds caps, and constrain mon caps
- Add the new cephfs_filesystem_name param to the
config
- Add upgrade to Wallaby considerations (minimum Ceph
version required)

Partially-Implement: bp update-cephfs-drivers
Change-Id: I113639cc9989bbaf224d19969993870d30b81c29
2021-04-28 09:23:58 +00:00
Zuul 42b709e446 Merge "Adds missing caps for mgr in cephfs configuration" 2021-01-22 21:15:14 +00:00
Jose Castro Leon ba3275e9ba Adds missing caps for mgr in cephfs configuration
Adds a missing cap to access mgr and be able to list subvolumegroups
and subvolumes in a cephfs volume

Change-Id: Ie9849ed875b996cf33aeb296f258ec84c8b720ef
Closes-Bug: #1907467
2021-01-22 20:07:13 +00:00
Victoria Martinez de la Cruz d7407afd55 Update manila and Ceph matrix support doc
Include Wallaby (master) support matrix and
some extra considerations to consider on manila
with cephfs backends.

Change-Id: Iad7cb229151b8dd707a59553cb6e966090d0eeae
2021-01-13 20:41:58 +00:00
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
Goutham Pacha Ravi 2d7c464453 Enable cephfs snapshots
The CephFS driver optionally advertised snapshot
support to manila, based on a configuration
option "cephfs_enable_snapshots". Manila does not
provide snapshots by default to users, unless an
administrator chooses to set the "snapshot_support"
extra-spec in the share type they're using. So this
configuration option is really an unnecessary safeguard
at this point.

Moreover, CephFS snapshots are fully supported from
Ceph Nautilus, and with Id847b1b5e6623172f2600afd69e51182067444cb,
manila added a support statement for the Victoria
release that indicates that Nautilus is the minimum
version of ceph supported. So let's default this
option to True, and deprecate this option at the same
time to eliminate this duplicate safeguard.

Partially-implements: bp update-cephfs-drivers
Depends-On: I885ff78586540d01590f98cca2a00d55161dbe04
Change-Id: I1ef42b414f8af0b8f9a912655757ec200a75c309
Signed-off-by: Goutham Pacha Ravi <gouthampravi@gmail.com>
2020-07-07 22:13:08 -07:00
Goutham Pacha Ravi 524ad986e3 Add Ceph support statement
The manila discussed cephfs futures
during the Victoria cycle PTG [1]. To support newer
features in ceph, we'll need to start using the
ceph-mgr interface that debuted in Nautilus.

When we start adopting ceph-mgr, we can no longer
support Mimic, Luminous and older releases of Ceph
without maintaining code workarounds and a continuous
integration system to ensure they're not broken.
This takes considerable effort from community members.

We've supported the Luminous release since OpenStack
Queens, and there have been at least
three other major releases of Ceph in the meantime,
let's add a release note and adjust the ceph driver
documentation calling out our support/testing stance.

[1] http://lists.openstack.org/pipermail/openstack-discuss/2020-June/015494.html

Partially-implements: bp update-cephfs-drivers
Change-Id: Id847b1b5e6623172f2600afd69e51182067444cb
Signed-off-by: Goutham Pacha Ravi <gouthampravi@gmail.com>
2020-07-06 17:19:07 -07:00
ericxiett 0f4997d0ee Fix incorrect 'cephfnfs1' to 'cephfsnfs1'
Change-Id: Icdd7eafac412982e5770f9a8a7b7d57c91ad6cea
2019-08-08 09:30:08 +08:00
Pierre Riteau b23c7b3719 Fix hyperlink reference to security section
Change-Id: Id936885d51054a2c4aa93d4b2a051e9e5e37bce5
2019-03-12 11:30:09 +00:00
guotao.bj f10835e9c2 Delete the duplicate words in cephfs_driver.rst
Change-Id: Ic70dca4122b0210352279529d98bf5f637bb7eb8
2018-11-13 17:15:23 +08:00
xuleibj 18b8bf628c Fix typos
There are two 'the', delete one of them.

Change-Id: I0d4b13daff19b5c7922e28e01fdc4ee29393318b
2018-02-09 11:22:59 +08:00
Ramana Raja f5812012ac [Doc] Correct a known restriction in cephfs_driver
TrivialFix

Change-Id: Ie369f997fa09e5e1128ba745df1163411d6be24f
2017-12-26 16:39:41 +05:30
Ramana Raja add46c036b ganesha: store exports and export counter in RADOS
Allow the ganesha driver to store ganesha exports
and export counter as Ceph RADOS objects. This enables
highly available(HA) Ganesha servers in manila deployments
to store their config in a HA storage.

Implements: blueprint ganesha-ha-rados
Change-Id: Ia51156055fa10d0661e662c9c998829864f1a204
2017-12-08 10:33:44 +05:30
caowei ff27e23776 [Doc]Update cephfs_auth_id for cephfsnfs Configuration
TrivialFix
Change-Id: I3ce33cca59dff25ad89fdd770c852beadf74f234
2017-11-21 11:46:55 +00:00
caowei c82c04124f The default cephfs_enable_snapshots set to False
The snapshot support of the driver is disabled by default.
Reference:
https://github.com/openstack/manila/blob/master/manila/share/drivers/cephfs/driver.py#L60

TrivialFix

Change-Id: I462a7567851ed3e40ff075762cd9c75d69b4ad69
2017-11-01 15:42:13 +08:00
Tom Barron a149c283d7 doc: move stuff from contributor to admin
As agreed in weekly manila community meetings and at the
Queens PTG, several documents currently presented to contributors
are really of general interest to cloud administrators and should
be presented accordingly.

Move the docs on manila back ends, the feature support mapping,
capabilities and extra specs, and export locations and metatdata
to the admin section.

Change-Id: I6d9dec56890fb3a9bc0539c45c43233517cea048
2017-10-18 15:55:24 -04:00