Upgrading from Percona Server for MongoDB 6.0 to 7.0¶
Considerations¶
1.To upgrade Percona Server for MongoDB to version 7.0, you must be running version 6.0. Upgrades from earlier versions are not supported.
-
Before upgrading your production Percona Server for MongoDB deployments, test all your applications in a testing environment to make sure they are compatible with the new version. For more information, see Compatibility Changes in MongoDB 7.0
-
If you are using data-at-rest-encryption with KMIP server, check the upgrade considerations
-
If you run Amazon Linux 2023, consider the following:
We build and test Percona Server for MongoDB only on the latest versions of Amazon Linux 2023. Because of the way Amazon Linux updates their libraries, Percona Server for MongoDB works only on specific Amazon Linux versions.
The following table shows Percona Server for MongoDB versions that are supported on specific versions of Amazon Linux 2023:
Percona Server for MongoDB version Amazon Linux 2023 version 7.0.16-10 2023.6.x and earlier 7.0.18-11 2023.7.x and newer To upgrade Percona Server for MongoDB, make sure that you run a compatible version of Amazon Linux 2023. Use the update instructions to update the operating system.
We recommend to upgrade Percona Server for MongoDB from official Percona repositories using percona-release
repository management tool and
the corresponding package manager for your system.
This document describes this method for the in-place upgrade (where your existing data and configuration files are preserved).
Prerequisites¶
Before the upgrade, do the following:
-
Make a full backup of your data and configuration files
-
In Percona Server for MongoDB 7.0, journaling is enabled by default. Both the
storage.journal.enabled
configuration option and the corresponding--journal
,--no-journal
command-line options are ignored. You receive the corresponding warning during the server start after the upgrade. To get rid of this warning, change your configuration to remove the journaling options.
-
Stop the
mongod
service:$ sudo systemctl stop mongod
-
Enable Percona repository for Percona Server for MongoDB 7.0:
$ sudo percona-release enable psmdb-70
-
Update the local cache:
$ sudo apt update
-
Install Percona Server for MongoDB 7.0 packages:
$ sudo apt install percona-server-mongodb
-
Start the
mongod
instance:$ sudo systemctl start mongod
For more information, see Installing Percona Server for MongoDB on Debian and Ubuntu.
-
Stop the
mongod
service:$ sudo systemctl stop mongod
-
Enable Percona repository for Percona Server for MongoDB 7.0:
$ sudo percona-release enable psmdb-70
-
Install Percona Server for MongoDB 7.0 packages:
$ sudo yum install percona-server-mongodb
-
Start the
mongod
instance:$ sudo systemctl start mongod
After the upgrade, Percona Server for MongoDB is started with the feature set of 6.0 version. Assuming that your applications are compatible with the new version, enable 7.0 version features. Run the following command against the admin
database:
> db.adminCommand( { setFeatureCompatibilityVersion: "7.0", confirm: true } )
See also
MongoDB Documentation: