PG-754 RElease notes 14.12 (#587)

* PG-754 RElease notes 14.12

modified:   docs/major-upgrade.md
        modified:   docs/pg-stat-monitor.md
        new file:   docs/release-notes-v14.12.md
        modified:   docs/release-notes.md
        modified:   mkdocs-base.yml
        modified:   variables.yml

.github/workflows/main.yml

@@ -45,7 +45,7 @@ jobs:
       - name: Deploy docs
         run: |
           mike deploy 14 -b publish -p
-          mike retitle 14 "14.11" -b publish -p
+          mike retitle 14 "14.12" -b publish -p
 
 # - name: Install Node.js 14.x
 #        uses: percona-platform/setup-node@v2

docs/major-upgrade.md

@@ -2,6 +2,19 @@
 
 This document describes the in-place upgrade of Percona Distribution for PostgreSQL using the `pg_upgrade`
 tool.
+
+!!! important
+
+    When running a major upgrade on **RHEL 8 and compatible derivatives**, consider the following:
+
+    Percona Distribution for PostgreSQL 16.3, 15.7, 14.12, 13.15 and 12.18 include `llvm` packages 16.0.6, while its previous versions 16.2, 15.6, 14.11, 13.14, and 12.17 include `llvm` 12.0.1. Since `llvm` libraries differ and are not compatible, the direct major version upgrade from 15.6 to 16.3 may cause issues. 
+
+    To ensure a smooth upgrade path, follow these steps:
+
+    * Upgrade to the latest minor version within your current major version (e.g., from 13.14 to 13.15).
+    * Then, perform the major upgrade to your desired version (e.g., from 13.15 to 14.12).
+
+
 The in-place upgrade means installing a new version without removing the old version and keeping the data files on the server.
 
 !!! admonition "See also"

docs/pg-stat-monitor.md

@@ -2,7 +2,7 @@
 
 !!! note
 
-    This document describes the functionality of pg_stat_monitor 2.0.0.
+    This document describes the functionality of pg_stat_monitor {{pgsmversion}}.
 
 ## Overview
 

docs/release-notes-v14.12.md

@@ -0,0 +1,49 @@
+# Percona Distribution for PostgreSQL 14.12 (2024-06-07)
+
+[Installation](installing.md){.md-button}
+
+Percona Distribution for PostgreSQL is a solution with the collection of tools from PostgreSQL community that are tested to work together and serve to assist you in deploying and managing PostgreSQL. The aim of Percona Distribution for PostgreSQL is to address the operational issues like High-Availability, Disaster Recovery, Security, Observability, Spatial data handling, Performance and Scalability and others that enterprises are facing.
+
+
+This release of Percona Distribution for PostgreSQL is based on [PostgreSQL 14.12](https://www.postgresql.org/docs/14/release-14-12.html). 
+
+## Release Highlights
+
+* Percona Distribution for PostgreSQL now includes the ETCD distributed configuration store version 3.5.x for all supported operating systems. This enhancement simplifies deploying high-availability solutions because you can install all necessary components from a single source, ensuring their seamless compatibility.
+* Percona Distribution for PostgreSQL is now available on Ubuntu 24.04 LTS Noble Numbat.
+* Percona Distribution for PostgreSQL on Red Hat Enterprise Linux 8 and compatible derivatives is now fully compatible with upstream `llvm` packages and includes the latest version 16.0.6 of them. 
+
+    To ensure a smooth upgrade process, the recommended approach is to  **upgrade to the latest minor version within your current major version before going to the next major version**. For example, if you're currently on 13.14, upgrade to 13.15 first, then you can upgrade to 14.12. This two-step approach avoids any potential conflicts caused by differing `llvm` versions on Red Hat Enterprise Linux 8 and compatible derivatives.
+
+
+------------------------------------------------------------------------------
+
+The following is the list of extensions available in Percona Distribution for PostgreSQL.
+
+| Extension           | Version        | Description                  |
+| ------------------- | -------------- | ---------------------------- |
+| [ETCD](https://etcd.io/)| 3.5.13 | A distributed, reliable key-value store for setting up high available Patroni clusters |
+|[HAProxy](http://www.haproxy.org/) | 2.8.9 | a high-availability and load-balancing solution |
+| [Patroni](https://patroni.readthedocs.io/en/latest/) | 3.3.0 | a HA (High Availability) solution for PostgreSQL |
+| [PgAudit](https://www.pgaudit.org/)             | 1.6.2   | provides detailed session or object audit logging via the standard logging facility provided by PostgreSQL                |
+| [pgAudit set_user](https://github.com/pgaudit/set_user)| 4.0.1 | provides an additional layer of logging and control when unprivileged users must escalate themselves to superusers or object owner roles in order to perform needed maintenance tasks.|
+| [pgBackRest](https://pgbackrest.org/)           | 2.51    | a backup and restore solution for PostgreSQL       |
+|[pgBadger](https://github.com/darold/pgbadger)   | 12.4     | a fast PostgreSQL Log Analyzer.|
+|[PgBouncer](https://www.pgbouncer.org/)          |1.22.1    | a lightweight connection pooler for PostgreSQL|
+| [pg_gather](https://github.com/jobinau/pg_gather)| v26     | an SQL script for running the diagnostics of the health of PostgreSQL cluster |
+| [pgpool2](https://git.postgresql.org/gitweb/?p=pgpool2.git;a=summary) | 4.5.1 | a middleware between PostgreSQL server and client for high availability, connection pooling and load balancing.|
+| [pg_repack](https://github.com/reorg/pg_repack) | 1.5.0   | rebuilds PostgreSQL database objects           |
+| [pg_stat_monitor](https://github.com/percona/pg_stat_monitor)|{{pgsmversion}} | collects and aggregates statistics for PostgreSQL and provides histogram information.|
+| [PostGIS](https://github.com/postgis/postgis) | 3.3.6 | a spatial extension for PostgreSQL.|
+| [PostgreSQL Common](https://salsa.debian.org/postgresql/postgresql-common)| 259 | PostgreSQL database-cluster manager. It provides a structure under which multiple versions of PostgreSQL may be installed and/or multiple clusters may be maintained at one time.|
+|[wal2json](https://github.com/eulerto/wal2json)  |2.6       | a PostgreSQL logical decoding JSON output plugin|
+
+
+Percona Distribution for PostgreSQL on Red Hat Enterprise Linux 8 and compatible derivatives also includes the following packages:
+
+* `llvm` 16.0.6 packages. This fixes compatibility issues with LLVM from upstream.
+* supplemental `python3-etcd` packages, which can be used for setting up Patroni clusters. 
+
+Percona Distribution for PostgreSQL is also shipped with the [libpq](https://www.postgresql.org/docs/14/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.md

@@ -1,5 +1,7 @@
 # Release notes index
 
+* [Percona  Distribution for PostgreSQL 14.12](release-notes-v14.12.md) (2024-06-07)
+
 * [Percona Distribution for PostgreSQL 14.11](release-notes-v14.11.md) (2024-03-01)
 
 * [Percona Distribution for PostgreSQL 14.10 Update](release-notes-v14.10.upd.md) (2024-01-19)

mkdocs-base.yml

@@ -131,7 +131,7 @@ plugins:
   with-pdf: # https://github.com/orzih/mkdocs-with-pdf
           output_path: '_pdf/PerconaDistributionPostgreSQL-14.pdf'
           cover_title: 'Percona Distribution for PostgreSQL Documentation'
-          cover_subtitle: 14.11 (March 01, 2024)
+          cover_subtitle: 14.11 (June 07, 2024)
           author: 'Percona Technical Documentation Team'
           cover_logo: docs/_images/Percona_Logo_Color.png
           debug_html: false
@@ -154,6 +154,7 @@ nav:
   - Home: index.md
   - Release notes:
       - "Release notes index": "release-notes.md"
+      - release-notes-v14.12.md
       - release-notes-v14.11.md
       - release-notes-v14.10.upd.md
       - release-notes-v14.10.md

variables.yml

@@ -2,6 +2,7 @@
 # See also mkdocs.yml plugins.with-pdf.cover_subtitle and output_path
 
 
-release: 'release-notes-v14.11'
+release: 'release-notes-v14.12'
 pgversion: '14'
-dockertag: '14.11'
+dockertag: '14.12'
+pgsmversion: '2.0.4'