From: Juan Miguel Olmo Martínez <jolmomar@redhat.com>
Date: Tue, 19 May 2020 10:07:10 +0000 (+0200)
Subject: doc: New section in device management
X-Git-Tag: v15.2.4~69^2~19
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=5557c5f37a9daddbc0561f1664f0508ef875c477;p=ceph.git

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 8e120446a7c..98691a043d4 100644
--- 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
 -------------------