doc: Add document about fs nfs interface to create CephFS exports

Signed-off-by: Varsha Rao <varao@redhat.com>
(cherry picked from commit 48c8e8b546066085c9a32c7214c34efd15692a4d)

diff --git a/doc/cephfs/fs-nfs-exports.rst b/doc/cephfs/fs-nfs-exports.rst
new file mode 100644 (file)
index 0000000..5f2b6e5
--- /dev/null
+++ b/doc/cephfs/fs-nfs-exports.rst
@@ -0,0 +1,61 @@
+=======================
+CephFS Exports over NFS
+=======================
+
+CephFS namespaces can be exported over NFS protocol using the
+`NFS-Ganesha NFS server <https://github.com/nfs-ganesha/nfs-ganesha/wiki>`_.
+
+Requirements
+============
+
+-  Latest Ceph file system with mgr and dashboard enabled
+-  'nfs-ganesha', 'nfs-ganesha-ceph' and nfs-ganesha-rados-grace packages
+   (version 2.7.6-2 and above)
+
+Create NFS Ganesha Cluster
+==========================
+
+.. code:: bash
+
+    $ ceph fs nfs cluster create [--size=1] <cluster_id>
+
+This creates a common recovery pool for all Ganesha daemons, new user based on
+cluster_id and common ganesha config rados object.
+
+Here size denotes the number of ganesha daemons within a cluster.
+
+.. note:: This does not setup ganesha recovery database and start the daemons.
+          It needs to be done manually if not using vstart for creating
+          clusters. Please refer `ganesha-rados-grace doc
+          <https://github.com/nfs-ganesha/nfs-ganesha/blob/next/src/doc/man/ganesha-rados-grace.rst>`_
+
+Create CephFS Export
+====================
+
+.. code:: bash
+
+    $ ceph fs nfs export create <fsname> <binding> [--readonly] [--path=/path/in/cephfs] [--attach=<cluster_id>]
+
+It creates export rados objects containing the export block. Here binding is
+the pseudo root name.
+
+Configuring NFS-Ganesha to export CephFS with vstart
+====================================================
+
+.. code:: bash
+
+    $ MDS=1 MON=1 OSD=3 GANESHA=1 ../src/vstart.sh -n -d
+
+GANESHA: It denotes the number of ganesha clusters to be created.
+
+Mount
+=====
+
+After the exports are successfully created and Ganesha daemons are no longer in
+grace period. The exports can be mounted by
+
+.. code:: bash
+
+    $ mount -t nfs -o port=<ganesha-port> <ganesha-host-name>:<ganesha-pseudo-path> <mount-point>
+
+.. note:: Only NFS v4.0+ is supported.

diff --git a/doc/cephfs/index.rst b/doc/cephfs/index.rst
index 4031e10320315497cfaa044791601c539365b421..58839a3f18d40c97231e64f10b649a5dbac66b51 100644 (file)
--- a/doc/cephfs/index.rst
+++ b/doc/cephfs/index.rst
@@ -83,6 +83,7 @@ Administration
     MDS Configuration Settings <mds-config-ref>
     Manual: ceph-mds <../../man/8/ceph-mds>
     Export over NFS <nfs>
+    Export over NFS with volume nfs interface <fs-nfs-exports>
     Application best practices <app-best-practices>
     FS volume and subvolumes <fs-volumes>
     CephFS Quotas <quota>