From: Zac Dover <zac.dover@gmail.com>
Date: Tue, 5 Apr 2022 15:48:24 +0000 (+1000)
Subject: doc/start: add testing support information
X-Git-Tag: v18.0.0~1118^2
X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=0364f3afcccc85d190237b0a74b4deeefa4738f3;p=ceph.git

doc/start: add testing support information

This PR adds information about support for testing,
and information about which distros the Ceph project
builds packages for.

This is one in a series of PRs including the following:

https://github.com/ceph/ceph/pull/45385
https://github.com/ceph/ceph/pull/45764

This PR specifically includes the information that Ernesto
Puerta collected here:
https://github.com/ceph/ceph/pull/45385#pullrequestreview-911766656

Signed-off-by: Zac Dover <zac.dover@gmail.com>
---

diff --git a/doc/start/os-recommendations.rst b/doc/start/os-recommendations.rst
index 0a843cdaabdff..64887c925c43f 100644
--- a/doc/start/os-recommendations.rst
+++ b/doc/start/os-recommendations.rst
@@ -38,55 +38,27 @@ 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
+specific distributions outside of the kernel and system initialization
 package (i.e., sysvinit, systemd).
 
-+--------------+--------+--------+---------------+----------+--------+
-| Release Name | Tag    | CentOS | Ubuntu        | OpenSUSE | Debian |
-+==============+========+========+===============+==========+========+
-| Quincy       | 17.2.z | 8      | 20.04         | 15.3     | 11     |
-+--------------+--------+--------+---------------+----------+--------+
-| Pacific      | 16.2.z | 8      | 18.04, 20.04  | 15.2     | 10, 11 |
-+--------------+--------+--------+---------------+----------+--------+
-| Octopus      | 15.2.z | 7, 8   | 18.04, 20.04  | 15.2     | 10     |
-+--------------+--------+--------+---------------+----------+--------+
-
-
-Notes
------
-
-- **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.
-
-- **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
-  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
-  platform.
-
-- **C**: We run a comprehensive functional, regression, and stress test suite
-  on this platform on a continuous basis. This includes development branches,
-  pre-release, and released code.
++--------------+--------+------------------------+--------------------------------+-------------------+-----------------+
+| Release Name | Tag    | CentOS                 | Ubuntu                         | OpenSUSE :sup:`C` | Debian :sup:`C` |
++==============+========+========================+================================+===================+=================+
+| Quincy       | 17.2.z | 8 :sup:`A`             | 20.04 :sup:`A`                 | 15.3              | 11              |
++--------------+--------+------------------------+--------------------------------+-------------------+-----------------+
+| Pacific      | 16.2.z | 8 :sup:`A`             | 18.04 :sup:`C`, 20.04 :sup:`A` | 15.2              | 10, 11          |
++--------------+--------+------------------------+--------------------------------+-------------------+-----------------+
+| Octopus      | 15.2.z | 7 :sup:`B` 8 :sup:`A`  | 18.04 :sup:`C`, 20.04 :sup:`A` | 15.2              | 10              |
++--------------+--------+------------------------+--------------------------------+-------------------+-----------------+
+
+- **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