Upgrading from Percona Server for MongoDB 5.0 to 6.0¶

Considerations¶

To upgrade Percona Server for MongoDB to version 6.0, you must be running version 5.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 6.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

6.0.20-17 2023.6.x and earlier

6.0.21-18 2023.7.x

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).

Warning

Perform a full backup of your data and configuration files before upgrading.

Upgrade on Debian and Ubuntu Upgrade on Red Hat Enterprise Linux and derivatives

Stop the mongod service:
```
$ sudo systemctl stop mongod
```
Enable Percona repository for Percona Server for MongoDB 6.0:
```
$ sudo percona-release enable psmdb-60
```
Update the local cache:
```
$ sudo apt update
```
Install Percona Server for MongoDB 6.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 6.0:
```
$ sudo percona-release enable psmdb-60
```
Install Percona Server for MongoDB 6.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 5.0 version. Assuming that your applications are compatible with the new version, enable 6.0 version features. Run the following command against the admin database:

> db.adminCommand( { setFeatureCompatibilityVersion: "6.0" } )