The following procedures allow you to pin or unpin the FCV for your cluster, downgrade your cluster by one major version, or file a support ticket.
Limitations
The following limitations apply to downgrading your cluster's version:
You can only downgrade your cluster using the procedure on this page if you pinned the FCV before upgrading.
You can only downgrade your cluster to the major version that matches the pinned FCV.
You can only perform this action if the pinned FCV is only one major version below the current FCV and you don't have rapid release enabled.
You can't downgrade to a version after it reaches end-of-life. Ensure pinning occurs before the current version reaches end-of-life.
FCV pinning is only available on Dedicated clusters.
FCV pinning can't be extended beyond 4 weeks from the pin date.
If a downgrade is necessary, and you did not pin the FCV before upgrading, you can:
Restore to a specific point in time:
If you have Continuous Cloud Backup enabled for your cluster, you can perform a PIT restore to restore your cluster to a previous state with the older MongoDB version:
Create a new cluster with the previous major version.
Perform a PIT restore using the instructions in Restore from Continuous Cloud Backup.
Restore from an Atlas snapshot:
If you have Cloud Backup enabled without continuous cloud backups, consider restoring the latest snapshot of the cluster based on the previous version to a new cluster:
Create a new cluster with the previous major version.
Restore the latest snapshot before the MongoDB version upgrade to the new cluster using the instructions in Restore from a Scheduled or On-Demand Snapshot.
Required Access
To downgrade a cluster by a major version, pin the FCV for your cluster,
or unpin the FCV for your cluster, you must have the Project Owner
or higher role for the project.
Pin the FCV for Your Cluster
When your cluster has a pinned FCV, a pin icon appears next to your cluster's Version at the bottom of the cluster card. If you hover your cursor over the pin icon, a tooltip that shows the FCV and the expiration date appears.
Atlas unpins your cluster's FCV on the next maintenance window starting on or after the expiration date.
If you already upgraded your cluster's MongoDB version, Atlas upgrades its FCV to match its MongoDB version after the pin expires.
To pin the FCV for your cluster:
In Atlas, go to the Clusters page for your project.
If it's not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.
If it's not already displayed, select your desired project from the Projects menu in the navigation bar.
In the sidebar, click Clusters under the Database heading.
The Clusters page displays.
Set the expiration date.
All dates are set to Timestamp in ISO 8601 date and time format in UTC, in the MM/DD/YYYY format. Set the FCV expiration date
to be within four weeks of the date to which you pinned the FCV. When the expiration date passes, the tooltip displays
Expired XX/XX/XXXX. Your FCV pin automatically expires after 4 weeks.
After the FCV pin expires, Atlas unpins your cluster's FCV on the next maintenance window starting on or after the expiration date. If you already upgraded your cluster's MongoDB version, Atlas upgrades its FCV to match its MongoDB version.
To pin the FCV for your cluster using the Atlas Administration API, see Pin FCV for One Cluster from One Project.
Unpin the FCV for Your Cluster
To unpin the FCV for your cluster:
In Atlas, go to the Clusters page for your project.
If it's not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.
If it's not already displayed, select your desired project from the Projects menu in the navigation bar.
In the sidebar, click Clusters under the Database heading.
The Clusters page displays.
To unpin the FCV for your cluster using the Atlas Administration API, see Unpin FCV for One Cluster from One Project.
Downgrade Your Cluster by One Major Version
To downgrade your cluster by one major version:
In Atlas, go to the Clusters page for your project.
If it's not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.
If it's not already displayed, select your desired project from the Projects menu in the navigation bar.
In the sidebar, click Clusters under the Database heading.
The Clusters page displays.
To downgrade your cluster by one major version using the API, see Modify One Cluster from One Project.
Contact Support
If you have any questions regarding migration support beyond what is covered in this documentation, or if you encounter an error during migration, file a support ticket through the Atlas user interface.
If you have any questions or need further assistance, reach out to our support team.