Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

PBM-1419 Reworked supported versions matrix #218

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

PBM-1419 Reworked supported versions matrix #218

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 29 additions & 14 deletions docs/details/versions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,26 +2,41 @@

Percona Backup for MongoDB is compatible with:

* MongoDB Community / Enterprise Edition with [MongoDB Replication :octicons-link-external-16:](https://docs.mongodb.com/manual/replication/) enabled for logical backups.
* Percona Server for MongoDB with [MongoDB Replication :octicons-link-external-16:](https://docs.mongodb.com/manual/replication/) for logical backups. For physical backups, also configure WiredTiger as the storage engine.
* MongoDB Community / Enterprise Edition with [MongoDB Replication :octicons-link-external-16:](https://docs.mongodb.com/manual/replication/) enabled. Percona Backup for MongoDB supports only *logical backups*.
* Percona Server for MongoDB with [MongoDB Replication :octicons-link-external-16:](https://docs.mongodb.com/manual/replication/) for logical backups. For physical and incremental backups, also configure WiredTiger as the storage engine.

The following table provides information about the supported MongoDB versions for each PBM release.
Navigate to the required compatibility matrix to see what MongoDB versions your current PBM release is compatible with for backups and restores.

!!! note ""

End-of-life MongoDB versions may work with PBM, but they are not tested for compatibility. Consider using an previous PBM version in this case.
End-of-life MongoDB versions may work with PBM, but they are not tested for compatibility. Consider using a previous PBM version in this case.

## Percona Server for MongoDB compatibility matrix

| PBM version | MongoDB Community / Enterprise | Percona Server for MongoDB|Compatibility with previous PBM versions|
| ----------- |------------------------------- | ------------------------- |----------------------------------------|
| [2.6.0](../release-notes/2.6.0.md) | <ul><li>Logical backups: version 5.0.x and higher</li></ul> | <ul><li>Logical backups: version 5.0.x and higher</li><li>Physical backups: version 5.0.x, 6.0.x, 7.0.x</li><li>Incremental backups: version 5.0.14-12, 6.0.3-2 and higher, 7.0.x</li></ul> | Yes |
| [2.5.0](../release-notes/2.5.0.md) | <ul><li>Logical backups: version 5.0.x and higher</li></ul> | <ul><li>Logical backups: version 5.0.x and higher</li><li>Physical backups: version 5.0.x, 6.0.x, 7.0.x</li><li>Incremental backups: version 5.0.14-12, 6.0.3-2 and higher, 7.0.x</li></ul> | Yes |
| [2.4.0](../release-notes/2.4.0.md) | <ul><li>Logical backups: version 5.0.x and higher</li></ul> | <ul><li>Logical backups: version 5.0.x and higher</li><li>Physical backups: version 5.0.x, 6.0.x, 7.0.x</li><li>Incremental backups: version 5.0.14-12, 6.0.3-2 and higher, 7.0.x</li></ul>| Yes |
| [2.3.0](../release-notes/2.3.0.md) | <ul><li>Logical backups: version 4.4 and higher</li></ul> | <ul><li>Logical backups: version 4.4 and higher</li><li>Physical backups - version 4.4.6-8 and higher, 5.0.x, 6.0.x</li><li>Incremental backups: versions 4.4.18, 5.0.14-12, 6.0.3-2 and higher</li></ul>| Yes |
| [2.2.0](../release-notes/2.2.0.md) | <ul><li>Logical backups: version 4.4 and higher</li></ul> | <ul><li>Logical backups: version 4.4 and higher</li><li>Physical backups - version 4.4.6-8 and higher, 5.0.x, 6.0.x</li><li>Incremental backups: versions 4.4.18, 5.0.14-12, 6.0.3-2 and higher</li></ul>| Yes |
| [2.1.0](../release-notes/2.1.0.md) | <ul><li>Logical backups: version 4.4 and higher</li></ul> | <ul><li>Logical backups: version 4.4 and higher</li><li>Physical backups - version 4.4.6-8, 5.0.x, 6.0.x</li><li>Incremental backups: version 4.2.24-24, 4.4.18, 5.0.14-12, 6.0.3-2 and higher</li></ul>| No. A fresh backup is required|
| [1.7.0](../release-notes/1.7.0.md) | <ul><li>Logical backups: version 4.2 and higher</li></ul> | <ul><li>Logical backups: version 4.2 and higher</li><li>Physical backups (tech preview): version 4.2.15-16, 4.4.6-8, 5.0 and higher</li></ul> | Yes
| [1.6.1](../release-notes/1.6.1.md) | <ul><li>Logical backups: version 3.6 and higher with [MongoDB Replication :octicons-link-external-16:](https://docs.mongodb.com/manual/replication/) enabled</li></ul> | <ul><li>Logical backups: version 3.6 and higher</li></ul>|Yes
The following table lists the Percona Server for MongoDB versions supported for each backup type.

Each entry indicates the PBM version that introduces changes in the supported Percona Server for MongoDB versions.

| PBM version | Logical | Physical |Incremental physical | Restore backward compatibility|
| ----------- |---------|----------|---------------------|---------------------|
| **2.4.0 - 2.7.0** | 5.0.x, 6.0.x, 7.0.x | 5.0.x, 6.0.x, 7.0.x | 5.0.14-12, 6.0.3-2 and higher, 7.0.x | Yes |
| **2.2.0 - 2.3.0** | 4.4 and higher| 4.4.6-8 and higher, 5.0.x, 6.0.x| 4.4.18, 5.0.14-12, 6.0.3-2 and higher| Yes |
| **2.1.0** | 4.4 and higher | 4.4.6-8, 5.0.x, 6.0.x| 4.2.24-24, 4.4.18, 5.0.14-12, 6.0.3-2 and higher| No. A fresh backup is required|
| **1.7.0** | 4.2 and higher| tech preview: 4.2.15-16, 4.4.6-8, 5.0 and higher| | Yes
| **1.6.1** | 3.6 and higher | N/A |N/A |N/A |Yes


## MongoDB Community / Enterprise Edition compatibility matrix

This table lists the supported MongoDB Community and Enterprise Edition versions for logical backups. Each entry indicates the new PBM version that introduces changes in the supported MongoDB versions.

| PBM version | Logical backups | Restore backward compatibility|
| ----------- |-----------------| ----------------------------- |
| **2.4.0 - 2.7.0** | 5.0.x and higher | Yes |
| **2.2.0 - 2.3.0** | 4.4.x and higher | Yes |
| **2.1.0** | 4.4.x and higher| No. A fresh backup is required|
| **1.7.0** | 4.2 and higher| Yes
| **1.6.1** | 3.6 and higher|Yes



Expand Down
Loading