From a3d5b1afa933ba6a441ffed284f3f692a874c2e0 Mon Sep 17 00:00:00 2001 From: Anastasia Alexandrova Date: Thu, 26 Dec 2024 16:50:00 +0100 Subject: [PATCH] PG-1173 Release notes 17.2 (#677) * PG-1173 Release notes 17.1 new file: docs/release-notes-v17.1.md modified: docs/release-notes.md modified: mkdocs-base.yml modified: variables.yml * PG-1220 Removed the step to disable llvm toolset --------- Signed-off-by: Anastasia Alexadrova --- docs/docker.md | 1 + docs/minor-upgrade.md | 2 +- docs/release-notes-v17.2.md | 48 +++++++++++++++++++++++++++++++++++++ docs/release-notes.md | 3 ++- docs/third-party.md | 1 + docs/yum.md | 30 ++++------------------- mkdocs-base.yml | 3 ++- variables.yml | 7 +++--- 8 files changed, 64 insertions(+), 31 deletions(-) create mode 100644 docs/release-notes-v17.2.md diff --git a/docs/docker.md b/docs/docker.md index 88ab7cd89..ec736623d 100644 --- a/docs/docker.md +++ b/docs/docker.md @@ -27,6 +27,7 @@ For more information about using Docker, see the [Docker Docs :octicons-link-ext | `percona-pgaudit{{pgversion}}_set_user`| An additional layer of logging and control when unprivileged users must escalate themselves to superuser or object owner roles in order to perform needed maintenance tasks.| | `percona-pg_repack{{pgversion}}`| rebuilds PostgreSQL database objects.| | `percona-wal2json{{pgversion}}` | a PostgreSQL logical decoding JSON output plugin.| + | `percona-pgvector` | A vector similarity search for PostgreSQL| ## Start the container {.power-number} diff --git a/docs/minor-upgrade.md b/docs/minor-upgrade.md index 50e237a88..22cecad60 100644 --- a/docs/minor-upgrade.md +++ b/docs/minor-upgrade.md @@ -81,4 +81,4 @@ Run **all** commands as root or via **sudo**: ``` -If you wish to upgrade Percona Distribution for PostgreSQL to the major version, refer to [Upgrading Percona Distribution for PostgreSQL from 15 to 16](major-upgrade.md). +If you wish to upgrade Percona Distribution for PostgreSQL to the major version, refer to [Upgrading Percona Distribution for PostgreSQL from 16 to 17](major-upgrade.md). diff --git a/docs/release-notes-v17.2.md b/docs/release-notes-v17.2.md new file mode 100644 index 000000000..4558c7a39 --- /dev/null +++ b/docs/release-notes-v17.2.md @@ -0,0 +1,48 @@ +# Percona Distribution for PostgreSQL 17.2.1 ({{date.17_2}}) + +--8<-- "release-notes-intro.md" + +This release of Percona Distribution for PostgreSQL is based on Percona Server for PostgreSQL 17.2.1 - a binary compatible, open source drop in replacement of [PostgreSQL Community 17.2](https://www.postgresql.org/docs/17/release-17-2.html). + +## Release Highlights + +* This release includes fixes for [CVE-2024-10978](https://www.postgresql.org/support/security/CVE-2024-10978/) and for certain PostgreSQL extensions that break because they depend on the modified Application Binary Interface (ABI). These regressions were introduced in PostgreSQL 17.1, 16.5, 15.9, 14.14, 13.17, and 12.21. For this reason, the release of Percona Distribution for PostgreSQL 17.1.1 has been skipped. +* Percona Distribution for PostgreSQL includes [`pgvector` :octicons-link-external-16](https://github.com/pgvector/pgvector) - an open source extension that enables you to use PostgreSQL as a vector database. It brings vector data type and vector operations (mainly similarity search) to PostgreSQL. You can install `pgvector` from repositories, tarballs, and it is also available as a Docker image. +* The new version of `pg_tde` extension features index encryption and the support of storing encryption keys in KMIP-compatible servers. These feature come with the Beta version of the `tde_heap` access method. Learn more in the [pg_tde release notes :octicons-link-external-16:](https://percona.github.io/pg_tde/main/release-notes/release-notes.html) +* The `pg_tde` extension itself is now a part of the Percona Server for PostgreSQL server package and a Docker image. If you installed the extension before, from its individual package, uninstall it first to avoid conflicts during the upgrade. See the [Minor Upgrade of Percona Distribution for PostgreSQL](minor-upgrade.md#preconditions) for details. +For how to run `pg_tde` in Docker, check the [Enable encryption](docker.md#enable-encryption) section in the documentation. +* Percona Distribution for PostgreSQL now statically links `llvmjit.so` library for Red Hat Enterprise Linux 8 and 9 and compatible derivatives. This resolves the conflict between the LLVM version required by Percona Distribution for PostgreSQL and the one supplied with the operating system. This also enables you to use the LLVM modules supplied with the operating system for other software you require. +* Percona Monitoring and Management (PMM) 2.43.2 is now compatible with `pg_stat_monitor` 2.1.0 to monitor PostgreSQL 17. + +------------------------------------------------------------------------------ + + +The following is the list of extensions available in Percona Distribution for PostgreSQL. + +| Extension | Version | Description | +| ------------------- | -------------- | ---------------------------- | +| [etcd](https://etcd.io/)| 3.5.16 | A distributed, reliable key-value store for setting up high available Patroni clusters | +|[HAProxy :octicons-link-external-16:](http://www.haproxy.org/) | 2.8.11 | a high-availability and load-balancing solution | +| [Patroni :octicons-link-external-16:](https://patroni.readthedocs.io/en/latest/) | 4.0.3 | a HA (High Availability) solution for PostgreSQL | +| [PgAudit :octicons-link-external-16:](https://www.pgaudit.org/) | 17.0 | provides 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.1.0 | 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 :octicons-link-external-16:](https://pgbackrest.org/) | 2.54.0 | a backup and restore solution for PostgreSQL | +|[pgBadger :octicons-link-external-16:](https://github.com/darold/pgbadger) | 12.4 | a fast PostgreSQL Log Analyzer.| +|[PgBouncer :octicons-link-external-16:](https://www.pgbouncer.org/) |1.23.1 | a lightweight connection pooler for PostgreSQL| +| [pg_gather :octicons-link-external-16:](https://github.com/jobinau/pg_gather)| v28 | an SQL script for running the diagnostics of the health of PostgreSQL cluster | +| [pgpool2 :octicons-link-external-16:](https://git.postgresql.org/gitweb/?p=pgpool2.git;a=summary) | 4.5.4 | 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.1 | rebuilds PostgreSQL database objects | +| [pg_stat_monitor :octicons-link-external-16:](https://github.com/percona/pg_stat_monitor)|{{pgsmversion}} | collects and aggregates statistics for PostgreSQL and provides histogram information.| +|[pgvector :octicons-link-external-16:](https://github.com/pgvector/pgvector)| v0.8.0 | A vector similarity search for PostgreSQL| +| [PostGIS :octicons-link-external-16:](https://github.com/postgis/postgis) | 3.3.7 | a spatial extension for PostgreSQL.| +| [PostgreSQL Common :octicons-link-external-16:](https://salsa.debian.org/postgresql/postgresql-common)| 265 | 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 :octicons-link-external-16:](https://github.com/eulerto/wal2json) |2.6 | a PostgreSQL logical decoding JSON output plugin| + +For Red Hat Enterprise Linux 8 and 9 and compatible derivatives, Percona Distribution for PostgreSQL also includes the following packages: + +* `llvm` 17.0.6 packages. This fixes compatibility issues with LLVM from upstream. +* supplemental `python3-etcd` 0.4.5 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/17/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." \ No newline at end of file diff --git a/docs/release-notes.md b/docs/release-notes.md index a35d71acb..d9908b262 100644 --- a/docs/release-notes.md +++ b/docs/release-notes.md @@ -1,3 +1,4 @@ # Percona Distribution for PostgreSQL release notes -* [Percona Distribution for PostgreSQL 17](release-notes-v17.0.md) ({{date.17_0}}) +* [Percona Distribution for PostgreSQL 17.2.1](release-notes-v17.2.md) ({{date.17_2}}) +* [Percona Distribution for PostgreSQL 17.0.1](release-notes-v17.0.md) ({{date.17_0}}) diff --git a/docs/third-party.md b/docs/third-party.md index b9e3253af..bcd1a3710 100644 --- a/docs/third-party.md +++ b/docs/third-party.md @@ -17,5 +17,6 @@ Percona Distribution for PostgreSQL is supplied with the set of third-party open | [pgpool2](https://www.pgpool.net/mediawiki/index.php/Main_Page) | Required | A middleware between PostgreSQL server and client for high availability, connection pooling and load balancing | | [pg_repack](https://github.com/reorg/pg_repack) | Required | Rebuilds PostgreSQL database objects | | [pg_stat_monitor](https://github.com/percona/pg_stat_monitor) | Required | Collects and aggregates statistics for PostgreSQL and provides histogram information | +| [pgvector](https://github.com/pgvector/pgvector)| Required | A vector similarity search for PostgreSQL| | [PostGIS](http://postgis.net/) | Required | Allows storing and manipulating spacial data in PostgreSQL | |[wal2json](https://github.com/eulerto/wal2json)|Required| A PostgreSQL logical decoding JSON output plugin.| \ No newline at end of file diff --git a/docs/yum.md b/docs/yum.md index fc3bd429a..cabf62fdb 100644 --- a/docs/yum.md +++ b/docs/yum.md @@ -19,10 +19,10 @@ Depending on what operating system you are using, you may need to enable or disa === "RHEL8/Oracle Linux 8/Rocky Linux 8" - Disable the ``postgresql`` and ``llvm-toolset``modules: + Disable the ``postgresql`` module: ```{.bash data-prompt="$"} - $ sudo dnf module disable postgresql llvm-toolset + $ sudo dnf module disable postgresql ``` ### For `percona-postgresql{{pgversion}}-devel` package @@ -39,7 +39,6 @@ You may need to install the `percona-postgresql{{pgversion}}-devel` package when ```{.bash data-prompt="$"} $ sudo dnf install dnf-plugins-core - $ sudo dnf module enable llvm-toolset $ sudo dnf config-manager --set-enabled powertools ``` @@ -53,7 +52,6 @@ You may need to install the `percona-postgresql{{pgversion}}-devel` package when ```{.bash data-prompt="$"} $ sudo dnf install dnf-plugins-core - $ sudo dnf module enable llvm-toolset $ sudo dnf config-manager --set-enabled crb $ sudo dnf install perl-IPC-Run -y ``` @@ -111,13 +109,7 @@ For Red Hat Enterprise Linux 8 and derivatives, replace the operating system ver $ sudo yum install epel-release ``` - 2. Enable the `llvm-toolset dnf` module - - ```{.bash data-prompt="$"} - $ sudo dnf module enable llvm-toolset - ``` - - 3. Enable the codeready builder repository to resolve dependencies conflict. + 2. Enable the codeready builder repository to resolve dependencies conflict. ```{.bash data-prompt="$"} $ sudo dnf config-manager --set-enabled codeready-builder-for-rhel-9-x86_64-rpms @@ -134,13 +126,7 @@ For Red Hat Enterprise Linux 8 and derivatives, replace the operating system ver $ sudo yum install epel-release ``` - 2. Enable the `llvm-toolset dnf` module - - ```{.bash data-prompt="$"} - $ sudo dnf module enable llvm-toolset - ``` - - 3. Enable the codeready builder repository to resolve dependencies conflict. + 2. Enable the codeready builder repository to resolve dependencies conflict. ```{.bash data-prompt="$"} $ sudo dnf install dnf-plugins-core @@ -158,13 +144,7 @@ For Red Hat Enterprise Linux 8 and derivatives, replace the operating system ver $ sudo yum install epel-release ``` - 2. Enable the `llvm-toolset dnf` module - - ```{.bash data-prompt="$"} - $ sudo dnf module enable llvm-toolset - ``` - - 3. Enable the codeready builder repository to resolve dependencies conflict. + 2. Enable the codeready builder repository to resolve dependencies conflict. ```{.bash data-prompt="$"} $ sudo dnf config-manager --set-enabled ol9_codeready_builder diff --git a/mkdocs-base.yml b/mkdocs-base.yml index 314cd13fe..35c02116d 100644 --- a/mkdocs-base.yml +++ b/mkdocs-base.yml @@ -131,7 +131,7 @@ plugins: output_path: '_pdf/PerconaDistributionPostgreSQL-17.pdf' cover_title: 'Distribution for PostgreSQL Documentation' - cover_subtitle: 17.0 (October 3, 2024) + cover_subtitle: 17.2 (December 26, 2024) author: 'Percona Technical Documentation Team' cover_logo: docs/_images/Percona_Logo_Color.png debug_html: false @@ -196,6 +196,7 @@ nav: - Uninstall: uninstalling.md - Release Notes: - "Release notes index": "release-notes.md" + - release-notes-v17.2.md - release-notes-v17.0.md - Reference: - Telemetry: telemetry.md diff --git a/variables.yml b/variables.yml index 9342bac61..5638ca60a 100644 --- a/variables.yml +++ b/variables.yml @@ -1,14 +1,15 @@ # PG Variables set for HTML output # See also mkdocs.yml plugins.with-pdf.cover_subtitle and output_path -release: 'release-notes-v17.0' -dockertag: '17.0' +release: 'release-notes-v17.2' +dockertag: '17.2' pgversion: '17' pgsmversion: '2.1.0' -pspgversion: '17.0.1' +pspgversion: '17.2.1' date: 17_0: 2024-10-03 + 17_2: 2024-12-26