Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

DOCSP-45861 Older Version Support Task Page #533

Open
wants to merge 11 commits into
base: feature-older-version-support
Choose a base branch
from

Conversation

ajhuh-mdb
Copy link
Collaborator

@ajhuh-mdb ajhuh-mdb commented Dec 23, 2024

DESCRIPTION

  • Task page for running mongosync on pre-6.0 clusters

STAGING

JIRA

https://jira.mongodb.org/browse/DOCSP-45861

Copy link

netlify bot commented Dec 23, 2024

Deploy Preview for docs-cluster-to-cluster-sync ready!

Name Link
🔨 Latest commit 348f706
🔍 Latest deploy log https://app.netlify.com/sites/docs-cluster-to-cluster-sync/deploys/677c014701a9850008e64f25
😎 Deploy Preview https://deploy-preview-533--docs-cluster-to-cluster-sync.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

Copy link
Collaborator

@jmd-mongo jmd-mongo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for these updates, @ajhuh-mdb! This one LGTM mod a nit.

Thanks,
Joe

source/reference/older-version-support.txt Outdated Show resolved Hide resolved
@ajhuh-mdb
Copy link
Collaborator Author

Hey @ajayvijayakumar123 👋 Whenever you get the chance, could you review this docs PR for the older version support page? TIA!

Copy link
Collaborator

@ajayvijayakumar123 ajayvijayakumar123 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some suggestions! Also tagging @mvankeulen94

To learn more about supported server versions, see
:ref:`c2c-server-version-compatibility`.

Steps
Copy link
Collaborator

@ajayvijayakumar123 ajayvijayakumar123 Jan 6, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we should recommend using mongomirror or mongodump / mongorestore if the user can't upgrade their source cluster to 4.4+ and destination cluster to 6.0+.

@mvankeulen94, you mentioned that we should recommend users to use unsupported older versions of mongodump and mongorestore to perform a skip-level upgrade on https://jira.mongodb.org/browse/DOCSP-41415 's comments. I'm not sure if we should publicly recommend using unsupported versions of dump/restore. Thoughts?

Copy link
Collaborator Author

@ajhuh-mdb ajhuh-mdb Jan 6, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ah got it. Similar to what you mentioned, I wasn't sure if we wanted to recommend that in our docs since it seemed like more of a workaround rather than an official solution. Can wait for Maria's comments on this, but I'm leaning towards not recommending this and maybe having users defer to support/reaching out to receive this recommendation instead.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks all, agreed that we shouldn't publicly document using unsupported versions of dump+restore. In the meantime since my July comment, we have introduced some internal guidance around migration from EOL'd versions. We can leave the public guidance scoped to officially supported tooling

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Perfect, sounds good.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@mvankeulen94 to confirm, we don't want to mention dump/restore or mongomirror on this page?

source/reference/older-version-support.txt Outdated Show resolved Hide resolved
source/reference/older-version-support.txt Outdated Show resolved Hide resolved
Embedded Verifier
~~~~~~~~~~~~~~~~~

When you sync from a pre-6.0 source cluster, enable the

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ajayvijayakumar123 is this strictly necessary? Now that embedded verification is decoupled from the persistence project, there are still migrations that wouldn't be able to proceed with verification. Can we remove this embedded verifier section and just link to the verify data transfer docs instead?

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yup that works. I just wanted us to recommend users to verify pre-6.0 migrations. Linking to the verify data transfer docs sounds good

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants