From 3adb70a24d62da06f702fded0f4e2f8481afbd4f Mon Sep 17 00:00:00 2001 From: Ramana Raja Date: Sun, 10 Apr 2022 14:21:24 -0400 Subject: [PATCH] doc/mgr/nfs: Add commands to check the statuses .. of NFS and ingress services after creating/deleting a NFS cluster. The `nfs cluster info` command is not sufficient to show that the NFS cluster is created/deleted as expected. Signed-off-by: Ramana Raja --- doc/mgr/nfs.rst | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/doc/mgr/nfs.rst b/doc/mgr/nfs.rst index 777e2ee8173..a30bd2db133 100644 --- a/doc/mgr/nfs.rst +++ b/doc/mgr/nfs.rst @@ -76,6 +76,17 @@ service. For more details, refer :ref:`orchestrator-cli-placement-spec` but keep in mind that specifying the placement via a YAML file is not supported. +Deployment of NFS daemons and the ingress service is asynchronous: the +command may return before the services have completely started. You may +wish to check that these services do successfully start and stay running. +When using cephadm orchestration, these commands check service status: + +.. code:: bash + + $ ceph orch ls --service_name=nfs. + $ ceph orch ls --service_name=ingress.nfs. + + Ingress ------- @@ -128,6 +139,18 @@ Delete NFS Ganesha Cluster This deletes the deployed cluster. + +Removal of NFS daemons and the ingress service is asynchronous: the +command may return before the services have been completely deleted. You may +wish to check that these services are no longer reported. When using cephadm +orchestration, these commands check service status: + +.. code:: bash + + $ ceph orch ls --service_name=nfs. + $ ceph orch ls --service_name=ingress.nfs. + + Updating an NFS Cluster ----------------------- -- 2.39.5