diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index 1b4fa88a0..88a3875b4 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -43,7 +43,7 @@ jobs: - name: Deploy docs run: | mike deploy 17 -b publish -p - mike retitle 17 "17.6" -b publish -p + mike retitle 17 "17.7" -b publish -p diff --git a/docs/release-notes/release-notes-v17.4.md b/docs/release-notes/release-notes-v17.4.md index f495beb50..19899668d 100644 --- a/docs/release-notes/release-notes-v17.4.md +++ b/docs/release-notes/release-notes-v17.4.md @@ -24,7 +24,7 @@ We have extended Percona Distribution for PostgreSQL tarballs with PostGIS - an ### Deprecation of meta packages -[Meta-packages for Percona Distribution for PostgreSQL](../repo-overview.md#repository-contents) are deprecated and will be removed in future releases. +[Meta-packages for Percona Distribution for PostgreSQL](../repo-overview.md) are deprecated and will be removed in future releases. ## Supplied third-party extensions diff --git a/docs/release-notes/release-notes-v17.7.1.md b/docs/release-notes/release-notes-v17.7.1.md new file mode 100644 index 000000000..7fc886dc7 --- /dev/null +++ b/docs/release-notes/release-notes-v17.7.1.md @@ -0,0 +1,95 @@ +# Percona Distribution for PostgreSQL 17.7.1 ({{date.17_7_1}}) + +--8<-- "release-notes-intro.md" + +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). + +## Release Highlights + +### `pg_tde` is now a standalone package + +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). + +For more information on installing `pg_tde`, see [Install pg_tde :octicons-link-external-16:](https://docs.percona.com/pg-tde/install.html). + +Clusters that already have `pg_tde` in `shared_preload_libraries` will continue to operate normally after a minor upgrade. + +No user action is required. + +!!! note + 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. + +### Percona Telemetry Extension for PostgreSQL Deprecated + +The `percona_pg_telemetry` extension has been deprecated and replaced with a backwards compatibility stub to avoid breaking existing installations. + +No telemetry data will be gathered, it will not be maintained going forward and it should not be used in new deployments. + +### 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: + +- 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: 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). + +## Known Issue + +### For minor & major upgrades (RHEL only) + +During an upgrade on RHEL, you may encounter the following error: + +``` +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. + +## 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.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.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/) | 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.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.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. + +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." diff --git a/docs/release-notes/release-notes.md b/docs/release-notes/release-notes.md index 190a00954..0d7a6ca22 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 ## 2025 +* [17.7.1](release-notes-v17.7.1.md) ({{date.17_7_1}}) * [17.6.1](release-notes-v17.6.1.md) ({{date.17_6_1}}) * [17.5.3](release-notes-v17.5.3.md) ({{date.17_5_3}}) * [17.5.2](release-notes-v17.5.md) ({{date.17_5}}) diff --git a/docs/sboms.md b/docs/sboms.md index acaaaf457..20ca06011 100644 --- a/docs/sboms.md +++ b/docs/sboms.md @@ -6,21 +6,21 @@ Percona provides Software Bill of Materials (SBOMs), these files can help with c SBOMs are available for: === "Debian" - - [Debian 11 (Bullseye, x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-bullseye-x86_64.json) - - [Debian 11 (Bullseye, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-bullseye-aarch64.json) - - [Debian 12 (Bookworm, x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-bookworm-x86_64.json) - - [Debian 12 (Bookworm, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-bookworm-aarch64.json) + - [Debian 11 (Bullseye, x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-bullseye-x86_64.json) + - [Debian 11 (Bullseye, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-bullseye-aarch64.json) + - [Debian 12 (Bookworm, x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-bookworm-x86_64.json) + - [Debian 12 (Bookworm, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-bookworm-aarch64.json) === "Ubuntu" - - [Ubuntu 22.04 (Jammy, x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-jammy-x86_64.json) - - [Ubuntu 22.04 (Jammy, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-jammy-aarch64.json) - - [Ubuntu 24.04 (Noble, x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-noble-x86_64.json) - - [Ubuntu 24.04 (Noble, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-noble-aarch64.json) + - [Ubuntu 22.04 (Jammy, x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-jammy-x86_64.json) + - [Ubuntu 22.04 (Jammy, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-jammy-aarch64.json) + - [Ubuntu 24.04 (Noble, x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-noble-x86_64.json) + - [Ubuntu 24.04 (Noble, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-noble-aarch64.json) === "Red Hat Enterprise Linux (RHEL) and derivatives" - - [RHEL 8 (x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-ol8-x86_64.json) - - [RHEL 8 (aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-ol8-aarch64.json) - - [RHEL 9 (x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-ol9-x86_64.json) - - [RHEL 9 (aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-ol9-aarch64.json) - - [RHEL 10 (x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-ol10-x86_64.json) - - [RHEL 10 (aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-ol10-aarch64.json) + - [RHEL 8 (x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-ol8-x86_64.json) + - [RHEL 8 (aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-ol8-aarch64.json) + - [RHEL 9 (x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-ol9-x86_64.json) + - [RHEL 9 (aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-ol9-aarch64.json) + - [RHEL 10 (x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-ol10-x86_64.json) + - [RHEL 10 (aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-ol10-aarch64.json) 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 b4db2a382..e8ed45130 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-17/{{dockertag}}/binary/tarball/percona-postgresql-17.6-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-17/{{dockertag}}/binary/tarball/percona-postgresql-17.6-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-17/{{dockertag}}/binary/tarball/percona-postgresql-17.6-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-17/{{dockertag}}/binary/tarball/percona-postgresql-17.6-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-17/{{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-17/{{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-17/{{dockertag}}/binary/tarball/percona-postgresql-{{pgsubversion}}-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-17/{{dockertag}}/binary/tarball/percona-postgresql-{{pgsubversion}}-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-17/{{dockertag}}/binary/tarball/percona-postgresql-{{pgsubversion}}-ssl3-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-17/{{dockertag}}/binary/tarball/percona-postgresql-{{pgsubversion}}-ssl3-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/docs/templates/pdf_cover_page.tpl b/docs/templates/pdf_cover_page.tpl index 8eb76ee0e..b42745fbb 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.6.1 (September 10, 2025)

+

17.7.1 (December 02, 2025)

diff --git a/mkdocs.yml b/mkdocs.yml index 726339180..2de9d5417 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -88,6 +88,7 @@ nav: - Uninstall: uninstalling.md - Release notes: - "Release notes index": release-notes/release-notes.md + - "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 diff --git a/variables.yml b/variables.yml index f03cc4437..cc4215a58 100644 --- a/variables.yml +++ b/variables.yml @@ -2,17 +2,18 @@ # See also mkdocs.yml plugins.with-pdf.cover_subtitle and output_path -release: 'release-notes-v17.6.1' -dockertag: '17.6' -pgsubversion: '17.6' +release: 'release-notes-v17.7.1' +dockertag: '17.7' +pgsubversion: '17.7' pgversion: '17' -pspgversion: '17.6.1' +pspgversion: '17.7.1' pgsmversion: '2.1.1' date: + 17_7_1: 2025-12-02 17_6_1: 2025-09-10 17_5_3: 2025-09-01 17_5: 2025-06-30