From 32caf18de7da8fdc43c1a279903d6f316c996f68 Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Mon, 29 Jun 2026 18:16:52 +0300 Subject: [PATCH 1/4] PG-2503 - Add release notes for PSP 17.10.2 This PR adds the release notes for PSP 17.10.2 and also modifies the nav menu's release notes dates to be inline with Percona's style guide. --- docs/release-notes/release-notes-v17.10.2.md | 87 ++++++++++++++++++++ docs/release-notes/release-notes.md | 1 + docs/templates/pdf_cover_page.tpl | 2 +- mkdocs.yml | 21 ++--- variables.yml | 5 +- 5 files changed, 103 insertions(+), 13 deletions(-) create mode 100644 docs/release-notes/release-notes-v17.10.2.md diff --git a/docs/release-notes/release-notes-v17.10.2.md b/docs/release-notes/release-notes-v17.10.2.md new file mode 100644 index 000000000..9a33c64f4 --- /dev/null +++ b/docs/release-notes/release-notes-v17.10.2.md @@ -0,0 +1,87 @@ +# Percona Distribution for PostgreSQL 17.10.2 ({{date.17_10_2}}) + +--8<-- "release-notes-intro.md" + +This release of Percona Distribution for PostgreSQL is based on Percona Server for PostgreSQL 17.10.2 - a binary compatible, open source drop in replacement of [PostgreSQL Community 17.10](https://www.postgresql.org/docs/17/release-17-10.html). + +## Release Highlights + +This release continues to deliver Percona’s open source value-add components for enterprise use cases, including `pg_tde` 2.2.1 for Transparent Data Encryption and more. See the full component list below for details. + +!!! note + `pg_tde` 2.2.1 requires Percona Distribution for PostgreSQL 17.10 at minimum. Earlier versions of PPG are not supported with this release of `pg_tde`. + +To upgrade from earlier versions (e.g. Percona Distribution for PostgreSQL 16.x), follow the steps in [Upgrading Percona Distribution for PostgreSQL](../major-upgrade.md). + +### Tarball updates + +The binary tarballs for x86_64 and ARM64 architectures have been updated in this release. The following libraries and components have new versions: + +- postgres-common: 290 +- pgBouncer: 1.25.2 +- etcd: 3.5.30 +- pysyncobj: 0.3.15 +- haproxy: 2.8.23 +- patroni: 4.1.3 +- pgpool2: 4.7.1 +- postgis: 3.5.6 +- pg_gather: 33 +- pg_cron: 1.6.7 +- pg_tde: 2.2.0 + +See [Install Percona Distribution for PostgreSQL from binary tarballs](../tarball.md) for the download links. + +### Addressed CVEs + +This release includes important security measures that address the following CVEs: CVE-2026-6479, CVE-2026-6473, CVE-2026-6474, CVE-2026-6472, CVE-2026-6478, CVE-2026-6477, CVE-2026-6475, CVE-2026-6637. For more details, see the PostgreSQL [17.10 release notes :octicons-link-external-16:](https://www.postgresql.org/docs/17/release-17-10.html). + +## Known Issues + +### For minor & major upgrades (RHEL only) + +During an upgrade on RHEL, you may encounter the following error: + +```bash +Unknown Error occurred: Transaction test error: + file /usr/share/postgresql-common/server/postgresql.mk from install of percona-postgresql-common conflicts with file from package percona-postgresql-common-dev + file /usr/share/postgresql-common/t/040_upgrade.t from install of percona-postgresql-common conflicts with file from package percona-postgresql-common-dev +``` + +To resolve this, remove the `percona-postgresql-common-dev` package and reinstall it with the new intended upgraded PPG/PSP server. + +## MD5 Authentication Deprecated + +The md5 password authentication is deprecated now and will be removed in a future release. + +## Supplied third-party extensions + +Review each extension’s release notes for What’s new, improvements, or bug fixes. + +The following is the list of extensions available in Percona Distribution for PostgreSQL. + +| Extension | Version | Description | +| --- | --- | --- | +| [etcd :octicons-link-external-16:](https://etcd.io/) | 3.5.30 | A distributed, reliable key-value store for setting up highly available Patroni clusters | +| [python-etcd :octicons-link-external-16:](https://python-etcd.readthedocs.io/en/latest/) | 0.4.5 | A Python client library for interacting with etcd | +| [HAProxy :octicons-link-external-16:](https://www.haproxy.org/) | 2.8.23 | A high-availability and load-balancing solution | +| [Patroni :octicons-link-external-16:](https://patroni.readthedocs.io/en/latest/) | 4.1.3 | A HA (High Availability) solution for PostgreSQL | +| [PgAudit :octicons-link-external-16:](https://www.pgaudit.org/) | 17.1 | A detailed session or object audit logging via the standard logging facility provided by PostgreSQL | +| [pgAudit set_user :octicons-link-external-16:](https://github.com/pgaudit/set_user) | 4.2.0 | Provides an additional layer of logging and control when unprivileged users must escalate roles for maintenance | +| [pgBackRest :octicons-link-external-16:](https://pgbackrest.org/) | 2.58.0 | A backup and restore solution for PostgreSQL | +| [pgBadger :octicons-link-external-16:](https://github.com/darold/pgbadger) | 13.2 | A fast PostgreSQL log analyzer | +| [PgBouncer :octicons-link-external-16:](https://www.pgbouncer.org/) | 1.25.2 | A lightweight connection pooler for PostgreSQL | +| [pg_cron :octicons-link-external-16:](https://github.com/citusdata/pg_cron) | 1.6.7 | A simple cron-based job scheduler for PostgreSQL | +| [pg_gather :octicons-link-external-16:](https://github.com/jobinau/pg_gather) | v33 | An SQL script for running diagnostics on the health of a PostgreSQL cluster | +| [pg_oidc_validator](https://github.com/Percona-Lab/pg_oidc_validator) | 1.0 | OAuth validator library for PostgreSQL 18 | +| [pg_repack :octicons-link-external-16:](https://github.com/reorg/pg_repack) | 1.5.3 | Rebuilds PostgreSQL database objects | +| [pg_stat_monitor](https://github.com/percona/pg_stat_monitor) | 2.3.2 | Collects and aggregates statistics for PostgreSQL and provides histogram information | +| [pg_tde :octicons-link-external-16:](https://github.com/percona/pg_tde) | v2.2.0 | A PostgreSQL extension that provides Transparent Data Encryption (TDE) to protect data at rest | +| [pg_vector](https://github.com/pgvector/pgvector) | v0.8.2 | A vector similarity search extension for PostgreSQL | +| [pgpool2 :octicons-link-external-16:](https://git.postgresql.org/gitweb/?p=pgpool2.git;a=summary) | 4.7.1 | A middleware between PostgreSQL server and client for high availability, connection pooling, and load balancing | +| [PostGIS :octicons-link-external-16:](https://github.com/postgis/postgis) | 3.5.6 | A spatial extension for PostgreSQL | +| [PostgreSQL Commons :octicons-link-external-16:](https://salsa.debian.org/postgresql/postgresql-common) | 290 | PostgreSQL database-cluster manager. Supports multiple PostgreSQL versions and clusters simultaneously | +| [wal2json :octicons-link-external-16:](https://github.com/eulerto/wal2json) | 2.6 | A PostgreSQL logical decoding JSON output plugin | + +For Red Hat Enterprise Linux 8 and compatible derivatives, Percona Distribution for PostgreSQL also includes the supplemental `python3-etcd` 0.4.5 packages, which are used for setting up Patroni clusters. + +Percona Distribution for PostgreSQL is also shipped with the [libpq](https://www.postgresql.org/docs/18/libpq.html) library. It contains "a set of library functions that allow client programs to pass queries to the PostgreSQL backend server and to receive the results of these queries." diff --git a/docs/release-notes/release-notes.md b/docs/release-notes/release-notes.md index fd9531905..59b5ab858 100644 --- a/docs/release-notes/release-notes.md +++ b/docs/release-notes/release-notes.md @@ -4,6 +4,7 @@ This page lists all release notes for Percona Server for PostgreSQL 17, organize ## 2026 +* [17.10.2](release-notes-v17.10.2.md) ({{date.17_10_2}}) * [17.10.1](release-notes-v17.10.1.md) ({{date.17_10_1}}) * [17.9.1](release-notes-v17.9.1.md) ({{date.17_9_1}}) diff --git a/docs/templates/pdf_cover_page.tpl b/docs/templates/pdf_cover_page.tpl index 5539f78cc..c23cb6f06 100644 --- a/docs/templates/pdf_cover_page.tpl +++ b/docs/templates/pdf_cover_page.tpl @@ -7,6 +7,6 @@ {% if config.site_description %}

