Skip to content

Commit ac02bdb

Browse files
authored
PG-2347 - Add Release Notes (17) (#962)
This PR adds the release notes for PSP 17.
1 parent d4ba278 commit ac02bdb

8 files changed

Lines changed: 109 additions & 12 deletions

File tree

.github/workflows/main.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ jobs:
4343
- name: Deploy docs
4444
run: |
4545
mike deploy 17 -b publish -p
46-
mike retitle 17 "17.9" -b publish -p
46+
mike retitle 17 "17.10" -b publish -p
4747
4848
4949

_resourcepdf/overrides/main.html

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,12 +6,6 @@
66
{# Import the theme's layout. #}
77
{% extends "base.html" %}
88

9-
{% block announce %}
10-
<div class="md-banner" style="background-color: #b71c1c; color: white;">
11-
⚠️ pg_upgrade is currently broken with encrypted tables (pg_tde). Do NOT use it for upgrades.
12-
</div>
13-
{% endblock %}
14-
159
{% block scripts %}
1610
<script src="https://cmp.osano.com/Azqe5vTyLOSbN3OuT/49ad85b5-0418-4794-ab81-7599dddd534c/osano.js"></script>
1711
{{ super() }}
Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,98 @@
1+
# Percona Distribution for PostgreSQL 17.10.1 ({{date.17_10_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.10.1 - a binary compatible, open source drop in replacement of [PostgreSQL Community 17.10](https://www.postgresql.org/docs/17/release-17-10.html).
6+
7+
## Release Highlights
8+
9+
This release continues to deliver Percona’s open source value-add components for enterprise use cases, including `pg_tde` 2.2.0 for Transparent Data Encryption and more. See the full component list below for details.
10+
11+
!!! note
12+
`pg_tde` 2.2.0 requires Percona Distribution for PostgreSQL 17.10 at minimum. Earlier versions of PPG are not supported with this release of `pg_tde`.
13+
14+
To upgrade from earlier versions (e.g. Percona Distribution for PostgreSQL 16.x), follow the steps in [Upgrading Percona Distribution for PostgreSQL](../major-upgrade.md).
15+
16+
!!! note
17+
Starting with this release, `shared_preload_libraries` is empty by default. Extensions such as `pg_tde` must be added manually.
18+
19+
### Ubuntu 26.04 LTS support added
20+
21+
Percona Distribution for PostgreSQL is available on Ubuntu 26.04 LTS (Noble Numbat's successor). Packages are provided for AMD64 and ARM64 architectures.
22+
23+
### Added Quick Start guide
24+
25+
Added a Quick Start Guide walking users through setting up Percona Distribution for PostgreSQL with minimal steps and linking to more advanced topics.
26+
27+
### Tarball updates
28+
29+
The binary tarballs for x86_64 and ARM64 architectures have been updated in this release. The following libraries and components have new versions:
30+
31+
- postgres-common: 290
32+
- pgBouncer: 1.25.2
33+
- etcd: 3.5.30
34+
- pysyncobj: 0.3.15
35+
- haproxy: 2.8.23
36+
- patroni: 4.1.3
37+
- pgpool2: 4.7.1
38+
- postgis: 3.5.6
39+
- pg_gather: 33
40+
- pg_cron: 1.6.7
41+
- pg_tde: 2.2.0
42+
43+
See [Install Percona Distribution for PostgreSQL from binary tarballs](../tarball.md) for the download links.
44+
45+
### Addressed CVEs
46+
47+
This release includes important security measures that address the following CVEs: CVE-2026-6479, CVE-2026-6473, CVE-2026-6474, CVE-2026-6472, CVE-2026-6478, CVE-2026-6477, CVE-2026-6475, CVE-2026-6637. For more details, see the PostgreSQL [17.10 release notes :octicons-link-external-16:](https://www.postgresql.org/docs/17/release-17-10.html).
48+
49+
## Known Issues
50+
51+
### For minor & major upgrades (RHEL only)
52+
53+
During an upgrade on RHEL, you may encounter the following error:
54+
55+
```bash
56+
Unknown Error occurred: Transaction test error:
57+
file /usr/share/postgresql-common/server/postgresql.mk from install of percona-postgresql-common conflicts with file from package percona-postgresql-common-dev
58+
file /usr/share/postgresql-common/t/040_upgrade.t from install of percona-postgresql-common conflicts with file from package percona-postgresql-common-dev
59+
```
60+
61+
To resolve this, remove the `percona-postgresql-common-dev` package and reinstall it with the new intended upgraded PPG/PSP server.
62+
63+
## MD5 Authentication Deprecated
64+
65+
The md5 password authentication is deprecated now and will be removed in a future release.
66+
67+
## Supplied third-party extensions
68+
69+
Review each extension’s release notes for What’s new, improvements, or bug fixes.
70+
71+
The following is the list of extensions available in Percona Distribution for PostgreSQL.
72+
73+
| Extension | Version | Description |
74+
| --- | --- | --- |
75+
| [etcd :octicons-link-external-16:](https://etcd.io/) | 3.5.30 | A distributed, reliable key-value store for setting up highly available Patroni clusters |
76+
| [python-etcd :octicons-link-external-16:](https://python-etcd.readthedocs.io/en/latest/) | 0.4.5 | A Python client library for interacting with etcd |
77+
| [HAProxy :octicons-link-external-16:](https://www.haproxy.org/) | 2.8.23 | A high-availability and load-balancing solution |
78+
| [Patroni :octicons-link-external-16:](https://patroni.readthedocs.io/en/latest/) | 4.1.3 | A HA (High Availability) solution for PostgreSQL |
79+
| [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 |
80+
| [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 |
81+
| [pgBackRest :octicons-link-external-16:](https://pgbackrest.org/) | 2.58.0 | A backup and restore solution for PostgreSQL |
82+
| [pgBadger :octicons-link-external-16:](https://github.com/darold/pgbadger) | 13.2 | A fast PostgreSQL log analyzer |
83+
| [PgBouncer :octicons-link-external-16:](https://www.pgbouncer.org/) | 1.25.2 | A lightweight connection pooler for PostgreSQL |
84+
| [pg_cron :octicons-link-external-16:](https://github.com/citusdata/pg_cron) | 1.6.7 | A simple cron-based job scheduler for PostgreSQL |
85+
| [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 |
86+
| [pg_oidc_validator](https://github.com/Percona-Lab/pg_oidc_validator) | 1.0 | OAuth validator library for PostgreSQL 18 |
87+
| [pg_repack :octicons-link-external-16:](https://github.com/reorg/pg_repack) | 1.5.3 | Rebuilds PostgreSQL database objects |
88+
| [pg_stat_monitor](https://github.com/percona/pg_stat_monitor) | 2.3.2 | Collects and aggregates statistics for PostgreSQL and provides histogram information |
89+
| [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 |
90+
| [pg_vector](https://github.com/pgvector/pgvector) | v0.8.2 | A vector similarity search extension for PostgreSQL |
91+
| [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 |
92+
| [PostGIS :octicons-link-external-16:](https://github.com/postgis/postgis) | 3.5.6 | A spatial extension for PostgreSQL |
93+
| [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 |
94+
| [wal2json :octicons-link-external-16:](https://github.com/eulerto/wal2json) | 2.6 | A PostgreSQL logical decoding JSON output plugin |
95+
96+
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.
97+
98+
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."

docs/release-notes/release-notes.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@ This page lists all release notes for Percona Server for PostgreSQL 17, organize
44

55
## 2026
66

7+
* [17.10.1](release-notes-v17.10.1.md) ({{date.17_10_1}})
78
* [17.9.1](release-notes-v17.9.1.md) ({{date.17_9_1}})
89

910
## 2025

docs/sboms.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,8 @@ SBOMs are available for:
1818
- [Ubuntu 22.04 (Jammy, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-jammy-aarch64.json)
1919
- [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)
2020
- [Ubuntu 24.04 (Noble, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-noble-aarch64.json)
21+
- [Ubuntu 26.04 (Resolute, x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-resolute-x86_64.json)
22+
- [Ubuntu 26.04 (Resolute, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-resolute-aarch64.json)
2123

2224
=== "Red Hat Enterprise Linux (RHEL) and derivatives"
2325
- [RHEL 8 (x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-ol8-x86_64.json)

docs/templates/pdf_cover_page.tpl

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,6 @@
77
{% if config.site_description %}
88
<h1>{{ config.site_description }}</h1>
99
{% endif %}
10-
<h2>17.9.1 (March 02, 2026)</h2>
10+
<h2>17.10.1 (May 20, 2026)</h2>
1111
<!--<h3>Percona Technical Documentation Team</h3>-->
1212

mkdocs.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,7 @@ nav:
7878
- Uninstall: uninstalling.md
7979
- Release notes:
8080
- "Release notes index": release-notes/release-notes.md
81+
- "17.10.1": release-notes/release-notes-v17.10.1.md
8182
- "17.9.1": release-notes/release-notes-v17.9.1.md
8283
- 2025 (versions 17.4.1 - 17.7.1):
8384
- "17.7.1": release-notes/release-notes-v17.7.1.md

variables.yml

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,16 @@
22
# See also mkdocs.yml plugins.with-pdf.cover_subtitle and output_path
33

44

5-
release: 'release-notes-v17.9.1'
6-
dockertag: '17.9'
7-
pgsubversion: '17.9'
5+
release: 'release-notes-v17.10.1'
6+
dockertag: '17.10'
7+
pgsubversion: '17.10'
88
pgversion: '17'
9-
pspgversion: '17.9.1'
9+
pspgversion: '17.10.1'
1010
pgsmversion: '2.3.2'
1111

1212
date:
1313

14+
17_10_1: 2026-05-20
1415
17_9_1: 2026-03-02
1516
17_7_1: 2025-12-02
1617
17_6_1: 2025-09-10

0 commit comments

Comments
 (0)