From 7f1e455dcd336eb38721ab5e1d0855aaee24425d Mon Sep 17 00:00:00 2001 From: Anastasia Alexandrova Date: Mon, 25 Sep 2023 16:06:55 +0200 Subject: [PATCH] PBM-1178 Release notes 2.3.0 (#138) modified: docs/release-notes/2.0.4.md modified: docs/release-notes/2.3.0.md modified: mkdocs-base.yml modified: mkdocs-pdf.yml modified: variables.yml --- docs/details/versions.md | 6 +++--- docs/release-notes.md | 1 + docs/release-notes/2.0.4.md | 2 +- docs/release-notes/2.3.0.md | 37 +++++++++++++++++++++++++++++++++++++ mkdocs-base.yml | 7 +++++-- mkdocs-pdf.yml | 2 ++ variables.yml | 6 +++--- 7 files changed, 52 insertions(+), 9 deletions(-) create mode 100644 docs/release-notes/2.3.0.md diff --git a/docs/details/versions.md b/docs/details/versions.md index 4b94d3e6..8464ad95 100644 --- a/docs/details/versions.md +++ b/docs/details/versions.md @@ -4,7 +4,7 @@ Percona Backup for MongoDB is compatible with the following MongoDB versions: | PBM version | MongoDB Community / Enterprise | Percona Server for MongoDB| | ----------- |------------------------------- | ------------------------- | -| [2.3.0](release-notes/2.3.0.md) | Logical backups - version 4.4 and higher with [MongoDB Replication](https://docs.mongodb.com/manual/replication/) enabled| - Logical backups - version 4.4 and higher
- Physical backups - version 4.4.6-8, 5.0 and higher with [MongoDB Replication](https://docs.mongodb.com/manual/replication/) enabled and WiredTiger configured as the storage engine.| -| [1.7.0](release-notes/1.7.0.md) | Logical backups - version 4.2 and higher with [MongoDB Replication](https://docs.mongodb.com/manual/replication/) enabled| - Logical backups - version 4.2 and higher
- Physical backups (tech preview) - version 4.2.15-16, 4.4.6-8, 5.0 and higher with [MongoDB Replication](https://docs.mongodb.com/manual/replication/) enabled and WiredTiger configured as the storage engine. -| [1.6.1](release-notes/1.6.1.md) | Logical backups - version 3.6 and higher with [MongoDB Replication](https://docs.mongodb.com/manual/replication/) enabled| Logical backups - version 3.6 and higher| +| [2.3.0](../release-notes/2.3.0.md) | Logical backups - version 4.4 and higher with [MongoDB Replication](https://docs.mongodb.com/manual/replication/) enabled| - Logical backups - version 4.4 and higher
- Physical backups - version 4.4.6-8, 5.0 and higher with [MongoDB Replication](https://docs.mongodb.com/manual/replication/) enabled and WiredTiger configured as the storage engine.| +| [1.7.0](../release-notes/1.7.0.md) | Logical backups - version 4.2 and higher with [MongoDB Replication](https://docs.mongodb.com/manual/replication/) enabled| - Logical backups - version 4.2 and higher
- Physical backups (tech preview) - version 4.2.15-16, 4.4.6-8, 5.0 and higher with [MongoDB Replication](https://docs.mongodb.com/manual/replication/) enabled and WiredTiger configured as the storage engine. +| [1.6.1](../release-notes/1.6.1.md) | Logical backups - version 3.6 and higher with [MongoDB Replication](https://docs.mongodb.com/manual/replication/) enabled| Logical backups - version 3.6 and higher| diff --git a/docs/release-notes.md b/docs/release-notes.md index c62dadf9..ab524345 100644 --- a/docs/release-notes.md +++ b/docs/release-notes.md @@ -1,5 +1,6 @@ # Percona Backup for MongoDB release notes +* [Percona Backup for MongoDB 2.3.0](release-notes/2.3.0.md) * [Percona Backup for MongoDB 2.2.1](release-notes/2.2.1.md) * [Percona Backup for MongoDB 2.2.0](release-notes/2.2.0.md) * [Percona Backup for MongoDB 2.1.0](release-notes/2.1.0.md) diff --git a/docs/release-notes/2.0.4.md b/docs/release-notes/2.0.4.md index e89c0e22..3690043a 100644 --- a/docs/release-notes/2.0.4.md +++ b/docs/release-notes/2.0.4.md @@ -9,7 +9,7 @@ Percona Backup for MongoDB is a distributed, low-impact solution for consistent ## Release Highlights -The ability to [specify the custom path to `mongod` binaries](../usage/restore#define-mongod-binary-location) simplifies the physical restore process. +The ability to [specify the custom path to `mongod` binaries](../usage/restore.md#define-mongod-binary-location) simplifies the physical restore process. ## Bugs Fixed diff --git a/docs/release-notes/2.3.0.md b/docs/release-notes/2.3.0.md new file mode 100644 index 00000000..1ed8d18f --- /dev/null +++ b/docs/release-notes/2.3.0.md @@ -0,0 +1,37 @@ +# Percona Backup for MongoDB 2.3.0 (2023-09-25) + +[Installation](../installation.md){.md-button} + + +Percona Backup for MongoDB is a distributed, low-impact solution for consistent backups of MongoDB sharded clusters and replica sets. This is a tool for creating consistent backups across a MongoDB sharded cluster (or a non-sharded replica set), and for restoring those backups to a specific point in time. + +## Release Highlights + +* The support for MongoDB 4.2 is deprecated. Existing functionality in Percona Backup for MongoDB remains compatible with MongoDB 4.2 and Percona Server for MongoDB 4.2; however, further enhancements and bug fixes are no longer tested against this version. +* The ability to [view the backup contents](../usage/describe-backup.md) improves troubleshooting of backups in environments where databases are often created and / or dropped. +* The ability to [make physical backups in mixed deployments](../features/physical.md#physical-backups-in-mixed-deployments) with MongoDB Community and Percona Server for MongoDB (PSMDB) nodes streamlines the backup flow for organizations that are still evaluating or migrating their data sets against PSMDB. +* Improved validation of a base backup snapshot for point-in-time recovery aligns the recovery flow for logical and physical backups. + +### Supported platforms changes + +* A Docker image for Percona Backup for MongoDB is now available for ARM64 architectures. This improves the user experience with PBM for developers with ARM-based MacBooks. +* Percona Backup for MongoDB packages are now available for Debian 12 (bookworm). Percona Server for MongoDB is adding support for Debian 12 with the 7.0.x version. + +## New Features + +* [PBM-848](https://jira.percona.com/browse/PBM-848) - List databases and collections from backup + +## Improvements + +* [PBM-1147](https://jira.percona.com/browse/PBM-1147), [PBM-885](https://jira.percona.com/browse/PBM-885) - Support symlinks as the `path` for filesystem storage type and properly retrieve data during resync +* [PBM-1162](https://jira.percona.com/browse/PBM-1162), [PBM-1166](https://jira.percona.com/browse/PBM-1166) - Improve validation of physical and incremental backups as the base for point-in-time recovery +* [PBM-1171](https://jira.percona.com/browse/PBM-1171) - Add ability to make physical backups in mixed deployments + +## Bugs Fixed + +* [PBM-1161](https://jira.percona.com/browse/PBM-1161) - Rebuild indexes only for the selected namespaces after selective restore +* [PBM-1173](https://jira.percona.com/browse/PBM-1173), [PBM-1180](https://jira.percona.com/browse/PBM-1180) - Fixed the issue with the primary node crash after the point-in-time recovery from physical backup +* [PBM-1176](https://jira.percona.com/browse/PBM-1176) - Fixed the decoding of the physical restore metadata to ensure correct output of the `pbm describe-restore` command +* [PBM-1181](https://jira.percona.com/browse/PBM-1181) - Fixed the issue with logical restore failure by excluding the `config.changelog` collection from the restore + + diff --git a/mkdocs-base.yml b/mkdocs-base.yml index 52f04229..7c4d0984 100644 --- a/mkdocs-base.yml +++ b/mkdocs-base.yml @@ -3,7 +3,9 @@ site_name: Percona Backup for MongoDB site_description: Documentation site_author: Percona LLC -copyright: Percona LLC, © 2023 +copyright: > + Percona LLC and/or its affiliates © 2023 — Cookie Consent + repo_name: percona/pbm-docs repo_url: https://github.com/percona/pbm-docs @@ -101,7 +103,7 @@ plugins: with-pdf: # https://github.com/orzih/mkdocs-with-pdf output_path: '_pdf/PerconaBackupforMongoDB.pdf' cover_title: 'Backup for MongoDB Documentation' - cover_subtitle: 2.2.1 (July 27, 2023) + cover_subtitle: 2.3.0 (September 25, 2023) author: 'Percona Technical Documentation Team' cover_logo: docs/_images/Percona_Logo_Color.png debug_html: false @@ -129,6 +131,7 @@ nav: - Home: index.md - Release notes: - "Release notes index": "release-notes.md" + - release-notes/2.3.0.md - release-notes/2.2.1.md - release-notes/2.2.0.md - release-notes/2.1.0.md diff --git a/mkdocs-pdf.yml b/mkdocs-pdf.yml index 2fe89afb..c1974f8b 100644 --- a/mkdocs-pdf.yml +++ b/mkdocs-pdf.yml @@ -3,6 +3,8 @@ INHERIT: mkdocs-base.yml +copyright: Percona LLC, © 2023 + markdown_extensions: pymdownx.tabbed: {} admonition: {} diff --git a/variables.yml b/variables.yml index 17db7f88..5ab1d988 100644 --- a/variables.yml +++ b/variables.yml @@ -1,6 +1,6 @@ # PBM Variables set for HTML output # See also mkdocs.yml plugins.with-pdf.cover_subtitle and output_path -release: '2.2.1' -version: '2.2' -release_date: 2023-07-27 +release: '2.3.0' +version: '2.3' +