|
| 1 | +# .NET Driver Version 2.11.0-beta1 Release Notes |
| 2 | + |
| 3 | +This is a beta release for the 2.11.0 version of the driver. |
| 4 | + |
| 5 | +The main new features in 2.11.0-beta1 support new features in MongoDB 4.4.0. These features include: |
| 6 | + |
| 7 | +* Support for all new |
| 8 | + [``$meta``](https://docs.mongodb.com/manual/reference/operator/projection/meta/) |
| 9 | + projections: `randVal`, `searchScore`, `searchHighlights`, |
| 10 | + `geoNearDistance`, `geoNearPoint`, `recordId`, `indexKey` and |
| 11 | + `sortKey` |
| 12 | +* Support for passing a hint to update commands as well as |
| 13 | + `findAndModify` update and replace operations |
| 14 | +* Support for `allowDiskUse` on find operations |
| 15 | +* Support for `MONGODB-AWS` authentication using Amazon Web Services |
| 16 | + (AWS) Identity and Access Management (IAM) credentials |
| 17 | +* Support for stapled OCSP (Online Certificate Status Protocol) (macOS only) |
| 18 | + |
| 19 | +Other new additions and updates in this beta include: |
| 20 | + |
| 21 | +* A new target of .NET Standard 2.0 |
| 22 | +* Support for Snappy compression on .NET Core on Windows (in addition |
| 23 | + to existing support on .NET Framework) |
| 24 | +* Support for Zstandard compression on Windows on 64-bit platforms |
| 25 | +* A new default of enabling certificate revocation checking. |
| 26 | +* A new URI option `tlsDisableCertificateRevocationCheck` to disable |
| 27 | + certificate revocation checking. |
| 28 | +* An expanded list of retryable write errors via the inclusion of |
| 29 | + `ExceededTimeLimit`, `LockTimeout` and `ClientDisconnect` |
| 30 | +* A new GuidRepresentationMode setting to opt-in to the new V3 GuidRepresentation mode |
| 31 | + |
| 32 | +An online version of these release notes is available at: |
| 33 | + |
| 34 | +https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.11.0-beta1.md |
| 35 | + |
| 36 | +The full list of JIRA issues that are currently scheduled to be resolved in this release is available at: |
| 37 | + |
| 38 | +https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.11.0%20ORDER%20BY%20key%20ASC |
| 39 | + |
| 40 | +The list may change as we approach the release date. |
| 41 | + |
| 42 | +Documentation on the .NET driver can be found at: |
| 43 | + |
| 44 | +http://mongodb.github.io/mongo-csharp-driver/ |
| 45 | + |
| 46 | +## Upgrading |
| 47 | + |
| 48 | +### Backwards compatibility with driver version 2.7.0–2.10.x |
| 49 | +Because certificate revocation checking is now enabled by default, an |
| 50 | +application that is unable to contact the OCSP endpoints and/or CRL |
| 51 | +distribution points specified in a server's certificate may experience |
| 52 | +connectivity issues (e.g. if the application is behind a firewall with |
| 53 | +an outbound whitelist). This is because the driver needs to contact |
| 54 | +the OCSP endpoints and/or CRL distribution points specified in the |
| 55 | +server’s certificate and if these OCSP endpoints and/or CRL |
| 56 | +distribution points are not accessible, then the connection to the |
| 57 | +server may fail. In such a scenario, connectivity may be able to be |
| 58 | +restored by disabling certificate revocation checking by adding |
| 59 | +`tlsDisableCertificateRevocationCheck=true` to the application's connection |
| 60 | +string. |
0 commit comments