From 4525113fa123a5b1e8a23d6aefc306e6772326bc Mon Sep 17 00:00:00 2001 From: Paul Cuzner Date: Mon, 30 May 2022 13:55:27 +1200 Subject: [PATCH] docs: Add docs for new host rescan feature Signed-off-by: Paul Cuzner --- doc/cephadm/host-management.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/doc/cephadm/host-management.rst b/doc/cephadm/host-management.rst index c1534b6132ced..22f66eeafa11f 100644 --- a/doc/cephadm/host-management.rst +++ b/doc/cephadm/host-management.rst @@ -177,6 +177,21 @@ Where the force flag when entering maintenance allows the user to bypass warning See also :ref:`cephadm-fqdn` +Rescanning Host Devices +======================= + +Some servers and external enclosures may not register device removal or insertion with the +kernel. In these scenarios, you'll need to perform a host rescan. A rescan is typically +non-disruptive, and can be performed with the following CLI command.:: + + ceph orch host rescan [--with-summary] + +The ``with-summary`` flag provides a breakdown of the number of HBAs found and scanned, together +with any that failed.:: + + [ceph: root@rh9-ceph1 /]# ceph orch host rescan rh9-ceph1 --with-summary + Ok. 2 adapters detected: 2 rescanned, 0 skipped, 0 failed (0.32s) + Creating many hosts at once =========================== -- 2.39.5