(DOCSP-17252) Reintroduce page on adding a monitored process back to automation. (#5041) (#5044)

* (DOCSP-17252) Reintroduce page on adding a monitored process back to automation.

* (DOCSP-17252) Typo fix.

* (DOCSP-17252) Correct description of GUI label.

* (DOCSP-17252) Reorganize prerequisites section to remove unneeded headlines.

* (DOCSP-17252) Correct indentation.

* (DOCSP-17252) Formatting link.

* (DOCSP-17252) Exclude page from CM building.

* (DOCSP-17252) Put link behind OM cond block.

Author: lmkerbey-mdb

config/sphinx.yaml

@@ -243,6 +243,7 @@ saas-base:
     - /reference/legal/live-migration-atlas-licensing.txt
     - /reference/legal/live-migration-atlas-license.txt
     - /tutorial/add-message-to-interface.txt
+    - /tutorial/add-monitored-deployment-to-automation.txt
     - /tutorial/assign-snapshot-stores-to-data-center.txt
     - /tutorial/manage-ops-manager-logs.txt
     - /tutorial/configure-application-high-availability.txt

source/includes/steps-add-monitored-deployment-to-automation.yaml

@@ -4,7 +4,7 @@ inherit:
   file: steps-source-project-nav.yaml
   ref: project-nav-deployment-topology
 ---
-title: "On the line listing the process, click :guilabel:`Add New`."
+title: "On the line listing the process, click :guilabel:`Add`."
 stepnum: 2
 level: 4
 ref: add-automation-button

source/tutorial/add-monitored-deployment-to-automation.txt

@@ -0,0 +1,65 @@
+=====================================
+Add Monitored Processes to Automation
+=====================================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+Overview
+--------
+
+|mms| Automation lets you deploy, reconfigure and upgrade your MongoDB
+databases directly from the |mms| console.
+
+If |mms| is already monitoring your MongoDB processes, you can add them
+to Automation.
+
+Automation relies on the {+mdbagent+}, which you install on each
+server that hosts a process to be added to automated management. The
+{+mdbagent+}s regularly poll |mms| to determine goal configuration
+and deploy changes as needed.
+
+Considerations
+--------------
+
+Automation supports most but not all available MongoDB options. See
+:doc:`/reference/cluster-configuration-process-options` for unsupported
+MongoDB deployment options.
+
+When adding a MongoDB deployment requiring authentication, you have the
+option of importing that process's users and roles. During import,
+|mms| prompts you to resolve any conflicts that may occur between the
+imported users and roles and the managed users and roles.
+
+Automation and Updated Security Settings Upon Import
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. include:: /includes/fact-imported-users-to-automation.rst
+
+Prerequisites
+-------------
+
+- Ensure that your deployment satisfies the  
+  :doc:`deployment requirements </tutorial/provisioning-prep>`.
+
+- |mms| must be currently monitoring the MongoDB processes, and the
+  {+mdbagent+} must be running. The processes must appear on the
+  |mms| :guilabel:`Deployment` page.
+
+  .. seealso::
+
+     :doc:`/tutorial/add-existing-mongodb-processes` to enable |mms| to
+     automate and monitor your MongoDB processes if |mms| does not
+     currently do so. 
+
+.. include:: /includes/prerequisites-for-adding-existing-deployment-to-automation.rst
+
+Procedure
+---------
+
+.. include:: /includes/steps/add-monitored-deployment-to-automation.rst

source/tutorial/nav/manage-hosts.txt

@@ -19,6 +19,12 @@ Create or Import a MongoDB Deployment
 :doc:`/tutorial/add-existing-mongodb-processes`
   Add existing MongoDB deployment to |mms|.
 
+.. cond:: onprem
+
+   :doc:`/tutorial/add-monitored-deployment-to-automation`
+     Add a monitored MongoDB deployment to be managed through |mms|
+     Automation.
+
 :doc:`/tutorial/deploy-replica-set`
   Use |mms| to deploy a managed replica set.
 
@@ -54,6 +60,7 @@ Create or Import a MongoDB Deployment
       /tutorial/provisioning-prep
       /tutorial/nav/add-servers
       /tutorial/add-existing-mongodb-processes
+      /tutorial/add-monitored-deployment-to-automation
       /tutorial/deploy-replica-set
       /tutorial/deploy-sharded-cluster
       Deploy a Standalone Instance </tutorial/deploy-standalone>