Skip to content

Commit 16526e4

Browse files
authored
DOCSP-33885 Fix Server Version Requirement References (#200) (#202)
* DOCSP-33885 Fix Server Version Requirement References * * * typos * AB feedback * AV feedback * *
1 parent ecd692a commit 16526e4

File tree

6 files changed

+30
-60
lines changed

6 files changed

+30
-60
lines changed
Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
1-
Starting in 1.7.0, ``mongosync`` can perform a cross version migration
1+
Starting in 1.7.0, ``mongosync`` can perform a cross-version migration
22
from a lower major version source cluster to a higher major version
33
destination cluster. You can migrate up to two major versions ahead. For
44
example, you can synchronize a cluster running MongoDB 6.0 with a
55
cluster running 7.0.
66

7-
Cross version migration requires additional preparation and
8-
configuration when migrating from a pre-6.0 release. To perform a cross
9-
version migration from a pre-6.0 version of the MongoDB Server using
7+
Cross-version migration requires additional preparation and
8+
configuration when migrating from a pre-6.0 release. To perform a cross-version
9+
migration from a pre-6.0 version of the MongoDB Server using
1010
``mongosync``, please `contact <https://mongodb.com/contact>`__ your
1111
account team to inquire about Professional Services.

source/includes/fact-minimum-fcv.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
The minimum supported server :manual:`feature compatibility version <view-fcv>`
2+
is 6.0.
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
The minimum supported server versions of MongoDB are 6.0.8 and 7.0.0.

source/quickstart.txt

Lines changed: 4 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ Follow the instructions below to setup {+c2c-product-name+}.
4141
.. step:: Define a source and a destination cluster
4242

4343
If you already have a MongoDB cluster, either self-managed or
44-
hosted in :atlas:`MongodDB Atlas </getting-started?jmp=docs>`,
44+
hosted in :atlas:`MongoDB Atlas </getting-started?jmp=docs>`,
4545
use that cluster as the source cluster. If you don't have a
4646
cluster to work with, you will need to create one.
4747

@@ -50,14 +50,10 @@ Follow the instructions below to setup {+c2c-product-name+}.
5050
sharded cluster, or between sharded clusters, see:
5151
:ref:`c2c-sharded-clusters`.
5252

53-
The source and destination clusters must be:
54-
55-
- at least MongoDB 6.0.
56-
- at least Feature Compatibility Version 6.0
57-
58-
.. include:: /includes/version-sync-limitation.rst
53+
.. seealso::
5954

60-
.. include:: /includes/cross-version-sync.rst
55+
For more information on MongoDB server version compatibility or
56+
cross-version migrations, see :ref:`c2c-server-version-compatibility`.
6157

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

source/reference/limitations.txt

Lines changed: 3 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -24,35 +24,11 @@ Limitations
2424
General Limitations
2525
-------------------
2626

27-
- The minimum supported server versions are MongoDB 6.0.8 and 7.0.0.
27+
.. note::
2828

29-
- .. include:: /includes/fact-minimum-versions.rst
29+
For information on MongoDB server compatility, see
30+
:ref:`c2c-server-version-compatibility`.
3031

31-
- ``mongosync`` doesn't support MongoDB rapid releases such as 6.1 or
32-
6.2. The minimum supported server version is MongoDB 6.0.5.
33-
For more information on MongoDB versioning, see
34-
:ref:`release-version-numbers`.
35-
- In ``mongosync`` versions earlier than 1.7.0, the source and
36-
destination clusters must have the same major and minor release
37-
version, but can have different patch releases.
38-
39-
For example:
40-
41-
- ``mongosync`` can sync from a MongoDB 6.0.8 source cluster to a
42-
destination cluster using MongoDB 6.0.9. This is because the patch
43-
releases have the same major version.
44-
- ``mongosync`` doesn't support a sync from a MongoDB 6.0.9 source
45-
cluster to a destination cluster using MongoDB 7.0.0. This is
46-
because the releases have different major versions.
47-
48-
- In ``mongosync`` versions earlier than 1.7.0, the source and
49-
destination clusters must have the same :dbcommand:`Feature
50-
Compatibility Version <setFeatureCompatibilityVersion>`.
51-
52-
- .. include:: /includes/cross-version-sync.rst
53-
54-
- The minimum supported :dbcommand:`Feature Compatibility Version
55-
<setFeatureCompatibilityVersion>` is 6.0.
5632
- The destination cluster must be empty.
5733
- ``mongosync`` doesn't validate that the clusters or the environment
5834
are properly configured.

source/reference/versioning.txt

Lines changed: 16 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -39,35 +39,30 @@ asked to upgrade in order to receive support.
3939
MongoDB Server Version Compatibility and Support
4040
------------------------------------------------
4141

42-
{+c2c-product-name+} supports the following versions of MongoDB Server:
42+
Before you run {+c2c-product-name+}, consider the following MongoDB server
43+
version limitations and requirements:
4344

45+
- .. include:: /includes/fact-minimum-server-version-support.rst
4446

45-
.. list-table::
46-
:header-rows: 1
47-
:stub-columns: 1
47+
- ``mongosync`` doesn't support MongoDB rapid releases, such as 6.1 or 6.2.
4848

49-
* - ``mongosync`` Version
50-
- MongoDB Server Version
49+
- .. include:: /includes/fact-minimum-fcv.rst
5150

52-
* - 1.6.0
53-
- 7.0.x
51+
Synchronize Data Between Clusters Running Older MongoDB Server Versions
52+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
5453

55-
* - 1.0.0
56-
- 6.0.x
54+
.. include:: /includes/fact-minimum-versions.rst
5755

58-
Considerations
59-
--------------
6056

61-
{+c2c-product-name+} has the following version related considerations:
57+
Synchronize Data Between Clusters with Different MongoDB Server Major Versions
58+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
6259

63-
Same Server Version
64-
~~~~~~~~~~~~~~~~~~~
60+
.. include:: /includes/cross-version-sync.rst
6561

66-
{+c2c-product-name+} only supports syncing between the same version of
67-
MongoDB Server. The major and minor :ref:`server version numbers
68-
<release-version-numbers>` must be the same on both clusters.
69-
Starting in ``mongosync`` 1.6.0, the source and destination cluster
70-
can use different patch releases of the same major and minor version.
62+
Version-Related Considerations
63+
------------------------------
64+
65+
{+c2c-product-name+} has the following version related considerations:
7166

7267
Support Lifecycle
7368
~~~~~~~~~~~~~~~~~
@@ -214,7 +209,7 @@ Major Releases
214209

215210
- Changes that break compatibility with a supported version of MongoDB
216211
Server.
217-
- Dropping a version of the REST API. ``mongosync`` may dropping all
212+
- Dropping a version of the REST API. ``mongosync`` may drop all
218213
older endpoints in favor of a new version of the API. There will never
219214
be any other types of backwards incompatible changes in the REST API.
220215
- Removing support for a previously supported MongoDB Server feature if

0 commit comments

Comments
 (0)