Skip to content

DOCSP-5004 Add reminder to check driver compatibility before upgradin… #5459

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

Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 13 additions & 2 deletions source/includes/upgrade-guidance-checklists.rst
Original file line number Diff line number Diff line change
Expand Up @@ -19,13 +19,24 @@ successively upgrade major releases until you have upgraded to
|oldseries|. For example, if you are running a |olderseries|, you must
|upgradefirst| *before* you can upgrade to |newversion|.

Check Driver Compatibility
~~~~~~~~~~~~~~~~~~~~~~~~~~

Before you upgrade MongoDB, check that you're using a MongoDB
|newversion|-compatible driver. Consult the `driver documentation
<https://docs.mongodb.com/drivers/>`_ for your specific driver to verify
compatibility with MongoDB |newversion|.

Upgraded deployments that run on incompatible drivers might encounter
unexpected or undefined behavior.

Preparedness
~~~~~~~~~~~~

Before beginning your upgrade, see the |compatibility| document to
ensure that your applications and deployments are compatible with
MongoDB |newversion|. Resolve the incompatibilities in your deployment before
starting the upgrade.
MongoDB |newversion|. Resolve the incompatibilities in your deployment
before starting the upgrade.

Before upgrading MongoDB, always test your application in a staging
environment before deploying the upgrade to your production
Expand Down