PG-790 Release notes 15.7 (#585)

* PG-790 Release notes 15.7 * Added a note reg. major upgrade modified: .github/workflows/main.yml new file: docs/release-notes-v15.7.md modified: docs/release-notes.md modified: mkdocs-base.yml modified: variables.yml
percona · Jun 6, 2024 · 22dce26 · 22dce26
1 parent ab11fbd
commit 22dce26
Show file tree

Hide file tree

Showing 7 changed files with 76 additions and 11 deletions.
diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
@@ -46,7 +46,7 @@ jobs:
       - name: Deploy docs
         run: |
           mike deploy 15 -b publish -p
-          mike retitle 15 "15.5" -b publish -p
+          mike retitle 15 "15.7" -b publish -p
 
 # - name: Install Node.js 14.x
 #        uses: percona-platform/setup-node@v2

diff --git a/docs/major-upgrade.md b/docs/major-upgrade.md
@@ -2,6 +2,18 @@
 
 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 14.11 to 14.12).
+    * Then, perform the major upgrade to your desired version (e.g., from 14.12 to 15.7).
+
+
 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"

diff --git a/docs/pg-stat-monitor.md b/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
 

diff --git a/docs/release-notes-v15.7.md b/docs/release-notes-v15.7.md
@@ -0,0 +1,48 @@
+# Percona Distribution for PostgreSQL 15.7 (2024-06-06)
+
+[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 15.7](https://www.postgresql.org/docs/current/release-15-7.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 14.11, upgrade to 14.12 first, then you can upgrade to 15.7. 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.7.0   | 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 maintained at one time.|
+|[wal2json](https://github.com/eulerto/wal2json)  |2.6       | a PostgreSQL logical decoding JSON output plugin|
+
+
+Percona Distribution for PostgreSQL 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/15/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.md b/docs/release-notes.md
@@ -1,5 +1,7 @@
 # Percona Distribution for PostgreSQL release notes 
 
+* [Percona Distribution for PostgreSQL 15.7](release-notes-v15.7.md) (2024-06-06)
+
 * [Percona Distribution for PostgreSQL 15.6](release-notes-v15.6.md) (2024-02-28)
 
 * [Percona Distribution for PostgreSQL 15.5 Update](release-notes-v15.5.upd.md) (2024-01-18)

diff --git a/mkdocs-base.yml b/mkdocs-base.yml
@@ -131,7 +131,7 @@ plugins:
   with-pdf: # https://github.com/orzih/mkdocs-with-pdf
           output_path: '_pdf/PerconaDistributionPostgreSQL-15.pdf'
           cover_title: 'Distribution for PostgreSQL Documentation'
-          cover_subtitle: 15.6 (February 28, 2024)
+          cover_subtitle: 15.7 (June 6, 2024)
           author: 'Percona Technical Documentation Team'
           cover_logo: docs/_images/Percona_Logo_Color.png
           debug_html: false
@@ -148,19 +148,21 @@ extra:
     provider: mike
   #homepage:
   #  https://docs.percona.com
-  postgresrecommended: 16
+  postgresrecommended: 15
 
 nav:
   - 'Home': 'index.md'
   - Release Notes:
       - "Release notes index": "release-notes.md"
+      - release-notes-v15.7.md
       - release-notes-v15.6.md
       - release-notes-v15.5.upd.md
-      - release-notes-v15.5.md
-      - release-notes-v15.4.md
-      - release-notes-v15.3.md
-      - release-notes-v15.2.upd.md
-      - release-notes-v15.2.md
+      - 2023 (versions 15.2 - 15.5):
+        - release-notes-v15.5.md
+        - release-notes-v15.4.md
+        - release-notes-v15.3.md
+        - release-notes-v15.2.upd.md
+        - release-notes-v15.2.md
       - 2022 (versions 15.0 - 15.1):
         - release-notes-v15.1.md
         - release-notes-v15.0.md

diff --git a/variables.yml b/variables.yml
@@ -2,6 +2,7 @@
 # See also mkdocs.yml plugins.with-pdf.cover_subtitle and output_path
 
 
-release: 'release-notes-v15.6'
+release: 'release-notes-v15.7'
 pgversion: '15'
-dockertag: '15.6'
+dockertag: '15.7'
+pgsmversion: '2.0.4'