Skip to content

Commit e6a23ee

Browse files
kanchana-mongodbrohsharmdb-ashley
authored
DOCSP-34690 Make cross version sync documentation clear (#257)
* DOCSP-34690 Make cross version sync documentation clear * DOCSP-34690 updates for KD's CR feedback * DOCSP-34690 updates for RS' feedback * Update source/reference/supported-server-version.txt Co-authored-by: Rohan Sharan <[email protected]> * DOCSP-34690 updates for RS' feedback * Apply suggestions from code review Co-authored-by: Ashley Brown <[email protected]> --------- Co-authored-by: Rohan Sharan <[email protected]> Co-authored-by: Ashley Brown <[email protected]>
1 parent 98ff21c commit e6a23ee

File tree

5 files changed

+59
-32
lines changed

5 files changed

+59
-32
lines changed

source/includes/cross-version-sync.rst

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,6 @@
1-
Starting in 1.7.0, ``mongosync`` can perform a cross-version migration
2-
from a lower major version source cluster to a higher major version
3-
destination cluster. You can migrate up to two major versions ahead. For
4-
example, you can synchronize a cluster running MongoDB 6.0 with a
5-
cluster running 7.0.
1+
Starting in 1.7.0, ``mongosync`` can perform version migration from
2+
certain lower major version source clusters to certain higher major
3+
version destination clusters.
64

75
Cross-version migration requires additional preparation and
86
configuration when migrating from a pre-6.0 release. To perform a cross-version

source/quickstart.txt

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -63,8 +63,10 @@ Follow the instructions below to set up {+c2c-product-name+}.
6363

6464
.. seealso::
6565

66-
For more information on MongoDB server version compatibility or
67-
cross-version migrations, see :ref:`c2c-server-version-compatibility`.
66+
You can migrate between clusters on the same or different
67+
MongoDB versions. For more information on MongoDB server
68+
version compatibility or cross-version migrations, see
69+
:ref:`c2c-server-version-compatibility`.
6870

6971
The number of nodes in the destination replica set does not have
7072
to equal the number of nodes in the source replica set.

source/reference.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,4 +19,5 @@ Reference
1919
/reference/permissions
2020
/reference/telemetry
2121
/reference/versioning
22+
/reference/supported-server-version
2223

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
.. _c2c-server-version-compatibility:
2+
3+
====================================
4+
MongoDB Server Version Compatibility
5+
====================================
6+
7+
.. default-domain:: mongodb
8+
9+
.. contents:: On this page
10+
:local:
11+
:backlinks: none
12+
:depth: 2
13+
:class: singlecol
14+
15+
Before you run {+c2c-product-name+}, consider the following MongoDB server
16+
version limitations and requirements:
17+
18+
- .. include:: /includes/fact-minimum-server-version-support.rst
19+
20+
- ``mongosync`` doesn't support MongoDB rapid releases, such as 6.1 or 6.2.
21+
22+
- .. include:: /includes/fact-minimum-fcv.rst
23+
24+
Synchronize Data Between Clusters Running Older MongoDB Server Versions
25+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
26+
27+
.. include:: /includes/fact-minimum-versions.rst
28+
29+
30+
Synchronize Data Between Clusters with Different MongoDB Server Major Versions
31+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
32+
33+
.. include:: /includes/cross-version-sync.rst
34+
35+
``mongosync`` supports syncs between the following source and
36+
destination MongoDB server versions.
37+
38+
.. list-table::
39+
:widths: 40 30 30
40+
41+
* -
42+
- **6.0** Destination
43+
- **7.0** Destination
44+
45+
* - **6.0** Source
46+
- √
47+
- √
48+
49+
* - **7.0** Source
50+
-
51+
- √

source/reference/versioning.txt

Lines changed: 0 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -34,31 +34,6 @@ Currently Supported Versions
3434
If you are using an unsupported version of ``mongosync``, you may be
3535
asked to upgrade in order to receive support.
3636

37-
.. _c2c-server-version-compatibility:
38-
39-
MongoDB Server Version Compatibility and Support
40-
------------------------------------------------
41-
42-
Before you run {+c2c-product-name+}, consider the following MongoDB server
43-
version limitations and requirements:
44-
45-
- .. include:: /includes/fact-minimum-server-version-support.rst
46-
47-
- ``mongosync`` doesn't support MongoDB rapid releases, such as 6.1 or 6.2.
48-
49-
- .. include:: /includes/fact-minimum-fcv.rst
50-
51-
Synchronize Data Between Clusters Running Older MongoDB Server Versions
52-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
53-
54-
.. include:: /includes/fact-minimum-versions.rst
55-
56-
57-
Synchronize Data Between Clusters with Different MongoDB Server Major Versions
58-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
59-
60-
.. include:: /includes/cross-version-sync.rst
61-
6237
Version-Related Considerations
6338
------------------------------
6439

0 commit comments

Comments
 (0)