.NET Driver Version 2.12.0-beta1 Release Notes

.NET Driver Version 2.12.0-beta1 Release Notes

This is a beta release for the 2.12.0 version of the driver.

The main new features in 2.12.0-beta1 include:

• Support for Hidden Indexes in MongoDB 4.4
• Support for Azure and GCP keystores in client-side field level encryption (CSFLE)
• Fixed memory leak in heartbeat when cluster is inaccessible

An online version of these release notes is available at:

https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.12.0-beta1.md

The full list of JIRA issues that are currently scheduled to be resolved in this release is available at:

https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.12.0%20ORDER%20BY%20key%20ASC

The list may change as we approach the release date.

Documentation on the .NET driver can be found at:

http://mongodb.github.io/mongo-csharp-driver/

.NET Driver Version 2.11.4 Release Notes

.NET Driver Version 2.11.4 Release Notes

This is a patch release that addresses some issues reported since 2.11.3 was released.

An online version of these release notes is available at:

https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.11.4.md

The list of JIRA tickets resolved in this release is available at:

https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.11.4%20ORDER%20BY%20key%20ASC

Documentation on the .NET driver can be found at:

http://mongodb.github.io/mongo-csharp-driver/

Upgrading

There are no known backwards breaking changes in this release.

v2.11.3

.NET Driver Version 2.11.3 Release Notes

This is a patch release that addresses an issue reported since 2.11.2 was released.

An online version of these release notes is available at:

https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.11.3.md

The list of JIRA tickets resolved in this release is available at:

https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.11.3%20ORDER%20BY%20key%20ASC

Documentation on the .NET driver can be found at:

http://mongodb.github.io/mongo-csharp-driver/

Upgrading

Since the only change in this patch release is CSHARP-3218 and that issue is specific to Xamarin you only need
to upgrade from 2.11.2 to 2.11.3 if you are using the driver on Xamarin.

There are no known backwards breaking changes in this release.

v2.11.2

.NET Driver Version 2.11.2 Release Notes

This is a patch release that fixes a bug reported since 2.11.1 was released.

An online version of these release notes is available at:

https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.11.2.md

The list of JIRA tickets resolved in this release is available at:

https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.11.2%20ORDER%20BY%20key%20ASC

Documentation on the .NET driver can be found at:

http://mongodb.github.io/mongo-csharp-driver/

Upgrading

Everyone using versions 2.11.0 or 2.11.1 of the C# driver with version 4.4.0 or later of the server should upgrade to 2.11.2.
The issue fixed is related to simultaneous authentication of two or more connections, in which case a change introduced
in 2.11.0 can result in authentication failing. Under loads low enough that only one connection is ever opened at the same
time the issue does not happen.

See: https://jira.mongodb.org/browse/CSHARP-3196

There are no known backwards breaking changes in this release.

.NET Driver Version 2.11.1 Release Notes

.NET Driver Version 2.11.1 Release Notes

This is a patch release that fixes a couple of bugs reported since 2.11.0 was released.

An online version of these release notes is available at:

https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.11.1.md

The list of JIRA tickets resolved in this release is available at:

https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.11.1%20ORDER%20BY%20key%20ASC

Documentation on the .NET driver can be found at:

http://mongodb.github.io/mongo-csharp-driver/

Upgrading

If you are writing a WinForms application you will want to upgrade to this version of the driver (see CSHARP-3182).

There are no known backwards breaking changes in this release.

.NET Driver Version 2.11.0 Release Notes

.NET Driver Version 2.11.0 Release Notes

The main new features in 2.11.0 support new features in MongoDB 4.4.0. These features include:

• Support for all new $meta projections: randVal, searchScore, searchHighlights,
  geoNearDistance, geoNearPoint, recordId, indexKey and
  sortKey
• Support for passing a hint to update commands as well as
  findAndModify update and replace operations
• Support for allowDiskUse on find operations
• Support for MONGODB-AWS authentication using Amazon Web Services
  (AWS) Identity and Access Management (IAM) credentials
• Support for stapled OCSP (Online Certificate Status Protocol) (macOS only)
• Support for shorter SCRAM (Salted Challenge Response Authentication Mechanism) conversations
• Support for speculative SCRAM and MONGODB-X509 authentication
• Support for the CommitQuorum option in createIndexes
• Support for hedged reads

Other new additions and updates in this release include:

• A new target of .NET Standard 2.0
• Support for Snappy compression on .NET Core on Windows (in addition
  to existing support on .NET Framework)
• Support for Zstandard compression on Windows on 64-bit platforms
• A new URI option tlsDisableCertificateRevocationCheck to disable
  certificate revocation checking.
• An expanded list of retryable write errors via the inclusion of
  ExceededTimeLimit, LockTimeout and ClientDisconnect
• A new GuidRepresentationMode setting to opt-in to the new V3 GuidRepresentation mode
• Improved SDAM (Server Discovery and Monitoring) error handling
• Support for the AuthorizedDatabases option in ListDatabases
• Session support for AsQueryable

An online version of these release notes is available at:

https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.11.0.md

The full list of JIRA issues resolved in this release is available at:

https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.11.0%20ORDER%20BY%20key%20ASC

Documentation on the .NET driver can be found at:

http://mongodb.github.io/mongo-csharp-driver/

.NET Driver Version 2.11.0-beta2 Release Notes

.NET Driver Version 2.11.0-beta2 Release Notes

This is a beta release for the 2.11.0 version of the driver.

The main new features in 2.11.0-beta2 support new features in MongoDB 4.4.0. These features include:

• Support for all new
  $meta
  projections: randVal, searchScore, searchHighlights,
  geoNearDistance, geoNearPoint, recordId, indexKey and
  sortKey
