From f7ace59e539e69d92b207383839d1dfd3cc4d4e6 Mon Sep 17 00:00:00 2001 From: "Yan, Zheng" <zyan@redhat.com> Date: Fri, 24 Aug 2018 17:30:18 +0800 Subject: [PATCH] doc: suppored features of kernel client Fixes: http://tracker.ceph.com/issues/27209 Signed-off-by: "Yan, Zheng" <zyan@redhat.com> --- doc/cephfs/index.rst | 1 + doc/cephfs/kernel-features.rst | 40 ++++++++++++++++++++++++++++++++++ 2 files changed, 41 insertions(+) create mode 100644 doc/cephfs/kernel-features.rst diff --git a/doc/cephfs/index.rst b/doc/cephfs/index.rst index 4bbc8b1306e..3fc20e40044 100644 --- a/doc/cephfs/index.rst +++ b/doc/cephfs/index.rst @@ -75,6 +75,7 @@ authentication keyring. Mount CephFS as FUSE <fuse> Mount CephFS in fstab <fstab> Use the CephFS Shell <cephfs-shell> + Supported Features of Kernel Driver <kernel-features> Manpage ceph-fuse <../../man/8/ceph-fuse> Manpage mount.ceph <../../man/8/mount.ceph> Manpage mount.fuse.ceph <../../man/8/mount.fuse.ceph> diff --git a/doc/cephfs/kernel-features.rst b/doc/cephfs/kernel-features.rst new file mode 100644 index 00000000000..edd27bcd4ab --- /dev/null +++ b/doc/cephfs/kernel-features.rst @@ -0,0 +1,40 @@ + +Supported Features of Kernel Driver +======================================== + +Inline data +----------- +Inline data was introduced by the Firefly release. Linux kernel clients >= 3.19 +can read inline data, can convert existing inline data to RADOS objects when +file data is modified. At present, Linux kernel clients do not store file data +as inline data. + +See `Experimental Features`_ for more information. + +Quotas +------ +Quota was first introduced by the hammer release. Quota disk format got renewed +by the Mimic release. Linux kernel clients >= 4.17 can support the new format +quota. At present, no Linux kernel client support the old format quota. + +See `Quotas`_ for more information. + +Multiple filesystems within a Ceph cluster +------------------------------------------ +The feature was introduced by the Jewel release. Linux kernel clients >= 4.7 +can support it. + +See `Experimental Features`_ for more information. + +Multiple active metadata servers +-------------------------------- +The feature has been supported since the Luminous release. It is recommended to +use Linux kernel clients >= 4.14 when there are multiple active MDS. + +Snapshots +--------- +The feature has been supported since the Mimic release. It is recommended to +use Linux kernel clients >= 4.17 if snapshot is used. + +.. _Experimental Features: ../experimental-features +.. _Quotas: ../quota