]> git.apps.os.sepia.ceph.com Git - ceph.git/commitdiff
doc: clarify use of location: in host spec 57647/head
authorMatthew Vernon <mvernon@wikimedia.org>
Wed, 22 May 2024 15:31:33 +0000 (16:31 +0100)
committerZac Dover <zac.dover@proton.me>
Thu, 23 May 2024 01:26:45 +0000 (11:26 +1000)
It wasn't clear that you can specify more than one element of the CRUSH hierarchy in a spec file, nor that it might be useful to do so (e.g. to ensure the host ends up beneath the default root).

So update the text to make it clearer, and similarly the example.

Signed-off-by: Matthew Vernon <mvernon@wikimedia.org>
(cherry picked from commit 2366391ccec0fb6d8a1c159d6e3cdf5ff4f1d603)

doc/cephadm/host-management.rst

index 1fba8e582d30274a62a4a7a411e25c01b3a33852..05c0ccf97d61612ed6b0391d55c195bc6ed45651 100644 (file)
@@ -303,7 +303,10 @@ Setting the initial CRUSH location of host
 ==========================================
 
 Hosts can contain a ``location`` identifier which will instruct cephadm to 
-create a new CRUSH host located in the specified hierarchy.
+create a new CRUSH host bucket located in the specified hierarchy.
+You can specify more than one element of the tree when doing so (for
+instance if you want to ensure that the rack that a host is being
+added to is also added to the default bucket), for example:
 
 .. code-block:: yaml
 
@@ -311,6 +314,7 @@ create a new CRUSH host located in the specified hierarchy.
     hostname: node-00
     addr: 192.168.0.10
     location:
+      root: default
       rack: rack1
 
 .. note::