From f50692bf44c755e875f04a650d82f6b04f07bf6b Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Mon, 29 Jun 2026 17:29:33 +0300 Subject: [PATCH 1/7] PG-2503 - Add PSP 18.4.2 release notes This PR adds the release notes for version 18.4.2, as well as minor modifications to the release notes dates in the sidebar nav menu. --- docs/release-notes/release-notes-v18.4.2.md | 87 +++++++++++++++++++++ docs/release-notes/release-notes.md | 1 + docs/templates/pdf_cover_page.tpl | 2 +- mkdocs.yml | 7 +- variables.yml | 5 +- 5 files changed, 96 insertions(+), 6 deletions(-) create mode 100644 docs/release-notes/release-notes-v18.4.2.md diff --git a/docs/release-notes/release-notes-v18.4.2.md b/docs/release-notes/release-notes-v18.4.2.md new file mode 100644 index 000000000..d82f9602a --- /dev/null +++ b/docs/release-notes/release-notes-v18.4.2.md @@ -0,0 +1,87 @@ +# Percona Distribution for PostgreSQL 18.4.2 ({{date.18_4_2}}) + +--8<-- "release-notes-intro.md" + +This release of Percona Distribution for PostgreSQL is based on Percona Server for PostgreSQL 18.4.2 - a binary compatible, open source drop in replacement of [PostgreSQL Community 18.4](https://www.postgresql.org/docs/18/release-18-4.html). + +## Release Highlights + +This release continues to deliver Percona’s open source value-add components for enterprise use cases, `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 18.4 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 17.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: TBD. For more details, see the [PostgreSQL 18.4 release notes](https://www.postgresql.org/docs/18/release-18-4.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/) | 18 | 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 f22bb688d..616850e3d 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 18, organize ## 2026 +* [18.4.2](release-notes-v18.4.2.md) ({{date.18_4_2}}) * [18.4.1](release-notes-v18.4.1.md) ({{date.18_4_1}}) * [18.3.1](release-notes-v18.3.1.md) ({{date.18_3_1}}) diff --git a/docs/templates/pdf_cover_page.tpl b/docs/templates/pdf_cover_page.tpl index cacaec304..811462355 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 %} -

18.4.1 (May 20, 2026)

+

18.4.2 (July 30, 2026)

