From: Kamoltat Sirivadhna <ksirivad@redhat.com>
Date: Wed, 7 Aug 2024 19:20:41 +0000 (+0000)
Subject: docs/rados/operations/stretch-mode: warn device class is not supported
X-Git-Tag: v20.0.0~1296^2
X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=refs%2Fpull%2F59087%2Fhead;p=ceph.git

docs/rados/operations/stretch-mode: warn device class is not supported

Signed-off-by: Kamoltat Sirivadhna <ksirivad@redhat.com>
---

diff --git a/doc/rados/operations/stretch-mode.rst b/doc/rados/operations/stretch-mode.rst
index 31bbe821f96ea..a5694718a5847 100644
--- a/doc/rados/operations/stretch-mode.rst
+++ b/doc/rados/operations/stretch-mode.rst
@@ -272,8 +272,21 @@ SSDs (including NVMe OSDs). Hybrid HDD+SDD or HDD-only OSDs are not recommended
 due to the long time it takes for them to recover after connectivity between
 data centers has been restored. This reduces the potential for data loss.
 
-In the future, stretch mode might support erasure-coded pools and might support
-deployments that have more than two data centers.
+.. warning:: Device class is currently not supported in stretch mode.
+   For example, the following rule containing ``device class`` will not work::
+
+      rule stretch_replicated_rule {
+                 id 2
+                 type replicated class hdd
+                 step take default
+                 step choose firstn 0 type datacenter
+                 step chooseleaf firstn 2 type host
+                 step emit
+      }
+
+In the future, stretch mode could support erasure-coded pools,
+enable deployments across multiple data centers,
+and accommodate various device classes.
 
 Other commands
 ==============