diff --git a/docs/release-notes/release-notes-v17.0.md b/docs/release-notes/release-notes-v17.0.md deleted file mode 100644 index 755bba199..000000000 --- a/docs/release-notes/release-notes-v17.0.md +++ /dev/null @@ -1,134 +0,0 @@ -# Percona Distribution for PostgreSQL 17.0.1 ({{date.17_0}}) - -[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). - -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. - -To check what software you're running, run the following SQL query: - -```sql -SELECT version(); -``` - -??? example "Sample output" - - ```sql - version - ---------------------------------------------------------------------------------------------------------------------------------------------- - PostgreSQL 17.0 - Percona Server for PostgreSQL 17.0.1 - ``` - -Alternatively, you can pass the `--version` flag when you establish the `psql` session: - -```{.bash data-prompt="$"} -$ psql --version -``` - -??? example "Sample output" - - ```sql - psql (PostgreSQL) 17.0 - Percona Server for PostgreSQL 17.0.1 - ``` -## Release Highlights - -### Percona Server for PostgreSQL improvements - -* Exposed Storage Manager API to enable PostgreSQL extensions to hook in custom storage managers. -* Extended Write-Ahead Log (WAL) API to hook into WAL read and write functions. - -### PostgreSQL Community improvements - -PostgreSQL Community 17 features a lot of new functionalities and enhancements to performance, replication, monitoring, developer experience and more. Among them are the following: - -#### Incremental base backups - -Save time and storage space with the ability to back up only the changes since the last backup using [`pg_basebackup`](https://www.postgresql.org/docs/17/continuous-archiving.html#BACKUP-INCREMENTAL-BACKUP) with the `--incremental` option. The new [`pg_combinebackup`](https://www.postgresql.org/docs/17/app-pgcombinebackup.html) tool allows manipulation of base and incremental file system backups for recovery. - -Note that you still require a full backup to derive the increments from and to be used during recovery. - -This feature is especially beneficial for organizations with large data sets where a full backup is a time-consuming and resource-intensive operation. - -#### Performance improvements - -* Vacuum Process Enhancements: The VACUUM process, responsible for reclaiming storage, now has a new internal data structure, reducing memory usage by up to 20x and improving overall performance. -* The new stream I/O interface can enhance performance during sequential scans and when running the `ANALYZE` command. -* Added support for parallel index builds for `BRIN` indexes, which can significantly speed up index creation. Additionally, this release significantly improves execution time of queries that use the `IN` clause with a B-tree index. - -#### Developer experience - -* Developers can now transform JSON objects into a standard database table and convert JSON values to different data types directly within SQL statements. This adds flexibility when working with multiple data formats. -* Run bulk upload and export data from PostgreSQL up to 2x faster with improved `COPY` performance. In addition, use the `ON_ERROR` option to proceed with the copy operation even if there is an error inserting a row. -* The RETURNING clause added to the MERGE command enables developers to retrieve and return the rows modified by the MERGE operation in a single step, reducing the need for additional queries and simplifying complex workflows. - -#### 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. -* 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 - -#### Security improvements - -* Enable users to perform maintenance operations such as ANALYZE, VACUUM, REINDEX, CLUSTER, REFRESH MATERIALIZED VIEW, and LOCK TABLE on all relations by assigning the new predefined `pg_maintain` role to them. In addition, the `search_path` is safe for maintenance operations like VACUUM, ANALYZE, CLUSTER, REFRESH MATERIALIZED VIEW and INDEX. - -#### Monitoring improvements - -* 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 - -* Learn about why an active session is waiting using the `pg_stat_activity` and new `pg_wait_events` views - -!!! admonition "See also" - - * [PostgreSQL 17 release announcement :octicons-link-external-16:](https://www.postgresql.org/about/news/postgresql-17-released-2936/) - * [PostgreSQL 17 release notes :octicons-link-external-16:](https://www.postgresql.org/docs/17/release-17.html) - * Percona Blog: [The Powerful Features Released in PostgreSQL 17 Beta 2](https://www.percona.com/blog/the-powerful-features-released-in-postgresql-17-beta-2/) - -### Join Percona Squad - -Participate in monthly SWAG raffles, get an early access to new product features and invite-only “ask me anything” sessions with database performance experts. Interested? [Fill in the form](https://squad.percona.com/pg) - -## 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. - -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 | -| ------------------- | -------------- | ---------------------------- | -| [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.2 | 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.53.1 | 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)| v27 | 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.| -| [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)| 264 | 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| - -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. - -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/release-notes-v17.2.md b/docs/release-notes/release-notes-v17.2.md deleted file mode 100644 index 5155049be..000000000 --- a/docs/release-notes/release-notes-v17.2.md +++ /dev/null @@ -1,50 +0,0 @@ -# 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://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. - - 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/release-notes-v17.4.md b/docs/release-notes/release-notes-v17.4.md deleted file mode 100644 index f495beb50..000000000 --- a/docs/release-notes/release-notes-v17.4.md +++ /dev/null @@ -1,56 +0,0 @@ -# Percona Distribution for PostgreSQL 17.4.1 ({{date.17_4}}) - ---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). - -## Release Highlights - -This release fixes [CVE-2025-1094](https://www.postgresql.org/support/security/CVE-2025-1094/), which closed a vulnerability in the `libpq` PostgreSQL client library but introduced a regression related to string handling for non-null terminated strings. The error would be visible based on how a PostgreSQL client implemented this behavior. This regression affects versions 17.3, 16.7, 15.11, 14.16, and 13.19. For this reason, version 17.3 was skipped. - -### A new version of `pg_tde` - -Percona Distribution for PostgreSQL includes the Release Candidate of `pg_tde` extension that brings in Transparent Data Encryption. This version of `pg_tde` provides a bunch of improvements, among which is the redesigned WAL encryption, simplified configuration for single-tenant environments, the ability to change key provider configuration offline, and more. Learn about these features in the [`pg_tde` release notes :octicons-link-external-16:](https://docs.percona.com/pg-tde/release-notes/rc.html). - -### Improved security and user experience for Docker images - -* 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. - -### 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). - -### 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. - -## Supplied third-party extensions - -Review each extension’s release notes for What’s new, improvements, or bug fixes. The following is the list of extensions available in Percona Distribution for PostgreSQL. - -| Extension | Version | Description | -|--------------------------------------------------------------------------------------|-----------|----------------------------------------------------------------------------------------------------------------------| -| [etcd :octicons-link-external-16:](https://etcd.io/) | 3.5.18 | A distributed, reliable key-value store for setting up high available Patroni clusters | -| [HAProxy :octicons-link-external-16:](http://www.haproxy.org/) | 2.8.13 | A high-availability and load-balancing solution | -| [Patroni :octicons-link-external-16:](https://patroni.readthedocs.io/en/latest/) | 4.0.5 | A HA (High Availability) solution for PostgreSQL | -| [PgAudit :octicons-link-external-16:](https://www.pgaudit.org/) | 17.1 | 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 roles for maintenance. | -| [pgBackRest :octicons-link-external-16:](https://pgbackrest.org/) | 2.54.2 | A backup and restore solution for PostgreSQL | -| [pgBadger :octicons-link-external-16:](https://github.com/darold/pgbadger) | 13.1 | A fast PostgreSQL Log Analyzer | -| [PgBouncer :octicons-link-external-16:](https://www.pgbouncer.org/) | 1.24.0 | A lightweight connection pooler for PostgreSQL | -| [pg_gather :octicons-link-external-16:](https://github.com/jobinau/pg_gather) | v29 | An SQL script for running the diagnostics of the health of a PostgreSQL cluster | -| [pgpool2 :octicons-link-external-16:](https://git.postgresql.org/gitweb/?p=pgpool2.git;a=summary) | 4.5.5 | 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.2 | 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.8 | A spatial extension for PostgreSQL | -| [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. - -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/release-notes-v17.5.1.md b/docs/release-notes/release-notes-v17.5.1.md deleted file mode 100644 index dcf908624..000000000 --- a/docs/release-notes/release-notes-v17.5.1.md +++ /dev/null @@ -1,39 +0,0 @@ -# Percona Distribution for PostgreSQL 17.5.1 ({{date.17_5_1}}) - ---8<-- "release-notes-intro.md" - -This release of Percona Distribution for PostgreSQL is based on Percona Server for PostgreSQL 17.5.1 - a binary compatible, open source drop in replacement of [PostgreSQL Community 17.5](https://www.postgresql.org/docs/17/release-17-5.html). - -## Release Highlights - -### A new version of `pg_tde` - -Percona Distribution for PostgreSQL includes the Release Candidate 2 (RC2) of `pg_tde` extension that brings in Transparent Data Encryption. This version of `pg_tde` provides a bunch of improvements, among which is WAL encryption now supporting Vault, automatic WAL internal key generation at server startup, new visibility and verification functions for default principal keys, and more. Learn about these features in the [`pg_tde` release notes :octicons-link-external-16:](https://docs.percona.com/pg-tde/release-notes/rc2.html). - -### 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. - -| Extension | Version | Description | -|--------------------------------------------------------------------------------------|-----------|----------------------------------------------------------------------------------------------------------------------| -| [etcd :octicons-link-external-16:](https://etcd.io/) | 3.5.21 | A distributed, reliable key-value store for setting up high available Patroni clusters | -| [HAProxy :octicons-link-external-16:](http://www.haproxy.org/) | 2.8.15 | A high-availability and load-balancing solution | -| [Patroni :octicons-link-external-16:](https://patroni.readthedocs.io/en/latest/) | 4.0.5 | A HA (High Availability) solution for PostgreSQL | -| [PgAudit :octicons-link-external-16:](https://www.pgaudit.org/) | 17.1 | 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 roles for maintenance. | -| [pgBackRest :octicons-link-external-16:](https://pgbackrest.org/) | 2.55.0 | A backup and restore solution for PostgreSQL | -| [pgBadger :octicons-link-external-16:](https://github.com/darold/pgbadger) | 13.1 | A fast PostgreSQL Log Analyzer | -| [PgBouncer :octicons-link-external-16:](https://www.pgbouncer.org/) | 1.24.1 | A lightweight connection pooler for PostgreSQL | -| [pg_gather :octicons-link-external-16:](https://github.com/jobinau/pg_gather) | v30 | An SQL script for running the diagnostics of the health of a PostgreSQL cluster | -| [pgpool2 :octicons-link-external-16:](https://git.postgresql.org/gitweb/?p=pgpool2.git;a=summary) | 4.6.0 | 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.2 | Rebuilds PostgreSQL database objects | -| [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.8 | A spatial extension for PostgreSQL | -| [PostgreSQL Common :octicons-link-external-16:](https://salsa.debian.org/postgresql/postgresql-common) | 277 | 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. - -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/release-notes-v17.5.3.md b/docs/release-notes/release-notes-v17.5.3.md deleted file mode 100644 index 320134851..000000000 --- a/docs/release-notes/release-notes-v17.5.3.md +++ /dev/null @@ -1,45 +0,0 @@ -# Percona Distribution for PostgreSQL 17.5.3 ({{date.17_5_3}}) - ---8<-- "release-notes-intro.md" - -This release of Percona Distribution for PostgreSQL is based on Percona Server for PostgreSQL 17.5.3 - a binary compatible, open source drop in replacement of [PostgreSQL Community 17.5](https://www.postgresql.org/docs/17/release-17-5.html). - -## Release Highlights - -### `pg_tde` 2.0 - WAL encryption now generally available - -Percona Distribution for PostgreSQL includes the 2.0 release of `pg_tde`. -This version introduces several enhancements, most notably the general availability of WAL encryption. -See the [`pg_tde` release notes :octicons-link-external-16:](https://docs.percona.com/pg-tde/release-notes/release-notes-v2.0.html) for more details. - -### Major documentation update in Percona Distribution for PostgreSQL - -* Expanded and improved the [High Availability](../solutions/high-availability.md) topic with more information and example deployments. -* Updated the [PostGIS installation commands via yum](../yum.md#for-postgis) topic. -* Updated the [Telemetry](../telemetry.md) topic with revised steps and commands. -* Added new [FAQ](../faq.md) and [Versioning](../versioning.md) topics. - -The following is the list of extensions available in Percona Distribution for PostgreSQL. - -| Extension | Version | Description | -|--------------------------------------------------------------------------------------|-----------|----------------------------------------------------------------------------------------------------------------------| -| [etcd :octicons-link-external-16:](https://etcd.io/) | 3.5.21 | A distributed, reliable key-value store for setting up highly available Patroni clusters -| [python-etcd :octicons-link-external-16:](https://python-etcd.readthedocs.io/en/latest/) | 0.4.5 | A Python client library for interacting with etcd | -| [HAProxy :octicons-link-external-16:](http://www.haproxy.org/) | 2.8.15 | A high-availability and load-balancing solution | -| [Patroni :octicons-link-external-16:](https://patroni.readthedocs.io/en/latest/) | 4.0.5 | A HA (High Availability) solution for PostgreSQL | -| [PgAudit :octicons-link-external-16:](https://www.pgaudit.org/) | 17.1 | A 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 roles for maintenance. | -| [pgBackRest :octicons-link-external-16:](https://pgbackrest.org/) | 2.55.0 | A backup and restore solution for PostgreSQL | -| [pgBadger :octicons-link-external-16:](https://github.com/darold/pgbadger) | 13.1 | A fast PostgreSQL Log Analyzer | -| [PgBouncer :octicons-link-external-16:](https://www.pgbouncer.org/) | 1.24.1 | A lightweight connection pooler for PostgreSQL | -| [pg_gather :octicons-link-external-16:](https://github.com/jobinau/pg_gather) | v30 | An SQL script for running the diagnostics of the health of a PostgreSQL cluster | -| [pgpool2 :octicons-link-external-16:](https://git.postgresql.org/gitweb/?p=pgpool2.git;a=summary) | 4.6.0 | 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.2 | Rebuilds PostgreSQL database objects | -| [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.8 | A spatial extension for PostgreSQL | -| [PostgreSQL Common :octicons-link-external-16:](https://salsa.debian.org/postgresql/postgresql-common) | 277 | 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. - -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/release-notes-v17.5.md b/docs/release-notes/release-notes-v17.5.md deleted file mode 100644 index b2eb30ea3..000000000 --- a/docs/release-notes/release-notes-v17.5.md +++ /dev/null @@ -1,50 +0,0 @@ -# Percona Distribution for PostgreSQL 17.5.2 ({{date.17_5}}) - ---8<-- "release-notes-intro.md" - -This release of Percona Distribution for PostgreSQL is based on Percona Server for PostgreSQL 17.5.2 - a binary compatible, open source drop in replacement of [PostgreSQL Community 17.5](https://www.postgresql.org/docs/17/release-17-5.html). - -## Release Highlights - -### General Availability (GA) of pg_tde - -Percona Distribution for PostgreSQL now includes the 1.0 GA release of Percona's Transparent Data Encryption for PostgreSQL. - -Learn more in the [`pg_tde` 1.0 release notes :octicons-link-external-16:](https://docs.percona.com/pg-tde/release-notes/release-notes-v1.0.html). - -### Major documentation update - -The `pg_tde` documentation has received significant updates, which include: - -- New KMS configuration guides for Fortanix, Vault, KMIP and OpenBAO -- Reorganized and expanded topics for Architecture, GUC, Functions, TDE Operations and FAQ -- Extensive and numerous refinements and clarifications across the entire site - -Explore the full documentation [in the official `pg_tde` documentations](https://docs.percona.com/pg-tde/index.html). - -The following is the list of extensions available in Percona Distribution for PostgreSQL. - -| Extension | Version | Description | -|--------------------------------------------------------------------------------------|-----------|----------------------------------------------------------------------------------------------------------------------| -| [etcd :octicons-link-external-16:](https://etcd.io/) | 3.5.21 | A distributed, reliable key-value store for setting up high available Patroni clusters | -| [HAProxy :octicons-link-external-16:](http://www.haproxy.org/) | 2.8.15 | A high-availability and load-balancing solution | -| [Patroni :octicons-link-external-16:](https://patroni.readthedocs.io/en/latest/) | 4.0.5 | A HA (High Availability) solution for PostgreSQL | -| [PgAudit :octicons-link-external-16:](https://www.pgaudit.org/) | 17.1 | 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 roles for maintenance. | -| [pgBackRest :octicons-link-external-16:](https://pgbackrest.org/) | 2.55.0 | A backup and restore solution for PostgreSQL | -| [pgBadger :octicons-link-external-16:](https://github.com/darold/pgbadger) | 13.1 | A fast PostgreSQL Log Analyzer | -| [PgBouncer :octicons-link-external-16:](https://www.pgbouncer.org/) | 1.24.1 | A lightweight connection pooler for PostgreSQL | -| [pg_gather :octicons-link-external-16:](https://github.com/jobinau/pg_gather) | v30 | An SQL script for running the diagnostics of the health of a PostgreSQL cluster | -| [pgpool2 :octicons-link-external-16:](https://git.postgresql.org/gitweb/?p=pgpool2.git;a=summary) | 4.6.0 | 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.2 | Rebuilds PostgreSQL database objects | -| [pg_stat_monitor](https://github.com/percona/pg_stat_monitor) | 2.2.0 | 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.8 | A spatial extension for PostgreSQL | -| [PostgreSQL Common :octicons-link-external-16:](https://salsa.debian.org/postgresql/postgresql-common) | 277 | 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. - -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/release-notes-v17.6.1.md b/docs/release-notes/release-notes-v18.1.1.md similarity index 92% rename from docs/release-notes/release-notes-v17.6.1.md rename to docs/release-notes/release-notes-v18.1.1.md index 3f0eca4ec..222a4bb04 100644 --- a/docs/release-notes/release-notes-v17.6.1.md +++ b/docs/release-notes/release-notes-v18.1.1.md @@ -1,8 +1,8 @@ -# Percona Distribution for PostgreSQL 17.6.1 ({{date.17_6_1}}) +# Percona Distribution for PostgreSQL 18.1.1 ({{date.18_1_1}}) --8<-- "release-notes-intro.md" -This release of Percona Distribution for PostgreSQL is based on Percona Server for PostgreSQL 17.6.1 - a binary compatible, open source drop in replacement of [PostgreSQL Community 17.6](https://www.postgresql.org/docs/17/release-17-6.html). +This release of Percona Distribution for PostgreSQL is based on Percona Server for PostgreSQL 18.1.1 - a binary compatible, open source drop in replacement of [PostgreSQL Community 18.1](https://www.postgresql.org/docs/18/release-18.html). ## Release Highlights @@ -28,7 +28,7 @@ See [Install Percona Distribution for PostgreSQL from binary tarballs](../tarbal ### Addressed CVEs -This release includes important security measures that address the following CVEs: CVE-2012-0868, CVE-2017-7484, and CVE-2025-8715. For more details, see the [PostgreSQL 17.6 release notes](https://www.postgresql.org/docs/release/17.6/). +This release includes important security measures that address the following CVEs: TBA. For more details, see the [PostgreSQL 18.1 release notes](https://www.postgresql.org/docs/release/18.0/). ## Known Issue @@ -36,7 +36,7 @@ This release includes important security measures that address the following CVE During an upgrade on RHEL, you may encounter the following error: -``` +```bash Unknown Error occurred: Transaction test error: file /usr/share/postgresql-common/server/postgresql.mk from install of percona-postgresql-common conflicts with file from package percona-postgresql-common-dev file /usr/share/postgresql-common/t/040_upgrade.t from install of percona-postgresql-common conflicts with file from package percona-postgresql-common-dev @@ -48,7 +48,7 @@ The following is the list of extensions available in Percona Distribution for Po | Extension | Version | Description | |--------------------------------------------------------------------------------------|-----------|----------------------------------------------------------------------------------------------------------------------| -| [etcd :octicons-link-external-16:](https://etcd.io/) | 3.5.21 | A distributed, reliable key-value store for setting up highly available Patroni clusters +| [etcd :octicons-link-external-16:](https://etcd.io/) | 3.5.21 | A distributed, reliable key-value store for setting up highly available Patroni clusters | | [python-etcd :octicons-link-external-16:](https://python-etcd.readthedocs.io/en/latest/) | 0.4.5 | A Python client library for interacting with etcd | | [HAProxy :octicons-link-external-16:](http://www.haproxy.org/) | 2.8.15 | A high-availability and load-balancing solution | | [Patroni :octicons-link-external-16:](https://patroni.readthedocs.io/en/latest/) | 4.0.6 | A HA (High Availability) solution for PostgreSQL | @@ -67,4 +67,4 @@ The following is the list of extensions available in Percona Distribution for Po 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." +Percona Distribution for PostgreSQL is also shipped with the [libpq](https://www.postgresql.org/docs/18/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/release-notes.md b/docs/release-notes/release-notes.md index 190a00954..1819d88ee 100644 --- a/docs/release-notes/release-notes.md +++ b/docs/release-notes/release-notes.md @@ -1,16 +1,7 @@ # 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. +This page lists all release notes for Percona Server for PostgreSQL 18, organized by year and version. Use it to track new features, fixes, and updates across major and minor versions. ## 2025 -* [17.6.1](release-notes-v17.6.1.md) ({{date.17_6_1}}) -* [17.5.3](release-notes-v17.5.3.md) ({{date.17_5_3}}) -* [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}}) +* [18.1.1](release-notes-v18.1.1.md) ({{date.18_1_1}}) diff --git a/mkdocs-base.yml b/mkdocs-base.yml index a5c507c93..9818c1cc3 100644 --- a/mkdocs-base.yml +++ b/mkdocs-base.yml @@ -162,8 +162,8 @@ extra: nav: - 'Home': 'index.md' - - get-help.md - 'Percona Server for PostgreSQL': postgresql-server.md + - get-help.md - Get started: - Quickstart guide: installing.md - 1. Install: @@ -173,6 +173,7 @@ nav: - Run in Docker: docker.md - enable-extensions.md - repo-overview.md + - sboms.md - 2. Connect to PostgreSQL: connect.md - 3. Manipulate data in PostgreSQL: crud.md - 4. What's next: whats-next.md @@ -214,17 +215,15 @@ nav: - "Major upgrade": major-upgrade.md - minor-upgrade.md - migration.md + - FAQ: faq.md - Troubleshooting guide: troubleshooting.md - - How to: how-to.md - Uninstall: uninstalling.md - - Release Notes: - - "Release notes index": "release-notes.md" - - release-notes-v17.0.md - - release-notes-v17.2.md - - release-notes-v17.4.md - - release-notes-v17.5.md + - Release notes: + - "Release notes index": release-notes/release-notes.md + - "18.1.1": release-notes/release-notes-v18.1.1.md - Reference: - Telemetry: telemetry.md - Licensing: licensing.md + - Versioning: versioning.md - Trademark policy: trademark-policy.md diff --git a/mkdocs.yml b/mkdocs.yml index 03b5fa616..b79f5fe0d 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -86,14 +86,7 @@ nav: - Uninstall: uninstalling.md - Release notes: - "Release notes index": release-notes/release-notes.md - - "17.6.1": release-notes/release-notes-v17.6.1.md - - "17.5.3": release-notes/release-notes-v17.5.3.md - - "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 + - "18.0.1": release-notes/release-notes-v18.1.1.md - Reference: - Telemetry: telemetry.md - Licensing: licensing.md diff --git a/variables.yml b/variables.yml index f03cc4437..1c39d74b3 100644 --- a/variables.yml +++ b/variables.yml @@ -1,24 +1,12 @@ # PG Variables set for HTML output # See also mkdocs.yml plugins.with-pdf.cover_subtitle and output_path - -release: 'release-notes-v17.6.1' -dockertag: '17.6' -pgsubversion: '17.6' -pgversion: '17' -pspgversion: '17.6.1' +release: 'release-notes-v18.1.1' +dockertag: '18.1' +pgsubversion: '18.1' +pgversion: '18' +pspgversion: '18.1.1' pgsmversion: '2.1.1' - - date: - - 17_6_1: 2025-09-10 - 17_5_3: 2025-09-01 - 17_5: 2025-06-30 - 17_5_1: 2025-05-28 - 17_4: 2025-03-27 - 17_2: 2024-12-26 - 17_0: 2024-10-03 - - + 18_1_1: 2025-10-15