diff --git a/mkdocs.yml b/mkdocs.yml index 2e7088b9d..c1ee430bd 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -79,10 +79,11 @@ nav: - Uninstall: uninstalling.md - Release notes: - "Release notes index": release-notes/release-notes.md - - "18.4.1": release-notes/release-notes-v18.4.1.md - - "18.3.1": release-notes/release-notes-v18.3.1.md + - "18.4.2 ({{date.18_4_2}})": release-notes/release-notes-v18.4.2.md + - "18.4.1 ({{date.18_4_1}})": release-notes/release-notes-v18.4.1.md + - "18.3.1 ({{date.18_3_1}})": release-notes/release-notes-v18.3.1.md - "2025": - - "18.1.1": release-notes/release-notes-v18.1.1.md + - "18.1.1 ({{date.18_1_1}})": release-notes/release-notes-v18.1.1.md - Reference: - Licensing: licensing.md - Versioning: versioning.md diff --git a/variables.yml b/variables.yml index e7eb36fe6..f3670f077 100644 --- a/variables.yml +++ b/variables.yml @@ -1,17 +1,18 @@ # PG Variables set for HTML output # See also mkdocs.yml plugins.with-pdf.cover_subtitle and output_path -release: 'release-notes-v18.4.1' +release: 'release-notes-v18.4.2' dockertag: '18.4' pgsubversion: '18.4' pgversion: '18' -pspgversion: '18.4.1' +pspgversion: '18.4.2' pgsmversion: '2.3.2' pgbouncerversion: '1.25.2' pgbackrestversion: '2.58.0' date: + 18_4_2: 2026-07-30 18_4_1: 2026-05-20 18_3_1: 2026-03-02 18_1_1: 2025-11-28 From e707a622006c7ca515e3a04dbd50fc432bef2e78 Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Fri, 3 Jul 2026 15:20:20 +0300 Subject: [PATCH 2/7] apply content related to out of cycle release --- docs/release-notes/release-notes-v18.4.2.md | 76 +++++---------------- 1 file changed, 18 insertions(+), 58 deletions(-) diff --git a/docs/release-notes/release-notes-v18.4.2.md b/docs/release-notes/release-notes-v18.4.2.md index d82f9602a..d4f987f0f 100644 --- a/docs/release-notes/release-notes-v18.4.2.md +++ b/docs/release-notes/release-notes-v18.4.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 18.4.2 - a binary compatible, open source drop in replacement of [PostgreSQL Community 18.4](https://www.postgresql.org/docs/18/release-18-4.html). +This release of Percona Distribution for PostgreSQL is based on Percona Server for PostgreSQL 18.4.2 - a binary-compatible, open source drop-in replacement of [PostgreSQL Community 18.4](https://www.postgresql.org/docs/18/release-18-4.html). ## Release Highlights -This release continues to deliver Percona’s open source value-add components for enterprise use cases, `pg_tde` 2.2.1 for Transparent Data Encryption and more. See the full component list below for details. +Percona Distribution for PostgreSQL 18.4.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 18.4 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 18.4. -To upgrade from earlier versions (e.g. Percona Distribution for PostgreSQL 17.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: TBD. For more details, see the [PostgreSQL 18.4 release notes](https://www.postgresql.org/docs/18/release-18-4.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/) | 18 | 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. +## 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/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." From bd142b14c2d67631b0a962321b36c23f71731aef Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Fri, 3 Jul 2026 15:23:59 +0300 Subject: [PATCH 3/7] Update release-notes-v18.4.2.md --- docs/release-notes/release-notes-v18.4.2.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/release-notes/release-notes-v18.4.2.md b/docs/release-notes/release-notes-v18.4.2.md index d4f987f0f..419283f94 100644 --- a/docs/release-notes/release-notes-v18.4.2.md +++ b/docs/release-notes/release-notes-v18.4.2.md @@ -44,4 +44,4 @@ The following bundled components have been updated in this release: 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." +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. From 8de287a9241831aec88b561ddf9a7af75669ab53 Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Fri, 3 Jul 2026 16:09:45 +0300 Subject: [PATCH 4/7] Update release-notes-v18.4.2.md --- docs/release-notes/release-notes-v18.4.2.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/release-notes/release-notes-v18.4.2.md b/docs/release-notes/release-notes-v18.4.2.md index 419283f94..e91090c5c 100644 --- a/docs/release-notes/release-notes-v18.4.2.md +++ b/docs/release-notes/release-notes-v18.4.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 a8be3c560deebbd2a436a1020b16800e77b8fbe6 Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Fri, 3 Jul 2026 16:38:07 +0300 Subject: [PATCH 5/7] Update release-notes-v18.4.2.md --- docs/release-notes/release-notes-v18.4.2.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/release-notes/release-notes-v18.4.2.md b/docs/release-notes/release-notes-v18.4.2.md index e91090c5c..dc5be10d7 100644 --- a/docs/release-notes/release-notes-v18.4.2.md +++ b/docs/release-notes/release-notes-v18.4.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 18.4.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 18.4.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 18.4. +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 18.4.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). From d9bd5882027840828b2046fce91f44d6a62e2122 Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Mon, 6 Jul 2026 16:01:04 +0300 Subject: [PATCH 6/7] Update variables.yml --- variables.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/variables.yml b/variables.yml index f3670f077..b3498c3fa 100644 --- a/variables.yml +++ b/variables.yml @@ -12,7 +12,7 @@ pgbackrestversion: '2.58.0' date: - 18_4_2: 2026-07-30 + 18_4_2: 2026-07-06 18_4_1: 2026-05-20 18_3_1: 2026-03-02 18_1_1: 2025-11-28 From 3f14b7d5734c2bd203f1a0446ab16950031aaaf3 Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Mon, 6 Jul 2026 16:48:21 +0300 Subject: [PATCH 7/7] Update release date in PDF cover page template --- docs/templates/pdf_cover_page.tpl | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/templates/pdf_cover_page.tpl b/docs/templates/pdf_cover_page.tpl index 811462355..90a0d5624 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 %} -

18.4.2 (July 30, 2026)

+

18.4.2 (July 06, 2026)