From 7cc4c91dce2a1f1bcb6a02efb231bdbda0929500 Mon Sep 17 00:00:00 2001
From: Sage Weil <sage@newdream.net>
Date: Wed, 11 Aug 2021 11:31:21 -0500
Subject: [PATCH] doc/mgr/nfs: add section on updating an nfs cluster

Signed-off-by: Sage Weil <sage@newdream.net>
---
 doc/mgr/nfs.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/doc/mgr/nfs.rst b/doc/mgr/nfs.rst
index 4b05544f60a..988e33c4d9d 100644
--- a/doc/mgr/nfs.rst
+++ b/doc/mgr/nfs.rst
@@ -126,6 +126,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
 -------------------------