|
| 1 | +# Percona Distribution for PostgreSQL 17.7.1 ({{date.17_7_1}}) |
| 2 | + |
| 3 | +--8<-- "release-notes-intro.md" |
| 4 | + |
| 5 | +This release of Percona Distribution for PostgreSQL is based on Percona Server for PostgreSQL 17.7.1 - a binary compatible, open source drop in replacement of [PostgreSQL Community 17.7 :octicons-link-external-16:](https://www.postgresql.org/docs/17/release-17-7.html). |
| 6 | + |
| 7 | +## Release Highlights |
| 8 | + |
| 9 | +### `pg_tde` is now a standalone package |
| 10 | + |
| 11 | +Starting with this release, `pg_tde` is no longer shipped with Percona Server for PostgreSQL. However, pg_tde is installed automatically as a hard dependency. This ensures that minor updates do not break clusters that use Transparent Data Encryption (TDE). |
| 12 | + |
| 13 | +For more information on installing `pg_tde`, see [Install pg_tde :octicons-link-external-16:](https://docs.percona.com/pg-tde/install.html). |
| 14 | + |
| 15 | +Clusters that already have `pg_tde` in `shared_preload_libraries` will continue to operate normally after a minor upgrade. |
| 16 | + |
| 17 | +No user action is required. |
| 18 | + |
| 19 | +!!! note |
| 20 | + Although `pg_tde` is installed automatically, when upgrading to PostgreSQL 18 it will not install it as a dependency. If your cluster uses TDE, you must install `pg_tde` manually before starting PostgreSQL 18. |
| 21 | + |
| 22 | +### Percona Telemetry Extension for PostgreSQL Deprecated |
| 23 | + |
| 24 | +The `percona_pg_telemetry` extension has been deprecated and replaced with a backwards compatibility stub to avoid breaking existing installations. |
| 25 | + |
| 26 | +No telemetry data will be gathered, it will not be maintained going forward and it should not be used in new deployments. |
| 27 | + |
| 28 | +### Tarball updates |
| 29 | + |
| 30 | +The binary tarballs for x86_64 and ARM64 architectures have been updated in this release. The following libraries and components have new versions: |
| 31 | + |
| 32 | +- pgbouncer: 1.25.0 |
| 33 | +- pgpool2: 4.6.3 |
| 34 | +- etcd: 3.5.24 |
| 35 | +- PostGIS: 3.5.4 |
| 36 | +- set_user: 4.2.0 |
| 37 | +- pg_repack: 1.5.3 |
| 38 | +- pg_stat_monitor: 2.3.1 |
| 39 | +- pgBackRest: 2.57.0 |
| 40 | +- Patroni: 4.1.0 |
| 41 | +- HAProxy: 2.8.16 |
| 42 | +- pgvector: 0.8.1 |
| 43 | +- libxml2: 2.12.10 |
| 44 | +- pg_tde: 2.1.0 |
| 45 | + |
| 46 | +See [Install Percona Distribution for PostgreSQL from binary tarballs](../tarball.md) for the download links. |
| 47 | + |
| 48 | +### Addressed CVEs |
| 49 | + |
| 50 | +This release includes important security measures that address the following CVEs: CVE-2025-12817, CVE-2025-12818. For more details, see the PostgreSQL [17.7 release notes :octicons-link-external-16:](https://www.postgresql.org/docs/17/release-17-7.html). |
| 51 | + |
| 52 | +## Known Issue |
| 53 | + |
| 54 | +### For minor & major upgrades (RHEL only) |
| 55 | + |
| 56 | +During an upgrade on RHEL, you may encounter the following error: |
| 57 | + |
| 58 | +``` |
| 59 | +Unknown Error occurred: Transaction test error: |
| 60 | + file /usr/share/postgresql-common/server/postgresql.mk from install of percona-postgresql-common conflicts with file from package percona-postgresql-common-dev |
| 61 | + file /usr/share/postgresql-common/t/040_upgrade.t from install of percona-postgresql-common conflicts with file from package percona-postgresql-common-dev |
| 62 | +``` |
| 63 | + |
| 64 | +To resolve this, remove the `percona-postgresql-common-dev` package and reinstall it with the new intended upgraded PPG/PSP server. |
| 65 | + |
| 66 | +## Supplied third-party extensions |
| 67 | + |
| 68 | +Review each extension’s release notes for What’s new, improvements, or bug fixes. |
| 69 | + |
| 70 | +The following is the list of extensions available in Percona Distribution for PostgreSQL. |
| 71 | + |
| 72 | +| Extension | Version | Description | |
| 73 | +|--------------------------------------------------------------------------------------|-----------|----------------------------------------------------------------------------------------------------------------------| |
| 74 | +| [etcd :octicons-link-external-16:](https://etcd.io/) | 3.5.24 | A distributed, reliable key-value store for setting up highly available Patroni clusters |
| 75 | +| [python-etcd :octicons-link-external-16:](https://python-etcd.readthedocs.io/en/latest/) | 0.4.5 | A Python client library for interacting with etcd | |
| 76 | +| [HAProxy :octicons-link-external-16:](http://www.haproxy.org/) | 2.8.16 | A high-availability and load-balancing solution | |
| 77 | +| [Patroni :octicons-link-external-16:](https://patroni.readthedocs.io/en/latest/) | 4.1.0 | A HA (High Availability) solution for PostgreSQL | |
| 78 | +| [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 | |
| 79 | +| [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. | |
| 80 | +| [pgBackRest :octicons-link-external-16:](https://pgbackrest.org/) | 2.57.0 | A backup and restore solution for PostgreSQL | |
| 81 | +| [pgBadger :octicons-link-external-16:](https://github.com/darold/pgbadger) | 13.1 | A fast PostgreSQL Log Analyzer | |
| 82 | +| [PgBouncer :octicons-link-external-16:](https://www.pgbouncer.org/) | 1.25.0 | A lightweight connection pooler for PostgreSQL | |
| 83 | +| [pg_gather :octicons-link-external-16:](https://github.com/jobinau/pg_gather) | v32 | An SQL script for running the diagnostics of the health of a PostgreSQL cluster | |
| 84 | +| [pgpool2 :octicons-link-external-16:](https://git.postgresql.org/gitweb/?p=pgpool2.git;a=summary) | 4.6.3 | A middleware between PostgreSQL server and client for high availability, connection pooling, and load balancing | |
| 85 | +| [pg_repack :octicons-link-external-16:](https://github.com/reorg/pg_repack) | 1.5.3 | Rebuilds PostgreSQL database objects |
| 86 | +| [pg_stat_monitor](https://github.com/percona/pg_stat_monitor) | 2.3.1 | Collects and aggregates statistics for PostgreSQL and provides histogram information. | |
| 87 | +| [pgvector :octicons-link-external-16:](https://github.com/pgvector/pgvector) | v0.8.1 | A vector similarity search for PostgreSQL | |
| 88 | +| [PostGIS :octicons-link-external-16:](https://github.com/postgis/postgis) | 3.5.4 | A spatial extension for PostgreSQL | |
| 89 | +| [PostgreSQL Common :octicons-link-external-16:](https://salsa.debian.org/postgresql/postgresql-common) | 287 | PostgreSQL database-cluster manager. Supports multiple PostgreSQL versions and clusters simultaneously | |
| 90 | +| [wal2json :octicons-link-external-16:](https://github.com/eulerto/wal2json) | 2.6 | A PostgreSQL logical decoding JSON output plugin | |
| 91 | +| [pg_tde :octicons-link-external-16:](https://github.com/percona/pg_tde) | v2.1.0 | A PostgreSQL extension that provides Transparent Data Encryption (TDE) to protect data at rest | |
| 92 | + |
| 93 | +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. |
| 94 | + |
| 95 | +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." |
0 commit comments