(DOCSP-29089) Non-App DBs can be deployed with OM (#199) (#211)

lmkerbey-mdb · web-flow · commit d14024a30f72 · 2024-05-17T14:22:29.000-04:00
[JIRA](https://jira.mongodb.org/browse/DOCSP-29089) [Build Log](https://workerpool-boxgs.mongodbstitch.com/pages/job.html?collName=queue&jobId=66479fd4cf5bec1c296e8753) [Staging: Install Backing DBs](https://preview-mongodblmkerbeymdb.gatsbyjs.io/ops-manager/DOCSP-29089-60/tutorial/prepare-backing-mongodb-instances/#deploy-backing-databases) [Staging: Install OM](https://preview-mongodblmkerbeymdb.gatsbyjs.io/ops-manager/DOCSP-29089-60/tutorial/install-on-prem-with-rpm-packages/#install-onprem) Backport of #199
diff --git a/source/includes/next-steps-on-prem-install.rst b/source/includes/next-steps-on-prem-install.rst
@@ -2,6 +2,9 @@ After you install the |application| to your |onprem| hosts, you
 must :doc:`install {+mdbagent+}s </tutorial/nav/install-mongodb-agent>`
 on the hosts that will run your MongoDB deployments.
 
+You can :ref:`Enable Application Database Monitoring
+<enable-application-database-monitoring>`.
+
 You can install the {+mdbagent+} on hosts running existing MongoDB
 deployments or on hosts on which you will create new MongoDB
 deployments. Hosts that serve your MongoDB deployments must meet the
diff --git a/source/includes/prerequisites-on-prem-install.rst b/source/includes/prerequisites-on-prem-install.rst
@@ -24,8 +24,10 @@ Before you install |onprem|, you must:
 
    .. note::
 
-      |mms| cannot deploy its own backing databases. You must deploy
-      those databases manually.
+      You must deploy :term:`application databases <application
+      database>` manually. However, you can deploy backup databases
+      with |onprem|. For more information, see :ref:`Deploy Backing
+      Databases <deploy-om-appdb>`.
 
 4. Install and verify an Email Server. |onprem| needs an email server
    to :ref:`send alerts <create-alert-configuration>` and recover
diff --git a/source/includes/procedures/deploy-backing-dbs.rst b/source/includes/procedures/deploy-backing-dbs.rst
@@ -0,0 +1,38 @@
+.. procedure::
+   :style: normal
+
+   .. step:: Provision hosts.
+
+      Your hosts must meet the :ref:`backing-instances-prerequisites`
+      requirements.
+
+      .. important::
+
+	 Configure the MongoDB deployment for your :term:`backing
+	 databases` according to the :manual:`MongoDB Production Notes
+	 </administration/production-notes>`. If you don't, the
+	 MongoDB deployment might fail.
+
+   .. step:: Install MongoDB on each host.
+
+      Follow the steps to :manual:`Install MongoDB
+      </installation>`. If you install :product:`MongoDB Enterprise
+      <mongodb-enterprise-advanced>` for the backing database, you
+      must install the MongoDB Enterprise dependencies.
+
+   .. step:: Deploy replica sets for each backing database.
+
+      Follow the steps described in :manual:`Deploy one Replica Set
+      </tutorial/deploy-replica-set>` for each :term:`application database`.
+      After deploying your application databases, you can install |onprem|
+      using one of the following procedures:
+
+      - :ref:`Install with RPM Package <om-install-rpm>`
+      - :ref:`Install with DEB Package <om-install-deb>`
+      - :ref:`Install from Archive with Linux <om-install-archive>`
+
+      You can then perform managed :ref:`replica set deployment
+      <om-deploy-replica-set>` with |onprem| for your remaining
+      backing databases. Alternatively, you can :manual:`manually
+      deploy replica sets </tutorial/deploy-replica-set>` for each
+      backing database.
diff --git a/source/includes/steps-source-install-onprem.yaml b/source/includes/steps-source-install-onprem.yaml
@@ -139,7 +139,11 @@ level: 4
 ref: configure-backup-database-uri
 content: |
 
-  a. On each |onprem| server that you activate as a Backup Daemon, 
+  a. :ref:`Deploy your backup databases <deploy-om-appdb>`. You can
+     use |onprem| to :ref:`manage replica set deployment
+     <om-deploy-replica-set>` after you install MongoDB on each host.
+
+  #. On each |onprem| server that you activate as a Backup Daemon, 
      create the directory that will be used as the 
      :term:`head directory <head directory>`. The directory must be:
 
@@ -149,18 +153,18 @@ content: |
 
      - writable by the ``mongodb-mms`` user.
 
-  b. Configure the :doc:`Backup Storage </tutorial/nav/backup-storage>` you
+  #. Configure the :doc:`Backup Storage </tutorial/nav/backup-storage>` you
      want to use for your snapshots.
 
-  c. Open |onprem| and verify that you are logged in as the user you
+  #. Open |onprem| and verify that you are logged in as the user you
      registered when installing |onprem|. This user is the
      :ref:`global owner <global-owner-role>`.
 
-  d. Click the :guilabel:`Admin` link at the top right of the page.
+  #. Click the :guilabel:`Admin` link at the top right of the page.
 
-  e. Click the :guilabel:`Backup` tab.
+  #. Click the :guilabel:`Backup` tab.
 
-  f. Follow the prompts to configure the Backup Daemon and Backup Storage.
+  #. Follow the prompts to configure the Backup Daemon and Backup Storage.
      |onprem| walks you through configuration of the daemon and snapshot
      storage.
 
diff --git a/source/tutorial/deploy-replica-set.txt b/source/tutorial/deploy-replica-set.txt
@@ -1,3 +1,5 @@
+.. _om-deploy-replica-set:
+
 ====================
 Deploy a Replica Set
 ====================
diff --git a/source/tutorial/install-on-prem-from-archive.txt b/source/tutorial/install-on-prem-from-archive.txt
@@ -1,6 +1,8 @@
-=====================================================
-Install |onprem| from a ``tar.gz`` or ``zip`` Archive
-=====================================================
+.. _om-install-archive:
+
+======================================================
+Install |onprem| from a ``tar.gz`` or ``.zip`` Archive
+======================================================
 
 .. default-domain:: mongodb
 
diff --git a/source/tutorial/install-on-prem-with-deb-packages.txt b/source/tutorial/install-on-prem-with-deb-packages.txt
@@ -1,3 +1,5 @@
+.. _om-install-deb:
+
 =======================================
 Install |onprem| with a ``deb`` Package
 =======================================
diff --git a/source/tutorial/install-on-prem-with-rpm-packages.txt b/source/tutorial/install-on-prem-with-rpm-packages.txt
@@ -1,3 +1,5 @@
+.. _om-install-rpm:
+
 ========================================
 Install |onprem| with an ``rpm`` Package
 ========================================
diff --git a/source/tutorial/prepare-backing-mongodb-instances.txt b/source/tutorial/prepare-backing-mongodb-instances.txt
@@ -1,3 +1,5 @@
+.. _om-install-backing-dbs:
+
 ======================================================
 Install the |application| Database and Backup Database
 ======================================================
@@ -294,7 +296,7 @@ Deploy Backing Databases
 To deploy MongoDB :manual:`replica sets </reference/glossary/#std-term-replica-set>` to host the
 |onprem| :term:`backing databases`:
 
-.. include:: /includes/steps/deploy-backing-dbs.rst
+.. include:: /includes/procedures/deploy-backing-dbs.rst
 
 Next Steps
 ----------

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,5 @@`
	`1`	`+.. _om-deploy-replica-set:`
	`2`	`+`
`1`	`3`	`====================`
`2`	`4`	`Deploy a Replica Set`
`3`	`5`	`====================`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,5 @@`
	`1`	`+.. _om-install-deb:`
	`2`	`+`
`1`	`3`	`=======================================`
`2`	`4`	Install \|onprem\| with a ``deb`` Package
`3`	`5`	`=======================================`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,5 @@`
	`1`	`+.. _om-install-rpm:`
	`2`	`+`
`1`	`3`	`========================================`
`2`	`4`	Install \|onprem\| with an ``rpm`` Package
`3`	`5`	`========================================`