diff --git a/docs/major-upgrade.md b/docs/major-upgrade.md index 3a6c84259..04412ef18 100644 --- a/docs/major-upgrade.md +++ b/docs/major-upgrade.md @@ -43,6 +43,11 @@ so the system is usable. The exact steps may differ depending on the package manager of your operating system. +!!! note + `pg_tde` is **not** a dependency in PostgreSQL 18. If your PostgreSQL 17 cluster uses `pg_tde`, you must install the `pg_tde` package **before** starting the upgraded server. + + If the package is missing, PostgreSQL 18 will fail to start because the required `pg_tde` shared library is not available. + ## On Debian and Ubuntu using `apt` Run **all** commands as root or via **sudo**: diff --git a/docs/release-notes/release-notes-v18.1.1.md b/docs/release-notes/release-notes-v18.1.1.md index 222a4bb04..e4f893c57 100644 --- a/docs/release-notes/release-notes-v18.1.1.md +++ b/docs/release-notes/release-notes-v18.1.1.md @@ -2,35 +2,57 @@ --8<-- "release-notes-intro.md" -This release of Percona Distribution for PostgreSQL is based on Percona Server for PostgreSQL 18.1.1 - a binary compatible, open source drop in replacement of [PostgreSQL Community 18.1](https://www.postgresql.org/docs/18/release-18.html). +This release of Percona Distribution for PostgreSQL is based on Percona Server for PostgreSQL 18.1.1 - a binary compatible, open source drop in replacement of [PostgreSQL Community 18.1](https://www.postgresql.org/docs/18/release-18-1.html). + +It introduces several major enhancements, such as: + +- **Parallel logical replication** for improved throughput during initial data synchronization +- **Faster in-place upgrades** via `pg_upgrade` performance improvements +- **Enhanced monitoring** with new statistics views for `pg_stat_io` and background writer activity +- **Security improvements**, including expanded SSL/TLS configuration options +- **Performance optimizations** for query execution and index management +- Added support for **asynchronous I/O (AIO)** with PostgreSQL 18.1.1 which is now the default I/O mechanism. + +These features make PostgreSQL 18 a major step forward in scalability, observability, and operational efficiency. ## Release Highlights -### SBOMs available for download +This release continues to deliver Percona’s open source value-add components for enterprise use cases, including `pg_stat_monitor` 2.3.1 for advanced query-level observability, `pg_tde` 2.1 for Transparent Data Encryption and more. See the full component list below for details. + +!!! note + 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). + +### `pg_tde` is now a standalone package -Percona now provides Software Bill of Materials (SBOMs) to support compliance and security audits. SBOM files are available for tarball builds. +Starting with PostgreSQL 18, `pg_tde` is no longer shipped with the server package. If your cluster relies on `pg_tde`, you must install the package manually. -See [Software Bill of Materials (SBOMs)](../sboms.md) for the full list. +For more information on installing `pg_tde`, see [Install pg_tde :octicons-link-external-16:](https://docs.percona.com/pg-tde/install.html). ### 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: -- LIBXSLT: 1.1.43 -- LUA: 5.3.6 -- LIBTIFF: 4.7.0 -- EXPAT: 2.5.0 -- PGPOOL: 4.6.2 -- PGBACKREST: 2.56.0 -- PATRONI: 4.0.6 +- pgbouncer: 1.25.0 +- pgpool2: 4.6.3 +- etcd: 3.5.24 +- PostGIS: 3.5.4 +- set_user: 4.2.0 +- pg_repack: 1.5.3 +- pg_stat_monitor: 2.3.1 +- pgBackRest: 2.57.0 +- Patroni: 4.1.0 +- HAProxy: 2.8.16 +- pgvector: 0.8.1 +- libxml2: 2.12.10 +- pg_tde: 2.1.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: TBA. For more details, see the [PostgreSQL 18.1 release notes](https://www.postgresql.org/docs/release/18.0/). +This release includes important security measures that address the following CVEs: CVE-2025-12817, CVE-2025-12818. For more details, see the [PostgreSQL 18.1 release notes](https://www.postgresql.org/docs/18/release-18-1.html). -## Known Issue +## Known Issues ### For minor & major upgrades (RHEL only) @@ -44,26 +66,36 @@ 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.21 | A distributed, reliable key-value store for setting up highly available Patroni clusters | +| [etcd :octicons-link-external-16:](https://etcd.io/) | 3.5.24 | 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:](http://www.haproxy.org/) | 2.8.15 | A high-availability and load-balancing solution | -| [Patroni :octicons-link-external-16:](https://patroni.readthedocs.io/en/latest/) | 4.0.6 | 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.1.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.56.0 | A backup and restore solution for PostgreSQL | +| [HAProxy :octicons-link-external-16:](http://www.haproxy.org/) | 2.8.16 | A high-availability and load-balancing solution | +| [Patroni :octicons-link-external-16:](https://patroni.readthedocs.io/en/latest/) | 4.1.0 | A HA (High Availability) solution for PostgreSQL | +| [PgAudit :octicons-link-external-16:](https://www.pgaudit.org/) | 18.0 | 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.57.0 | A backup and restore solution for PostgreSQL | | [pgBadger :octicons-link-external-16:](https://github.com/darold/pgbadger) | 13.1 | A fast PostgreSQL Log Analyzer | -| [PgBouncer :octicons-link-external-16:](https://www.pgbouncer.org/) | 1.24.1 | A lightweight connection pooler for PostgreSQL | -| [pg_gather :octicons-link-external-16:](https://github.com/jobinau/pg_gather) | v31 | An SQL script for running the diagnostics of the health of a PostgreSQL cluster | -| [pgpool2 :octicons-link-external-16:](https://git.postgresql.org/gitweb/?p=pgpool2.git;a=summary) | 4.6.2 | A middleware between PostgreSQL server and client for high availability, connection pooling, and load balancing | -| [pg_repack :octicons-link-external-16:](https://github.com/reorg/pg_repack) | 1.5.2 | Rebuilds PostgreSQL database objects | -| [pgvector :octicons-link-external-16:](https://github.com/pgvector/pgvector) | v0.8.0 | A vector similarity search for PostgreSQL | -| [PostGIS :octicons-link-external-16:](https://github.com/postgis/postgis) | 3.3.8 | A spatial extension for PostgreSQL | -| [PostgreSQL Common :octicons-link-external-16:](https://salsa.debian.org/postgresql/postgresql-common) | 280 | PostgreSQL database-cluster manager. Supports multiple PostgreSQL versions and clusters simultaneously | +| [PgBouncer :octicons-link-external-16:](https://www.pgbouncer.org/) | 1.25.0 | A lightweight connection pooler for PostgreSQL | +| [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 | +| [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 | +| [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.1 | Collects and aggregates statistics for PostgreSQL and provides histogram information. | +| [pgvector :octicons-link-external-16:](https://github.com/pgvector/pgvector) | v0.8.1 | A vector similarity search for PostgreSQL | +| [PostGIS :octicons-link-external-16:](https://github.com/postgis/postgis) | 3.5.4 | A spatial extension for PostgreSQL | +| [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 | | [wal2json :octicons-link-external-16:](https://github.com/eulerto/wal2json) | 2.6 | A PostgreSQL logical decoding JSON output plugin | +| [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 | 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. diff --git a/docs/solutions/ha-etcd-config.md b/docs/solutions/ha-etcd-config.md index d9f423e67..d507db596 100644 --- a/docs/solutions/ha-etcd-config.md +++ b/docs/solutions/ha-etcd-config.md @@ -1,6 +1,6 @@ # Etcd setup -In our solutions, we use etcd distributed configuration store. [Refresh your knowledge about etcd](ha-components.md#etcd). +In our solutions, we use etcd distributed configuration store. [Refresh your knowledge about etcd](ha-components.md#database-and-dsc-layers). ## Install etcd diff --git a/docs/tarball.md b/docs/tarball.md index a4408659d..9c0b19525 100644 --- a/docs/tarball.md +++ b/docs/tarball.md @@ -10,10 +10,12 @@ You can download the tarballs using the links below. The following tarballs are available for the x86_64 and ARM64 architectures: -* [percona-postgresql-{{dockertag}}-ssl1.1-linux-aarch64.tar.gz](https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{dockertag}}/binary/tarball/percona-postgresql-{{pgsubversion}}-ssl1.1-linux-aarch64.tar.gz) - for operating systems on ARM64 architecture that run OpenSSL version 1.x -* [percona-postgresql-{{dockertag}}-ssl1.1-linux-x86_64.tar.gz](https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{dockertag}}/binary/tarball/percona-postgresql-{{pgsubversion}}-ssl1.1-linux-x86_64.tar.gz) - for operating systems on x86_64 architecture that run OpenSSL version 1.x -* [percona-postgresql-{{dockertag}}-ssl3-linux-aarch64.tar.gz](https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{dockertag}}/binary/tarball/percona-postgresql-{{pgsubversion}}-ssl3-linux-aarch64.tar.gz) - for operating systems on ARM64 architecture that run OpenSSL version 3.x -* [percona-postgresql-{{dockertag}}-ssl3-linux-x86_64.tar.gz](https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{dockertag}}/binary/tarball/percona-postgresql-{{pgsubversion}}-ssl3-linux-x86_64.tar.gz) - for operating systems on x86_64 architecture that run OpenSSL version 3.x +* [percona-postgresql-{{dockertag}}-ssl1.1-linux-aarch64.tar.gz](https://downloads.percona.com/downloads/postgresql-distribution-18/{{dockertag}}/binary/tarball/percona-postgresql-{{dockertag}}-ssl1.1-linux-aarch64.tar.gz) - for operating systems on ARM64 architecture that run OpenSSL version 1.x +* [percona-postgresql-{{dockertag}}-ssl1.1-linux-x86_64.tar.gz](https://downloads.percona.com/downloads/postgresql-distribution-18/{{dockertag}}/binary/tarball/percona-postgresql-{{dockertag}}-ssl1.1-linux-x86_64.tar.gz) - for operating systems on x86_64 architecture that run OpenSSL version 1.x +* [percona-postgresql-{{dockertag}}-ssl3-linux-aarch64.tar.gz](https://downloads.percona.com/downloads/postgresql-distribution-18/{{dockertag}}/binary/tarball/percona-postgresql-{{dockertag}}-ssl3-linux-aarch64.tar.gz) - for operating systems on ARM64 architecture that run OpenSSL version 3.1.x +* [percona-postgresql-{{dockertag}}-ssl3-linux-x86_64.tar.gz](https://downloads.percona.com/downloads/postgresql-distribution-18/{{dockertag}}/binary/tarball/percona-postgresql-{{dockertag}}-ssl3-linux-x86_64.tar.gz) - for operating systems on x86_64 architecture that run OpenSSL version 3.1.x +* [percona-postgresql-{{dockertag}}-ssl3.5-linux-aarch64.tar.gz](https://downloads.percona.com/downloads/postgresql-distribution-18/{{dockertag}}/binary/tarball/percona-postgresql-{{dockertag}}-ssl3.5-linux-aarch64.tar.gz) - for operating systems on ARM64 architecture that run OpenSSL version 3.5.x +* [percona-postgresql-{{dockertag}}-ssl3.5-linux-x86_64.tar.gz](https://downloads.percona.com/downloads/postgresql-distribution-18/{{dockertag}}/binary/tarball/percona-postgresql-{{dockertag}}-ssl3.5-linux-x86_64.tar.gz) - for operating systems on x86_64 architecture that run OpenSSL version 3.5.x To check what OpenSSL version you have, run the following command: diff --git a/mkdocs.yml b/mkdocs.yml index b79f5fe0d..58e3a1a51 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -86,7 +86,7 @@ nav: - Uninstall: uninstalling.md - Release notes: - "Release notes index": release-notes/release-notes.md - - "18.0.1": release-notes/release-notes-v18.1.1.md + - "18.1.1": release-notes/release-notes-v18.1.1.md - Reference: - Telemetry: telemetry.md - Licensing: licensing.md