From: Zac Dover Date: Sun, 25 Aug 2024 20:03:34 +0000 (+1000) Subject: doc/cephadm: how to get exact size_spec from device X-Git-Tag: v17.2.8~133^2 X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=830f8760502643c97700e96ab8c0e6e903d4d702;p=ceph.git doc/cephadm: how to get exact size_spec from device Add instructions for retrieving the exact size of block devices. Fixes: https://tracker.ceph.com/issues/66754 Signed-off-by: Zac Dover (cherry picked from commit d00d1b52d50b5575d918c3be7b7a8249ef31f0a8) --- diff --git a/doc/cephadm/services/osd.rst b/doc/cephadm/services/osd.rst index 5344d984b4364..5e4194d026c76 100644 --- a/doc/cephadm/services/osd.rst +++ b/doc/cephadm/services/osd.rst @@ -84,6 +84,39 @@ information about interacting with these LEDs, refer to :ref:`devices`. The current release of `libstoragemgmt`_ (1.8.8) supports SCSI, SAS, and SATA based local disks only. There is no official support for NVMe devices (PCIe) +Retrieve Exact Size of Block Devices +==================================== + +Run a command of the following form to discover the exact size of a block +device. The value returned here is used by the orchestrator when comparing high +and low values: + +.. prompt:: bash # + + cephadm shell ceph-volume inventory --format json | jq .sys_api.human_readable_size + +The exact size in GB is the size reported in TB, multiplied by 1000. + +Example +------- +The following provides a specific example of this command based upon the +general form of the command above: + +.. prompt:: bash # + + cephadm shell ceph-volume inventory /dev/sdc --format json | jq .sys_api.human_readable_size + +:: + + "3.64 TB" + +This means that the exact device size is 3.64 * 1000, or 3640GB. + +This procedure was developed by Frédéric Nass. See `this thread on the +[ceph-users] mailing list +`_ +for discussion of this matter. + .. _cephadm-deploy-osds: Deploy OSDs