Skip to content

DOCSP-44249: Drop support for Server version 3.6 #117

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
merged 5 commits into from
Nov 7, 2024
Merged
Show file tree
Hide file tree
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
20 changes: 12 additions & 8 deletions source/includes/mongodb-compatibility-table-pymongo.rst
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,16 @@
- MongoDB 4.0
- MongoDB 3.6

* - 4.11
- ✓
- ✓
- ✓
- ✓
- ✓
- ✓
- ✓
-

* - 4.10
- ✓
- ✓
Expand All @@ -21,10 +31,7 @@
- ✓
- ✓
- ✓
- ⊛
-
-
-
- ✓

* - 4.9
- ✓
Expand All @@ -34,10 +41,7 @@
- ✓
- ✓
- ✓
- ⊛
-
-
-
- ✓

* - 4.4 to 4.8
- ⊛
Expand Down
14 changes: 10 additions & 4 deletions source/includes/troubleshooting/connection-targets.rst
Original file line number Diff line number Diff line change
@@ -1,16 +1,22 @@
Server Reports Wire Version X, PyMongo Requires Y
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

If you try to connect to {+mdb-server+} v3.4 or earlier,
If you try to connect to {+mdb-server+} v3.6 or earlier,
{+driver-short+} might raise the following error:

.. code-block::

pymongo.errors.ConfigurationError: Server at localhost:27017 reports wire version 5, but this version of PyMongo requires at least 6 (MongoDB 3.6).
pymongo.errors.ConfigurationError: Server at localhost:27017 reports wire version 6, but this version of PyMongo requires at least 7 (MongoDB 4.0).

This occurs when the driver version is too new for the server it's connecting to.
To resolve this issue, upgrade your MongoDB deployment to v3.6 or later, or downgrade to
{+driver-short+} v3.x, which supports {+mdb-server+} v2.6 and later.
To resolve this issue, you can do one of the following:

- Upgrade your MongoDB deployment to v4.0 or later.

- Downgrade to {+driver-short+} 4.10 or earlier, which supports {+mdb-server+}
v3.6 and later.

- Downgrade to {+driver-short+} v3.x, which supports {+mdb-server+} v2.6 and later.

AutoReconnect
~~~~~~~~~~~~~
Expand Down
10 changes: 10 additions & 0 deletions source/upgrade.txt
Original file line number Diff line number Diff line change
Expand Up @@ -104,6 +104,16 @@ and upgrade versions.

.. diagram for this example?

.. _version-4.11-breaking-changes:

Version 4.11 Breaking Changes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

- {+mdb-server+} v3.6 is no longer supported. The minimum supported {+mdb-server+}
version is now v4.0.

- The minimum wire version is now 7. See :manual:`minWireVersion </reference/command/hello/#mongodb-data-hello.minWireVersion>`.

.. _version-4.9-breaking-changes:

Version 4.9 Breaking Changes
Expand Down
7 changes: 6 additions & 1 deletion source/whats-new.txt
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ What's New
:values: reference

.. meta::
:keywords: update, new feature, deprecation, upgrade, driver v4.7, driver v4.8, driver v4.9, driver v4.10
:keywords: update, new feature, deprecation, upgrade, driver v4.7, driver v4.8, driver v4.9, driver v4.10, driver v4.11

Learn what's new in:

Expand All @@ -32,6 +32,11 @@ Learn what's new in:
What's New in 4.11
------------------

.. warning:: Breaking Changes

{+driver-short+} v4.11 contains breaking changes. For more information, see
:ref:`version-4.11-breaking-changes`.

The {+driver-short+} v4.11 release includes the following new features:

- Adds support for free-threaded CPython when running Python v3.13+.
Expand Down
Loading