From: Anthony D'Atri Date: Fri, 5 Sep 2025 12:35:25 +0000 (-0400) Subject: doc/rados/operations: Clarify overwrites in erasure-code.rst X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=c8980f467bd91fd9a662a8d808a1f75cf773398f;p=ceph.git doc/rados/operations: Clarify overwrites in erasure-code.rst Signed-off-by: Anthony D'Atri --- diff --git a/doc/rados/operations/erasure-code.rst b/doc/rados/operations/erasure-code.rst index aa9b6329c88..0d4dcca58b5 100644 --- a/doc/rados/operations/erasure-code.rst +++ b/doc/rados/operations/erasure-code.rst @@ -177,10 +177,10 @@ Erasure Coding with Overwrites ------------------------------ By default, erasure-coded pools work only with operations that -perform full object writes and appends (for example, RGW). +perform full RADOS object writes, for example, RGW. Since Luminous, partial writes for an erasure-coded pool may be -enabled with a per-pool setting. This lets RBD and CephFS store their +enabled with a per-pool setting. This lets RBD, CephFS, and librados store data in an erasure-coded pool: .. prompt:: bash $ @@ -189,13 +189,16 @@ data in an erasure-coded pool: This can be enabled only on a pool residing on BlueStore OSDs, since BlueStore's checksumming is used during deep scrubs to detect bitrot -or other corruption. Using Filestore with EC overwrites is not only +and other corruption. Using Filestore with EC overwrites is not only unsafe, but it also results in lower performance compared to BlueStore. Moreover, Filestore is deprecated and any Filestore OSDs in your cluster should be migrated to BlueStore. +There is no downside to enabling EC overwrites, so it is best practice to +routinely do so. + Erasure-coded pools do not support omap, so to use them with RBD and -CephFS you must instruct them to store their data in an EC pool and +CephFS you must instruct them and their clients to store their data in an EC pool and their metadata in a replicated pool. For RBD, this means using the erasure-coded pool as the ``--data-pool`` during image creation: @@ -213,7 +216,8 @@ Erasure Coding Optimizations Since Tentacle, an erasure-coded pool may have optimizations enabled with a per-pool setting. This improves performance for smaller I/Os and -eliminates padding which can save capacity: +eliminates padding, which can significantly reduce space amplification +and wasted capacity: .. prompt:: bash $