diff --git a/docs/index.md b/docs/index.md index cec54cd17..cab4542e7 100644 --- a/docs/index.md +++ b/docs/index.md @@ -48,11 +48,6 @@ Our comprehensive resources will help you overcome challenges, from everyday iss Learn about the releases and changes in the Distribution. -[Release notes :material-arrow-right:]({{release}}.md){.md-button} +[Release notes :material-arrow-right:](release-notes/{{release}}.md){.md-button} - - - - - diff --git a/docs/release-notes.md b/docs/release-notes.md deleted file mode 100644 index 5122eaa20..000000000 --- a/docs/release-notes.md +++ /dev/null @@ -1,6 +0,0 @@ -# Percona Distribution for PostgreSQL release notes - -* [Percona Distribution for PostgreSQL 17.5.2](release-notes-v17.5.md) ({{date.17_5}}) -* [Percona Distribution for PostgreSQL 17.4.1](release-notes-v17.4.md) ({{date.17_4}}) -* [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/release-notes-v17.0.md b/docs/release-notes/release-notes-v17.0.md similarity index 95% rename from docs/release-notes-v17.0.md rename to docs/release-notes/release-notes-v17.0.md index d2247029b..755bba199 100644 --- a/docs/release-notes-v17.0.md +++ b/docs/release-notes/release-notes-v17.0.md @@ -1,16 +1,15 @@ # Percona Distribution for PostgreSQL 17.0.1 ({{date.17_0}}) -[Installation](installing.md){.md-button} -[Upgrade](major-upgrade.md){.md-button} - +[Installation](../installing.md){.md-button} +[Upgrade](../major-upgrade.md){.md-button} We are pleased to announce the launch of Percona Distribution for PostgreSQL 17.0.1 - 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 **Percona Server for PostgreSQL 17.0.1** - a binary compatible, open source drop in replacement of [PostgreSQL Community 17.0 :octicons-link-external-16:](https://www.postgresql.org/docs/17/release-17.html). +This release of Percona Distribution for PostgreSQL is based on **Percona Server for PostgreSQL 17.0.1** - a binary compatible, open source drop in replacement of [PostgreSQL Community 17.0 :octicons-link-external-16:](https://www.postgresql.org/docs/17/release-17.html). -Both Percona Server for PostgreSQL and PostgreSQL Community function identically enabling you to migrate from one to another. +Both Percona Server for PostgreSQL and PostgreSQL Community function identically enabling you to migrate from one to another. -Percona Server for PostgreSQL 17.0.1 has the extra digit in version which represents Percona version number. +Percona Server for PostgreSQL 17.0.1 has the extra digit in version which represents Percona version number. To check what software you're running, run the following SQL query: @@ -70,7 +69,7 @@ This feature is especially beneficial for organizations with large data sets whe #### Replication improvements -* Gain more control for managing PostgreSQL databases in high availability environments with the ability to continue logical replication from a new primary node after the failover. +* Gain more control for managing PostgreSQL databases in high availability environments with the ability to continue logical replication from a new primary node after the failover. * Track inactive and invalid replication slots in the `pg_replication_slots` view. With the `inactive_since` and `invalidation_reason` columns added to this view, you can get insights when a slot became inactive as well as the reason for an invalid slot. * Convert a physical replica into a logical one using the new [`pg_createsubscriber`](https://www.postgresql.org/docs/17/app-pgcreatesubscriber.html) command-line tool @@ -80,10 +79,10 @@ This feature is especially beneficial for organizations with large data sets whe #### Monitoring improvements -* Get deeper insights about query plans and execution with the new options for the EXPLAIN command: +* Get deeper insights about query plans and execution with the new options for the EXPLAIN command: * SERIALIZE shows the amount of time it takes to convert data for network transmission - * MEMORY reports optimizer memory usage + * MEMORY reports optimizer memory usage * Learn about why an active session is waiting using the `pg_stat_activity` and new `pg_wait_events` views @@ -99,14 +98,12 @@ Participate in monthly SWAG raffles, get an early access to new product features ## Known Limitations -Percona Monitoring and Management (PMM) 2.43.1 is not compatible with `pg_stat_monitor` 2.1.0 to monitor PostgreSQL 17. However, PMM is compatible with `pg_stat_monitor` 2.1.0 for monitoring of PostgreSQL 16 and previous versions. +Percona Monitoring and Management (PMM) 2.43.1 is not compatible with `pg_stat_monitor` 2.1.0 to monitor PostgreSQL 17. However, PMM is compatible with `pg_stat_monitor` 2.1.0 for monitoring of PostgreSQL 16 and previous versions. The support for PostgreSQL 17 will be available in the future PMM release. - ------------------------------------------------------------------------------ - The following is the list of extensions available in Percona Distribution for PostgreSQL. | Extension | Version | Description | @@ -130,8 +127,8 @@ The following is the list of extensions available in Percona Distribution for Po Percona Distribution for PostgreSQL on Red Hat Enterprise Linux 8 and compatible derivatives also includes the following packages: * `llvm` 17.0.6 packages. This fixes compatibility issues with LLVM from upstream. -* supplemental `python3-etcd` packages, which can be used for setting up Patroni clusters. +* 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/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 +backend server and to receive the results of these queries." diff --git a/docs/release-notes-v17.2.md b/docs/release-notes/release-notes-v17.2.md similarity index 93% rename from docs/release-notes-v17.2.md rename to docs/release-notes/release-notes-v17.2.md index 6d97890d0..5155049be 100644 --- a/docs/release-notes-v17.2.md +++ b/docs/release-notes/release-notes-v17.2.md @@ -2,19 +2,19 @@ --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). +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. +* 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://docs.percona.com/pg-tde/release-notes/beta2.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#before-you-start) for details. +* 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#before-you-start) for details. + + For how to run `pg_tde` in Docker, check the [Enable encryption](../docker.md#enable-encryption) section in the documentation. - 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. +* Percona Monitoring and Management (PMM) 2.43.2 is now compatible with `pg_stat_monitor` 2.1.0 to monitor PostgreSQL 17. ------------------------------------------------------------------------------ @@ -43,8 +43,8 @@ The following is the list of extensions available in Percona Distribution for Po 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. +* 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 +backend server and to receive the results of these queries." diff --git a/docs/release-notes-v17.4.md b/docs/release-notes/release-notes-v17.4.md similarity index 94% rename from docs/release-notes-v17.4.md rename to docs/release-notes/release-notes-v17.4.md index f3d096d9e..f495beb50 100644 --- a/docs/release-notes-v17.4.md +++ b/docs/release-notes/release-notes-v17.4.md @@ -2,7 +2,7 @@ --8<-- "release-notes-intro.md" -This release of Percona Distribution for PostgreSQL is based on Percona Server for PostgreSQL 17.4.1 - a binary compatible, open source drop in replacement of [PostgreSQL Community 17.4](https://www.postgresql.org/docs/17/release-17-4.html). +This release of Percona Distribution for PostgreSQL is based on Percona Server for PostgreSQL 17.4.1 - a binary compatible, open source drop in replacement of [PostgreSQL Community 17.4](https://www.postgresql.org/docs/17/release-17-4.html). ## Release Highlights @@ -16,15 +16,15 @@ Percona Distribution for PostgreSQL includes the Release Candidate of `pg_tde` e * Percona Distribution for PostgreSQL Docker image is now based on Universal Base Image (UBI) version 9, which includes the latest security fixes. This makes the image compliant with the Red Hat certification and ensures the seamless work of containers on Red Hat OpenShift Container Platform. -* You no longer have to specify the `{{dockertag}}-multi` tag when you run Percona Distribution for PostgreSQL in Docker. Instead, use the `percona/percona-distribution-postgresql:{{dockertag}}`. Docker automatically identifies the architecture of your operating system and pulls the corresponding image. Refer to [Run in Docker](docker.md) for how to get started. +* You no longer have to specify the `{{dockertag}}-multi` tag when you run Percona Distribution for PostgreSQL in Docker. Instead, use the `percona/percona-distribution-postgresql:{{dockertag}}`. Docker automatically identifies the architecture of your operating system and pulls the corresponding image. Refer to [Run in Docker](../docker.md) for how to get started. ### PostGIS is included into tarballs -We have extended Percona Distribution for PostgreSQL tarballs with PostGIS - an open-source extension to handle spatial data. This way you can install and run PostgreSQL as a geospatial database on hosts without a direct access to the Internet. Learn more about [installing from tarballs](tarball.md) and [Spatial data manipulation](solutions/postgis.md). +We have extended Percona Distribution for PostgreSQL tarballs with PostGIS - an open-source extension to handle spatial data. This way you can install and run PostgreSQL as a geospatial database on hosts without a direct access to the Internet. Learn more about [installing from tarballs](../tarball.md) and [Spatial data manipulation](../solutions/postgis.md). ### Deprecation of meta packages -[Meta-packages for Percona Distribution for PostgreSQL](repo-overview.md#repository-contents) are deprecated and will be removed in future releases. +[Meta-packages for Percona Distribution for PostgreSQL](../repo-overview.md#repository-contents) are deprecated and will be removed in future releases. ## Supplied third-party extensions @@ -49,9 +49,8 @@ Review each extension’s release notes for What’s new, improvements, or bug f | [PostgreSQL Common :octicons-link-external-16:](https://salsa.debian.org/postgresql/postgresql-common) | 267 | PostgreSQL database-cluster manager. Supports multiple PostgreSQL versions and clusters simultaneously | | [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 compatible derivatives, Percona Distribution for PostgreSQL also includes the supplemental `python3-etcd` 0.4.5 packages, which are used for setting up Patroni clusters. +For Red Hat Enterprise Linux 8 and compatible derivatives, Percona Distribution for PostgreSQL also includes the supplemental `python3-etcd` 0.4.5 packages, which are 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 +backend server and to receive the results of these queries." diff --git a/docs/release-notes-v17.5.1.md b/docs/release-notes/release-notes-v17.5.1.md similarity index 95% rename from docs/release-notes-v17.5.1.md rename to docs/release-notes/release-notes-v17.5.1.md index f099f242f..dcf908624 100644 --- a/docs/release-notes-v17.5.1.md +++ b/docs/release-notes/release-notes-v17.5.1.md @@ -12,7 +12,7 @@ Percona Distribution for PostgreSQL includes the Release Candidate 2 (RC2) of `p ### Updated Major upgrade topic in documentation -The [Upgrading Percona Distribution for PostgreSQL from 16 to 17](major-upgrade.md) guide has been updated with revised steps for the [On Debian and Ubuntu using `apt`](major-upgrade.md/#on-debian-and-ubuntu-using-apt) section, improving clarity and reliability of the upgrade process. +The [Upgrading Percona Distribution for PostgreSQL from 16 to 17](../major-upgrade.md) guide has been updated with revised steps for the [On Debian and Ubuntu using `apt`](../major-upgrade.md/#on-debian-and-ubuntu-using-apt) section, improving clarity and reliability of the upgrade process. | Extension | Version | Description | |--------------------------------------------------------------------------------------|-----------|----------------------------------------------------------------------------------------------------------------------| diff --git a/docs/release-notes-v17.5.md b/docs/release-notes/release-notes-v17.5.md similarity index 100% rename from docs/release-notes-v17.5.md rename to docs/release-notes/release-notes-v17.5.md diff --git a/docs/release-notes/release-notes.md b/docs/release-notes/release-notes.md new file mode 100644 index 000000000..ddc401f47 --- /dev/null +++ b/docs/release-notes/release-notes.md @@ -0,0 +1,14 @@ +# Percona Server for PostgreSQL release notes + +This page lists all release notes for Percona Server for PostgreSQL 17, organized by year and version. Use it to track new features, fixes, and updates across major and minor versions. + +## 2025 + +* [17.5.2](release-notes-v17.5.md) ({{date.17_5}}) +* [17.5.1](release-notes-v17.5.1.md) ({{date.17_5_1}}) +* [17.4.1](release-notes-v17.4.md) ({{date.17_4}}) + +## 2024 + +* [17.2.1](release-notes-v17.2.md) ({{date.17_2}}) +* [17.0.1](release-notes-v17.0.md) ({{date.17_0}}) diff --git a/mkdocs.yml b/mkdocs.yml index d9b37654f..6b6cf247a 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -84,13 +84,15 @@ nav: - migration.md - Troubleshooting guide: troubleshooting.md - Uninstall: uninstalling.md - - Release Notes: - - "Release notes index": "release-notes.md" - - release-notes-v17.5.md - - release-notes-v17.5.1.md - - release-notes-v17.4.md - - release-notes-v17.2.md - - release-notes-v17.0.md + - Release notes: + - "Release notes index": release-notes/release-notes.md + - 2025: + - "17.5.2": release-notes/release-notes-v17.5.md + - "17.5.1": release-notes/release-notes-v17.5.1.md + - "17.4.1": release-notes/release-notes-v17.4.md + - 2024 (versions 17.0.1 - 17.2.1): + - "17.2.1": release-notes/release-notes-v17.2.md + - "17.0.1": release-notes/release-notes-v17.0.md - Reference: - Telemetry: telemetry.md - Licensing: licensing.md