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 <[email protected]>
percona · Dec 26, 2024 · a3d5b1a · a3d5b1a
1 parent 6b4ac16
commit a3d5b1a
Show file tree

Hide file tree

Showing 8 changed files with 64 additions and 31 deletions.
diff --git 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
@@ -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
@@ -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." 
diff --git 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
@@ -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.|
diff --git 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
@@ -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
@@ -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
Original file line number	Diff line number	Diff line change
Expand Up		@@ -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).