Skip to content

Commit 2945371

Browse files
authored
PG-1786 Release Notes 13 (#839)
* PG-1786 Release Notes 13 * add sboms file, and notes on minor/major issue - populate release notes with more highlights - updated table versions * add actual update versions for components * Update variables.yml * Update variables.yml
1 parent 223833b commit 2945371

File tree

9 files changed

+144
-14
lines changed

9 files changed

+144
-14
lines changed

.github/workflows/main.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ jobs:
4444
- name: Deploy docs
4545
run: |
4646
mike deploy 13 -b publish -p
47-
mike retitle 13 "13.21" -b publish -p
47+
mike retitle 13 "13.22" -b publish -p
4848
4949
# - name: Install Node.js 14.x
5050
# uses: percona-platform/setup-node@v2

docs/major-upgrade.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -355,3 +355,15 @@ Run **all** commands as root or via **sudo**:
355355
```{.bash data-prompt="$"}
356356
$ rm -rf /var/lib/pgsql/12/data
357357
```
358+
359+
## For major upgrades (RHEL only)
360+
361+
During a major upgrade on RHEL, you may encounter the following error:
362+
363+
```
364+
Unknown Error occurred: Transaction test error:
365+
file /usr/share/postgresql-common/server/postgresql.mk from install of percona-postgresql-common conflicts with file from package percona-postgresql-common-dev
366+
file /usr/share/postgresql-common/t/040_upgrade.t from install of percona-postgresql-common conflicts with file from package percona-postgresql-common-dev
367+
```
368+
369+
To resolve this, remove the `percona-postgresql-common-dev` package and reinstall it with the new intended upgraded PPG/PSP server.

docs/minor-upgrade.md

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,6 @@ Though minor upgrades do not change the behavior, we recommend you to back up yo
66

77
Minor upgrade of Percona Distribution for PostgreSQL includes the following steps:
88

9-
109
1. Stop the `postgresql` cluster;
1110

1211
2. Update `percona-release`;
@@ -36,7 +35,6 @@ Run **all** commands as root or via **sudo**:
3635
$ sudo systemctl stop postgresql.service
3736
```
3837

39-
4038
=== ":material-redhat: On Red Hat Enterprise Linux and derivatives"
4139

4240
```{.bash data-promp="$"}
@@ -45,25 +43,32 @@ Run **all** commands as root or via **sudo**:
4543

4644
2. [Update `percona-release` to the latest version](https://docs.percona.com/percona-software-repositories/updating.html).
4745

48-
4946
3. Install new version packages. See [Installing Percona Distribution for PostgreSQL](installing.md).
5047

51-
5248
4. Restart the `postgresql` service.
5349

54-
5550
=== ":material-debian: On Debian / Ubuntu"
5651

5752
```{.bash data-prompt="$"}
5853
$ sudo systemctl start postgresql.service
5954
```
6055

61-
6256
=== ":material-redhat: On Red Hat Enterprise Linux and derivatives"
6357

6458
```{.bash data-prompt="$"}
6559
$ sudo systemctl start postgresql-13
6660
```
6761

62+
## For minor upgrades (RHEL only)
63+
64+
During a minor upgrade on RHEL, you may encounter the following error:
65+
66+
```
67+
Unknown Error occurred: Transaction test error:
68+
file /usr/share/postgresql-common/server/postgresql.mk from install of percona-postgresql-common conflicts with file from package percona-postgresql-common-dev
69+
file /usr/share/postgresql-common/t/040_upgrade.t from install of percona-postgresql-common conflicts with file from package percona-postgresql-common-dev
70+
```
71+
72+
To resolve this, remove the `percona-postgresql-common-dev` package and reinstall it with the new intended upgraded PPG/PSP server.
6873

6974
If you wish to upgrade Percona Distribution for PostgreSQL to the major version, refer to [Upgrading Percona Distribution for PostgreSQL from 12 to 13](major-upgrade.md).
Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
# Percona Distribution for PostgreSQL 13.22 ({{date.13_22}})
2+
3+
[Installation](../installing.md){.md-button}
4+
5+
--8<-- "release-notes-intro.md"
6+
7+
This release of Percona Distribution for PostgreSQL is based on [PostgreSQL 13.22](https://www.postgresql.org/docs/13/release-13-22.html).
8+
9+
## Release Highlights
10+
11+
### Tarball updates
12+
13+
The [installation preconditions for tarballs](../tarball.md) now include an extra step for RHEL, Rocky Linux, or Oracle Linux 10: installing the `acl` package.
14+
15+
The binary tarballs for x86_64 and ARM64 architectures have been updated in this release. The following libraries and components have new versions:
16+
17+
- LIBXSLT: 1.1.43
18+
- LUA: 5.3.6
19+
- LIBTIFF: 4.7.0
20+
- EXPAT: 2.5.0
21+
- PGPOOL: 4.6.2
22+
- PGBACKREST: 2.56.0
23+
- PATRONI: 4.0.6
24+
25+
See [Install Percona Distribution for PostgreSQL from binary tarballs](../tarball.md) for the download links.
26+
27+
The [installation preconditions for tarballs](../tarball.md) now include an extra step for RHEL, Rocky Linux, or Oracle Linux 10: installing the `acl` package.
28+
29+
### SBOMs available for download
30+
31+
Percona now provides Software Bill of Materials (SBOMs) to support compliance and security audits. SBOM files are available for tarball builds.
32+
33+
See [Software Bill of Materials (SBOMs)](../sboms.md) for the full list.
34+
35+
### Addressed CVEs
36+
37+
This release includes important security measures that address the following CVEs: CVE-2025-8713, CVE-2025-8714, and CVE-2025-8715. For more details, see the [PostgreSQL 13.22 release notes](https://www.postgresql.org/docs/release/13.22/).
38+
39+
## Known Issue
40+
41+
### For minor & major upgrades (RHEL only)
42+
43+
During an upgrade on RHEL, you may encounter the following error:
44+
45+
```
46+
Unknown Error occurred: Transaction test error:
47+
file /usr/share/postgresql-common/server/postgresql.mk from install of percona-postgresql-common conflicts with file from package percona-postgresql-common-dev
48+
file /usr/share/postgresql-common/t/040_upgrade.t from install of percona-postgresql-common conflicts with file from package percona-postgresql-common-dev
49+
```
50+
51+
To resolve this, remove the `percona-postgresql-common-dev` package and reinstall it with the new intended upgraded PPG/PSP server.
52+
53+
## Supplied third-party extensions
54+
55+
Review each extension’s release notes for What’s new, improvements, or bug fixes.
56+
57+
The following is the list of extensions available in Percona Distribution for PostgreSQL.
58+
59+
| Extension | Version | Description |
60+
|----------------------------------------------------------------------------------------|-----------|----------------------------------------------------------------------------------------------------------------------|
61+
| [etcd](https://etcd.io/) | 3.5.21 | A distributed, reliable key-value store for setting up high available Patroni clusters |
62+
| [python-etcd :octicons-link-external-16:](https://python-etcd.readthedocs.io/en/latest/) | 0.4.5 | A Python client library for interacting with etcd |
63+
| [HAProxy](http://www.haproxy.org/) | 2.8.15 | A high-availability and load-balancing solution |
64+
| [Patroni](https://patroni.readthedocs.io/en/latest/) | 4.0.6 | A HA (High Availability) solution for PostgreSQL |
65+
| [PgAudit](https://www.pgaudit.org/) | 1.5.3 | Provides detailed session or object audit logging via the standard logging facility provided by PostgreSQL |
66+
| [pgAudit set_user](https://github.com/pgaudit/set_user) | 4.1.0 | Provides an additional layer of logging and control when unprivileged users must escalate themselves to superusers or object owner roles to perform needed maintenance tasks. |
67+
| [pgBackRest](https://pgbackrest.org/) | 2.56.0 | A backup and restore solution for PostgreSQL |
68+
| [pgBadger](https://github.com/darold/pgbadger) | 13.1 | A fast PostgreSQL Log Analyzer. |
69+
| [PgBouncer](https://www.pgbouncer.org/) | 1.24.1 | A lightweight connection pooler for PostgreSQL |
70+
| [pg_gather](https://github.com/jobinau/pg_gather) | v31 | An SQL script for running the diagnostics of the health of PostgreSQL cluster |
71+
| [pgpool2](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. |
72+
| [pg_repack](https://github.com/reorg/pg_repack) | 1.5.2 | Rebuilds PostgreSQL database objects |
73+
| [pg_stat_monitor](https://github.com/percona/pg_stat_monitor) | 2.2.0 | Collects and aggregates statistics for PostgreSQL and provides histogram information. |
74+
| [pgvector](https://github.com/pgvector/pgvector) | v0.8.0 | A vector similarity search for PostgreSQL |
75+
| [PostGIS](https://github.com/postgis/postgis) | 3.3.8 | A spatial extension for PostgreSQL. |
76+
| [PostgreSQL Common](https://salsa.debian.org/postgresql/postgresql-common) | 280 | PostgreSQL database-cluster manager. It provides a structure under which multiple versions of PostgreSQL may be installed and/or multiple clusters maintained at one time. |
77+
| [wal2json](https://github.com/eulerto/wal2json) | 2.6 | A PostgreSQL logical decoding JSON output plugin |
78+
79+
For Red Hat Enterprise Linux 8 and 9 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.
80+
81+
Percona Distribution for PostgreSQL is also shipped with the [libpq](https://www.postgresql.org/docs/13/libpq.html) library. It contains "a set of
82+
library functions that allow client programs to pass queries to the PostgreSQL
83+
backend server and to receive the results of these queries."

docs/release-notes/release-notes.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ This page lists all release notes for Percona Distribution for PostgreSQL 13, or
44

55
## 2025
66

7+
* [13.22](release-notes-v13.22.md) ({{date.13_22}})
8+
79
* [13.21 Update](release-notes-v13.21.upd.md) ({{date.13_21_1}})
810

911
* [13.21](release-notes-v13.21.md) ({{date.13_21}})

docs/sboms.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
# Software Bill of Materials (SBOMs)
2+
3+
Percona provides Software Bill of Materials (SBOMs), these files can help with compliance and security audits.
4+
5+
SBOMs are available for:
6+
7+
=== "Debian"
8+
- [Debian 11 (Bullseye, x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-{{sbomtag}}/binary/tarball/sbom-percona-postgresql-{{dockertag}}-bullseye-x86_64.json)
9+
- [Debian 11 (Bullseye, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-{{sbomtag}}/binary/tarball/sbom-percona-postgresql-{{dockertag}}-bullseye-aarch64.json)
10+
- [Debian 12 (Bookworm, x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-{{sbomtag}}/binary/tarball/sbom-percona-postgresql-{{dockertag}}-bookworm-x86_64.json)
11+
- [Debian 12 (Bookworm, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-{{sbomtag}}/binary/tarball/sbom-percona-postgresql-{{dockertag}}-bookworm-aarch64.json)
12+
13+
=== "Ubuntu"
14+
- [Ubuntu 22.04 (Jammy, x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-{{sbomtag}}/binary/tarball/sbom-percona-postgresql-{{dockertag}}-jammy-x86_64.json)
15+
- [Ubuntu 22.04 (Jammy, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-{{sbomtag}}/binary/tarball/sbom-percona-postgresql-{{dockertag}}-jammy-aarch64.json)
16+
- [Ubuntu 24.04 (Noble, x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-{{sbomtag}}/binary/tarball/sbom-percona-postgresql-{{dockertag}}-noble-x86_64.json)
17+
- [Ubuntu 24.04 (Noble, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-{{sbomtag}}/binary/tarball/sbom-percona-postgresql-{{dockertag}}-noble-aarch64.json)
18+
19+
=== "Red Hat Enterprise Linux (RHEL) and derivatives"
20+
- [RHEL 8 (x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-{{sbomtag}}/binary/tarball/sbom-percona-postgresql-{{dockertag}}-ol8-x86_64.json)
21+
- [RHEL 8 (aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-{{sbomtag}}/binary/tarball/sbom-percona-postgresql-{{dockertag}}-ol8-aarch64.json)
22+
- [RHEL 9 (x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-{{sbomtag}}/binary/tarball/sbom-percona-postgresql-{{dockertag}}-ol9-x86_64.json)
23+
- [RHEL 9 (aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-{{sbomtag}}/binary/tarball/sbom-percona-postgresql-{{dockertag}}-ol9-aarch64.json)
24+
- [RHEL 10 (x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-{{sbomtag}}/binary/tarball/sbom-percona-postgresql-{{dockertag}}-ol10-x86_64.json)
25+
- [RHEL 10 (aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-{{sbomtag}}/binary/tarball/sbom-percona-postgresql-{{dockertag}}-ol10-aarch64.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>13.21 Update (July 17, 2025)</h2>
10+
<h2>13.22 (September 18, 2025)</h2>
1111
<!--<h3>Percona Technical Documentation Team</h3>-->
1212

mkdocs-base.yml

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -181,6 +181,7 @@ nav:
181181
- Run in Docker: docker.md
182182
- enable-extensions.md
183183
- repo-overview.md
184+
- sboms.md
184185
- 2. Connect to PostgreSQL: connect.md
185186
- 3. Manipulate data in PostgreSQL: crud.md
186187
- 4. What's next: whats-next.md
@@ -227,10 +228,10 @@ nav:
227228
- Uninstall: uninstalling.md
228229
- Release notes:
229230
- "Release notes index": release-notes/release-notes.md
230-
- 2025:
231-
- "13.21 Update": release-notes/release-notes-v13.21.upd.md
232-
- "13.21": release-notes/release-notes-v13.21.md
233-
- "13.20": release-notes/release-notes-v13.20.md
231+
- "13.22": release-notes/release-notes-v13.22.md
232+
- "13.21 Update": release-notes/release-notes-v13.21.upd.md
233+
- "13.21": release-notes/release-notes-v13.21.md
234+
- "13.20": release-notes/release-notes-v13.20.md
234235
- 2024 (versions 13.13 Update - 13.18):
235236
- "13.18": release-notes/release-notes-v13.18.md
236237
- "13.16": release-notes/release-notes-v13.16.md

variables.yml

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,13 @@
11
# PG Variables set for HTML output
22
# See also mkdocs.yml plugins.with-pdf.cover_subtitle and output_path
33

4-
release: 'release-notes-v13.21'
4+
release: 'release-notes-v13.22'
55
pgversion: '13'
6-
dockertag: '13.21'
6+
dockertag: '13.22'
7+
sbomtag: '13/13.22'
78

89
date:
10+
13_22: 2025-09-18
911
13_21_1: 2025-07-17
1012
13_21: 2025-06-30
1113
13_20: 2025-03-06

0 commit comments

Comments
 (0)