From: John Wyatt Date: Sat, 14 Mar 2020 05:55:53 +0000 (-0700) Subject: Doc: added space requirement to "Build Prerequisites" X-Git-Tag: wip-pdonnell-testing-20200918.022351~1538^2 X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=b3832800578ab1f8436626374aeaf233897e8611;p=ceph-ci.git Doc: added space requirement to "Build Prerequisites" Build prerequisites section does not include how much space Ceph takes. A Ceph debug build can take 40 gigabytes by itself - double the default size of many VMs by default, including CentOS 8 for virt-manager. New contributors may be turned off or may not understand why Ceph does not build. Also a warning on LVM taking up too much disk space. Signed-off-by: John B. Wyatt IV --- diff --git a/doc/install/build-ceph.rst b/doc/install/build-ceph.rst index 147986e4c7d..5c93ca52d8b 100644 --- a/doc/install/build-ceph.rst +++ b/doc/install/build-ceph.rst @@ -3,16 +3,24 @@ ============ You can get Ceph software by retrieving Ceph source code and building it yourself. -To build Ceph, you need to set up a development environment, compile Ceph, -and then either install in user space or build packages and install the packages. +To build Ceph, you need to set up a development environment, compile Ceph, +and then either install in user space or build packages and install the packages. Build Prerequisites =================== -.. tip:: Check this section to see if there are specific prerequisites for your +.. tip:: Check this section to see if there are specific prerequisites for your Linux/Unix distribution. +A debug build of Ceph may take around 40 gigabytes. If you want to build Ceph in +a virtual machine (VM) please make sure total disk space on the VM is at least +60 gigabytes. + +Please also be aware that some distributions of Linux, like CentOS, use Linux +Volume Manager (LVM) for the default installation. LVM may reserve a large +portion of disk space of a typical sized virtual disk for the operating system. + Before you can build Ceph source code, you need to install several libraries and tools::