import quincy beta 17.1.0

[ceph.git] / ceph / doc / start / os-recommendations.rst

diff --git a/ceph/doc/start/os-recommendations.rst b/ceph/doc/start/os-recommendations.rst
index 32d7fcf53ebfd668eab3a608e994ad7b36100a66..ee5c6442d642145f5ad9a796d10d6aa9db14c80a 100644 (file)
--- a/ceph/doc/start/os-recommendations.rst
+++ b/ceph/doc/start/os-recommendations.rst
@@ -13,29 +13,25 @@ Linux Kernel
 
 - **Ceph Kernel Client**
 
 
 - **Ceph Kernel Client**
 

-  If you are using the kernel client, the general advice is to *track* "stable"
-  or "longterm maintenance" kernel series provided by either http://kernel.org
-  or your distribution on the kernel client machines.
+  If you are using the kernel client to map RBD block devices or mount
+  CephFS, the general advice is to use a "stable" or "longterm
+  maintenance" kernel series provided by either http://kernel.org or
+  your Linux distribution on any client hosts.

 
   For RBD, if you choose to *track* long-term kernels, we currently recommend
 
   For RBD, if you choose to *track* long-term kernels, we currently recommend

-  4.x-based "longterm maintenance" kernel series:
+  4.x-based "longterm maintenance" kernel series or later:

 
 

-  - 4.9.z
-  - 4.4.z
+  - 4.19.z
+  - 4.14.z
+  - 5.x

 
 

-  These are considered pretty old, but if you must:
+  For CephFS, see the section about `Mounting CephFS using Kernel Driver`_
+  for kernel version guidance.

 
 

-  - 3.16.z
-  - 3.10.z
+  Older kernel client versions may not support your `CRUSH tunables`_ profile
+  or other newer features of the Ceph cluster, requiring the storage cluster
+  to be configured with those features disabled.

 
 

-  For CephFS, see `CephFS best practices`_ for kernel version guidance.
-
-  Older kernel client versions may not support your `CRUSH tunables`_ profile.
-
-- **B-tree File System (Btrfs)**
-
-  If you use the ``btrfs`` file system with Ceph, we recommend using a
-  recent Linux kernel (3.14 or later).

 
 Platforms
 =========
 
 Platforms
 =========


@@ -43,84 +39,103 @@ Platforms
 The charts below show how Ceph's requirements map onto various Linux
 platforms.  Generally speaking, there is very little dependence on
 specific distributions aside from the kernel and system initialization
 The charts below show how Ceph's requirements map onto various Linux
 platforms.  Generally speaking, there is very little dependence on
 specific distributions aside from the kernel and system initialization

-package (i.e., sysvinit, upstart, systemd).
+package (i.e., sysvinit, systemd).

 
 

-Infernalis (9.2.z) and Jewel (10.2.z)
--------------------------------------
+Octopus (15.2.z)
+-----------------

 
 +----------+----------+--------------------+--------------+---------+------------+
 
 +----------+----------+--------------------+--------------+---------+------------+

-| Distro   | Release  | Code Name          | Kernel       | Notes   | Testing    | 
+| Distro   | Release  | Code Name          | Kernel       | Notes   | Testing    |

 +==========+==========+====================+==============+=========+============+
 +==========+==========+====================+==============+=========+============+

-| CentOS   | 7        | N/A                | linux-3.10.0 |         | B, I, C    |
+| CentOS   | 8        | N/A                | linux-4.18   |         | B, I, C    |

 +----------+----------+--------------------+--------------+---------+------------+
 +----------+----------+--------------------+--------------+---------+------------+

-| Debian   | 8.0      | Jessie             | linux-3.16.0 | 1, 2    | B, I       |
+| CentOS   | 7        | N/A                | linux-3.10.0 | 4, 5    | B, I       |

 +----------+----------+--------------------+--------------+---------+------------+
 +----------+----------+--------------------+--------------+---------+------------+

-| Fedora   | 22       | N/A                | linux-3.14.0 |         | B, I       |
+| Debian   | 10       | Buster             | linux-4.19   |         | B          |
++----------+----------+--------------------+--------------+---------+------------+
+| RHEL     | 8        | Ootpa              | linux-4.18   |         | B, I, C    |

 +----------+----------+--------------------+--------------+---------+------------+
 | RHEL     | 7        | Maipo              | linux-3.10.0 |         | B, I       |
 +----------+----------+--------------------+--------------+---------+------------+
 +----------+----------+--------------------+--------------+---------+------------+
 | RHEL     | 7        | Maipo              | linux-3.10.0 |         | B, I       |
 +----------+----------+--------------------+--------------+---------+------------+

