From 60c7158744c5943f0645be3aeeb98ee0cd628096 Mon Sep 17 00:00:00 2001 From: alisonjhuh Date: Wed, 16 Jun 2021 17:00:13 -0400 Subject: [PATCH] DOCSP-5004 Add reminder to check driver compatibility before upgrading server --- source/includes/upgrade-guidance-checklists.rst | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) 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