From 188f4ae80fefcdd8d95d719a88d8422b2c120f0c Mon Sep 17 00:00:00 2001 From: Alfredo Deza Date: Tue, 28 Aug 2018 13:32:19 -0700 Subject: [PATCH] doc/ceph-volume add filestore docs for batch Signed-off-by: Alfredo Deza --- doc/ceph-volume/lvm/batch.rst | 27 ++++++++++++++++++++++++++- 1 file changed, 26 insertions(+), 1 deletion(-) diff --git a/doc/ceph-volume/lvm/batch.rst b/doc/ceph-volume/lvm/batch.rst index f6c1005735d03..bf484b017d553 100644 --- a/doc/ceph-volume/lvm/batch.rst +++ b/doc/ceph-volume/lvm/batch.rst @@ -36,10 +36,35 @@ on the input of devices: .. note:: Although operations in ``ceph-volume lvm create`` allow usage of ``block.wal`` it isn't supported with the ``batch`` sub-command + +.. _ceph-volume-lvm-batch_filestore: + +``filestore`` +------------- +The :term:`filestore` objectstore can be used when creating multiple OSDs +with the ``batch`` sub-command. It allows two different scenarios depending +on the input of devices: + +#. Devices are all the same type (for example all spinning HDD or all SSDs): + 1 OSD is created per device, collocating the journal in the same HDD. +#. Devices are a mix of HDDS and SSDs: data is placed on the spinning device, + while the journal is created on the SSD using the sizing options from + ceph.conf and falling back to the default journal size of 5GB. + + +When a mix of solid and spinning devices are used, ``ceph-volume`` will try to +detect existing volume groups on the solid devices. If a VG is found, it will +try to create the logical volume from there, otherwise raising an error if +space is insufficient. + +If a raw solid device is used along with a device that has a volume group in +addition to some spinning devices, ``ceph-volume`` will try to extend the +existing volume group and then create a logical volume. + .. _ceph-volume-lvm-batch_report: Reporting ---------- +========= When a call is received to create OSDs, the tool will prompt the user to continue if the pre-computed output is acceptable. This output is useful to understand the outcome of the received devices. Once confirmation is accepted, -- 2.39.5