Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/main.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
2 changes: 1 addition & 1 deletion docs/release-notes/release-notes-v17.4.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
95 changes: 95 additions & 0 deletions docs/release-notes/release-notes-v17.7.1.md
Original file line number Diff line number Diff line change
@@ -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."
1 change: 1 addition & 0 deletions docs/release-notes/release-notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -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}})
Expand Down
28 changes: 14 additions & 14 deletions docs/sboms.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
2 changes: 1 addition & 1 deletion docs/solutions/ha-etcd-config.md
Original file line number Diff line number Diff line change
@@ -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

Expand Down
10 changes: 6 additions & 4 deletions docs/tarball.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:

Expand Down
2 changes: 1 addition & 1 deletion docs/templates/pdf_cover_page.tpl
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,6 @@
{% if config.site_description %}
<h1>{{ config.site_description }}</h1>
{% endif %}
<h2>17.6.1 (September 10, 2025)</h2>
<h2>17.7.1 (December 02, 2025)</h2>
<!--<h3>Percona Technical Documentation Team</h3>-->

1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
9 changes: 5 additions & 4 deletions variables.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down