Merge pull request #13369 from idryomov/wip-doc-kernel-vers

doc: kernel client os-recommendations update

Reviewed-by: Jason Dillaman <dillaman@redhat.com>

doc/start/os-recommendations.rst

@@ -13,19 +13,24 @@ Linux Kernel
 
 - **Ceph Kernel Client**
 
-  We currently recommend:
+  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.
 
-  - 4.1.4 or later
-  - 3.16.3 or later (rbd deadlock regression in 3.16.[0-2])
-  - *NOT* 3.15.* (rbd deadlock regression)
-  - 3.14.*
+  For RBD, if you choose to *track* long-term kernels, we currently recommend
+  4.x-based "longterm maintenance" kernel series:
+
+  - 4.9.z
+  - 4.4.z
 
   These are considered pretty old, but if you must:
 
-  - 3.10.*
+  - 3.16.z
+  - 3.10.z
+
+  For CephFS, see `CephFS best practices`_ for kernel version guidance.
 
-  Firefly (CRUSH_TUNABLES3) tunables are supported starting with 3.15.
-  See `CRUSH Tunables`_ for more details.
+  Older kernel client versions may not support your `CRUSH tunables`_ profile.
 
 - **B-tree File System (Btrfs)**
 
@@ -126,3 +131,5 @@ Testing
   pre-release, and released code.
 
 .. _CRUSH Tunables: ../../rados/operations/crush-map#tunables
+
+.. _CephFS best practices: ../../cephfs/best-practices