diff --git a/source/includes/upgrade-guidance-checklists.rst b/source/includes/upgrade-guidance-checklists.rst index bdd6aaf5059..1893393fcaa 100644 --- a/source/includes/upgrade-guidance-checklists.rst +++ b/source/includes/upgrade-guidance-checklists.rst @@ -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 +`_ 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