mirror of
https://github.com/ceph/ceph
synced 2026-08-02 07:03:18 +00:00
b2ecec6b3a
Several CephFS pages described deprecated commands and features without clear status or replacements, and one page documented an upgrade path that predates every supported release. * cephfs-mirroring: correct the peer_add deprecation note to reference the actual replacement command, peer_bootstrap create, and link the Bootstrap Peers section * kernel-features, experimental-features: state that inline data has been deprecated since the Octopus release and that enabling it triggers a health warning * upgrading: remove the "Upgrading pre-Firefly file systems past Jewel" section; the tmap_upgrade command it referenced was removed in Kraken Fixes: https://tracker.ceph.com/issues/77188 Signed-off-by: Emmanuel Ameh <eameh@contractor.linuxfoundation.org>
43 lines
1.8 KiB
ReStructuredText
43 lines
1.8 KiB
ReStructuredText
=====================
|
|
Experimental Features
|
|
=====================
|
|
|
|
CephFS includes a number of experimental features which are not fully
|
|
stabilized or qualified for users to turn on in real deployments. We generally
|
|
do our best to clearly demarcate these and fence them off so they cannot be
|
|
used by mistake.
|
|
|
|
Some of these features are closer to being done than others, though. We
|
|
describe each of them with an approximation of how risky they are and briefly
|
|
describe what is required to enable them. Note that doing so will
|
|
*irrevocably* flag maps in the Monitor as having once enabled this flag to
|
|
improve debugging and support processes.
|
|
|
|
Inline data
|
|
-----------
|
|
By default, all CephFS file data is stored in RADOS objects. The inline data
|
|
feature enables small files (generally <2KB) to be stored in the inode
|
|
and served out of the MDS. This may improve small-file performance but increases
|
|
load on the MDS. It is not sufficiently tested to support at this time, although
|
|
failures within it are unlikely to make non-inlined data inaccessible.
|
|
|
|
Inline data has always been off by default and requires setting
|
|
the ``inline_data`` flag.
|
|
|
|
Inline data has been deprecated since the Octopus release. Enabling it triggers
|
|
a health warning, and the feature will be removed altogether in a future release.
|
|
|
|
Mantle: Programmable Metadata Load Balancer
|
|
-------------------------------------------
|
|
|
|
Mantle is a programmable metadata balancer built into the MDS. The idea is to
|
|
protect the mechanisms for balancing load (migration, replication,
|
|
fragmentation) but stub out the balancing policies using Lua. For details, see
|
|
:doc:`/cephfs/mantle`.
|
|
|
|
LazyIO
|
|
------
|
|
LazyIO relaxes POSIX semantics. Buffered reads/writes are allowed even when a
|
|
file is opened by multiple applications on multiple clients. Applications are
|
|
responsible for managing cache coherency themselves.
|
