How to upgrade

The MongoDB charm supports minor version upgrades on both replica sets and sharded clusters.

This overview page contains:

• Supported charm revisions that are safe to upgrade to or from
• Important considerations before upgrading
• Next steps to begin the upgrade process

Supported revisions

Below is a list of 6/stable revisions of Charmed MongoDB that support upgrades. If you wish to upgrade to/from a different revision, then perform a cluster migration via backup.

• Revision 164
• Revision 199

Before upgrading

Before upgrading, there are some important considerations to take into account:

• Current state of your deployment
• Concurrency with other operations during the upgrade
• Backing up your data

Current state of your deployment

Before upgrading your Charmed MongoDB deployment, ensure that it is both active and idle with juju status. The deployment should be healthy and not performing and long running operations such as creating a backup.

Concurrency with other operations

We strongly recommend users to not perform any other extraordinary operations on Charmed MongoDB cluster while upgrading, as it can lead the cluster into inconsistent states.

Some examples of extraordinary are operations (but not limited to) the following:

• Adding or removing units
• Creating or destroying new relations
• Upgrading other connected/related/integrated applications simultaneously

Backups

Make sure to have a backup of your data when running any type of upgrade. Guides on how to make a backup can be found here.

Next steps

Once you are ready to upgrade, proceed with:

1. Revisions that support upgrades
2. Perform a minor upgrade on a replica set
3. Perform a minor upgrade on a sharded cluster