-| Ubuntu   | 14.04    | Trusty Tahr        | linux-3.13.0 |         | B, I, C    |
+| Ubuntu   | 18.04    | Bionic Beaver      | linux-4.15   | 4       | B, I, C    |

 +----------+----------+--------------------+--------------+---------+------------+
 +----------+----------+--------------------+--------------+---------+------------+

+| openSUSE | 15.2     | Leap               | linux-5.3    | 6       |            |
++----------+----------+--------------------+--------------+---------+------------+
+| openSUSE |          | Tumbleweed         |              |         |            |
++----------+----------+--------------------+--------------+---------+------------+
+

 
 

-Hammer (0.94)
--------------
+Nautilus (14.2.z)
+-----------------

 
 +----------+----------+--------------------+--------------+---------+------------+
 
 +----------+----------+--------------------+--------------+---------+------------+

-| Distro   | Release  | Code Name          | Kernel       | Notes   | Testing    | 
+| Distro   | Release  | Code Name          | Kernel       | Notes   | Testing    |

 +==========+==========+====================+==============+=========+============+
 +==========+==========+====================+==============+=========+============+

-| CentOS   | 6        | N/A                | linux-2.6.32 | 1, 2    |            |
+| CentOS   | 7        | N/A                | linux-3.10.0 | 3       | B, I, C    |

 +----------+----------+--------------------+--------------+---------+------------+
 +----------+----------+--------------------+--------------+---------+------------+

-| CentOS   | 7        | N/A                | linux-3.10.0 |         | B, I, C    |
+| Debian   | 8.0      | Jessie             | linux-3.16.0 | 1, 2    | B, I       |

 +----------+----------+--------------------+--------------+---------+------------+
 +----------+----------+--------------------+--------------+---------+------------+

-| Debian   | 7.0      | Wheezy             | linux-3.2.0  | 1, 2    |            |
+| Debian   | 9.0      | Stretch            | linux-4.9    | 1, 2    | B, I       |

 +----------+----------+--------------------+--------------+---------+------------+
 +----------+----------+--------------------+--------------+---------+------------+

-| Ubuntu   | 12.04    | Precise Pangolin   | linux-3.2.0  | 1, 2    |            |
+| RHEL     | 7        | Maipo              | linux-3.10.0 |         | B, I       |

 +----------+----------+--------------------+--------------+---------+------------+
 | Ubuntu   | 14.04    | Trusty Tahr        | linux-3.13.0 |         | B, I, C    |
 +----------+----------+--------------------+--------------+---------+------------+
 +----------+----------+--------------------+--------------+---------+------------+
 | Ubuntu   | 14.04    | Trusty Tahr        | linux-3.13.0 |         | B, I, C    |
 +----------+----------+--------------------+--------------+---------+------------+

-
-Firefly (0.80)
---------------
-
+| Ubuntu   | 16.04    | Xenial Xerus       | linux-4.4.0  | 3       | B, I, C    |

 +----------+----------+--------------------+--------------+---------+------------+
 +----------+----------+--------------------+--------------+---------+------------+

-| Distro   | Release  | Code Name          | Kernel       | Notes   | Testing    | 
-+==========+==========+====================+==============+=========+============+
-| CentOS   | 6        | N/A                | linux-2.6.32 | 1, 2    | B, I       |
+| Ubuntu   | 18.04    | Bionic Beaver      | linux-4.15   | 3       | B, I, C    |

 +----------+----------+--------------------+--------------+---------+------------+
 +----------+----------+--------------------+--------------+---------+------------+

-| CentOS   | 7        | N/A                | linux-3.10.0 |         | B          |
+| openSUSE | 15.1     | Leap               | linux-4.12   | 6       |            |

 +----------+----------+--------------------+--------------+---------+------------+
 +----------+----------+--------------------+--------------+---------+------------+

-| Debian   | 7.0      | Wheezy             | linux-3.2.0  | 1, 2    | B          |
+
+Luminous (12.2.z)
+-----------------
+

 +----------+----------+--------------------+--------------+---------+------------+
 +----------+----------+--------------------+--------------+---------+------------+