• Support for passing a hint to update commands as well as
  findAndModify update and replace operations
• Support for allowDiskUse on find operations
• Support for MONGODB-AWS authentication using Amazon Web Services
  (AWS) Identity and Access Management (IAM) credentials
• Support for stapled OCSP (Online Certificate Status Protocol) (macOS only)
• Support for shorter SCRAM (Salted Challenge Response Authentication Mechanism) conversations
• Support for speculative SCRAM and MONGODB-X509 authentication
• Support for the CommitQuorum option in createIndexes
• Support for hedged reads

Other new additions and updates in this beta include:

• A new target of .NET Standard 2.0
• Support for Snappy compression on .NET Core on Windows (in addition
  to existing support on .NET Framework)
• Support for Zstandard compression on Windows on 64-bit platforms
• A new default of enabling certificate revocation checking.
• A new URI option tlsDisableCertificateRevocationCheck to disable
  certificate revocation checking.
• An expanded list of retryable write errors via the inclusion of
  ExceededTimeLimit, LockTimeout and ClientDisconnect
• A new GuidRepresentationMode setting to opt-in to the new V3 GuidRepresentation mode
• Improved SDAM (Server Discovery and Monitoring) error handling
• Support for the AuthorizedDatabases option in ListDatabases
• Session support for AsQueryable

An online version of these release notes is available at:

https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.11.0-beta2.md

The full list of JIRA issues that are currently scheduled to be resolved in this release is available at:

https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.11.0%20ORDER%20BY%20key%20ASC

The list may change as we approach the release date.

Documentation on the .NET driver can be found at:

http://mongodb.github.io/mongo-csharp-driver/

Upgrading

Backwards compatibility with driver version 2.7.0–2.10.x

Because certificate revocation checking is now enabled by default, an
application that is unable to contact the OCSP endpoints and/or CRL
distribution points specified in a server's certificate may experience
connectivity issues (e.g. if the application is behind a firewall with
an outbound whitelist). This is because the driver needs to contact
the OCSP endpoints and/or CRL distribution points specified in the
server’s certificate and if these OCSP endpoints and/or CRL
distribution points are not accessible, then the connection to the
server may fail. In such a scenario, connectivity may be able to be
restored by disabling certificate revocation checking by adding
tlsDisableCertificateRevocationCheck=true to the application's connection
string.

.NET Driver Version 2.10.4 Release Notes

.NET Driver Version 2.10.4 Release Notes

This is a patch release that fixes a couple of bugs reported since 2.10.3 was released.

An online version of these release notes is available at:

https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.10.4.md

The list of JIRA tickets resolved in this release is available at:

https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.10.4%20ORDER%20BY%20key%20ASC

Documentation on the .NET driver can be found at:

http://mongodb.github.io/mongo-csharp-driver/

Upgrading

There are no known backwards breaking changes in this release.

.NET Driver Version 2.11.0-beta1 Release Notes

.NET Driver Version 2.11.0-beta1 Release Notes

This is a beta release for the 2.11.0 version of the driver.

The main new features in 2.11.0-beta1 support new features in MongoDB 4.4.0. These features include:

• Support for all new
  $meta
  projections: randVal, searchScore, searchHighlights,
  geoNearDistance, geoNearPoint, recordId, indexKey and
  sortKey
• Support for passing a hint to update commands as well as
  findAndModify update and replace operations
• Support for allowDiskUse on find operations
• Support for MONGODB-AWS authentication using Amazon Web Services
  (AWS) Identity and Access Management (IAM) credentials
• Support for stapled OCSP (Online Certificate Status Protocol) (macOS only)

Other new additions and updates in this beta include:

• A new target of .NET Standard 2.0
• Support for Snappy compression on .NET Core on Windows (in addition
  to existing support on .NET Framework)
• Support for Zstandard compression on Windows on 64-bit platforms
• A new default of enabling certificate revocation checking.
• A new URI option tlsDisableCertificateRevocationCheck to disable
  certificate revocation checking.
• An expanded list of retryable write errors via the inclusion of
  ExceededTimeLimit, LockTimeout and ClientDisconnect
• A new GuidRepresentationMode setting to opt-in to the new V3 GuidRepresentation mode

An online version of these release notes is available at:

https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.11.0-beta1.md

The full list of JIRA issues that are currently scheduled to be resolved in this release is available at:

https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.11.0%20ORDER%20BY%20key%20ASC

The list may change as we approach the release date.

Documentation on the .NET driver can be found at:

http://mongodb.github.io/mongo-csharp-driver/

Upgrading

Backwards compatibility with driver version 2.7.0–2.10.x

Because certificate revocation checking is now enabled by default, an
application that is unable to contact the OCSP endpoints and/or CRL
distribution points specified in a server's certificate may experience
connectivity issues (e.g. if the application is behind a firewall with
an outbound whitelist). This is because the driver needs to contact
the OCSP endpoints and/or CRL distribution points specified in the
server’s certificate and if these OCSP endpoints and/or CRL
distribution points are not accessible, then the connection to the
server may fail. In such a scenario, connectivity may be able to be
restored by disabling certificate revocation checking by adding
tlsDisableCertificateRevocationCheck=true to the application's connection
string.

.NET Driver Version 2.10.3 Release Notes

.NET Driver Version 2.10.3 Release Notes

This is a patch release that fixes several bugs reported since 2.10.2 was released.

An online version of these release notes is available at:

https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.10.3.md

The list of JIRA tickets resolved in this release is available at:

https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.10.3%20ORDER%20BY%20key%20ASC

Documentation on the .NET driver can be found at:

http://mongodb.github.io/mongo-csharp-driver/

Upgrading

There are no known backwards breaking changes in this release.