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, the general advice is to *track* "stable"
  17   or "longterm maintenance" kernel series provided by either http://kernel.org
  18   or your distribution on the kernel client machines.
  19
  20   For RBD, if you choose to *track* long-term kernels, we currently recommend
  21   4.x-based "longterm maintenance" kernel series:
  22
  23   - 4.9.z
  24   - 4.4.z
  25
  26   These are considered pretty old, but if you must:
  27
  28   - 3.16.z
  29   - 3.10.z
  30
  31   For CephFS, see `CephFS best practices`_ for kernel version guidance.
  32
  33   Older kernel client versions may not support your `CRUSH tunables`_ profile.
  34
  35 - **B-tree File System (Btrfs)**
  36
  37   If you use the ``btrfs`` file system with Ceph, we recommend using a
  38   recent Linux kernel (3.14 or later).
  39
  40 Platforms
  41 =========
  42
  43 The charts below show how Ceph's requirements map onto various Linux
  44 platforms.  Generally speaking, there is very little dependence on
  45 specific distributions aside from the kernel and system initialization
  46 package (i.e., sysvinit, upstart, systemd).
  47
  48 Infernalis (9.2.z) and Jewel (10.2.z)
  49 -------------------------------------
  50
  51 +----------+----------+--------------------+--------------+---------+------------+
  52 | Distro   | Release  | Code Name          | Kernel       | Notes   | Testing    |
  53 +==========+==========+====================+==============+=========+============+
  54 | CentOS   | 7        | N/A                | linux-3.10.0 |         | B, I, C    |
  55 +----------+----------+--------------------+--------------+---------+------------+
  56 | Debian   | 8.0      | Jessie             | linux-3.16.0 | 1, 2    | B, I       |
  57 +----------+----------+--------------------+--------------+---------+------------+
  58 | Fedora   | 22       | N/A                | linux-3.14.0 |         | B, I       |
  59 +----------+----------+--------------------+--------------+---------+------------+
  60 | RHEL     | 7        | Maipo              | linux-3.10.0 |         | B, I       |
  61 +----------+----------+--------------------+--------------+---------+------------+
  62 | Ubuntu   | 14.04    | Trusty Tahr        | linux-3.13.0 |         | B, I, C    |
  63 +----------+----------+--------------------+--------------+---------+------------+
  64
  65 Hammer (0.94)
  66 -------------
  67
  68 +----------+----------+--------------------+--------------+---------+------------+
  69 | Distro   | Release  | Code Name          | Kernel       | Notes   | Testing    |
  70 +==========+==========+====================+==============+=========+============+
  71 | CentOS   | 6        | N/A                | linux-2.6.32 | 1, 2    |            |
  72 +----------+----------+--------------------+--------------+---------+------------+
  73 | CentOS   | 7        | N/A                | linux-3.10.0 |         | B, I, C    |
  74 +----------+----------+--------------------+--------------+---------+------------+
  75 | Debian   | 7.0      | Wheezy             | linux-3.2.0  | 1, 2    |            |
  76 +----------+----------+--------------------+--------------+---------+------------+
  77 | Ubuntu   | 12.04    | Precise Pangolin   | linux-3.2.0  | 1, 2    |            |
  78 +----------+----------+--------------------+--------------+---------+------------+
  79 | Ubuntu   | 14.04    | Trusty Tahr        | linux-3.13.0 |         | B, I, C    |
  80 +----------+----------+--------------------+--------------+---------+------------+
  81
  82 Firefly (0.80)
  83 --------------
  84
  85 +----------+----------+--------------------+--------------+---------+------------+
  86 | Distro   | Release  | Code Name          | Kernel       | Notes   | Testing    |
  87 +==========+==========+====================+==============+=========+============+
  88 | CentOS   | 6        | N/A                | linux-2.6.32 | 1, 2    | B, I       |
  89 +----------+----------+--------------------+--------------+---------+------------+
  90 | CentOS   | 7        | N/A                | linux-3.10.0 |         | B          |
  91 +----------+----------+--------------------+--------------+---------+------------+
  92 | Debian   | 7.0      | Wheezy             | linux-3.2.0  | 1, 2    | B          |
  93 +----------+----------+--------------------+--------------+---------+------------+
  94 | Fedora   | 19       | Schrödinger's Cat  | linux-3.10.0 |         | B          |
  95 +----------+----------+--------------------+--------------+---------+------------+
  96 | Fedora   | 20       | Heisenbug          | linux-3.14.0 |         | B          |
  97 +----------+----------+--------------------+--------------+---------+------------+
  98 | RHEL     | 6        | Santiago           | linux-2.6.32 | 1, 2    | B, I, C    |
  99 +----------+----------+--------------------+--------------+---------+------------+
 100 | RHEL     | 7        | Maipo              | linux-3.10.0 |         | B, I, C    |
 101 +----------+----------+--------------------+--------------+---------+------------+
 102 | Ubuntu   | 12.04    | Precise Pangolin   | linux-3.2.0  | 1, 2    | B, I, C    |
 103 +----------+----------+--------------------+--------------+---------+------------+
 104 | Ubuntu   | 14.04    | Trusty Tahr        | linux-3.13.0 |         | B, I, C    |
 105 +----------+----------+--------------------+--------------+---------+------------+
 106
 107 Notes
 108 -----
 109
 110 - **1**: The default kernel has an older version of ``btrfs`` that we do not
 111   recommend for ``ceph-osd`` storage nodes.  Upgrade to a recommended
 112   kernel or use ``XFS``.
 113
 114 - **2**: The default kernel has an old Ceph client that we do not recommend
 115   for kernel client (kernel RBD or the Ceph file system).  Upgrade to a
 116   recommended kernel.
 117
 118
 119 Testing
 120 -------
 121
 122 - **B**: We build release packages for this platform. For some of these
 123   platforms, we may also continuously build all ceph branches and exercise
 124   basic unit tests.
 125
 126 - **I**: We do basic installation and functionality tests of releases on this
 127   platform.
 128
 129 - **C**: We run a comprehensive functional, regression, and stress test suite
 130   on this platform on a continuous basis. This includes development branches,
 131   pre-release, and released code.
 132
 133 .. _CRUSH Tunables: ../../rados/operations/crush-map#tunables
 134
 135 .. _CephFS best practices: ../../cephfs/best-practices