]> git.apps.os.sepia.ceph.com Git - ceph.git/commitdiff
doc/cephfs/nfs: Add rook pod restart note, export and log block example 40766/head
authorVarsha Rao <varao@redhat.com>
Mon, 18 Jan 2021 16:24:32 +0000 (21:54 +0530)
committerNathan Cutler <ncutler@suse.com>
Sat, 10 Apr 2021 20:58:08 +0000 (22:58 +0200)
Fixes: https://tracker.ceph.com/issues/48914
Signed-off-by: Varsha Rao <varao@redhat.com>
(cherry picked from commit 01db81e2bc8bae908bcd3600dc9b54fb80c2a554)

doc/cephfs/fs-nfs-exports.rst

index e655c9233a010c33b13dbd82b37c9b55fe37d9a5..797274ec336e8f81e847d864395ec79c27194e6f 100644 (file)
@@ -97,6 +97,37 @@ Set Customized NFS Ganesha Configuration
 With this the nfs cluster will use the specified config and it will have
 precedence over default config blocks.
 
+Example use cases
+
+1) Changing log level
+
+  It can be done by adding LOG block in the following way::
+
+   LOG {
+    COMPONENTS {
+        ALL = FULL_DEBUG;
+    }
+   }
+
+2) Adding custom export block
+
+  The following sample block creates a single export. This export will not be
+  managed by `ceph nfs export` interface::
+
+   EXPORT {
+     Export_Id = 100;
+     Transports = TCP;
+     Path = /;
+     Pseudo = /ceph/;
+     Protocols = 4;
+     Access_Type = RW;
+     Attr_Expiration_Time = 0;
+     Squash = None;
+     FSAL {
+       Name = CEPH;
+     }
+   }
+
 Reset NFS Ganesha Configuration
 ===============================
 
@@ -106,6 +137,9 @@ Reset NFS Ganesha Configuration
 
 This removes the user defined configuration.
 
+.. note:: With a rook deployment, ganesha pods must be explicitly restarted
+   for the new config blocks to be effective.
+
 Create CephFS Export
 ====================