{{ config.site_description }}

{% endif %} -

17.10.1 (May 20, 2026)

+

17.10.2 (July 30, 2026)

diff --git a/mkdocs.yml b/mkdocs.yml index 76fe4921b..629386c40 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -78,18 +78,19 @@ nav: - Uninstall: uninstalling.md - Release notes: - "Release notes index": release-notes/release-notes.md - - "17.10.1": release-notes/release-notes-v17.10.1.md - - "17.9.1": release-notes/release-notes-v17.9.1.md + - "17.10.2 ({{date.17_10_2}})": release-notes/release-notes-v17.10.2.md + - "17.10.1 ({{date.17_10_1}})": release-notes/release-notes-v17.10.1.md + - "17.9.1 ({{date.17_9_1}})": release-notes/release-notes-v17.9.1.md - 2025 (versions 17.4.1 - 17.7.1): - - "17.7.1": release-notes/release-notes-v17.7.1.md - - "17.6.1": release-notes/release-notes-v17.6.1.md - - "17.5.3": release-notes/release-notes-v17.5.3.md - - "17.5.2": release-notes/release-notes-v17.5.md - - "17.5.1": release-notes/release-notes-v17.5.1.md - - "17.4.1": release-notes/release-notes-v17.4.md + - "17.7.1 ({{date.17_7_1}})": release-notes/release-notes-v17.7.1.md + - "17.6.1 ({{date.17_6_1}})": release-notes/release-notes-v17.6.1.md + - "17.5.3 ({{date.17_5_3}})": release-notes/release-notes-v17.5.3.md + - "17.5.2 ({{date.17_5_2}})": release-notes/release-notes-v17.5.md + - "17.5.1 ({{date.17_5}})": release-notes/release-notes-v17.5.1.md + - "17.4.1 ({{date.17_4}})": release-notes/release-notes-v17.4.md - 2024 (versions 17.0.1 - 17.2.1): - - "17.2.1": release-notes/release-notes-v17.2.md - - "17.0.1": release-notes/release-notes-v17.0.md + - "17.2.1 ({{date.17_2}})": release-notes/release-notes-v17.2.md + - "17.0.1 ({{date.17_0}})": release-notes/release-notes-v17.0.md - Reference: - Telemetry: telemetry.md - Licensing: licensing.md diff --git a/variables.yml b/variables.yml index 71906f8be..a3a189a01 100644 --- a/variables.yml +++ b/variables.yml @@ -2,15 +2,16 @@ # See also mkdocs.yml plugins.with-pdf.cover_subtitle and output_path -release: 'release-notes-v17.10.1' +release: 'release-notes-v17.10.2' dockertag: '17.10' pgsubversion: '17.10' pgversion: '17' -pspgversion: '17.10.1' +pspgversion: '17.10.2' pgsmversion: '2.3.2' date: + 17_10_2: 2026-07-30 17_10_1: 2026-05-20 17_9_1: 2026-03-02 17_7_1: 2025-12-02 From bbe6917d8c1147c8e5cdbe70575314d7460ddbdd Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Fri, 3 Jul 2026 15:23:41 +0300 Subject: [PATCH 2/4] Update release-notes-v17.10.2.md --- docs/release-notes/release-notes-v17.10.2.md | 80 +++++--------------- 1 file changed, 20 insertions(+), 60 deletions(-) diff --git a/docs/release-notes/release-notes-v17.10.2.md b/docs/release-notes/release-notes-v17.10.2.md index 9a33c64f4..f37a30534 100644 --- a/docs/release-notes/release-notes-v17.10.2.md +++ b/docs/release-notes/release-notes-v17.10.2.md @@ -2,38 +2,20 @@ --8<-- "release-notes-intro.md" -This release of Percona Distribution for PostgreSQL is based on Percona Server for PostgreSQL 17.10.2 - a binary compatible, open source drop in replacement of [PostgreSQL Community 17.10](https://www.postgresql.org/docs/17/release-17-10.html). +This release of Percona Distribution for PostgreSQL is based on Percona Server for PostgreSQL 17.10.2 - a binary-compatible, open source drop-in replacement of [PostgreSQL Community 17.10](https://www.postgresql.org/docs/17/release-17-10.html). ## Release Highlights -This release continues to deliver Percona’s open source value-add components for enterprise use cases, including `pg_tde` 2.2.1 for Transparent Data Encryption and more. See the full component list below for details. +Percona Distribution for PostgreSQL 17.10.2 is an out-of-cycle maintenance release that updates bundled components, including `pg_tde` 2.2.1, and refreshes Docker images with fixes for high-severity CVEs where available. !!! note - `pg_tde` 2.2.1 requires Percona Distribution for PostgreSQL 17.10 at minimum. Earlier versions of PPG are not supported with this release of `pg_tde`. + `pg_tde` 2.2.1 is not compatible with Percona Distribution for PostgreSQL versions earlier than 17.10. -To upgrade from earlier versions (e.g. Percona Distribution for PostgreSQL 16.x), follow the steps in [Upgrading Percona Distribution for PostgreSQL](../major-upgrade.md). +To upgrade from an earlier version of Percona Distribution for PostgreSQL, follow the steps in [Upgrading Percona Distribution for PostgreSQL](../major-upgrade.md). -### Tarball updates +### Docker image updates -The binary tarballs for x86_64 and ARM64 architectures have been updated in this release. The following libraries and components have new versions: - -- postgres-common: 290 -- pgBouncer: 1.25.2 -- etcd: 3.5.30 -- pysyncobj: 0.3.15 -- haproxy: 2.8.23 -- patroni: 4.1.3 -- pgpool2: 4.7.1 -- postgis: 3.5.6 -- pg_gather: 33 -- pg_cron: 1.6.7 -- pg_tde: 2.2.0 - -See [Install Percona Distribution for PostgreSQL from binary tarballs](../tarball.md) for the download links. - -### Addressed CVEs - -This release includes important security measures that address the following CVEs: CVE-2026-6479, CVE-2026-6473, CVE-2026-6474, CVE-2026-6472, CVE-2026-6478, CVE-2026-6477, CVE-2026-6475, CVE-2026-6637. For more details, see the PostgreSQL [17.10 release notes :octicons-link-external-16:](https://www.postgresql.org/docs/17/release-17-10.html). +Docker images have been rebuilt to address high-severity CVEs where fixes were available. ## Known Issues @@ -49,39 +31,17 @@ Unknown Error occurred: Transaction test error: To resolve this, remove the `percona-postgresql-common-dev` package and reinstall it with the new intended upgraded PPG/PSP server. -## MD5 Authentication Deprecated - -The md5 password authentication is deprecated now and will be removed in a future release. - -## Supplied third-party extensions - -Review each extension’s release notes for What’s new, improvements, or bug fixes. - -The following is the list of extensions available in Percona Distribution for PostgreSQL. - -| Extension | Version | Description | -| --- | --- | --- | -| [etcd :octicons-link-external-16:](https://etcd.io/) | 3.5.30 | A distributed, reliable key-value store for setting up highly available Patroni clusters | -| [python-etcd :octicons-link-external-16:](https://python-etcd.readthedocs.io/en/latest/) | 0.4.5 | A Python client library for interacting with etcd | -| [HAProxy :octicons-link-external-16:](https://www.haproxy.org/) | 2.8.23 | A high-availability and load-balancing solution | -| [Patroni :octicons-link-external-16:](https://patroni.readthedocs.io/en/latest/) | 4.1.3 | A HA (High Availability) solution for PostgreSQL | -| [PgAudit :octicons-link-external-16:](https://www.pgaudit.org/) | 17.1 | A detailed session or object audit logging via the standard logging facility provided by PostgreSQL | -| [pgAudit set_user :octicons-link-external-16:](https://github.com/pgaudit/set_user) | 4.2.0 | Provides an additional layer of logging and control when unprivileged users must escalate roles for maintenance | -| [pgBackRest :octicons-link-external-16:](https://pgbackrest.org/) | 2.58.0 | A backup and restore solution for PostgreSQL | -| [pgBadger :octicons-link-external-16:](https://github.com/darold/pgbadger) | 13.2 | A fast PostgreSQL log analyzer | -| [PgBouncer :octicons-link-external-16:](https://www.pgbouncer.org/) | 1.25.2 | A lightweight connection pooler for PostgreSQL | -| [pg_cron :octicons-link-external-16:](https://github.com/citusdata/pg_cron) | 1.6.7 | A simple cron-based job scheduler for PostgreSQL | -| [pg_gather :octicons-link-external-16:](https://github.com/jobinau/pg_gather) | v33 | An SQL script for running diagnostics on the health of a PostgreSQL cluster | -| [pg_oidc_validator](https://github.com/Percona-Lab/pg_oidc_validator) | 1.0 | OAuth validator library for PostgreSQL 18 | -| [pg_repack :octicons-link-external-16:](https://github.com/reorg/pg_repack) | 1.5.3 | Rebuilds PostgreSQL database objects | -| [pg_stat_monitor](https://github.com/percona/pg_stat_monitor) | 2.3.2 | Collects and aggregates statistics for PostgreSQL and provides histogram information | -| [pg_tde :octicons-link-external-16:](https://github.com/percona/pg_tde) | v2.2.0 | A PostgreSQL extension that provides Transparent Data Encryption (TDE) to protect data at rest | -| [pg_vector](https://github.com/pgvector/pgvector) | v0.8.2 | A vector similarity search extension for PostgreSQL | -| [pgpool2 :octicons-link-external-16:](https://git.postgresql.org/gitweb/?p=pgpool2.git;a=summary) | 4.7.1 | A middleware between PostgreSQL server and client for high availability, connection pooling, and load balancing | -| [PostGIS :octicons-link-external-16:](https://github.com/postgis/postgis) | 3.5.6 | A spatial extension for PostgreSQL | -| [PostgreSQL Commons :octicons-link-external-16:](https://salsa.debian.org/postgresql/postgresql-common) | 290 | PostgreSQL database-cluster manager. Supports multiple PostgreSQL versions and clusters simultaneously | -| [wal2json :octicons-link-external-16:](https://github.com/eulerto/wal2json) | 2.6 | A PostgreSQL logical decoding JSON output plugin | - -For Red Hat Enterprise Linux 8 and compatible derivatives, Percona Distribution for PostgreSQL also includes the supplemental `python3-etcd` 0.4.5 packages, which are used for setting up Patroni clusters. - -Percona Distribution for PostgreSQL is also shipped with the [libpq](https://www.postgresql.org/docs/18/libpq.html) library. It contains "a set of library functions that allow client programs to pass queries to the PostgreSQL backend server and to receive the results of these queries." +## Component updates + +The following bundled components have been updated in this release: + +| Component | Version | +|-----------|---------| +| pg_tde | 2.2.1 | +| PostGIS | 3.5.7 | +| pgVector | 0.8.3 | +| pgpool-II | 4.7.2 | + +For Red Hat Enterprise Linux 8 and compatible derivatives, Percona Distribution for PostgreSQL also includes the supplemental `python3-etcd` 0.4.5 packages, which are used for setting up Patroni clusters. + +Percona Distribution for PostgreSQL is also shipped with the [libpq](https://www.postgresql.org/docs/17/libpq.html) library. It contains a set of library functions that allow client programs to pass queries to the PostgreSQL backend server and to receive the results of these queries. From 818ffa50839291bbe36fc885a01b85c925498c5f Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Fri, 3 Jul 2026 16:10:09 +0300 Subject: [PATCH 3/4] Update release-notes-v17.10.2.md --- docs/release-notes/release-notes-v17.10.2.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/release-notes/release-notes-v17.10.2.md b/docs/release-notes/release-notes-v17.10.2.md index f37a30534..d4c7dae72 100644 --- a/docs/release-notes/release-notes-v17.10.2.md +++ b/docs/release-notes/release-notes-v17.10.2.md @@ -40,7 +40,7 @@ The following bundled components have been updated in this release: | pg_tde | 2.2.1 | | PostGIS | 3.5.7 | | pgVector | 0.8.3 | -| pgpool-II | 4.7.2 | +| pgpool | 4.7.2 | For Red Hat Enterprise Linux 8 and compatible derivatives, Percona Distribution for PostgreSQL also includes the supplemental `python3-etcd` 0.4.5 packages, which are used for setting up Patroni clusters. From ff0a3f8a7a694757e9b9d53b844a11357ce49424 Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Fri, 3 Jul 2026 16:37:20 +0300 Subject: [PATCH 4/4] Update release-notes-v17.10.2.md --- docs/release-notes/release-notes-v17.10.2.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/release-notes/release-notes-v17.10.2.md b/docs/release-notes/release-notes-v17.10.2.md index d4c7dae72..94fa8a973 100644 --- a/docs/release-notes/release-notes-v17.10.2.md +++ b/docs/release-notes/release-notes-v17.10.2.md @@ -6,10 +6,12 @@ This release of Percona Distribution for PostgreSQL is based on Percona Server f ## Release Highlights -Percona Distribution for PostgreSQL 17.10.2 is an out-of-cycle maintenance release that updates bundled components, including `pg_tde` 2.2.1, and refreshes Docker images with fixes for high-severity CVEs where available. +Percona Distribution for PostgreSQL 17.10.2 is an out-of-cycle maintenance release that addresses an issue where TimescaleDB and Citus were not compilable with earlier Percona Server for PostgreSQL versions, and fixes high-severity CVEs for which fixes were available. -!!! note - `pg_tde` 2.2.1 is not compatible with Percona Distribution for PostgreSQL versions earlier than 17.10. +This release also updates bundled components, including `pg_tde` 2.2.1, and refreshes Docker images with fixes for high-severity CVEs where available. + +!!! warning + Percona Server for PostgreSQL 17.10.2 and `pg_tde` 2.2.1 are only supported together. Combining either with an earlier version of the other is not supported. To upgrade from an earlier version of Percona Distribution for PostgreSQL, follow the steps in [Upgrading Percona Distribution for PostgreSQL](../major-upgrade.md).