Skip to content

Commit 796549e

Browse files
authored
(DOCSP-20729) Added additional prerequisites, about adding a deployment for Monitoring, to push live migration to Atlas (#5155) (#5157)
* (DOCSP-20729) Added additional prerequisites about adding for monitoring, to live migration to Atlas * Apply copy review * Tech review from Joanna
1 parent 13738a2 commit 796549e

File tree

1 file changed

+48
-23
lines changed

1 file changed

+48
-23
lines changed

source/tutorial/migrate-to-atlas.txt

Lines changed: 48 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,9 @@ Overview
2424
To live migrate data from the |mms|-monitored deployments to
2525
clusters in |service-short|, you:
2626

27-
1. Prepare a cluster in |service|.
27+
1. Add your deployment to |mms| if you haven't already done so.
28+
#. Add credentials to Monitoring.
29+
#. Prepare a cluster in |service|.
2830
#. Provision a migration host in |mms| and connect |mms| to |service-short|.
2931
#. Start the live migration process in |service-short|.
3032

@@ -40,13 +42,58 @@ Restrictions
4042

4143
.. include:: /includes/migrate-to-atlas-restrictions.rst
4244

45+
Supported Platforms
46+
-------------------
47+
48+
The list of supported platforms depends on which type of live migration
49+
you are using:
50+
51+
- For live migrations of MongoDB 6.0.5+ clusters monitored by |cloud-short| to |service-short|,
52+
see :mongosync:`mongosync platforms </current/installation>` to review
53+
the list of supported platforms for the migration host.
54+
55+
- For live migrations of source clusters running MongoDB versions 4.4.x
56+
or 5.0.x (FCV), the live migration to |service-short|
57+
:ref:`is supported <live-migration-host-supported-platforms>` for all
58+
platforms on which you can provision a migration host.
59+
60+
Provisioning of the migration host is not supported on Windows or macOS.
61+
You can still live migrate your data from a Windows-based deployment
62+
to |service-short| if you provision your migration host on one of its
63+
supported platforms. You can't live migrate your data from a macOS-based
64+
deployment to |service-short|.
65+
4366
.. _lm-prereqs:
4467

4568
Prerequisites
4669
-------------
4770

4871
Before you begin the live migration process, follow these prerequisites.
4972

73+
Add Your Deployment to |mms|
74+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
75+
76+
Follow the procedure to :ref:`add-existing-mongodb-hosts`.
77+
78+
Add Credentials for Monitoring
79+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
80+
81+
When you add your deployment to |mms|, you need to add credentials for Monitoring only, not for Automation or Backup. Adding your deployment for
82+
Monitoring imports your deployment's metadata into |mms| to help with the live migration process. It doesn't import your deployment's actual data. To
83+
learn more about authentication credentials, see :ref:`add-existing-mongodb-processes-auth`.
84+
85+
To add credentials for :ref:`Monitoring <monitoring-functional-overview>`:
86+
87+
1. Create the credentials to the deployment. See
88+
:ref:`Required Access for Monitoring <mms-req-cred-monitoring>`.
89+
#. Add the credentials based on your project's authentication mechanism.
90+
See :ref:`add-auth-credentials-imported-deployment`.
91+
92+
.. note::
93+
94+
If you're adding your MongoDB deployment to monitoring so that you can live migrate it to |service-short|, you don't need to add credentials for
95+
Automation and Backup. To learn more, see :ref:`add-existing-mongodb-processes-auth`.
96+
5097
.. cond:: onprem
5198

5299
Request an External IP Address
@@ -174,25 +221,3 @@ Perform these tasks in |service-short|:
174221

175222
- **Stage 3: Start the Migration**. In |service-short|, follow the
176223
steps in the wizard to start the live migration process.
177-
178-
Supported Platforms
179-
~~~~~~~~~~~~~~~~~~~
180-
181-
The list of supported platforms depends on which type of live migration
182-
you are using:
183-
184-
- For live migrations of MongoDB 6.0.5+ clusters monitored by |cloud-short| to |service-short|,
185-
see :mongosync:`mongosync platforms </current/installation>` to review
186-
the list of supported platforms for the migration host.
187-
188-
- For live migrations of source clusters running MongoDB versions 4.4.x
189-
or 5.0.x (FCV), the live migration to |service-short|
190-
:ref:`is supported <live-migration-host-supported-platforms>` for all
191-
platforms on which you can provision a migration host.
192-
193-
Provisioning of the migration host is not supported on Windows or macOS.
194-
You can still live migrate your data from a Windows-based deployment
195-
to |service-short| if you provision your migration host on one of its
196-
supported platforms. You can't live migrate your data from a macOS-based
197-
deployment to |service-short|.
198-

0 commit comments

Comments
 (0)