]> git.proxmox.com Git - ceph.git/blame - ceph/doc/start/os-recommendations.rst
update ceph source to reef 18.1.2
[ceph.git] / ceph / doc / start / os-recommendations.rst
CommitLineData
7c673cae
FG
1====================
2 OS Recommendations
3====================
4
5Ceph Dependencies
6=================
7
8As a general rule, we recommend deploying Ceph on newer releases of Linux.
9We also recommend deploying on releases with long-term support.
10
11Linux Kernel
12------------
13
14- **Ceph Kernel Client**
15
224ce89b
WB
16 If you are using the kernel client to map RBD block devices or mount
17 CephFS, the general advice is to use a "stable" or "longterm
18 maintenance" kernel series provided by either http://kernel.org or
19 your Linux distribution on any client hosts.
7c673cae 20
1e59de90
TL
21 For RBD, if you choose to *track* long-term kernels, we recommend
22 *at least* 4.19-based "longterm maintenance" kernel series. If you can
23 use a newer "stable" or "longterm maintenance" kernel series, do it.
7c673cae 24
f67539c2
TL
25 For CephFS, see the section about `Mounting CephFS using Kernel Driver`_
26 for kernel version guidance.
7c673cae 27
224ce89b 28 Older kernel client versions may not support your `CRUSH tunables`_ profile
1e59de90
TL
29 or other newer features of the Ceph cluster, requiring the storage cluster to
30 be configured with those features disabled. For RBD, a kernel of version 5.3
31 or CentOS 8.2 is the minimum necessary for reasonable support for RBD image
32 features.
7c673cae 33
7c673cae
FG
34
35Platforms
36=========
37
38The charts below show how Ceph's requirements map onto various Linux
39platforms. Generally speaking, there is very little dependence on
33c7a0ef 40specific distributions outside of the kernel and system initialization
20effc67 41package (i.e., sysvinit, systemd).
7c673cae 42
33c7a0ef
TL
43+--------------+--------+------------------------+--------------------------------+-------------------+-----------------+
44| Release Name | Tag | CentOS | Ubuntu | OpenSUSE :sup:`C` | Debian :sup:`C` |
45+==============+========+========================+================================+===================+=================+
46| Quincy | 17.2.z | 8 :sup:`A` | 20.04 :sup:`A` | 15.3 | 11 |
47+--------------+--------+------------------------+--------------------------------+-------------------+-----------------+
48| Pacific | 16.2.z | 8 :sup:`A` | 18.04 :sup:`C`, 20.04 :sup:`A` | 15.2 | 10, 11 |
49+--------------+--------+------------------------+--------------------------------+-------------------+-----------------+
50| Octopus | 15.2.z | 7 :sup:`B` 8 :sup:`A` | 18.04 :sup:`C`, 20.04 :sup:`A` | 15.2 | 10 |
51+--------------+--------+------------------------+--------------------------------+-------------------+-----------------+
52
53- **A**: Ceph provides packages and has done comprehensive tests on the software in them.
54- **B**: Ceph provides packages and has done basic tests on the software in them.
55- **C**: Ceph provides packages only. No tests have been done on these releases.
56
57.. note::
58 **For Centos 7 Users**
59
60 ``Btrfs`` is no longer tested on Centos 7 in the Octopus release. We recommend using ``bluestore`` instead.
7c673cae
FG
61
62.. _CRUSH Tunables: ../../rados/operations/crush-map#tunables
63
f67539c2 64.. _Mounting CephFS using Kernel Driver: ../../cephfs/mount-using-kernel-driver#which-kernel-version