From cc93da36976919648111e1557646162aae2c3dfb Mon Sep 17 00:00:00 2001 From: Anastasia Alexandrova Date: Fri, 7 Jun 2024 17:53:51 +0300 Subject: [PATCH] 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 | 2 +- docs/major-upgrade.md | 13 ++++++++++ docs/pg-stat-monitor.md | 2 +- docs/release-notes-v14.12.md | 49 ++++++++++++++++++++++++++++++++++++ docs/release-notes.md | 2 ++ mkdocs-base.yml | 3 ++- variables.yml | 5 ++-- 7 files changed, 71 insertions(+), 5 deletions(-) create mode 100644 docs/release-notes-v14.12.md diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index 5b72bf6b0..f1fea1654 100644 --- a/.github/workflows/main.yml +++ b/.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 diff --git a/docs/major-upgrade.md b/docs/major-upgrade.md index 3209f658a..3e8d6fc1a 100644 --- a/docs/major-upgrade.md +++ b/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" diff --git a/docs/pg-stat-monitor.md b/docs/pg-stat-monitor.md index fe0b84a71..23a2531b1 100644 --- 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-v14.12.md b/docs/release-notes-v14.12.md new file mode 100644 index 000000000..79e2c6b27 --- /dev/null +++ b/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." diff --git a/docs/release-notes.md b/docs/release-notes.md index e230e51ff..33ef514ce 100644 --- a/docs/release-notes.md +++ b/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) diff --git a/mkdocs-base.yml b/mkdocs-base.yml index 132d9b152..fae654c04 100644 --- 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-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 diff --git a/variables.yml b/variables.yml index a3a37418b..d05c52b88 100644 --- 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-v14.11' +release: 'release-notes-v14.12' pgversion: '14' -dockertag: '14.11' +dockertag: '14.12' +pgsmversion: '2.0.4'