Skip to content

Commit 595d0ea

Browse files
JuliaMongoJuliaMongo
authored
(DOCSP-29921) Push live migration backed by c2c: changes on the Cloud Manager side (#5106) (#5140)
* (DOCSP-29921) Push live migration backed by c2c, changes on the cloud manager side * Added info, added copy review comments, ready for a tech review * Edits, ready for a tech review * Periodic commit, tech review, to be continued * Tech review completed, ready for a second round of review by Pia * Tech review, second round * Tech review from Pia, after the meeting. Adjusted the deprecation note to shorten it and only indicate deprecation of OM support for push LM, also revamped the top-most migration topic in CM and OM docs to account for c2c-based LM options, organized that content similar to Atlas, to be version-centric until further revisions when c2c starts supporting all needed versions. Ready for a final review I hope. * Fix typo and move two more options into the 6.0.5 section, per comments from Pi * Final copy review, ready for merge * Fix the font for the deprecation note
1 parent 26be4f4 commit 595d0ea

10 files changed

+208
-166
lines changed

‎conf.py

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -110,6 +110,7 @@
110110
'snyk-vuln' : ('https://snyk.io/vuln/%s',''),
111111
'db-tools' : ('https://www.mongodb.com/docs/database-tools%s?tck=docs',''),
112112
'mdb-shell' : ('https://www.mongodb.com/docs/mongodb-shell%s',''),
113+
'mongosync' : ('https://www.mongodb.com/docs/cluster-to-cluster-sync%s',''),
113114
'mdb-sup' : ('https://support.mongodb.com%s?tck=docs',''),
114115
'mdb-feedback' : ('https://feedback.mongodb.com%s?tck=docs',''),
115116
'mdbu' : ('https://university.mongodb.com%s?tck=docs',''),
@@ -121,6 +122,7 @@
121122
'gcpc' : ('https://cloud.google.com/compute/docs%s',''),
122123
'msa' : ('https://docs.microsoft.com/en-us/azure%s',''),
123124
'prom-docs' : ('https://prometheus.io/docs%s','')
125+
124126
}
125127

126128
source_constants = {
@@ -168,7 +170,9 @@
168170
'onprem': 'Ops Manager',
169171
'fcv-current' : '4.4',
170172
'fcv-previous' : '4.2',
171-
'mongosh' : ':binary:`~bin.mongosh`'
173+
'mongosh' : ':binary:`~bin.mongosh`',
174+
'mongos' : ':binary:`~bin.mongos`'
175+
172176
}
173177

