DOCSP-45860-older-version-limitations #522
Conversation
✅ Deploy Preview for docs-cluster-to-cluster-sync ready!
To edit notification comments on pull requests, go to your Netlify site configuration. |
There was a problem hiding this comment.
@ajhuh-mdb thanks for these updates! Looks good so far - just have some comments and suggestions for your consideration.
|
Thanks for the initial review @jeff-allen-mongo. This should be ready for another look. |
|
Hi @ajayvijayakumar123 👋 Could you review this docs PR for documenting the Older Version Support limitations? I also left a comment open above for you. TIA! |
ajhuh-mdb
changed the base branch from
master
to
feature-older-version-support
| @@ -0,0 +1,43 @@ | |||
| - Writes that produce DDL events cannot occur on the source cluster during the | |||
There was a problem hiding this comment.
can we add a link to the definition of DDL?
| - :ref:`/reverse <c2c-api-reverse>` endpoint is not supported. You can't | ||
| enable the ``reversible`` option in the :ref:`/start <c2c-api-start>` request. | ||
|
|
||
| - You can't enable the ``enableUserWriteBlocking`` option in the ``/start`` |
There was a problem hiding this comment.
can we add a note here that the user is responsible for preventing writes to the source or destination?
There was a problem hiding this comment.
@mvankeulen94 @ajayvijayakumar123 do we have a way of ensuring users don't write to their clusters without the enableUserWriteBlocking option? Or is this something they just need to manually make sure of?
There was a problem hiding this comment.
I think they just need to manually make sure
| request. | ||
|
|
||
| - You can't enable the ``createSupportingIndexes`` :ref:`sharding parameter | ||
| <c2c-api-start-sharding>`. |
There was a problem hiding this comment.
@ajayvijayakumar123 is there a workaround we can advise for users? It's tricky to digest what this parameter does if the reader isn't already familiar with it
There was a problem hiding this comment.
Yup. Let's say the user wants to shard on shard key a:1. Instead of enabling createSupportingIndexes, the user would need to create an index to support the shard key on the source.
|
|
||
| - Indexes with inconsistent specs or that are missing on some shards are not | ||
| supported. To check for index inconsistencies, see | ||
| :ref:`manage-indexes-find-inconsistent-indexes`. |
There was a problem hiding this comment.
@ajayvijayakumar123 is this a change from status quo mongosync GA? We have 'mongosync only syncs indexes that have consistent index specifications on all shards.' in the limitations today
There was a problem hiding this comment.
Yup. For 6.0+ migrations, mongosync ignores inconsistent indexes and just doesn't build them on the destination. For pre-6.0 migrations, mongosync will error on these indexes.
There was a problem hiding this comment.
I'll make it clear that it'll error on pre-6.0 migrations
|
|
||
| - Indexes with inconsistent specs or that are missing on some shards are not | ||
| supported. To check for index inconsistencies, see | ||
| :ref:`manage-indexes-find-inconsistent-indexes`. |
ajhuh-mdb
merged commit aa418bf
into
mongodb:feature-older-version-support
* DOCSP-45860-older-version-limitations (#522) * DOCSP-45860-older-version-limitations * * * JA feedback * * * * * * * AV feedback * MvK feedback * DOCSP-45859 Version Compatibility (#518) * DOCSP-45859 Version Compatibility * * * * * * * AV feedback * swap list order * MvK feedback * DOCSP-45861 Older Version Support Task Page (#533) * DOCSP-45861 Older Version Support Task Page * add prerequisites & limitations * * * * * procedures * * * rn * * * remove extra step * nit * AV feedback * remove task page * * * * * * * DOCSP-45862 User permissions older version (#552) * DOCSP-45862-user-permissions * * * JD feedback * AV feedback * DOCSP-45863-embedded-verifier-migrations (#557) * DOCSP-45863-embedded-verifier-migrations * * * * * AV feedback * wording * add ddl limitation * * * RS feedback * * * remove merge conflict artifact * fix link title
4 participants
DESCRIPTION
STAGING
https://deploy-preview-522--docs-cluster-to-cluster-sync.netlify.app/reference/limitations/#pre-6.0-migrations
JIRA
DOCSP-45860