Upgrade to MongoDB Enterprise (Replica Set)
MongoDB Enterprise provides various features not available in the MongoDB Community edition, such as:
The following steps outline the procedure to upgrade a replica set from the MongoDB Community Edition to the MongoDB Enterprise Edition. For example, the steps can be used to upgrade MongoDB 4.0 Community to MongoDB 4.0 Enterprise.
Consideration
Warning
Do not use these instructions to upgrade to another release version. To upgrade release versions, refer to the appropriate release upgrade instructions, such as Upgrade to MongoDB 4.4.
Download Enterprise Binaries
Depending on your operating system, you can install the MongoDB Enterprise binaries by using a package manager or by downloading the binaries manually.
Procedure
To minimize downtime, you can upgrade from MongoDB Community to Enterprise Edition using a "rolling" upgrade by upgrading the members individually while the other members are available.
Upgrade secondary members of the replica set.
Upgrade the secondary members of the replica set one at a time:
Shut down the
mongod
instance.Restart with the Enterprise
mongod
, specifying the same configuration options (e.g. same data directory, configuration file, etc.).
Wait for the member to recover to SECONDARY
state before
upgrading the next secondary member.
Step down the replica set primary.
Once all the secondary members have been upgraded to Enterprise,
connect a mongo
shell to the primary and use
rs.stepDown()
to step down the primary and force an
election of a new primary.
Upgrade the primary.
When rs.status()
shows that the primary has stepped down and another member
has assumed PRIMARY
state, upgrade the stepped-down primary:
Shut down the stepped-down primary.
Restart with the Enterprise
mongod
, specifying the same configuration options (e.g. same data directory, configuration file, etc.).
Important
Before using any Enterprise features, ensure that all members have been upgraded to Enterprise edition.