-| Fedora   | 19       | Schrödinger's Cat  | linux-3.10.0 |         | B          |
+| Distro   | Release  | Code Name          | Kernel       | Notes   | Testing    |
++==========+==========+====================+==============+=========+============+
+| CentOS   | 7        | N/A                | linux-3.10.0 | 3       | B, I, C    |

 +----------+----------+--------------------+--------------+---------+------------+
 +----------+----------+--------------------+--------------+---------+------------+

-| Fedora   | 20       | Heisenbug          | linux-3.14.0 |         | B          |
+| Debian   | 8.0      | Jessie             | linux-3.16.0 | 1, 2    | B, I       |

 +----------+----------+--------------------+--------------+---------+------------+
 +----------+----------+--------------------+--------------+---------+------------+

-| RHEL     | 6        | Santiago           | linux-2.6.32 | 1, 2    | B, I, C    |
+| Debian   | 9.0      | Stretch            | linux-4.9    | 1, 2    | B, I       |

 +----------+----------+--------------------+--------------+---------+------------+
 +----------+----------+--------------------+--------------+---------+------------+

-| RHEL     | 7        | Maipo              | linux-3.10.0 |         | B, I, C    |
+| Fedora   | 22       | N/A                | linux-3.14.0 |         | B, I       |

 +----------+----------+--------------------+--------------+---------+------------+
 +----------+----------+--------------------+--------------+---------+------------+

-| Ubuntu   | 12.04    | Precise Pangolin   | linux-3.2.0  | 1, 2    | B, I, C    |
+| RHEL     | 7        | Maipo              | linux-3.10.0 |         | B, I       |

 +----------+----------+--------------------+--------------+---------+------------+
 | Ubuntu   | 14.04    | Trusty Tahr        | linux-3.13.0 |         | B, I, C    |
 +----------+----------+--------------------+--------------+---------+------------+
 +----------+----------+--------------------+--------------+---------+------------+
 | Ubuntu   | 14.04    | Trusty Tahr        | linux-3.13.0 |         | B, I, C    |
 +----------+----------+--------------------+--------------+---------+------------+

+| Ubuntu   | 16.04    | Xenial Xerus       | linux-4.4.0  | 3       | B, I, C    |
++----------+----------+--------------------+--------------+---------+------------+

 
 Notes
 -----
 
 
 Notes
 -----
 

-- **1**: The default kernel has an older version of ``btrfs`` that we do not
-  recommend for ``ceph-osd`` storage nodes.  Upgrade to a recommended
-  kernel or use ``XFS``.
+- **1**: The default kernel has an older version of ``Btrfs`` that we do not
+  recommend for ``ceph-osd`` storage nodes.  We recommend using ``BlueStore``
+  starting with Luminous, and ``XFS`` for previous releases with ``Filestore``.

 
 - **2**: The default kernel has an old Ceph client that we do not recommend
   for kernel client (kernel RBD or the Ceph file system).  Upgrade to a
   recommended kernel.
 
 
 - **2**: The default kernel has an old Ceph client that we do not recommend
   for kernel client (kernel RBD or the Ceph file system).  Upgrade to a
   recommended kernel.
 

+- **3**: The default kernel regularly fails in QA when the ``Btrfs``
+  file system is used.  We recommend using ``BlueStore`` starting from
+  Luminous, and ``XFS`` for previous releases with ``Filestore``.
+
+- **4**: ``btrfs`` is no longer tested on this release. We recommend
+  using ``bluestore``.
+
+- **5**: Some additional features related to dashboard are not available.
+
+- **6**: Packages are built regularly, but not distributed by upstream Ceph.

 
 Testing
 -------
 
 - **B**: We build release packages for this platform. For some of these
 
 Testing
 -------
 
 - **B**: We build release packages for this platform. For some of these

-  platforms, we may also continuously build all ceph branches and exercise
+  platforms, we may also continuously build all Ceph branches and perform

   basic unit tests.
 
 - **I**: We do basic installation and functionality tests of releases on this
   basic unit tests.
 
 - **I**: We do basic installation and functionality tests of releases on this


@@ -132,4 +147,4 @@ Testing
 
 .. _CRUSH Tunables: ../../rados/operations/crush-map#tunables
 
 
 .. _CRUSH Tunables: ../../rados/operations/crush-map#tunables
 

-.. _CephFS best practices: ../../cephfs/best-practices
+.. _Mounting CephFS using Kernel Driver: ../../cephfs/mount-using-kernel-driver#which-kernel-version