Upgrade to MongoDB Enterprise (Replica Set)

MongoDB Enterprise provides various features not available in theMongoDB Community edition, such as:

The following steps outline the procedure to upgrade a replica set fromthe MongoDB Community Edition to the MongoDB Enterprise Edition. Forexample, the steps can be used to MongoDB 4.0 Community to MongoDB 4.0Enterprise.

Consideration

Warning

Do not use these instructions to upgrade to another release version.To upgrade release versions, refer to the appropriate releaseupgrade instructions, such as Upgrade to MongoDB 4.2.

Download Enterprise Binaries

Depending on your operating system, you can install the MongoDBEnterprise binaries by using a package manager or by downloading thebinaries manually.

  • Linux (Package Manager)
  • Linux (Manual Download)
  • Windows
  • macOS

If you have installed MongoDB Community using a packagemanager, follow the package manager instructions for youroperating system:

During the installation, the package manager will remove thecommunity packages; this will not affect the runningdeployment until you restart.

If you have not installed MongoDB using a package manager,you can manually download the MongoDB binaries from theMongoDB Download Center. Followthe manual instructions, including specific prerequisitesfor MongoDB Enterprise, for your operating system:

Important

Install to a location different from that of your currentCommunity edition.

In the upgrade procedure, you will use the existing datadirectory and, if applicable, the existing configurationfile.

Important

You cannot use the .msi to install the Enterpriseedition if you have the Community edition of the samerelease series installed on the same machine. That is, ifyou have version 4.0.0 Community edition installed, youcannot use the .msi to install the 4.0.0 or 4.0.1Enterprise edition.

To install, extract/unzip the file to a locationdifferent from that of your current Communityedition.

In the upgrade procedure, you will use the existingdata directory and, if applicable, the existingconfiguration file.

Install the binaries:

Extract the files to a location differentfrom that of your current Community edition. Fordetails on extracting the files, see macOS.

In the upgrade procedure, you will use the existingdata directory and, if applicable, the existingconfiguration file.

Procedure

To minimize downtime, you can upgrade from MongoDB Community toEnterprise Edition using a “rolling” upgrade by upgrading the membersindividually while the other members are available.

Upgrade secondary members of the replica set.

Upgrade the secondary membersof the replica set one at a time:

  • Shut down the mongod instance.
  • Restart with the Enterprise mongod, specifying thesame configuration options (e.g. same data directory,configuration file, etc.).Wait for the member to recover to SECONDARY state beforeupgrading 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 users.stepDown() to step down the primary and force anelection of a new primary.

Upgrade the primary.

When rs.status()shows that the primary has stepped down and another memberhas assumed PRIMARY state, upgrade the stepped-down primary:

  • Shut down the stepped-down primary.
  • Restart with the Enterprise mongod, specifying thesame configuration options (e.g. same data directory,configuration file, etc.).

Important

Before using any Enterprise features, ensure that all members havebeen upgraded to Enterprise edition.