(DOCSP-38349) Add a section to troubleshooting about manually deleting projects and deployments in OM and CM (#1705) (#1709)

Author: JuliaMongo

source/includes/setting-k8sRsConf-spec.security.tls.enabled.rst

@@ -17,7 +17,7 @@
    - Clients (|mongo| shell, drivers, |compass|, and others)
      and the MongoDB deployment
 
-   By default, :setting:`net.ssl.mode` is set to ``requireSSL``. To change the
+   By default, ``net.ssl.mode`` is set to ``requireSSL``. To change the
    |tls| mode used for client and database connections, see
    :setting:`spec.additionalMongodConfig.net.ssl.mode`.
 

source/reference/known-issues.txt

@@ -138,6 +138,8 @@ For testing only, you may also set ``persistent : false``. This
 *must not be used in production*, as data is not preserved between
 restarts.
 
+.. _remove-rsrcs-before-removing-k8s:
+
 Remove Resources before Removing |k8s|
 --------------------------------------
 
@@ -149,6 +151,13 @@ If you want to remove deployments of MongoDB on |k8s|, use the
 resource specification to delete resources first so no dead Automation
 Agents remain.
 
+To troubleshoot any issues that might occur, see:
+
+- :ref:`remove-k8s-resource`
+- :ref:`k8s-disable-feature-controls`
+- :ref:`k8s-delete-om`
+
+
 Create Separate Namespaces for |k8s-op-short| and MongoDB Resources
 -------------------------------------------------------------------
 

source/reference/troubleshooting.txt

@@ -714,6 +714,70 @@ policy through the :opsmgr:`API </reference/api/controlled-features/update-contr
    |k8s-op-short| retains any changes you made in the |onprem|
    application while features were available.
 
+.. _k8s-delete-om:
+
+Remove Resources when the |k8s-op-short| Fails
+----------------------------------------------
+
+When you delete a MongoDB custom resource through the |k8s-op-short|, the
+|k8s-op-short| handles the removal of the deployment in |cloud-short| or |onprem|.
+To learn more, see :ref:`remove-k8s-resource`.
+
+However, the removal of resources might :ref:`fail <remove-rsrcs-before-removing-k8s>`
+in |k8s|. For example, if the |k8s-op-short| fails before you delete the MongoDB
+resource, you must manually remove the deployments and delete their projects in
+|cloud-short| or |onprem|.
+
+To remove |onprem| or |cloud-short| resources manually:
+
+1. :ref:`Disable Ops Manager feature controls <k8s-disable-feature-controls>`.
+
+#. Remove a deployment from |onprem| or |cloud-short| in the project by using the UI
+   or the API.
+
+   Remove a deployment in the |onprem| or |cloud-short| UI.
+   In |onprem|, :opsmgr:`remove a deployment from Automation </tutorial/unmanage-deployment/>`
+   and :opsmgr:`remove a deployment from Monitoring </tutorial/remove-process-from-monitoring/>`.
+
+   In |cloud-short|, :cloudmgr:`remove a deployment from Automation </tutorial/unmanage-deployment/>`
+   and :cloudmgr:`remove a deployment from Monitoring </tutorial/remove-process-from-monitoring/>`.
+
+   Alternatively, remove a deployment by using the API for updating the Automation
+   configuration in |onprem| or |cloud-short| with an empty configuration using
+   the :opsmgr:`Ops Manager API </reference/api/automation-config/update-automation-config/>` request,
+   or the :cloudmgr:`Cloud Manager API </reference/api/automation-config/update-automation-config/>` request.
+
+   Run the command similar to the following |onprem| example:
+
+   .. code-block:: sh
+
+      curl --user "{USERNAME}:{APIKEY}" --digest \
+           --header "Content-Type: application/json" \
+           --include \
+           --request PUT "https://{OPSMANAGER-HOST}/api/public/v1.0/groups/{PROJECT-ID}/automationConfig" \
+           --data '{}'
+
+   .. note::
+
+      Deleting a MongoDB resource for which you enabled backup doesn't
+      delete the resource's snapshots. You must :opsmgr:`delete snapshots 
+      in Ops Manager </tutorial/delete-backup-snapshots/>`, or :cloudmgr:`delete snapshots 
+      in Cloud Manager </tutorial/delete-backup-snapshots/>`.
+
+#. Delete a project from |onprem| or |cloud-short| by using the UI or the API.
+   :opsmgr:`Delete a project in Ops Manager </tutorial/manage-project-settings/>`, or
+   :cloudmgr:`delete a project in the Cloud Manager </tutorial/manage-project-settings/>`.
+
+   Alternatively, delete a project by using the :opsmgr:`Ops Manager API </reference/api/groups/delete-one-group>` request,
+   or the :cloudmgr:`Cloud Manager API </reference/api/groups/delete-one-group>` request.
+
+   Run the command similar to the following |onprem| example:
+
+   .. code-block:: sh
+
+      curl --user "{USERNAME}:{APIKEY}" --digest \
+           --request DELETE "{OPSMANAGER-HOST}/api/public/v1.0/groups/${PROJECT-ID}"
+
 .. _k8s-debug-failed container:
 
 Debug a Failing Container