- Release Notes for MongoDB 4.0
- Minor Releases
- Multi-Document Transactions
- Aggregation
- MongoDB Drivers
- Security
- Deprecate MMAPv1
- Replica Set
- Change Streams
- Free Monitoring
- Sharded Clusters
- .msi Installer on Windows
- Platform Support
- MongoDB Tools
- General Improvements
- Changes Affecting Compatibility
- Upgrade Procedures
- Download
- Known Issues in 4.0.3
- Known Issues in 4.0.2
- Known Issues in 4.0.1
- Known Issues in 4.0.0
- Fixed in 4.0.1
- Fixed in 4.0.1
Release Notes for MongoDB 4.0
Minor Releases
4.0.13 - Oct 19, 2019
Issues fixed:
- SERVER-37690: countDocuments throws an error when matching 0 document
- SERVER-41939: Connect to fastest LDAP server first
- WT-4869: Stop adding cache pressure when eviction is falling behind
- WT-4882: Improve checkpoint performance when there are large metadata pages
- WT-4898: Don’t allow the eviction server to reconcile if it’s busy
- All JIRA issues closed in 4.0.13%20AND%20resolution%3D%27Fixed%27%20and%20fixversion%3D%274.0.13%27)
- 4.0.13 Changelog
4.0.12 - Aug 12, 2019
Issues fixed:
- SERVER-41829: findAndModify ignores filter expressions that are not objects.
- SERVER-42603: Recent service file change may cause cyclic dependencies.
- All JIRA issues closed in 4.0.12%20AND%20resolution%3D%27Fixed%27%20and%20fixversion%3D%274.0.12%27)
- 4.0.12 Changelog
4.0.11 - Jul 26, 2019
Issues fixed:
- SERVER-39756: Sharding a very large collection can result ina long stall of writes against this collection
- SERVER-40134: Distinct command against a view can returnincorrect results when the distinct path is multikey
- SERVER-40535: Possibility to get a non-existent key if usingReadConcern level:local when reading signing keys in ReplicaSet
- SERVER-41361: Do not read at lastApplied while already holding the PBWM lock on secondaries
- SERVER-41869: Reverse mutex acquisition order in CatalogCache::_scheduleCollectionRefresh
- SERVER-42055: Only acquire a collection IX lock to write the lastVote document
- SERVER-42232: Adding a new shard renders all precedingresume tokens invalid
- All JIRA issues closed in 4.0.11%20AND%20resolution%3D%27Fixed%27%20and%20fixversion%3D%274.0.11%27)
- 4.0.11 Changelog
Note
Fixed issues include those that resolve the following CommonVulnerabilities and Exposures (CVEs):
- CVE-2019-2389 (See SERVER-40563)
- CVE-2019-2390 (See SERVER-42233)
4.0.10 - May 31, 2019
Issues fixed:
- SERVER-37765: Remove Support for Ubuntu 14.04
- SERVER-30356: Improve error report for validate command
- SERVER-38867: Refine handling of system.* collections in listCollections/show collections
- SERVER-39672: Default to
"local"
read concern if unspecified for multi-document transactions - WT-4769: Don’t discard active history for empty pages
- All JIRA issues closed in 4.0.10%20AND%20resolution%3D%27Fixed%27%20and%20fixversion%3D%274.0.10%27)
- 4.0.10 Changelog
4.0.9 - Apr 16, 2019
Issues fixed:
- SERVER-38949: Incorrect index bounds for {$ne: [“String”]} query
- SERVER-38984: Attach IDs to users
- SERVER-39178: Negotiate SCRAM mechanism in MongoURI::connect()
- SERVER-40333: Only clone collection options once for each shard on shard collection
- All JIRA issues closed in 4.0.9%20AND%20resolution%3D%27Fixed%27%20and%20fixversion%3D%274.0.9%27)
- 4.0.9 Changelog
Note
Fixed issues include those that resolve the following CommonVulnerabilities and Exposures (CVEs):
- CVE-2019-2386 (See SERVER-38984)
4.0.8 - Mar 29, 2019
Issues fixed:
- SERVER-40355: rs.config that contains an
_id
greater than the number of nodes will crash - SERVER-38994: Step down on SIGTERM. See SIGTERM and Replica Sets.
- SERVER-37722: Quiet mode does not suppress connection end events
- SERVER-37389: Give different messages for different connection failure reasons
- All JIRA issues closed in 4.0.8%20AND%20resolution%3D%27Fixed%27%20and%20fixversion%3D%274.0.8%27)
- 4.0.8 Changelog
4.0.7 - Mar 25, 2019
Issues fixed:
- SERVER-13779: Allow $not to be applied to $regex (currently only /regex/ syntax is allowed)
- SERVER-35740: Report high-water-mark resume token with each (possibly empty) change stream batch
- TOOLS-2158: mongodump failing on Windows with “error opening system CA store: Access is denied.”
- All JIRA issues closed in 4.0.7%20AND%20resolution%3D%27Fixed%27%20and%20fixversion%3D%274.0.7%27)
- 4.0.7 Changelog
4.0.6 - Feb 7, 2019
Issues fixed:
- SERVER-37778: Platform Support: Add Community & Enterprise Ubuntu 18.04 (zSeries)
- SERVER-37777: Platform Support: Add Community SLES12 (zSeries)
- SERVER-37775: Platform Support: Add Community RHEL7 (zSeries)
- SERVER-39180: Wrong initial chunk owner shard can be selected when sharding non-empty collection with pre-created zones
- SERVER-32146: Log slow oplog entry application
- SERVER-38293: Make listDatabases understand collection privileges
- SERVER-38887: Mongo.getDBs() does not correctly inspect privileges
- All JIRA issues closed in 4.0.6%20AND%20resolution%3D%27Fixed%27%20and%20fixversion%3D%274.0.6%27)
- 4.0.6 Changelog
4.0.5 - Dec 20, 2018
Issues fixed:
- SERVER-36437: The dbstats command should lock the database in MODE_IS instead of MODE_S
- SERVER-37182: Different values when referencing whole object vs. a field of that object after $arrayToObject
- SERVER-37200: $match stage following $listSessions not working against mongos
- SERVER-37557: Add startup warning about enableMajorityReadConcern and usage of arbiters
- All JIRA issues closed in 4.0.5%20AND%20resolution%3D%27Fixed%27%20and%20fixversion%3D%274.0.5%27)
- 4.0.5 Changelog
4.0.4 - Nov 8, 2018
Issues fixed:
- SERVER-26854: LockStats for sub-operations should not include time for previous sub ops
- SERVER-35323: sessionId matching ignores userId part of the lsid
- SERVER-37058: Update with numeric field names inside an array can cause validation to fail
- SERVER-37132: Negation of $in with regex can incorrectly plan from the cache, leading to missing query results
- TOOLS-2069: mongoreplay does not support SCRAM-SHA-256
- TOOLS-2131: mongorestore hang in replaying oplog with –archive and –oplogReplay option
- All JIRA issues closed in 4.0.4%20AND%20resolution%3D%27Fixed%27%20and%20fixversion%3D%274.0.4%27)
- 4.0.4 Changelog
4.0.3 - Oct 9, 2018
Issues fixed:
- SERVER-19815: Make repair more robust with the WiredTiger storage engine
- SERVER-35989:
db.collection.countDocuments()
anddb.collection.estimatedDocumentCount()
helpers - SERVER-36982: Reintroduce
enableMajorityReadConcern:false
server parameter - All JIRA issues closed in 4.0.3%20AND%20resolution%3D%27Fixed%27%20and%20fixversion%3D%274.0.3%27)
- 4.0.3 Changelog
4.0.2 - Aug 29, 2018
Issues fixed:
- SERVER-35720: Allow zones to be created on non-existent collection
- SERVER-35441: drop/dropDatabase does not cleanup config.tags
- SERVER-36102: Create initial chunks on appropriate shards for zoned sharding
- SERVER-36070: Aggregation with $out results in error when Auditing is enabled
- SERVER-34846: Covered index with collated field returns incorrect result when collation not involved in match or sort
- SERVER-34664: Commands that are unsupported in a transaction should error
- All JIRA issues closed in 4.0.2%20AND%20resolution%3D%27Fixed%27%20and%20fixversion%3D%274.0.2%27)
- 4.0.2 Changelog
4.0.1 - Aug 6, 2018
Issues fixed:
- SERVER-33000: Platform Support: add Ubuntu 18.04.
- SERVER-34933: PCRE verb support.
- SERVER-35101: Handle bindIp argument that contains whitespaces.
- SERVER-36027: Enterprise build does not recognize the
—redactClientLogData
flag. - All JIRA issues closed in 4.0.1%20AND%20resolution%3D%27Fixed%27%20and%20fixversion%3D%274.0.1%27)
- 4.0.1 Changelog
Multi-Document Transactions
Starting in version 4.0, MongoDB provides the ability to performmulti-document transactions against replicasets. With multi-document transactions, until a transaction commits, nowrite operations in the transaction are visible outside thetransaction. That is, the multi-document transactions are atomic.
Important
In most cases, multi-document transaction incurs a greaterperformance cost over single document writes, and theavailability of multi-document transactions should not be areplacement for effective schema design. For many scenarios, thedenormalized data model (embedded documents and arrays) will continue to be optimal for yourdata and use cases. That is, for many scenarios, modeling your dataappropriately will minimize the need for multi-documenttransactions.
For additional transactions usage considerations(such as runtime limit and oplog size limit), see alsoProduction Considerations.
Feature Compatibility
The featureCompatibilityVersion
of all members of the replica setmust be 4.0
or greater. To check thefeatureCompatibilityVersion
for a member, connect to the member andrun the following command:
- db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
For more information on the featureCompatibilityVersion
flag, seesetFeatureCompatibilityVersion
.
mongo Shell Methods
Method | Description |
---|---|
Session.startTransaction() | Starts a multi-statement transaction. |
Session.commitTransaction() | Commits the transaction. |
Session.abortTransaction() | Aborts the transaction. |
MongoDB Drivers
Clients require MongoDB drivers updated for MongoDB 4.0 to use transactions.
Read Concern snapshot
MongoDB 4.0 introduces a new read concern level"snapshot"
for multi-document transaction.
For a multi-document transaction, MongoDBmay sometimes substitute a stronger read concern for"local"
and "majority"
read concern.
For a list of all operations that accept read concerns, seeOperations That Support Read Concern.
Read Preference
Multi-document transactions that containread operations must use read preference primary
. Alloperations in a given transaction must route to the same member.
Commands
abortTransaction
- Use the corresponding driver method or
mongo
shellhelperSession.abortTransaction()
instead.
commitTransaction
- Use the corresponding driver method or
mongo
shellhelperSession.commitTransaction()
instead.
Locks
By default, multi-document transactionswait 5
milliseconds to acquire locks required by the operations inthe transaction. If the transaction cannot acquire its required lockswith the 5
milliseconds, the transaction aborts.
You can use the maxTransactionLockRequestTimeoutMillis
parameter to adjust how long transactions wait to acquire locks.
Transactions release all locks upon abort or commit.
$currentOp
The aggregation pipeline stage $currentOp
(and thecurrentOp
command and mongo
shell helperdb.currentOp()
method) return information on inactive sessionswhich are holding locks as part of a transaction.
Parameters
transactionLifetimeLimitSeconds
to specify the lifetimefor a multi-document transaction afterwhich the transaction is considered expired and will be aborted whenthe periodic cleanup process next runs.maxTransactionLockRequestTimeoutMillis
to specify howlong multi-document transactions shouldwait to aquire locks required by the operations in the transaction.
Aggregation
New Type Conversion Operators
MongoDB 4.0 adds the following new aggregation operators for typeconversion:
Operator | Description |
---|---|
$convert | Convert value to specified type. |
$toBool | Convert value to boolean. |
$toDate | Convert value to Date. |
$toDecimal | Convert value to Decimal128. |
$toDouble | Convert value to Double. |
$toInt | Convert value to integer. |
$toLong | Convert value to long. |
$toObjectId | Convert value to ObjectId. |
$toString | Convert value to string. |
New String Operators
MongoDB 4.0 adds the following new aggregation string operators:
Operator | Description |
---|---|
$ltrim | Removes whitespace or the specified characters from thebeginning of a string. |
$rtrim | Removes whitespace or the specified characters from the end of astring. |
$trim | Removes whitespace or the specified characters from thebeginning and end of a string. |
Additional Improvements
$bucket
The $bucket
stage no longer requires boundaries
document arguments to be wrapped in $literal
.
$dateToString
The $dateToString
aggregation operator has the followingoption changes:
Note
Requires featureCompatibilityVersion
(fcv) set to "4.0"
or greater.
- A new option
onNull
specifies the value to return if thedate
is null or missing. - The option
format
is now optional.
$dateFromParts
If the value specified for fields other than year
, isoYear
, andtimezone
is outside the valid range, $dateFromParts
carries or subtracts the difference from other date parts to calculatethe date. For more information, see Value Range.
$dateFromString
The $dateFromString
aggregation operator takes anoptional format
field.
$currentOp
The aggregation pipeline stage $currentOp
supports thefollowing new options:
idleSessions
option to return information on inactive sessionswhich are holding locks as part of a transaction.localOps
option to report operations that are running locally onthe currentmongos
instance, rather than reportingoperations that are running on the shards.
MongoDB Drivers
The following drivers are feature compatible with MongoDB 4.0:
- Java 3.8.0- Python 3.7.0- C 1.11.0 | - C# 2.7- Node 3.1.0- Ruby 2.6.0 | - Perl 2.0.0- PHPC 1.5.0- Scala 2.4.0 |
Security
Add Support for SCRAM-SHA-256
Note
To use SCRAM-SHA-256, thefeatureCompatibilityVersion
must be set to 4.0
. For moreinformation on featureCompatibilityVersion, see View FeatureCompatibilityVersion andsetFeatureCompatibilityVersion
.
MongoDB adds support for SCRAM authenticationmechanism SCRAM-SHA-256, which uses the SHA-256hash function. To modify the iteration count for SCRAM-SHA-256
,MongoDB adds a new parameter scramSHA256IterationCount
.
New Option for Create and Update User Operations
When creating or updating a SCRAM user, you can indicate the specificSCRAM mechanism or mechanisms to use for the user credentials.Specifically, MongoDB 4.0 adds the mechanisms
option to thefollowing commands and mongo
shell helpers:
Command | Method |
---|---|
createUser | db.createUser() |
updateUser | db.updateUser() |
When using SCRAM-SHA-256
, MongoDB (i.e. the server) requiresundigested password. Starting in MongoDB 4.0, the default value ofdigestPassword
is true
for createUser
, and thedefault value of passwordDigestor
is "server"
. In earlierMongoDB versions, digestPassword
is false
and client
respectively.
New Option for isMaster Command
Starting in MongoDB 4.0, the isMaster
command accepts anoptional field saslSupportedMechs: <db.user>
to return anadditional field isMaster.saslSupportedMechs
in its result.
isMaster.saslSupportedMechs
is an array of SASL mechanisms usedto create the specified user’s credentials.
Remove Support for MONGODB-CR
Starting in version 4.0, MongoDB removes support for the deprecatedMongoDB Challenge-Response (MONGODB-CR
) authentication mechanism.
Since version 3.0, MongoDB has not supported the creation ofMONGODB-CR
users unless the deployment had been upgraded from a 2.6or earlier deployment that already had MONGODB-CR
users and had notupgraded the authentication schema.
If your deployment has user credentials stored in MONGODB-CR
schema, you must upgrade to Salted Challenge ResponseAuthentication Mechanism (SCRAM)before youupgrade to version 4.0. For information on upgrading to SCRAM
, seeUpgrade to SCRAM.
usersInfo Enhancement
The usersInfo
command can return information across all databasesby specifying:
- { usersInfo: { forAllDBs: true } }
The usersInfo
and the mongo
shell helpersdb.getUser()
and db.getUsers()
method accept a newoptional filter
document. The filter document specifies$match
stage conditions to return information only forusers that match the conditions.
The usersInfo
command and the mongo
shell helpersdb.getUser()
and db.getUsers()
method return themechanisms
field for the user.
TLS/SSL
Starting in version 4.0, MongoDB uses the native TLS/SSL OS libraries:
Windows | Secure Channel (Schannel) |
Linux/BSD | OpenSSL |
macOS | Secure Transport |
Associated with this change, the parameteropensslCipherConfig
is supported for Linux/BSD and nolonger supported in Windows and macOS.
TLS 1.2 Support
MongoDB 4.0 binaries for macOS support TLS 1.2.
Disable TLS 1.0
MongoDB binaries (mongod
, mongos
, andmongo
) disables support for TLS 1.0 encryption onsystems where TLS 1.1+ is available.
If you need to support TLS 1.0:
For
mongod
instances, you can specifynone
tonet.ssl.disabledProtocols
or—sslDisabledProtocols none
.For
mongos
instances, you can specifynone
tonet.ssl.disabledProtocols
or—sslDisabledProtocols none
.For the
mongo
shell, you can specify—sslDisabledProtocols none
.
The —sslDisabledProtocols
option is available for the mongo
shell in:
- MongoDB version 4.0+
- MongoDB version 3.6.5+
- MongoDB version 3.4.15+
On macOS, to connect mongo
shell version 3.6.4 orearlier to a MongoDB 4.0+ deployment requires explicit enabling of TLS1.0.
AES-GCM
MongoDB Enterprise on Windows no longer supports AES256-GCM
. Thiscipher is now available only on Linux.
See also
Enable System Store for TLS/SSL on Windows and macOS
New Privilege Actions
To support free Cloud monitoring, MongoDBadds the following privilege actions available for the cluster
resource:
MongoDB modifies the clusterMonitor
role to include theseprivileges.
x.509 Authentication Certificate Restrictions
Starting in MongoDB 4.0, if you specify—sslAllowInvalidCertificates
ornet.ssl.allowInvalidCertificates: true
(or in MongoDB 4.2, thealias —tlsAllowInvalidateCertificates
ornet.tls.allowInvalidCertificates: true
) when using x.509authentication, an invalid certificate is only sufficient toestablish a TLS/SSL connection but is insufficient forauthentication.
If you are using invalid certificates to perform x.509 authentication,update your certificates to valid certificates. For example, you maysign your existing certificates with a trusted CA, or if using a customCA, specify that CA using net.ssl.CAFile
.
Enable System Store for TLS/SSL on Windows and macOS
The —sslCertificateSelector
option (certificateSelector
setting) allowsmongod
, mongo
shell andmongos
to use system SSL certificate stores for Windowsand macOS.
The —sslClusterCertificateSelector
option(clusterCertificateSelector
setting) allowsmongod
andmongos
to use system TLS/SSL certificate stores for Windowsand macOS for internal TLS/SSL communication within a cluster.
The option —kmipClientCertificateSelector
(security.kmip.clientCertificateSelector
) allowsmongod
and mongos
to use system TLS/SSLcertificate stores for Windows and macOS when using TLS/SSL connection to theKMIP server.
Deprecate MMAPv1
Starting in version 4.0, MongoDB deprecates the MMAPv1 storage Engineand will remove MMAPv1 in a future release.
To change your MMAPv1 storage engine deployment toWiredTiger Storage Engine, see:
Replica Set
Remove pv0 for Replica Sets
MongoDB 4.0 removes the deprecated replica set protocol version 0pv0
.
Before upgrading to MongoDB 4.0, you must upgrade to pv1
.
To upgrade to pv1
, connect a mongo
shell to thereplica set primary and perform the following sequence of operations:
- cfg = rs.conf();
- cfg.protocolVersion=1;
- rs.reconfig(cfg);
You can use catchUpTimeoutMillis
to prioritizebetween faster failovers and preservation of w:1
writes.
For more information on pv1
, seeReplica Set Protocol Version.
Remove Master-Slave Replication
MongoDB 4.0 removes support for the deprecated master-slavereplication. Before you can upgrade to MongoDB 4.0, if your deploymentuses master-slave replication, you must upgrade to a replica set.
To convert your master-slave replication, seeConvert a Master-Slave Deployment to a Replica Set.
Journaling and Replica Sets
Starting in MongoDB 4.0, you cannot specify —nojournal
option or storage.journal.enabled:false
for replica set members that use theWiredTiger storage engine.
rollbackTimeLimitSecs Parameter Available
Starting in MongoDB 4.0, a new rollbackTimeLimitSecs
parameter allows for the setting of the time limit in seconds betweenthe common point and the last oplog write entry for the memberindicated for rollback. The default rollback time limit is 1 day.
Wait for Background Index Builds
Starting in version 4.0, MongoDB waits for any in-progressbackground index builds to finishbefore starting a rollback.
Rollback Files
MongoDB adds the parameter createRollbackDataFiles
thatdetermines whether during a rollback, MongoDB creates rollback filesthat contains documents affected during the rollback.
replSetGetStatus Output Changes
The replSetGetStatus
returns the following new fields:
The following fields returned from replSetGetStatus
aredeprecated:
Oplog Size
Starting in MongoDB 4.0, the oplog can grow past its configured sizelimit to avoid deleting the majority commit point
.
Change Streams
Database and Deployment Change Streams
MongoDB adds the ability to:
- Open a change stream cursor for a singledatabase (excluding
admin
,local
, andconfig
database) towatch for changes to all its non-system
collections. - Open a change stream cursor for a deploymentto watch for changes to all non-
system
collections across alldatabases except foradmin
,local
, andconfig
.
Note
Requires featureCompatibilityVersion
(fcv) set to "4.0"
or greater.
Start Time Option
MongoDB adds the ability to specify a start time(startAtOperationTime
option) for a change stream.
Change Event Document Changes
The change event documents includethe new fields:
- the
clusterTime
which corresponds to timestamp from the oplogentry for the event. - the
txnNumber
and thelsid
if the operation is part of amulti-document transaction.
Resume Token Data Type Change
MongoDB 4.0 introduces new hex-encoded string change streams resume tokens:
The resume token _data
type depends on the MongoDB versions and,in some cases, the feature compatibility version (fcv) at the timeof the change stream’s opening/resumption (i.e. a change in fcvvalue does not affect the resume tokens for already opened changestreams):
MongoDB Version | Feature Compatibility Version | Resume Token _data Type |
---|---|---|
MongoDB 4.0.7 and later | “4.0” or “3.6” | Hex-encoded string (v1 ) |
MongoDB 4.0.6 and earlier | “4.0” | Hex-encoded string (v0 ) |
MongoDB 4.0.6 and earlier | “3.6” | BinData |
MongoDB 3.6 | “3.6” | BinData |
With hex-encoded string resume tokens, you can compare and sort theresume tokens.
Regardless of the fcv value, a 4.0 deployment can useeither BinData resume tokens or hex string resume tokens to resume achange stream. As such, a 4.0 deployment can use a resumetoken from a change stream opened on a collection from a 3.6deployment.
New resume token formats introduced in a MongoDB versioncannot be consumed by earlier MongoDB versions.
A 3.6 deployment can, however, use the BinData resume token returnedfrom a change stream opened against a collection from a deploymentwith fcv 3.6
. However, a 3.6 deployment cannot use thehex-encoded string resume tokens.
mongo Shell Methods
Method | Description |
---|---|
db.watch() | Opens a change stream cursor for a single database(excluding admin , local , and config database) towatch for changes to all its non-system collections.For the corresponding MongoDB driver method, refer to yourdriver documentation. |
Mongo.watch() | Opens a change stream cursor for adeployment to watch for changes to all non-system collections across all databases except for admin ,local , and config .For the corresponding MongoDB driver method, refer to yourdriver documentation.New in version 4.0. |
Free Monitoring
MongoDB 4.0 (Community Edition) offers free Cloud monitoring for standalone or replica sets.
Enable/Disable
By default, you can enable/disable free monitoring during runtimeusing:
mongo Shell Methods | Command |
---|---|
db.enableFreeMonitoring() db.disableFreeMonitoring() | setFreeMonitoring |
You can also enable or disable free monitoring at startup using either:
- the configuration file setting
cloud.monitoring.free.state
or - the command-line option
—enableFreeMonitoring
View Status
To view the state of your free monitoring, MongoDB provides thefollowing command and shell helper:
mongo Shell Methods | Command |
---|---|
db.getFreeMonitoringStatus() | getFreeMonitoringStatus |
The serverStatus
and the helperdb.getServerStatus()
also includes free monitoring statisticsin the freeMonitoring
field.
Access Control
To support free Cloud monitoring, MongoDB adds the following privilegeactions available for the cluster
resource:
The built-in role clusterMonitor
includes the new privilegeactions.
Sharded Clusters
mongos
uses "majority"
for thefollowing operations that affect the sharded cluster metadata:
.msi Installer on Windows
Starting in MongoDB 4.0, you can configure and start MongoDB as aservice during the install.
Platform Support
- MongoDB 4.0 (Community & Enterprise) adds support for:
- MongoDB 4.0 (Community) adds support for:
- s390x RHEL 6.x
- MongoDB 4.0 does not support SLES 11.
- Support for SLES 11 has also been removed in MongoDB 3.2.20+,3.4.15+, and 3.6.4+.
- MongoDB 4.0 does not support Ubuntu 12.04.
- Support for Ubuntu 12.04 has also been removed in MongoDB 3.2.20+,3.4.15+, and 3.6.4+.
- Support for Ubuntu 12.04 has also been removed in MongoDB 3.2.20+,3.4.15+, and 3.6.4+.
- In future releases, MongoDB will end support for the followingplatforms:
- Windows 7/2008R2
- Windows 8/2012
- Windows 8.1/2012R2
- Ubuntu 14.04
Refer to Supported Platforms for the full platformsupport matrix.
MongoDB Tools
mongoreplay play
supports a new MONGOREPLAY_HOST
environment variable that specifies the MongoDB connection string whenrunning mongoreplay play
. The new environment vairable can be usedinstead of the command-line —host
option.
For example, to play back a recording to a mongod
instance running with authentication mongodb1.example.net:27017
, you can specify the connection string in:
- The
MONGOREPLAY_HOST
environment variable:
- export MONGOREPLAY_HOST="mongodb://myUserName:s0meD1fficultPassw0rd@mongodb1.example.net:27017/?authSource=admin"
- mongoreplay play -p /some/path/to/my/recording.bson
- The
—host
command-line option
- mongoreplay play -p /some/path/to/my/recording.bson --host "mongodb://myUserName:s0meD1fficultPassw0rd@mongodb1.example.net:27017/?authSource=admin"
If —host
command-line option isspecified, the —host
value overridesthe environment variable.
General Improvements
Commands
- The command
listCollections
takes Intent Shared lock onthe database. In previous versions, the command takes Shared lock onthe database. - The command
listCollections
and itsmongo
shell helperdb.getCollectionInfos()
accepts the followingoption:nameOnly
to return only the collection names and types (whichdoes not require collection locks).authorizedCollections
to allow users without the requiredprivilege to runlistCollections
can run the command,withnameOnly: true, authorizedCollections: true
, to return thethe collection(s) to which the user has privileges.
- The command
serverStatus
and itsmongo
shell helperdb.serverStatus()
includesshardingStatistics
in its output. TheshardingStatistics
includes data on metadata refreshon sharded clusters. - The
mongo
shell helperdb.collection.drop()
accepts the write concern option. - For cursors created inside a session, you cannot call
getMore
outside the session. Similarly, for cursorscreated outside of a session, you cannot callgetMore
inside a session. - The command
dbHash
includes the following fields in itsoutput:capped
field that lists the capped collectionsuuids
field that contains the collections and theircorresponding UUIDs.
- The command
killOp
now supports termination of queries that arerunning on amongos
. When run on themongos
,killOp
can kill queries that are running in more than one shard.
Geospatial Query Improvements
- The geospatial query operators
$near
and$nearSphere
now supports querying on sharded collections. - As of MongoDB 4.0, the
$geoNear
aggregation operator andgeoNear
command support using theminDistance
optionwith 2d indexes. Similarly,$near
and$nearSphere
support the$minDistance
option for 2d indexes. Previously,minDistance
and$minDistance
were only available for 2dsphere indexes. - MongoDB 4.0 adds a
key
option for the$geoNear
aggregation operator andgeoNear
command that enablesusers to specify which geospatial index to use when querying acollection with multiple geospatial indexes. Previously, to use the$geoNear
aggregation operator orgeoNear
command, the collection could only have one geospatial index.
Network Layer Improvements
- For the parameter
taskExecutorPoolSize
, change defaultvalue to1
. - Add new parameter AsyncRequestsSenderUseBaton to enableperformance optimization on Linux for scatter/gather operations on
mongos
when using a singleTask Executorconnection pool
. - Added the following parameters to manage connection pools:
Configuration Options
mongos
supports:- Command line options:
slowms
and—slowOpSampleRate
- Configuration file options:
operationProfiling.slowOpThresholdMs
andoperationProfiling.slowOpSampleRate
- Command line options:
Miscellaneous
- The JavaScript engine’s JIT compiler is now disabled by default.
- Upgrades MozJS to ESR 45.9.0.
- Adds
RECOVERY
component to log messages. - MongoDB 4.0 adds support for using the
appName
connectionstring option for setting a custom app name when connecting from themongo
shell. Previously, only MongoDB drivers supportedusing theappName
to set a custom value and themongo
shell used the defaultMongoDB Shell
value as theapp name. - Adds a
mongo
shell methodconvertShardKeyToHashed
to return the hashed value for adocument. - Resolves
localhost
IP address as configured instead of assuming127.0.0.1
. - When using the DNS Seedlist Connection Format to connect to the
mongo
shell with authentication, themongo
shell will now prompt the user toprovide their password when starting up.
Changes Affecting Compatibility
Some changes can affect compatibility and may require user actions. Fora detailed list of compatibility changes, seeCompatibility Changes in MongoDB 4.0.
Upgrade Procedures
Feature Compatibility Version
To upgrade, the 3.6 instances must havefeatureCompatibilityVersion
set to 3.6
. To check the version:
- db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
For specific details on verifying and setting thefeatureCompatibilityVersion
as well as information on otherprerequisites/considerations for upgrades, refer to the individualupgrade instructions:
If you need guidance on upgrading to 4.0, MongoDB offers major versionupgrade servicesto help ensure a smooth transition without interruption to your MongoDB application.
Download
To download MongoDB 4.0, go to the MongoDB Download Center
See also
Known Issues in 4.0.3
- WT-4018:
- MongoDB 4.0 may lose data during unclean shutdowns on macOS 10.12.x and 10.13.x.
- SERVER-35431:
- After a rollback, the ‘dataSize’ field reported in
collStats
anddbStats
output can beinaccurate.
Known Issues in 4.0.2
- WT-4018:
- MongoDB 4.0 may lose data during unclean shutdowns on macOS 10.12.x and 10.13.x.
- SERVER-35431:
- After a rollback, the ‘dataSize’ field reported in
collStats
anddbStats
output can beinaccurate.
- SERVER-35657:
- Using multi-document transactions with a single-member replica setmay have significant performance impact. Single-member replica setsshould only be for testing/development purposes and are notrecommended for production use.
Note
Multi-document transactions performance on a single-memberreplica set are not indicative of performance on a replica setwith more than one member.
Known Issues in 4.0.1
- WT-4018:
- MongoDB 4.0 may lose data during unclean shutdowns on macOS 10.12.x and 10.13.x.
- SERVER-35431:
- After a rollback, the ‘dataSize’ field reported in
collStats
anddbStats
output can beinaccurate.
- SERVER-35657:
- Using multi-document transactions with a single-member replica setmay have significant performance impact. Single-member replica setsshould only be for testing/development purposes and are notrecommended for production use.
Note
Multi-document transactions performance on a single-memberreplica set are not indicative of performance on a replica setwith more than one member.
Known Issues in 4.0.0
- TOOLS-1952:
- Users running MongoDB 4.0
mongodump
may experienceslower performance compared to previous versions. Runningmongodump
with—forceTableScan
mayresolve performance issues.
- TOOLS-2058:
mongoreplay
does not show insert/find commands for MongoDB 4.0.
Fixed in 4.0.1
- WT-4018:
- MongoDB 4.0 may lose data during unclean shutdowns on macOS 10.12.x and 10.13.x.
- SERVER-35431:
- After a rollback, the ‘dataSize’ field reported in
collStats
anddbStats
output can beinaccurate.
- SERVER-35657:
- Using multi-document transactions with a single-member replica setmay have significant performance impact. Single-member replica setsshould only be for testing/development purposes and are notrecommended for production use.
Note
Multi-document transactions performance on a single-memberreplica set are not indicative of performance on a replica setwith more than one member.
- SERVER-35758:
- The shell prompt in the
mongo
shell will cause anerror if you use the session associated with the globaldb
object to run transactions.
Fixed in 4.0.1
Report an Issue
To report an issue, seehttps://github.com/mongodb/mongo/wiki/Submit-Bug-Reports forinstructions on how to file a JIRA ticket for the MongoDB server or oneof the related projects.
- Compatibility Changes in MongoDB 4.0
- Upgrade a Standalone to 4.0
- Upgrade a Replica Set to 4.0
- Upgrade a Sharded Cluster to 4.0
- Downgrade 4.0 Standalone to 3.6
- Downgrade 4.0 Replica Set to 3.6
- Downgrade 4.0 Sharded Cluster to 3.6
- 4.0 Changelog