|
| 1 | +# .NET Driver Version 2.11.0-beta2 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-beta2 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 | +* Support for shorter SCRAM (Salted Challenge Response Authentication Mechanism) conversations |
| 19 | +* Support for speculative SCRAM and MONGODB-X509 authentication |
| 20 | +* Support for the `CommitQuorum` option in `createIndexes` |
| 21 | +* Support for [hedged reads](https://docs.mongodb.com/master/core/read-preference-hedge-option/index.html) |
| 22 | + |
| 23 | +Other new additions and updates in this beta include: |
| 24 | + |
| 25 | +* A new target of .NET Standard 2.0 |
| 26 | +* Support for Snappy compression on .NET Core on Windows (in addition |
| 27 | + to existing support on .NET Framework) |
| 28 | +* Support for Zstandard compression on Windows on 64-bit platforms |
| 29 | +* A new default of enabling certificate revocation checking. |
| 30 | +* A new URI option `tlsDisableCertificateRevocationCheck` to disable |
| 31 | + certificate revocation checking. |
| 32 | +* An expanded list of retryable write errors via the inclusion of |
| 33 | + `ExceededTimeLimit`, `LockTimeout` and `ClientDisconnect` |
| 34 | +* A new GuidRepresentationMode setting to opt-in to the new V3 GuidRepresentation mode |
| 35 | +* Improved SDAM (Server Discovery and Monitoring) error handling |
| 36 | +* Support for the `AuthorizedDatabases` option in `ListDatabases` |
| 37 | +* Session support for `AsQueryable` |
| 38 | + |
| 39 | +An online version of these release notes is available at: |
| 40 | + |
| 41 | +https://github.com/mongodb/mongo-csharp-driver/blob/master/Release%20Notes/Release%20Notes%20v2.11.0-beta2.md |
| 42 | + |
| 43 | +The full list of JIRA issues that are currently scheduled to be resolved in this release is available at: |
| 44 | + |
| 45 | +https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.11.0%20ORDER%20BY%20key%20ASC |
| 46 | + |
| 47 | +The list may change as we approach the release date. |
| 48 | + |
| 49 | +Documentation on the .NET driver can be found at: |
| 50 | + |
| 51 | +http://mongodb.github.io/mongo-csharp-driver/ |
| 52 | + |
| 53 | +## Upgrading |
| 54 | + |
| 55 | +### Backwards compatibility with driver version 2.7.0–2.10.x |
| 56 | +Because certificate revocation checking is now enabled by default, an |
| 57 | +application that is unable to contact the OCSP endpoints and/or CRL |
| 58 | +distribution points specified in a server's certificate may experience |
| 59 | +connectivity issues (e.g. if the application is behind a firewall with |
| 60 | +an outbound whitelist). This is because the driver needs to contact |
| 61 | +the OCSP endpoints and/or CRL distribution points specified in the |
| 62 | +server’s certificate and if these OCSP endpoints and/or CRL |
| 63 | +distribution points are not accessible, then the connection to the |
| 64 | +server may fail. In such a scenario, connectivity may be able to be |
| 65 | +restored by disabling certificate revocation checking by adding |
| 66 | +`tlsDisableCertificateRevocationCheck=true` to the application's connection |
| 67 | +string. |
0 commit comments