174178
languages = [

‎config/sphinx.yaml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -340,4 +340,6 @@ onprem-base:
340340
- /tutorial/restore-deployment-to-atlas.txt
341341
- /tutorial/delete-user-account.txt
342342
- /tutorial/change-backup-region.txt
343+
343344
...
345+

‎source/includes/note-push-pull-migration-deprecation-for-om.rst

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
2+
.. only:: onprem
3+
4+
.. admonition:: Live Migration (push) Deprecated for Source Deployments Managed or Monitored by Ops Manager
5+
:class: important
6+
7+
Live migration (push) is deprecated for source deployments managed or monitored by |onprem|.
8+
You can only use live migration (push) for deployments that you monitor in |cloud-short|, not in |onprem|.
9+
Live migration (push) for source deployments monitored by |cloud-short| also supports MongoDB 6.0+.
10+
To learn more, see :atlas:`Live Migrate Your MongoDB 6.0.5 or Later Cluster Monitored by Cloud Manager to Atlas </import/c2c-push-live-migration/>`.
11+
12+
.. only:: cloud
13+
14+
.. admonition:: Live Migration (push) Deprecated for Source Deployments Managed or Monitored by Ops Manager
15+
:class: important
16+
17+
Live migration (push) is deprecated for source deployments managed or monitored by |onprem|.
18+
You can only use live migration (push) for deployments that you monitor in |cloud-short|, not in |onprem|.
19+
Live migration (push) for source deployments monitored by |cloud-short| also supports MongoDB 6.0+.
20+
To learn more, see :atlas:`Live Migrate Your MongoDB 6.0.5 or Later Cluster Monitored by Cloud Manager to Atlas
21+
</import/c2c-push-live-migration/>`.

‎source/includes/steps-migrate-community-to-atlas.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ content: |
3535
.. note::
3636
3737
If you're adding your MongoDB deployment
38-
to |cloud-short| or |onprem| so that you can live migrate it
38+
to monitoring so that you can live migrate it
3939
to |service-short|, you don't need to add credentials for
4040
Automation and Backup.
4141
To learn more, see :ref:`add-existing-mongodb-processes-auth`.

‎source/migration.txt

Lines changed: 75 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -10,11 +10,46 @@ Migrate Deployments
1010
:depth: 1
1111
:class: singlecol
1212

13-
To move your applications to the cloud, you can migrate data from your
14-
existing MongoDB deployments into
15-
`MongoDB Atlas <https://docs.atlas.mongodb.com/>`_. The following table
16-
helps you choose between different tools for migrating common deployment
17-
configurations into |service|.
13+
.. include:: /includes/note-push-pull-migration-deprecation-for-om.rst
14+
15+
.. _c2c-based-live-migration-choices:
16+
17+
MongoDB 6.0.5 and Later: Live Migrate to Atlas
18+
----------------------------------------------
19+
20+
If both the source and destination clusters are running MongoDB 6.0.5 or
21+
later, you can migrate your data from a source cluster into a destination
22+
MongoDB cluster in |service-short| using one of the following types of
23+
guided live migration in the |service| UI:
24+
25+
- Live migration (push). For instructions, see :atlas:`Live Migrate Your MongoDB 6.0.5+ Cluster Monitored by Cloud Manager to Atlas <c2c-push-live-migration>`.
26+
- Live migration (pull). For instructions, see :atlas:`Live Migrate (Pull) a MongoDB 6.0.5+ Cluster into Atlas <c2c-pull-live-migration>`.
27+
28+
The choice between push and pull live migrations depends on whether the
29+
network for your deployment allows flexibility in ingress rules and allows
30+
access through the firewall.
31+
32+
In addition, you can use these migration methods for MongoDB 6.0.5 and later
33+
deployments:
34+
35+
- If your data is in a MongoDB deployment and you don't have access to the :term:`oplog`,
36+
You can use :binary:`mongorestore <bin.mongorestore>` to run a self-managed migration.
37+
To learn more, see :atlas:`Seed with mongorestore </import/mongorestore/>`.
38+
39+
.. cond:: cloud
40+
41+
- If your data is in |mms| and you have a :term:`snapshot`, you can
42+
:ref:`restore a backup of a deployment to an Atlas deployment <restore-deployment-to-atlas>`.
43+
44+
45+
.. _mongomirror-based-live-migration-choices:
46+
47+
Earlier MongoDB Versions: Live Migrate to Atlas
48+
-----------------------------------------------
49+
50+
If you are migrating MongoDB versions earlier than 6.0.5, use one of the
51+
following migration methods, depending on your deployment's requirements
52+
and configuration.
1853

1954
.. cond:: onprem
2055

@@ -24,42 +59,38 @@ configurations into |service|.
2459

2560
* - Deployment Configuration
2661
- Migration Strategy
27-
28-
* - Your data is in |mms| and your network allows flexibility in
62+
63+
* - Your data is in a cluster running MongoDB earlier than 6.0.5,
64+
is managed or monitored by |mms| and your network allows flexibility in
2965
ingress rules.
3066

3167
- :atlas:`Pull data into Atlas </migration-live-atlas-managed>`
32-
from |mms|. In this type of Live Migration, |service| requires
68+
from |mms|. In this type of live migration, |service| requires
3369
access to the source deployment in |mms| through
3470
the deployment's firewall.
3571

36-
* - Your data is in |mms| and your network doesn't allow
37-
flexibility in ingress rules.
72+
* - Your data is in a cluster running MongoDB earlier than 6.0.5,
73+
your cluster is managed or monitored by |mms|, and your network doesn't
74+
allow flexibility in ingress rules.
3875

3976
- :ref:`Push your data into Atlas <migrate-to-atlas>` from |mms|.
40-
In this type of Live Migration, |service| receives data from
77+
In this type of live migration, |service-short| receives data from
4178
|mms| without requiring access through the firewall.
4279

43-
* - Your data is in MongoDB Community and your network doesn't
44-
allow flexibility in ingress rules.
80+
* - Your data is in a MongoDB Community cluster running MongoDB earlier than 6.0.5,
81+
and your network doesn't allow flexibility in ingress rules.
4582

4683
- :ref:`Push your MongoDB Community data into Atlas <migrate-community-to-atlas>`
47-
after adding your Community deployment to |mms|.
48-
In this type of Live Migration, |service| receives data from
84+
after adding your Community deployment to |cloud-short| for monitoring.
85+
In this type of live migration, |service-short| receives data from
4986
|mms| without requiring access through the firewall.
5087

51-
52-
53-
* - Your data is in a MongoDB deployment and you don't have access
54-
to the :term:`oplog`.
55-
- Use :binary:`mongorestore <bin.mongorestore>` to run a
56-
self-managed migration. To learn more, see
57-
:atlas:`Seed with mongorestore </import/mongorestore/>`.
88+
* - Your data is in a MongoDB deployment and you don't have access to the :term:`oplog`.
89+
- Use :binary:`mongorestore <bin.mongorestore>` to run a self-managed migration.
90+
To learn more, see :atlas:`Seed with mongorestore </import/mongorestore/>`.
5891

59-
You can also migrate a MongoDB deployment from one |mms| project
60-
to another project. To learn more, see
61-
:ref:`Migrate a MongoDB Deployment to a New Project
62-
<migrate-deployment-to-new-project>`.
92+
You can also migrate a MongoDB deployment from one |mms| project to another
93+
project. To learn more, see :ref:`Migrate a MongoDB Deployment to a New Project <migrate-deployment-to-new-project>`.
6394

6495
.. cond:: cloud
6596

@@ -70,39 +101,41 @@ configurations into |service|.
70101
* - Deployment Configuration
71102
- Migration Strategy
72103

73-
* - Your data is in |mms|, and your network allows flexibility in
104+
105+
106+
* - Your data is in a cluster running MongoDB earlier than 6.0.5,
107+
is managed or monitored by |mms| and your network allows flexibility in
74108
ingress rules.
75109

76110
- :atlas:`Pull data into Atlas </migration-live-atlas-managed>`
77-
from |mms|. In this type of Live Migration, |service|
111+
from |mms|. In this type of live migration, |service-short|
78112
requires access to the source deployment in |mms| through
79113
the deployment's firewall.
80114

81-
* - Your data is in |mms|, and your network doesn't allow
82-
flexibility in ingress rules.
83-
115+
* - Your data is in a cluster running MongoDB earlier than 6.0.5,
116+
your cluster is managed or monitored by |mms|, and your network doesn't
117+
allow flexibility in ingress rules.
118+
84119
- :ref:`Push your data into Atlas <migrate-to-atlas>` from |mms|.
85-
In this type of Live Migration, |service| receives data from
120+
In this type of live migration, |service-short| receives data from
86121
|mms| without requiring access through the firewall.
87122

88-
* - Your data is in MongoDB Community and your network doesn't
89-
allow flexibility in ingress rules.
90-
123+
* - Your data is in a MongoDB Community cluster running MongoDB earlier than 6.0.5,
124+
and your network doesn't allow flexibility in ingress rules.
125+
91126
- :ref:`Push your MongoDB Community data into Atlas <migrate-community-to-atlas>`
92-
after adding your Community deployment to |mms|.
93-
In this type of Live Migration, |service| receives data from
127+
after adding your Community deployment to |cloud-short| for monitoring.
128+
In this type of live migration, |service-short| receives data from
94129
|mms| without requiring access through the firewall.
95130

96131
* - Your data is in |cloud-short| and you have a :term:`snapshot`.
97132

98133
- :doc:`Restore a backup of a deployment to an Atlas deployment
99134
</tutorial/restore-deployment-to-atlas>`.
100135

101-
* - Your data is in a MongoDB deployment and you don't have access
102-
to the :term:`oplog`.
103-
- Use :binary:`mongorestore <bin.mongorestore>` to run a
104-
self-managed migration. To learn more, see
105-
:atlas:`Seed with mongorestore </import/mongorestore/>`.
136+
* - Your data is in a MongoDB deployment and you don't have access to the :term:`oplog`.
137+
- Use :binary:`mongorestore <bin.mongorestore>` to run a self-managed migration.
138+
To learn more, see :atlas:`Seed with mongorestore </import/mongorestore/>`.
106139

107140
.. cond:: onprem
108141

‎source/release-notes/changelogs/ops-manager/changelog-onprem-v6.0.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -244,6 +244,8 @@
244244
- Updates the {+mdbagent+} to :ref:`12.0.10.7591
245245
<mongodb-12.0.10.7591>`.
246246

247+
.. include:: /includes/note-push-pull-migration-deprecation-for-om.rst
248+
247249
.. include:: /includes/extracts/om6-warning-server-68925.rst
248250

249251
.. _opsmgr-server-6.0.1:

‎source/tutorial/migrate-community-to-atlas.txt

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -18,34 +18,35 @@ Overview
1818
.. cond:: cloud
1919

2020
If you use :manual:`MongoDB Community Edition </introduction>`
21-
but cannot use general :atlas:`Atlas Live Migration </migration-live-atlas-managed/>`
21+
but can't use general :atlas:`Atlas Live Migration </migration-live-atlas-managed/>`
2222
due to network restrictions, you can migrate your MongoDB deployments to
2323
|service-short| via |cloud-short|. To live migrate data from your MongoDB
2424
deployments to clusters in |service-short| using |cloud-short|:
2525

2626
1. Add your deployments to |cloud-short|.
2727
#. Add credentials for Monitoring.
28-
#. Follow the Live Migration Process to |service-short|.
28+
#. Follow the live migration process to |service-short|.
2929

3030
.. cond:: onprem
31+
32+
.. include:: /includes/note-push-pull-migration-deprecation-for-om.rst
3133

3234
If you use :manual:`MongoDB Community Edition </introduction>`
33-
but cannot use general :atlas:`Atlas Live Migration </migration-live-atlas-managed/>`
35+
but can't use general :atlas:`Atlas Live Migration </migration-live-atlas-managed/>`
3436
due to network restrictions, you can migrate your MongoDB deployments to
35-
|service-short| via |cloud-short| or |onprem|. To live migrate data from
36-
your MongoDB deployments to clusters in |service-short| using |cloud-short|
37-
or |onprem|:
37+
|service-short| via |cloud-short|. To live migrate data from
38+
your MongoDB deployments to clusters in |service-short| using |cloud-short|:
3839

3940
1. Add your deployments to |cloud-short| or |onprem|.
4041
#. Add credentials for Monitoring.
41-
#. Follow the Live Migration Process to |service-short|.
42+
#. Follow the live migration process to |service-short|.
4243

4344
For detailed steps, see :ref:`cc-to-atlas-procedure`.
4445

4546
Prerequisites
4647
-------------
4748

48-
Before you begin the Live Migration process from MongoDB Community
49+
Before you begin the live migration process from MongoDB Community
4950
to |service-short|, you must:
5051

5152
- Have an existing deployment in
@@ -58,8 +59,7 @@ to |service-short|, you must:
5859
.. cond:: onprem
5960

6061
- Start a free trial of
61-
:cloudmgr:`Cloud Manager </tutorial/getting-started>` or install
62-
:doc:`Ops Manager </core/installation-checklist>`.
62+
:cloudmgr:`Cloud Manager </tutorial/getting-started>`.
6363

6464
Considerations
6565
--------------
@@ -70,7 +70,7 @@ Considerations
7070
you need to add credentials for Monitoring only, not for Automation
7171
or Backup. Adding your deployment for Monitoring imports your
7272
deployment's metadata into |cloud-short| to help with the Live
73-
Migration process. It does not import your deployment's actual data.
73+
Migration process. It doesn't import your deployment's actual data.
7474

7575
To learn more about authentication
7676
credentials, see :ref:`add-existing-mongodb-processes-auth`.
@@ -93,15 +93,15 @@ Considerations
9393
Setup Considerations
9494
~~~~~~~~~~~~~~~~~~~~
9595

96-
You can use |cloud-short| or |onprem| to migrate your MongoDB deployments.
97-
However, |cloud-short| requires less setup than |onprem| since it's a
98-
hosted version of |onprem|.
96+
You can use |cloud-short| to migrate your MongoDB deployments.
9997

100-
To migrate your deployment using |onprem|, you need to
101-
:doc:`install it locally </core/installation-checklist>` and read and
102-
accept the Migration Agreement. You can read and accept the Migration
103-
Agreement for using |onprem| when you start the Live Migration
104-
process in |service-short|.
98+
.. include:: /includes/note-push-pull-migration-deprecation-for-om.rst
99+
100+
For deployments running MongoDB 6.0.5 or later, you can only use |cloud-short|,
101+
not |onprem|, to monitor them if you want to live migrate (push) them
102+
to |service-short|. You can migrate such deployments to |service-short|
103+
using live migration (pull). For a detailed overview of live migration
104+
options, see :atlas:`Migrate to Atlas </import/>`.
105105

106106
.. _cc-to-atlas-procedure:
107107

0 commit comments

Comments
 (0)