gian/ceph-mirror
1
0
Fork 0
mirror of https://github.com/ceph/ceph synced 2026-08-02 07:03:18 +00:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

doc/rados/operations: refine cache-tiering deprecation note per review

Browse Source 
Reduce the note to point existing users to the removal procedure, add a
ref target for the removal section, and rephrase the dm-cache mention to
reflect community adoption without implying official endorsement.
This commit is contained in:
Emmanuel Ameh 2026-06-23 10:34:33 +01:00
parent a3a347e6d1
commit 72265c8800
1 changed files with 8 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
doc/rados/operations/cache-tiering.rst
View File

@ -7,11 +7,11 @@
notice. **Do not deploy new cache tiers.** Migrate existing cache
tier deployments as soon as possible.
.. note:: The following documentation is retained for reference for existing
deployments only. For new deployments, use erasure-coded pools or fast
storage pools directly. As a community-supported block-level caching
alternative, consider ``dm-cache`` (the Linux kernel's device-mapper cache
target).
.. note:: This documentation is retained for existing deployments only.
If you need to remove a cache tier, see :ref:`cache-tiering-removal`.
Some community members have adopted ``dm-cache`` (the Linux kernel's
device-mapper cache target) as a block-level caching alternative, though
this is not an officially supported or endorsed configuration.
A cache tier provides Ceph clients with better I/O performance for a subset of
the data stored in a backing storage tier. Cache tiering involves creating a
@ -452,10 +452,12 @@ For example, to evict objects after 30 minutes, execute the following:
ceph osd pool set hot-storage cache_min_evict_age 1800
.. _cache-tiering-removal:
Removing a Cache Tier
=====================
Removing a cache tier differs depending on whether it is a writeback
Removing a cache tier differs depending on whether it is a writeback
cache or a read-only cache.