doc: New section in device management

A new section to describe the command used to blink lights in physical devices

Signed-off-by: Juan Miguel Olmo Martínez <jolmomar@redhat.com>
(cherry picked from commit e0257273dd4c83049ab9cedf703f165b63b52d01)

diff --git a/doc/rados/operations/devices.rst b/doc/rados/operations/devices.rst
index 8e120446a7c39516c65ba7baf04a1a5e1fd27bf1..98691a043d49be24afb40997f0694ed068c755e5 100644 (file)
--- a/doc/rados/operations/devices.rst
+++ b/doc/rados/operations/devices.rst
@@ -25,6 +25,27 @@ location and how it is being consumed with::
 
   ceph device info <devid>
 
+Identifying physical devices
+----------------------------
+
+You can blink the drive LEDs on hardware enclosures to make the replacement of
+failed disks easy and less error-prone.  Use the following command::
+
+  device light on|off <devid> [ident|fault] [--force]
+
+The ``<devid>`` parameter is the device identification. You can obtain this
+information using the following command::
+
+  ceph device ls
+
+The ``[ident|fault]`` parameter is used to set the kind of light to blink.
+By default, the `identification` light is used.
+
+.. note::
+   This command needs the Cephadm or the Rook `orchestrator <https://docs.ceph.com/docs/master/mgr/orchestrator/#orchestrator-cli-module>`_ module enabled.
+   The orchestrator module enabled is shown by executing the following command::
+
+     ceph orch status
 
 Enabling monitoring
 -------------------