PG-2164 - Release Notes 18.3.1 (#917)

Andriciuc · web-flow · commit ecbff4f89bbf · 2026-03-02T17:08:34.000+02:00
This PR adds the release notes for version 18.2.1 of PPG.
diff --git a/docs/release-notes/release-notes-v18.3.1.md b/docs/release-notes/release-notes-v18.3.1.md
@@ -0,0 +1,87 @@
+# Percona Distribution for PostgreSQL 18.3.1 ({{date.18_3_1}})
+
+--8<-- "release-notes-intro.md"
+
+This release of Percona Distribution for PostgreSQL is based on Percona Server for PostgreSQL 18.3.1 - a binary compatible, open source drop in replacement of [PostgreSQL Community 18.3](https://www.postgresql.org/docs/18/release-18-3.html).
+
+## Release Highlights
+
+This release continues to deliver Percona’s open source value-add components for enterprise use cases, including `pg_stat_monitor` 2.3.2 for advanced query-level observability, `pg_tde` 2.1.2 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).
+
+### 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.1
+- pgvector: 0.8.2
+- pgpool2: 4.7.0
+- etcd: 3.5.26
+- PostGIS: 3.5.5
+- pgBackRest: 2.58.0
+- postgresql-common: 289
+- pgBadger: 13.2
+- HAProxy: 2.8.18
+- pg_stat_monitor: 2.3.2
+- pg_tde: 2.1.2
+- postgis: 3.5.5
+- pg_oidc_validator: 1.0
+- ydiff: 1.4.2
+
+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-2026-2003, CVE-2026-2004, CVE-2026-2005, CVE-2026-2006, CVE-2026-2007. For more details, see the [PostgreSQL 18.3 release notes](https://www.postgresql.org/docs/18/release-18-3.html) and the [PostgreSQL 18.2 release notes](https://www.postgresql.org/docs/18/release-18-2.html).
+
+## Known Issues
+
+### For minor & major upgrades (RHEL only)
+
+During an upgrade on RHEL, you may encounter the following error:
+
+```bash
+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.
+
+## 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.26   | 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.18    | 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.58.0    | A backup and restore solution for PostgreSQL                                                                        |
+| [pgBadger :octicons-link-external-16:](https://github.com/darold/pgbadger)           | 13.2      | A fast PostgreSQL Log Analyzer                                                                                      |
+| [PgBouncer :octicons-link-external-16:](https://www.pgbouncer.org/)                  | 1.25.1    | 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.7.0 | 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.2     | Collects and aggregates statistics for PostgreSQL and provides histogram information.                                |
+| [pgvector :octicons-link-external-16:](https://github.com/pgvector/pgvector)         | v0.8.2    | A vector similarity search for PostgreSQL                                                                           |
+| [PostGIS :octicons-link-external-16:](https://github.com/postgis/postgis)            | 3.5.5     | A spatial extension for PostgreSQL                                                                                  |
+| [PostgreSQL Common :octicons-link-external-16:](https://salsa.debian.org/postgresql/postgresql-common) | 289 | 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.2       | A PostgreSQL extension that provides Transparent Data Encryption (TDE) to protect data at rest                                                                    |
+| [pg_oidc_validator](https://github.com/Percona-Lab/pg_oidc_validator) | 1.0 | OAuth validator library for PostgreSQL 18. |
+
+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/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."
diff --git a/docs/release-notes/release-notes.md b/docs/release-notes/release-notes.md
@@ -2,6 +2,10 @@
 
 This page lists all release notes for Percona Server for PostgreSQL 18, organized by year and version. Use it to track new features, fixes, and updates across major and minor versions.
 
+## 2026
+
+* [18.3.1](release-notes-v18.3.1.md) ({{date.18_3_1}})
+
 ## 2025
 
 * [18.1.1](release-notes-v18.1.1.md) ({{date.18_1_1}})
diff --git a/docs/templates/pdf_cover_page.tpl b/docs/templates/pdf_cover_page.tpl
@@ -7,6 +7,6 @@
 {% if config.site_description %}
 <h1>{{ config.site_description }}</h1>
 {% endif %} 
-<h2>18.1.1 (November 28, 2025)</h2>
+<h2>18.3.1 (March 02, 2026)</h2>
 <!--<h3>Percona Technical Documentation Team</h3>-->
 
diff --git a/mkdocs-base.yml b/mkdocs-base.yml
@@ -3,7 +3,7 @@
 site_name: Percona Distribution for PostgreSQL
 site_description: Documentation
 site_author: Percona LLC
-copyright:  <a href="https://www.percona.com/about">Percona LLC</a> and/or its affiliates © 2025 — <a href="#__consent">Cookie Consent</a>
+copyright:  <a href="https://www.percona.com/about">Percona LLC</a> and/or its affiliates © 2026 — <a href="#__consent">Cookie Consent</a>
 
 repo_name: percona/postgresql-docs
 repo_url: https://github.com/percona/postgresql-docs
@@ -226,6 +226,7 @@ nav:
   - Uninstall: uninstalling.md
   - Release notes:
       - "Release notes index": release-notes/release-notes.md
+      - "18.2.1": release-notes/release-notes-v18.2.1.md
       - "18.1.1": release-notes/release-notes-v18.1.1.md
   - Reference:
       - Telemetry: telemetry.md
diff --git a/mkdocs-pdf.yml b/mkdocs-pdf.yml
@@ -3,7 +3,7 @@
 
 INHERIT: mkdocs-base.yml
 
-copyright: Percona LLC, &#169; 2025
+copyright: Percona LLC, &#169; 2026
 
 extra_css:
   - https://unicons.iconscout.com/release/v3.0.3/css/line.css
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -73,7 +73,9 @@ nav:
   - Uninstall: uninstalling.md
   - Release notes:
       - "Release notes index": release-notes/release-notes.md
-      - "18.1.1": release-notes/release-notes-v18.1.1.md
+      - "18.3.1": release-notes/release-notes-v18.3.1.md
+      - "2025":
+        - "18.1.1": release-notes/release-notes-v18.1.1.md
   - Reference:
       - Telemetry: telemetry.md
       - Licensing: licensing.md
diff --git a/variables.yml b/variables.yml
@@ -1,12 +1,13 @@
 # PG Variables set for HTML output
 # See also mkdocs.yml plugins.with-pdf.cover_subtitle and output_path
 
-release: 'release-notes-v18.1.1'
-dockertag: '18.1'
-pgsubversion: '18.1'
+release: 'release-notes-v18.3.1'
+dockertag: '18.3'
+pgsubversion: '18.3'
 pgversion: '18'
-pspgversion: '18.1.1'
-pgsmversion: '2.1.1'
+pspgversion: '18.3.1'
+pgsmversion: '2.3.2'
 
 date:
+  18_3_1: 2026-03-02
   18_1_1: 2025-11-28
