diff options
| author | Zac Dover <zac.dover@proton.me> | 2024-08-25 22:03:34 +0200 |
|---|---|---|
| committer | Zac Dover <zac.dover@proton.me> | 2024-08-25 22:10:36 +0200 |
| commit | d00d1b52d50b5575d918c3be7b7a8249ef31f0a8 (patch) | |
| tree | c47b90445786a6d95ffa8b48a8a9ac6a5a9867d5 | |
| parent | Merge pull request #59053 from baum/wip-baum-20240806-00 (diff) | |
| download | ceph-d00d1b52d50b5575d918c3be7b7a8249ef31f0a8.tar.xz ceph-d00d1b52d50b5575d918c3be7b7a8249ef31f0a8.zip | |
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 <zac.dover@proton.me>
| -rw-r--r-- | doc/cephadm/services/osd.rst | 33 |
1 files changed, 33 insertions, 0 deletions
diff --git a/doc/cephadm/services/osd.rst b/doc/cephadm/services/osd.rst index 3ed091a06a5..9c0b4d2b495 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 </dev/sda> --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 +<https://lists.ceph.io/hyperkitty/list/ceph-users@ceph.io/message/5BAAYFCQAZZDRSNCUPCVBNEPGJDARRZA/>`_ +for discussion of this matter. + .. _cephadm-deploy-osds: Deploy OSDs |