Skip to content

Commit 5ab0212

Browse files
authored
(DOCSP-29089) Non-App DBs can be deployed with OM (#199)
[JIRA](https://jira.mongodb.org/browse/DOCSP-29089) [Build Log](https://workerpool-boxgs.mongodbstitch.com/pages/job.html?collName=queue&jobId=66479aadcf5bec1c296d1aa5) [Staging: Install Backing DBs](https://preview-mongodblmkerbeymdb.gatsbyjs.io/ops-manager/DOCSP-29089/tutorial/prepare-backing-mongodb-instances/#deploy-backing-databases) [Staging: Install OM](https://preview-mongodblmkerbeymdb.gatsbyjs.io/ops-manager/DOCSP-29089/tutorial/install-on-prem-with-rpm-packages/#install-onprem) While the above link for the OM installation procedure is specific to installing from RPM, the actual installation instructions are an include file that appears in all three installation procedure pages, so the changes there apply to the other two. Same with the prerequisites.
1 parent 581ac70 commit 5ab0212

9 files changed

+66
-9
lines changed

source/includes/next-steps-on-prem-install.rst

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,9 @@ After you install the |application| to your |onprem| hosts, you
22
must :doc:`install {+mdbagent+}s </tutorial/nav/install-mongodb-agent>`
33
on the hosts that will run your MongoDB deployments.
44

5+
You can :ref:`Enable Application Database Monitoring
6+
<enable-application-database-monitoring>`.
7+
58
You can install the {+mdbagent+} on hosts running existing MongoDB
69
deployments or on hosts on which you will create new MongoDB
710
deployments. Hosts that serve your MongoDB deployments must meet the

source/includes/prerequisites-on-prem-install.rst

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,8 +24,10 @@ Before you install |onprem|, you must:
2424

2525
.. note::
2626

27-
|mms| cannot deploy its own backing databases. You must deploy
28-
those databases manually.
27+
You must deploy :term:`application databases <application
28+
database>` manually. However, you can deploy backup databases
29+
with |onprem|. For more information, see :ref:`Deploy Backing
30+
Databases <deploy-om-appdb>`.
2931

3032
4. Install and verify an Email Server. |onprem| needs an email server
3133
to :ref:`send alerts <create-alert-configuration>` and recover
Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
.. procedure::
2+
:style: normal
3+
4+
.. step:: Provision hosts.
5+
6+
Your hosts must meet the :ref:`backing-instances-prerequisites`
7+
requirements.
8+
9+
.. important::
10+
11+
Configure the MongoDB deployment for your :term:`backing
12+
databases` according to the :manual:`MongoDB Production Notes
13+
</administration/production-notes>`. If you don't, the
14+
MongoDB deployment might fail.
15+
16+
.. step:: Install MongoDB on each host.
17+
18+
Follow the steps to :manual:`Install MongoDB
19+
</installation>`. If you install :product:`MongoDB Enterprise
20+
<mongodb-enterprise-advanced>` for the backing database, you
21+
must install the MongoDB Enterprise dependencies.
22+
23+
.. step:: Deploy replica sets for each backing database.
24+
25+
Follow the steps described in :manual:`Deploy one Replica Set
26+
</tutorial/deploy-replica-set>` for each :term:`application database`.
27+
After deploying your application databases, you can install |onprem|
28+
using one of the following procedures:
29+
30+
- :ref:`Install with RPM Package <om-install-rpm>`
31+
- :ref:`Install with DEB Package <om-install-deb>`
32+
- :ref:`Install from Archive with Linux <om-install-archive>`
33+
34+
You can then perform managed :ref:`replica set deployment
35+
<om-deploy-replica-set>` with |onprem| for your remaining
36+
backing databases. Alternatively, you can :manual:`manually
37+
deploy replica sets </tutorial/deploy-replica-set>` for each
38+
backing database.

source/includes/steps-source-install-onprem.yaml

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -139,7 +139,11 @@ level: 4
139139
ref: configure-backup-database-uri
140140
content: |
141141
142-
a. On each |onprem| server that you activate as a Backup Daemon,
142+
a. :ref:`Deploy your backup databases <deploy-om-appdb>`. You can
143+
use |onprem| to :ref:`manage replica set deployment
144+
<om-deploy-replica-set>` after you install MongoDB on each host.
145+
146+
#. On each |onprem| server that you activate as a Backup Daemon,
143147
create the directory that will be used as the
144148
:term:`head directory <head directory>`. The directory must be:
145149
@@ -149,18 +153,18 @@ content: |
149153
150154
- writable by the ``mongodb-mms`` user.
151155
152-
b. Configure the :doc:`Backup Storage </tutorial/nav/backup-storage>` you
156+
#. Configure the :doc:`Backup Storage </tutorial/nav/backup-storage>` you
153157
want to use for your snapshots.
154158
155-
c. Open |onprem| and verify that you are logged in as the user you
159+
#. Open |onprem| and verify that you are logged in as the user you
156160
registered when installing |onprem|. This user is the
157161
:ref:`global owner <global-owner-role>`.
158162
159-
d. Click the :guilabel:`Admin` link at the top right of the page.
163+
#. Click the :guilabel:`Admin` link at the top right of the page.
160164
161-
e. Click the :guilabel:`Backup` tab.
165+
#. Click the :guilabel:`Backup` tab.
162166
163-
f. Follow the prompts to configure the Backup Daemon and Backup Storage.
167+
#. Follow the prompts to configure the Backup Daemon and Backup Storage.
164168
|onprem| walks you through configuration of the daemon and snapshot
165169
storage.
166170

source/tutorial/deploy-replica-set.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
.. _om-deploy-replica-set:
2+
13
====================
24
Deploy a Replica Set
35
====================

source/tutorial/install-on-prem-from-archive.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
.. _om-install-archive:
2+
13
======================================================
24
Install |onprem| from a ``tar.gz`` or ``.zip`` Archive
35
======================================================

source/tutorial/install-on-prem-with-deb-packages.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
.. _om-install-deb:
2+
13
=======================================
24
Install |onprem| with a ``deb`` Package
35
=======================================

source/tutorial/install-on-prem-with-rpm-packages.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
.. _om-install-rpm:
2+
13
========================================
24
Install |onprem| with an ``rpm`` Package
35
========================================

source/tutorial/prepare-backing-mongodb-instances.txt

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
.. _om-install-backing-dbs:
2+
13
======================================================
24
Install the |application| Database and Backup Database
35
======================================================
@@ -294,7 +296,7 @@ Deploy Backing Databases
294296
To deploy MongoDB :manual:`replica sets </reference/glossary/#std-term-replica-set>` to host the
295297
|onprem| :term:`backing databases`:
296298

297-
.. include:: /includes/steps/deploy-backing-dbs.rst
299+
.. include:: /includes/procedures/deploy-backing-dbs.rst
298300

299301
Next Steps
300302
----------

0 commit comments

Comments
 (0)