ceph/doc/start/os-recommendations.rst

   1 ====================
   2  OS Recommendations
   3 ====================
   4
   5 Ceph Dependencies
   6 =================
   7
   8 As a general rule, we recommend deploying Ceph on newer releases of Linux.
   9 We also recommend deploying on releases with long-term support.
  10
  11 Linux Kernel
  12 ------------
  13
  14 - **Ceph Kernel Client**
  15
  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.
  20
  21   For RBD, if you choose to *track* long-term kernels, we currently recommend
  22   4.x-based "longterm maintenance" kernel series or later:
  23
  24   - 4.19.z
  25   - 4.14.z
  26   - 5.x
  27
  28   For CephFS, see the section about `Mounting CephFS using Kernel Driver`_
  29   for kernel version guidance.
  30
  31   Older kernel client versions may not support your `CRUSH tunables`_ profile
  32   or other newer features of the Ceph cluster, requiring the storage cluster
  33   to be configured with those features disabled.
  34
  35
  36 Platforms
  37 =========
  38
  39 The charts below show how Ceph's requirements map onto various Linux
  40 platforms.  Generally speaking, there is very little dependence on
  41 specific distributions aside from the kernel and system initialization
  42 package (i.e., sysvinit, systemd).
  43
  44 Octopus (15.2.z)
  45 -----------------
  46
  47 +----------+----------+--------------------+--------------+---------+------------+
  48 | Distro   | Release  | Code Name          | Kernel       | Notes   | Testing    |
  49 +==========+==========+====================+==============+=========+============+
  50 | CentOS   | 8        | N/A                | linux-4.18   |         | B, I, C    |
  51 +----------+----------+--------------------+--------------+---------+------------+
  52 | CentOS   | 7        | N/A                | linux-3.10.0 | 4, 5    | B, I       |
  53 +----------+----------+--------------------+--------------+---------+------------+
  54 | Debian   | 10       | Buster             | linux-4.19   |         | B          |
  55 +----------+----------+--------------------+--------------+---------+------------+
  56 | RHEL     | 8        | Ootpa              | linux-4.18   |         | B, I, C    |
  57 +----------+----------+--------------------+--------------+---------+------------+
  58 | RHEL     | 7        | Maipo              | linux-3.10.0 |         | B, I       |
  59 +----------+----------+--------------------+--------------+---------+------------+
  60 | Ubuntu   | 18.04    | Bionic Beaver      | linux-4.15   | 4       | B, I, C    |
  61 +----------+----------+--------------------+--------------+---------+------------+
  62 | openSUSE | 15.2     | Leap               | linux-5.3    | 6       |            |
  63 +----------+----------+--------------------+--------------+---------+------------+
  64 | openSUSE |          | Tumbleweed         |              |         |            |
  65 +----------+----------+--------------------+--------------+---------+------------+
  66
  67
  68 Nautilus (14.2.z)
  69 -----------------
  70
  71 +----------+----------+--------------------+--------------+---------+------------+
  72 | Distro   | Release  | Code Name          | Kernel       | Notes   | Testing    |
  73 +==========+==========+====================+==============+=========+============+
  74 | CentOS   | 7        | N/A                | linux-3.10.0 | 3       | B, I, C    |
  75 +----------+----------+--------------------+--------------+---------+------------+
  76 | Debian   | 8.0      | Jessie             | linux-3.16.0 | 1, 2    | B, I       |
  77 +----------+----------+--------------------+--------------+---------+------------+
  78 | Debian   | 9.0      | Stretch            | linux-4.9    | 1, 2    | B, I       |
  79 +----------+----------+--------------------+--------------+---------+------------+
  80 | RHEL     | 7        | Maipo              | linux-3.10.0 |         | B, I       |
  81 +----------+----------+--------------------+--------------+---------+------------+
  82 | Ubuntu   | 14.04    | Trusty Tahr        | linux-3.13.0 |         | B, I, C    |
  83 +----------+----------+--------------------+--------------+---------+------------+
  84 | Ubuntu   | 16.04    | Xenial Xerus       | linux-4.4.0  | 3       | B, I, C    |
  85 +----------+----------+--------------------+--------------+---------+------------+
  86 | Ubuntu   | 18.04    | Bionic Beaver      | linux-4.15   | 3       | B, I, C    |
  87 +----------+----------+--------------------+--------------+---------+------------+
  88 | openSUSE | 15.1     | Leap               | linux-4.12   | 6       |            |
  89 +----------+----------+--------------------+--------------+---------+------------+
  90
  91 Luminous (12.2.z)
  92 -----------------
  93
  94 +----------+----------+--------------------+--------------+---------+------------+
  95 | Distro   | Release  | Code Name          | Kernel       | Notes   | Testing    |
  96 +==========+==========+====================+==============+=========+============+
  97 | CentOS   | 7        | N/A                | linux-3.10.0 | 3       | B, I, C    |
  98 +----------+----------+--------------------+--------------+---------+------------+
  99 | Debian   | 8.0      | Jessie             | linux-3.16.0 | 1, 2    | B, I       |
 100 +----------+----------+--------------------+--------------+---------+------------+
 101 | Debian   | 9.0      | Stretch            | linux-4.9    | 1, 2    | B, I       |
 102 +----------+----------+--------------------+--------------+---------+------------+
 103 | Fedora   | 22       | N/A                | linux-3.14.0 |         | B, I       |
 104 +----------+----------+--------------------+--------------+---------+------------+
 105 | RHEL     | 7        | Maipo              | linux-3.10.0 |         | B, I       |
 106 +----------+----------+--------------------+--------------+---------+------------+
 107 | Ubuntu   | 14.04    | Trusty Tahr        | linux-3.13.0 |         | B, I, C    |
 108 +----------+----------+--------------------+--------------+---------+------------+
 109 | Ubuntu   | 16.04    | Xenial Xerus       | linux-4.4.0  | 3       | B, I, C    |
 110 +----------+----------+--------------------+--------------+---------+------------+
 111
 112 Notes
 113 -----
 114
 115 - **1**: The default kernel has an older version of ``Btrfs`` that we do not
 116   recommend for ``ceph-osd`` storage nodes.  We recommend using ``BlueStore``
 117   starting with Luminous, and ``XFS`` for previous releases with ``Filestore``.
 118
 119 - **2**: The default kernel has an old Ceph client that we do not recommend
 120   for kernel client (kernel RBD or the Ceph file system).  Upgrade to a
 121   recommended kernel.
 122
 123 - **3**: The default kernel regularly fails in QA when the ``Btrfs``
 124   file system is used.  We recommend using ``BlueStore`` starting from
 125   Luminous, and ``XFS`` for previous releases with ``Filestore``.
 126
 127 - **4**: ``btrfs`` is no longer tested on this release. We recommend
 128   using ``bluestore``.
 129
 130 - **5**: Some additional features related to dashboard are not available.
 131
 132 - **6**: Packages are built regularly, but not distributed by upstream Ceph.
 133
 134 Testing
 135 -------
 136
 137 - **B**: We build release packages for this platform. For some of these
 138   platforms, we may also continuously build all Ceph branches and perform
 139   basic unit tests.
 140
 141 - **I**: We do basic installation and functionality tests of releases on this
 142   platform.
 143
 144 - **C**: We run a comprehensive functional, regression, and stress test suite
 145   on this platform on a continuous basis. This includes development branches,
 146   pre-release, and released code.
 147
 148 .. _CRUSH Tunables: ../../rados/operations/crush-map#tunables
 149
 150 .. _Mounting CephFS using Kernel Driver: ../../cephfs/mount-using-kernel-driver#which-kernel-version