Merge PR ceph#42759 into master

* refs/pull/42759/head: doc/mgr/nfs: add section on updating an nfs cluster Reviewed-by: Varsha Rao <[email protected]>
jhesketh · Aug 11, 2021 · 034de1f · 034de1f
2 parents 94239d4 + 7cc4c91
commit 034de1f
Showing 1 changed file with 16 additions and 0 deletions.
diff --git a/doc/mgr/nfs.rst b/doc/mgr/nfs.rst
@@ -128,6 +128,22 @@ Delete NFS Ganesha Cluster
 
 This deletes the deployed cluster.
 
+Updating an NFS Cluster
+-----------------------
+
+In order to modify cluster parameters (like the port or placement), you need to
+use the orchestrator interface to update the NFS service spec.  The safest way to do
+that is to export the current spec, modify it, and then re-apply it.  For example,
+to modify the ``nfs.foo`` service,
+
+.. code:: bash
+
+    $ ceph orch ls --service-name nfs.foo --export > nfs.foo.yaml
+    $ vi nfs.foo.yaml
+    $ ceph orch apply -i nfs.foo.yaml
+
+For more information about the NFS service spec, see :ref:`deploy-cephadm-nfs-ganesha`.
+
 List NFS Ganesha Clusters
 -------------------------