]> git.apps.os.sepia.ceph.com Git - ceph.git/commitdiff
doc/cephfs/fs-nfs-exports: document new export apply capabilities
authorSage Weil <sage@newdream.net>
Fri, 9 Jul 2021 15:32:45 +0000 (11:32 -0400)
committerSage Weil <sage@newdream.net>
Wed, 14 Jul 2021 20:20:11 +0000 (16:20 -0400)
- import list
- import ganesha conf

Signed-off-by: Sage Weil <sage@newdream.net>
doc/mgr/nfs.rst

index a6ec25547ed5183549e7ae3d9b216442b53aa94d..1aa8706f2760fede6c5b2e2d910ef7c8c1ff2cdf 100644 (file)
@@ -342,6 +342,9 @@ For example,::
      "clients": []
    }
 
+The imported JSON can be a single dict describing a single export, or a JSON list
+containing multiple export dicts.
+
 The exported JSON can be modified and then reapplied.  Below, *pseudo*
 and *access_type* are modified.  When modifying an export, the
 provided JSON should fully describe the new state of the export (just
@@ -351,7 +354,7 @@ previous state of the export where possible.
 
 ::
 
-   $ ceph nfs export apply -i update_cephfs_export.json
+   $ ceph nfs export apply mynfs -i update_cephfs_export.json
    $ cat update_cephfs_export.json
    {
      "export_id": 1,
@@ -376,6 +379,27 @@ previous state of the export where possible.
      "clients": []
    }
 
+An export can also be created or updated by injecting a Ganesha NFS EXPORT config
+fragment.  For example,::
+
+   $ ceph nfs export apply mynfs -i update_cephfs_export.conf
+   $ cat update_cephfs_export.conf
+   EXPORT {
+       FSAL {
+           name = "CEPH";
+           filesystem = "a";
+       }
+       export_id = 1;
+       path = "/";
+       pseudo = "/a";
+       access_type = "RW";
+       squash = "none";
+       attr_expiration_time = 0;
+       security_label = true;
+       protocols = 4;
+       transports = "TCP";
+   }
+
 
 Mount
 =====