From b02c98bfa5f0ebe442abd97fab16d65b0ebfbf83 Mon Sep 17 00:00:00 2001 From: Zac Dover Date: Tue, 14 Jul 2020 23:51:08 +1000 Subject: [PATCH] doc/cephadm: add yaml infor for orch apply mon This commit breaks one of the long sentences into three shorter sentences, and adds a parenthetical comment walking the reader through a series of commands, explaining what each command does and why only the last of the commands ends up having a lasting effect on the Ceph environment. Fixes: https://tracker.ceph.com/issues/46133 Signed-off-by: Zac Dover --- doc/cephadm/install.rst | 43 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) diff --git a/doc/cephadm/install.rst b/doc/cephadm/install.rst index c172b903dab6c..628405d736b06 100644 --- a/doc/cephadm/install.rst +++ b/doc/cephadm/install.rst @@ -257,6 +257,49 @@ hosts to the cluster. No further steps are necessary. # ceph orch daemon add mon newhost1:10.1.2.123 # ceph orch daemon add mon newhost2:10.1.2.0/24 + .. note:: + The **apply** command can be confusing. For this reason, we recommend using + YAML specifications. + + Each 'ceph orch apply mon' command supersedes the one before it. + This means that you must use the proper comma-separated list-based + syntax when you want to apply monitors to more than one host. + If you do not use the proper syntax, you will clobber your work + as you go. + + For example:: + + # ceph orch apply mon host1 + # ceph orch apply mon host2 + # ceph orch apply mon host3 + + This results in only one host having a monitor applied to it: host 3. + + (The first command creates a monitor on host1. Then the second command + clobbers the monitor on host1 and creates a monitor on host2. Then the + third command clobbers the monitor on host2 and creates a monitor on + host3. In this scenario, at this point, there is a monitor ONLY on + host3.) + + To make certain that a monitor is applied to each of these three hosts, + run a command like this:: + + # ceph orch apply mon "host1,host2,host3" + + Instead of using the "ceph orch apply mon" commands, run a command like + this:: + + # ceph orch apply -i file.yaml + + Here is a sample **file.yaml** file:: + + service_type: mon + placement: + hosts: + - host1 + - host2 + - host3 + Deploy OSDs =========== -- 2.39.5