From: Sebastian Wagner <sebastian.wagner@suse.com>
Date: Tue, 8 Sep 2020 12:44:43 +0000 (+0200)
Subject: doc/cephadm: Add remove host to operations
X-Git-Tag: v15.2.9~88^2~6
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=42e899644476706b110bf96c4e9faca9919993f2;p=ceph.git

doc/cephadm: Add remove host to operations

Co-authored-by: Alexandra Settle <asettle@suse.com>
Co-authored-by: Kefu Chai <tchaikov@gmail.com>
Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
(cherry picked from commit 453000af19b25082aef1b473bd9284311ac98204)
---

diff --git a/doc/cephadm/operations.rst b/doc/cephadm/operations.rst
index 456f48628f3c1..f852ef94424de 100644
--- a/doc/cephadm/operations.rst
+++ b/doc/cephadm/operations.rst
@@ -305,3 +305,53 @@ the cluster, create an initial ``ceph.conf`` file. For example::
 Then, run bootstrap referencing this file::
 
   cephadm bootstrap -c /root/ceph.conf ...
+
+
+.. _cephadm-removing-hosts:
+
+Removing Hosts
+==============
+
+If the node that want you to remove is running OSDs, make sure you remove the OSDs from the node.
+
+To remove a host from a cluster, do the following:
+
+For all Ceph service types, except for ``node-exporter`` and ``crash``, remove
+the host from the placement specification file (for example, cluster.yml).
+For example, if you are removing the host named host2, remove all occurrences of
+``- host2`` from all ``placement:`` sections.
+
+Update:
+
+.. code-block:: yaml
+
+  service_type: rgw
+  placement:
+    hosts:
+    - host1
+    - host2
+
+To:
+
+.. code-block:: yaml
+
+
+  service_type: rgw
+  placement:
+    hosts:
+    - host1
+
+Remove the host from cephadm's environment:
+
+.. code-block:: bash
+
+  ceph orch host rm host2
+
+See also :ref:`orchestrator-cli-host-management`.
+
+If the host is running ``node-exporter`` and crash services, remove them by running
+the following command on the host:
+
+.. code-block:: bash
+
+  cephadm rm-daemon --fsid CLUSTER_ID --name SERVICE_NAME
diff --git a/doc/mgr/orchestrator.rst b/doc/mgr/orchestrator.rst
index fba1b5ce06265..4cf695992857a 100644
--- a/doc/mgr/orchestrator.rst
+++ b/doc/mgr/orchestrator.rst
@@ -58,6 +58,8 @@ Status
 Show current orchestrator mode and high-level status (whether the orchestrator
 plugin is available and operational)
 
+.. _orchestrator-cli-host-management:
+
 Host Management
 ===============
 
@@ -70,7 +72,7 @@ Add and remove hosts::
     ceph orch host add <hostname> [<addr>] [<labels>...]
     ceph orch host rm <hostname>
 
-For cephadm, see also :ref:`cephadm-fqdn`.
+For cephadm, see also :ref:`cephadm-fqdn` and :ref:`cephadm-removing-hosts`.
 
 Host Specification
 ------------------