Adding upstream version 18.2.2.upstream/18.2.2

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 82 insertions, 0 deletions

diff --git a/doc/start/os-recommendations.rst b/doc/start/os-recommendations.rst
new file mode 100644
index 000000000..81906569e
--- /dev/null
+++ b/doc/start/os-recommendations.rst
@@ -0,0 +1,82 @@
+====================
+ OS Recommendations
+====================
+
+Ceph Dependencies
+=================
+
+As a general rule, we recommend deploying Ceph on newer releases of Linux. 
+We also recommend deploying on releases with long-term support.
+
+Linux Kernel
+------------
+
+- **Ceph Kernel Client**
+
+  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 recommend
+  *at least* 4.19-based "longterm maintenance" kernel series.  If you can
+  use a newer "stable" or "longterm maintenance" kernel series, do it.
+
+  For CephFS, see the section about `Mounting CephFS using Kernel Driver`_
+  for kernel version guidance.
+
+  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 RBD, a kernel of version 5.3
+  or CentOS 8.2 is the minimum necessary for reasonable support for RBD image
+  features.
+
+
+Platforms
+=========
+
+The chart below shows which Linux platforms Ceph provides packages for, and
+which platforms Ceph has been tested on. 
+
+Ceph does not require a specific Linux distribution. Ceph can run on any
+distribution that includes a supported kernel and supported system startup
+framework, for example ``sysvinit`` or ``systemd``. Ceph is sometimes ported to
+non-Linux systems but these are not supported by the core Ceph effort.
+
+
++---------------+---------------+-----------------+------------------+------------------+
+|               | Reef (18.2.z) | Quincy (17.2.z) | Pacific (16.2.z) | Octopus (15.2.z) |
++===============+===============+=================+==================+==================+
+| Centos 7      |               |                 |         A        |      B           |
++---------------+---------------+-----------------+------------------+------------------+
+| Centos 8      |    A          |     A           |         A        |      A           |
++---------------+---------------+-----------------+------------------+------------------+
+| Centos 9      |    A          |                 |                  |                  |
++---------------+---------------+-----------------+------------------+------------------+
+| Debian 10     |    C          |                 |         C        |      C           |
++---------------+---------------+-----------------+------------------+------------------+
+| Debian 11     |    C          |     C           |         C        |                  |
++---------------+---------------+-----------------+------------------+------------------+
+| OpenSUSE 15.2 |    C          |                 |         C        |      C           |
++---------------+---------------+-----------------+------------------+------------------+
+| OpenSUSE 15.3 |    C          |     C           |                  |                  |
++---------------+---------------+-----------------+------------------+------------------+
+| Ubuntu 18.04  |               |                 |         C        |      C           |
++---------------+---------------+-----------------+------------------+------------------+
+| Ubuntu 20.04  |    A          |     A           |         A        |      A           |
++---------------+---------------+-----------------+------------------+------------------+
+| Ubuntu 22.04  |    A          |                 |                  |                  |
++---------------+---------------+-----------------+------------------+------------------+
+
+- **A**: Ceph provides packages and has done comprehensive tests on the software in them.
+- **B**: Ceph provides packages and has done basic tests on the software in them.
+- **C**: Ceph provides packages only. No tests have been done on these releases.
+
+.. note::
+   **For Centos 7 Users** 
+   
+   ``Btrfs`` is no longer tested on Centos 7 in the Octopus release. We recommend using ``bluestore`` instead.
+
+.. _CRUSH Tunables: ../../rados/operations/crush-map#tunables
+
+.. _Mounting CephFS using Kernel Driver: ../../cephfs/mount-using-kernel-driver#which-kernel-version