From e16fe0b19595356569f169f1044d358e9b54a4af Mon Sep 17 00:00:00 2001 From: Anastasia Alexandrova Date: Mon, 3 Mar 2025 15:44:14 +0100 Subject: [PATCH] PG-1345 Release notes 15.12 (#730) PG-1345 Release notes 15.12 modified: .github/workflows/main.yml deleted: docs/how-to.md new file: docs/release-notes-v15.12.md modified: docs/release-notes.md modified: mkdocs-base.yml modified: mkdocs-pdf.yml modified: requirements.txt modified: variables.yml Updated release highlights list Added deprecation label to meta packages Signed-off-by: Anastasia Alexadrova --------- Signed-off-by: Anastasia Alexadrova --- .github/workflows/main.yml | 8 +- docs/apt.md | 2 +- docs/how-to.md | 75 ---------- docs/pg-stat-monitor.md | 277 ----------------------------------- docs/release-notes-v15.12.md | 58 ++++++++ docs/release-notes.md | 2 + docs/repo-overview.md | 5 + docs/yum.md | 2 +- mkdocs-base.yml | 6 +- mkdocs-pdf.yml | 2 +- requirements.txt | 3 +- variables.yml | 7 +- 12 files changed, 82 insertions(+), 365 deletions(-) delete mode 100644 docs/how-to.md delete mode 100644 docs/pg-stat-monitor.md create mode 100644 docs/release-notes-v15.12.md diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml index fcb701979..97ae64436 100644 --- a/.github/workflows/main.yml +++ b/.github/workflows/main.yml @@ -12,12 +12,12 @@ jobs: steps: #Pull the latest changes - name: Chekout code - uses: actions/checkout@v2 + uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2 with: - fetch-depth: 0 + fetch-depth: 0 # fetch all commits/branches #Prepare the env - name: Set up Python - uses: actions/setup-python@v2 + uses: actions/setup-python@0b93645e9fea7318ecaed2b359559ac225c90a2b # v5.3.0 with: python-version: '3.x' @@ -46,7 +46,7 @@ jobs: - name: Deploy docs run: | mike deploy 15 -b publish -p - mike retitle 15 "15.10" -b publish -p + mike retitle 15 "15.12" -b publish -p # - name: Install Node.js 14.x # uses: percona-platform/setup-node@v2 diff --git a/docs/apt.md b/docs/apt.md index 103c821b1..ace5aeb01 100644 --- a/docs/apt.md +++ b/docs/apt.md @@ -43,7 +43,7 @@ Run all the commands in the following sections as root or using the `sudo` comma ### Install packages -=== "Install using meta-package" +=== "Install using meta-package (deprecated)" The [meta package](repo-overview.md#percona-ppg-server){:target=”_blank”} enables you to install several components of the distribution in one go. diff --git a/docs/how-to.md b/docs/how-to.md deleted file mode 100644 index 1d73b4957..000000000 --- a/docs/how-to.md +++ /dev/null @@ -1,75 +0,0 @@ -# How to - -## How to configure `etcd` nodes simultaneously - -!!! note - - We assume you have a deeper knowledge of how etcd works. Otherwise, refer to the configuration where you add etcd nodes one by one. - -Instead of adding `etcd` nodes one by one, you can configure and start all nodes in parallel. - -1. Create etcd configuration file on every node. You can edit the sample configuration file `/etc/etcd/etcd.conf.yaml` or create your own one. Replace the node names and IP addresses with the actual names and IP addresses of your nodes: - - === "node1" - - ```yaml title="/etc/etcd/etcd.conf.yaml" - name: 'node1' - initial-cluster-token: PostgreSQL_HA_Cluster_1 - initial-cluster-state: new - initial-cluster: node1=http://10.104.0.1:2380,node2=http://10.104.0.2:2380,node3=http://10.104.0.3:2380 - data-dir: /var/lib/etcd - initial-advertise-peer-urls: http://10.104.0.1:2380 - listen-peer-urls: http://10.104.0.1:2380 - advertise-client-urls: http://10.104.0.1:2379 - listen-client-urls: http://10.104.0.1:2379 - ``` - - === "node2" - - ```yaml title="/etc/etcd/etcd.conf.yaml" - name: 'node2' - initial-cluster-token: PostgreSQL_HA_Cluster_1 - initial-cluster-state: new - initial-cluster: node1=http://10.104.0.1:2380,node2=http://10.104.0.2:2380, node3=http://10.104.0.3:2380 - data-dir: /var/lib/etcd - initial-advertise-peer-urls: http://10.104.0.2:2380 - listen-peer-urls: http://10.104.0.2:2380 - advertise-client-urls: http://10.104.0.2:2379 - listen-client-urls: http://10.104.0.2:2379 - ``` - - === "node3" - - ```yaml title="/etc/etcd/etcd.conf.yaml" - name: 'node1' - initial-cluster-token: PostgreSQL_HA_Cluster_1 - initial-cluster-state: new - initial-cluster: node1=http://10.104.0.1:2380,node2=http://10.104.0.2:2380, node3=http://10.104.0.3:2380 - data-dir: /var/lib/etcd - initial-advertise-peer-urls: http://10.104.0.3:2380 - listen-peer-urls: http://10.104.0.3:2380 - advertise-client-urls: http://10.104.0.3:2379 - listen-client-urls: http://10.104.0.3:2379 - ``` - -2. Enable and start the `etcd` service on all nodes: - - ```{.bash data-prompt="$"} - $ sudo systemctl enable --now etcd - ``` - - During the node start, etcd searches for other cluster nodes defined in the configuration. If the other nodes are not yet running, the start may fail by a quorum timeout. This is expected behavior. Try starting all nodes again at the same time for the etcd cluster to be created. - -3. Check the etcd cluster members. Connect to one of the nodes and run the following command: - - ```{.bash data-prompt="$"} - $ sudo etcdctl member list - ``` - - The output resembles the following: - - ``` - 2d346bd3ae7f07c4: name=node2 peerURLs=http://10.104.0.2:2380 clientURLs=http://10.104.0.2:2379 isLeader=false - 8bacb519ebdee8db: name=node3 peerURLs=http://10.104.0.3:2380 clientURLs=http://10.104.0.3:2379 isLeader=false - c5f52ea2ade25e1b: name=node1 peerURLs=http://10.104.0.1:2380 clientURLs=http://10.104.0.1:2379 isLeader=true - ``` \ No newline at end of file diff --git a/docs/pg-stat-monitor.md b/docs/pg-stat-monitor.md deleted file mode 100644 index e5aaf1087..000000000 --- a/docs/pg-stat-monitor.md +++ /dev/null @@ -1,277 +0,0 @@ -# pg_stat_monitor - -!!! note - - This document describes the functionality of pg_stat_monitor {{pgsmversion}}. - -## Overview - -`pg_stat_monitor` is a Query Performance Monitoring -tool for PostgreSQL. It collects various statistics data such as query statistics, query plan, SQL comments and other performance insights. The collected data is aggregated and presented in a single view. This allows you to view queries from performance, application and analysis perspectives. - -`pg_stat_monitor` groups statistics data and writes it in a storage unit called *bucket*. The data is added and stored in a bucket for the defined period – the bucket lifetime. This allows you to identify performance issues and patterns based on time. - -You can specify the following: - - -* The number of buckets. Together they form a bucket chain. -* Bucket size. This is the amount of shared memory allocated for buckets. Memory is divided equally among buckets. -* Bucket lifetime. - -When a bucket lifetime expires, `pg_stat_monitor` resets all statistics and writes the data in the next bucket in the chain. When the last bucket’s lifetime expires, `pg_stat_monitor` returns to the first bucket. - -!!! important - - The contents of the bucket will be overwritten. In order not to lose the data, make sure to read the bucket before `pg_stat_monitor` starts writing new data to it. - - -### Views - -#### pg_stat_monitor view - -The `pg_stat_monitor` view contains all the statistics collected and aggregated by the extension. This view contains one row for each distinct combination of metrics and whether it is a top-level statement or not (up to the maximum number of distinct statements that the module can track). For details about available metrics, refer to the [`pg_stat_monitor` view reference :octicons-link-external-16:](https://docs.percona.com/pg-stat-monitor/reference.html). - -The following are the primary keys for pg_stat_monitor: - -* `bucket` -* `userid` -* `datname` -* `queryid` -* `client_ip` -* `planid` -* `application_name` - -A new row is created for each key in the `pg_stat_monitor` view. - -For security reasons, only superusers and members of the `pg_read_all_stats` role are allowed to see the SQL text, `client_ip` and `queryid` of queries executed by other users. Other users can see the statistics, however, if the view has been installed in their database. - -#### pg_stat_monitor_settings view (dropped) - -Starting with version 2.0.0, the `pg_stat_monitor_settings` view is deprecated and removed. All `pg_stat_monitor` configuration parameters are now available though the `pg_settings` view using the following query: - -```sql -SELECT name, setting, unit, context, vartype, source, min_val, max_val, enumvals, boot_val, reset_val, pending_restart FROM pg_settings WHERE name LIKE '%pg_stat_monitor%'; -``` - -For backward compatibility, you can create the `pg_stat_monitor_settings` view using the following SQL statement: - -```sql -CREATE VIEW pg_stat_monitor_settings - -AS - -SELECT * - -FROM pg_settings - -WHERE name like 'pg_stat_monitor.%'; -``` - -In `pg_stat_monitor` version 1.1.1 and earlier, the `pg_stat_monitor_settings` view shows one row per `pg_stat_monitor` configuration parameter. It displays configuration parameter name, value, default value, description, minimum and maximum values, and whether a restart is required for a change in value to be effective. - -To learn more, see the [Changing the configuration](#changing-the-configuration) section. - -## Installation - -This section describes how to install `pg_stat_monitor` from Percona repositories. To learn about other installation methods, see the [Installation :octicons-link-external-16:](https://docs.percona.com/pg-stat-monitor/install.html) section in the `pg_stat_monitor` documentation. - -**Preconditions**: - -To install `pg_stat_monitor` from Percona repositories, you need to subscribe to them. To do this, you must have the [`percona-release` repository management tool :octicons-link-external-16:](https://www.percona.com/doc/percona-repo-config/installing.html) up and running. - -To install `pg_stat_monitor`, run the following commands: - -=== "On Debian and Ubuntu" - - 1. Enable the repository - - ```{.bash data-prompt="$"} - $ sudo percona-release setup ppg15 - ``` - - 2. Install the package: - - ```{.bash data-prompt="$"} - $ sudo apt-get install percona-pg-stat-monitor15 - ``` - -=== "On Red Hat Enterprise Linux and derivatives" - - 1. Enable the repository - - ```{.bash data-prompt="$"} - $ sudo percona-release setup ppg15 - ``` - - 2. Install the package: - - ```{.bash data-prompt="$"} - $ sudo yum install percona-pg-stat-monitor15 - ``` - -## Setup - -`pg_stat_monitor` requires additional setup in order to use it with PostgreSQL. The setup steps are the following: - - -1. Add `pg_stat_monitor` in the `shared_preload_libraries` configuration parameter. - - The recommended way to modify PostgreSQL configuration file is using the [ALTER SYSTEM :octicons-link-external-16:](https://www.postgresql.org/docs/15/sql-altersystem.html) command. [Connect to psql](installing.md#connect-to-the-server) and use the following command: - - ```sql - ALTER SYSTEM SET shared_preload_libraries = 'pg_stat_monitor'; - ``` - - The parameter value is written to the `postgresql.auto.conf` file which is read in addition with `postgresql.conf` file. - - !!! note - - To use `pg_stat_monitor` together with `pg_stat_statements`, specify both modules separated by commas for the `ALTER SYSTEM SET` command. - - The order of modules is important: `pg_stat_monitor` must be specified **after** `pg_stat_statements`: - - ```sql - ALTER SYSTEM SET shared_preload_libraries = ‘pg_stat_statements, pg_stat_monitor’ - ``` - -2. Start or restart the `postgresql` instance to enable `pg_stat_monitor`. Use the following command for restart: - - - === "On Debian and Ubuntu" - - ```{.bash data-prompt="$"} - $ sudo systemctl restart postgresql.service - ``` - - - === "On Red Hat Enterprise Linux and derivatives" - - ```{.bash data-prompt="$"} - $ sudo systemctl restart postgresql-15 - ``` - - -3. Create the extension. Connect to `psql` and use the following command: - - ```sql - CREATE EXTENSION pg_stat_monitor; - ``` - - By default, the extension is created against the `postgres` database. You need to create the extension on every database where you want to collect statistics. - -!!! tip - - To check the version of the extension, run the following command in the `psql` session: - - ```sql - SELECT pg_stat_monitor_version(); - ``` - -## Usage - -For example, to view the IP address of the client application that made the query, run the following command: - -```sql -SELECT DISTINCT userid::regrole, pg_stat_monitor.datname, substr(query,0, 50) AS query, calls, bucket, bucket_start_time, queryid, client_ip -FROM pg_stat_monitor, pg_database -WHERE pg_database.oid = oid; -``` - -Output: - -``` - userid | datname | query | calls | bucket | bucket_start_time | queryid | client_ip -----------+----------+---------------------------------------------------+-------+--------+---------------------+------------------+----------- - postgres | postgres | SELECT name,description FROM pg_stat_monitor_sett | 1 | 9 | 2022-10-24 07:29:00 | AD536A8DEA7F0C73 | 127.0.0.1 - postgres | postgres | SELECT c.oid, +| 1 | 9 | 2022-10-24 07:29:00 | 34B888E5C844519C | 127.0.0.1 - | | n.nspname, +| | | | | - | | c.relname +| | | | | - | | FROM pg_ca | | | | | - postgres | postgres | SELECT DISTINCT userid::regrole, pg_stat_monitor. | 1 | 1 | 2022-10-24 07:31:00 | 6230793895381F1D | 127.0.0.1 - postgres | postgres | SELECT pg_stat_monitor_version() | 1 | 9 | 2022-10-24 07:29:00 | B617F5F12931F388 | 127.0.0.1 - postgres | postgres | CREATE EXTENSION pg_stat_monitor | 1 | 8 | 2022-10-24 07:28:00 | 14B98AF0776BAF7B | 127.0.0.1 - postgres | postgres | SELECT a.attname, +| 1 | 9 | 2022-10-24 07:29:00 | 96F8E4B589EF148F | 127.0.0.1 - | | pg_catalog.format_type(a.attt | | | | | - postgres | postgres | SELECT c.relchecks, c.relkind, c.relhasindex, c.r | 1 | 9 | 2022-10-24 07:29:00 | CCC51D018AC96A25 | 127.0.0.1 - -``` - - -Find more usage examples in the [`pg_stat_monitor` user guide :octicons-link-external-16:](https://docs.percona.com/pg-stat-monitor/user_guide.html). - -## Changing the configuration - -Run the following query to list available configuration parameters. - -```sql -SELECT name, short_desc FROM pg_settings WHERE name LIKE '%pg_stat_monitor%'; -``` - -**Output** - -``` - name | short_desc --------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------- - pg_stat_monitor.pgsm_bucket_time | Sets the time in seconds per bucket. - pg_stat_monitor.pgsm_enable_overflow | Enable/Disable pg_stat_monitor to grow beyond shared memory into swap space. - pg_stat_monitor.pgsm_enable_pgsm_query_id | Enable/disable PGSM specific query id calculation which is very useful in comparing same query across databases and clusters.. - pg_stat_monitor.pgsm_enable_query_plan | Enable/Disable query plan monitoring. - pg_stat_monitor.pgsm_extract_comments | Enable/Disable extracting comments from queries. - pg_stat_monitor.pgsm_histogram_buckets | Sets the maximum number of histogram buckets. - pg_stat_monitor.pgsm_histogram_max | Sets the time in millisecond. - pg_stat_monitor.pgsm_histogram_min | Sets the time in millisecond. - pg_stat_monitor.pgsm_max | Sets the maximum size of shared memory in (MB) used for statement's metadata tracked by pg_stat_monitor. - pg_stat_monitor.pgsm_max_buckets | Sets the maximum number of buckets. - pg_stat_monitor.pgsm_normalized_query | Selects whether save query in normalized format. - pg_stat_monitor.pgsm_overflow_target | Sets the overflow target for pg_stat_monitor. (Deprecated, use pgsm_enable_overflow) - pg_stat_monitor.pgsm_query_max_len | Sets the maximum length of query. - pg_stat_monitor.pgsm_query_shared_buffer | Sets the maximum size of shared memory in (MB) used for query tracked by pg_stat_monitor. - pg_stat_monitor.pgsm_track | Selects which statements are tracked by pg_stat_monitor. - pg_stat_monitor.pgsm_track_planning | Selects whether planning statistics are tracked. - pg_stat_monitor.pgsm_track_utility | Selects whether utility commands are tracked. -``` - -You can change a parameter by setting a new value in the configuration file. Some parameters require server restart to apply a new value. For others, configuration reload is enough. Refer to the [configuration parameters :octicons-link-external-16:](https://docs.percona.com/pg-stat-monitor/configuration.html) of the `pg_stat_monitor` documentation for the parameters’ description, how you can change their values and if the server restart is required to apply them. - -As an example, let’s set the bucket lifetime from default 60 seconds to 40 seconds. Use the **ALTER SYSTEM** command: - -```sql -ALTER SYSTEM set pg_stat_monitor.pgsm_bucket_time = 40; -``` - -Restart the server to apply the change: - - -=== "On Debian and Ubuntu" - - ```{.bash data-prompt="$"} - $ sudo systemctl restart postgresql.service - ``` - -=== "On Red Hat Enterprise Linux and derivatives" - - ```{.bash data-prompt="$"} - $ sudo systemctl restart postgresql-15 - ``` - -Verify the updated parameter: - -```sql -SELECT name, setting -FROM pg_settings -WHERE name = 'pg_stat_monitor.pgsm_bucket_time'; - - name | setting - ----------------------------------+--------- - pg_stat_monitor.pgsm_bucket_time | 40 -``` - -!!! admonition "See also" - - [`pg_stat_monitor` Documentation :octicons-link-external-16:](https://docs.percona.com/pg-stat-monitor/index.html) - - - Percona Blog: - - * [pg_stat_monitor: A New Way Of Looking At PostgreSQL Metrics :octicons-link-external-16:](https://www.percona.com/blog/2021/01/19/pg_stat_monitor-a-new-way-of-looking-at-postgresql-metrics/) - * [Improve PostgreSQL Query Performance Insights with pg_stat_monitor :octicons-link-external-16:](https://www.percona.com/blog/improve-postgresql-query-performance-insights-with-pg_stat_monitor/) diff --git a/docs/release-notes-v15.12.md b/docs/release-notes-v15.12.md new file mode 100644 index 000000000..a26871915 --- /dev/null +++ b/docs/release-notes-v15.12.md @@ -0,0 +1,58 @@ +# Percona Distribution for PostgreSQL 15.12 ({{date.15_12}}) + +[Installation](installing.md){.md-button} + +--8<-- "release-notes-intro.md" + +This release of Percona Distribution for PostgreSQL is based on [PostgreSQL 15.11](https://www.postgresql.org/docs/current/release-15-11.html) and [PostgreSQL 15.12](https://www.postgresql.org/docs/current/release-15-12.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 15.11 was skipped. + +### 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 spacial 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 [Spacial data manipulation](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. + +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.4 | a HA (High Availability) solution for PostgreSQL | +| [pgaudit :octicons-link-external-16:](https://www.pgaudit.org/) | 1.7.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.2 | a backup and restore solution for PostgreSQL | +| [pgBadger :octicons-link-external-16:](https://github.com/darold/pgbadger) | 13.0 | 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 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. | +| [PostGIS :octicons-link-external-16:](https://github.com/postgis/postgis) | 3.3.8 | a spatial extension for PostgreSQL. | +| [pgvector :octicons-link-external-16:](https://github.com/pgvector/pgvector) | v0.8.0 | A vector similarity search for PostgreSQL | +| [PostgreSQL Common :octicons-link-external-16:](https://salsa.debian.org/postgresql/postgresql-common) | 267 | 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 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/15/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 1844dd2be..dd993f35f 100644 --- a/docs/release-notes.md +++ b/docs/release-notes.md @@ -1,5 +1,7 @@ # Percona Distribution for PostgreSQL release notes +* [Percona Distribution for PostgreSQL 15.12](release-notes-v15.12.md) ({{date.15_12}}) + * [Percona Distribution for PostgreSQL 15.10](release-notes-v15.10.md) ({{date.15_10}}) * [Percona Distribution for PostgreSQL 15.8](release-notes-v15.8.md) ({{date.15_8}}) diff --git a/docs/repo-overview.md b/docs/repo-overview.md index 2cf7186e5..a65f9e4a2 100644 --- a/docs/repo-overview.md +++ b/docs/repo-overview.md @@ -12,6 +12,11 @@ Percona Distribution for PostgreSQL provides individual packages for its compone Using a meta-package, you can install all components it contains in one go. +!!! note + + Meta-packages are deprecated and will be removed in future releases. + + ### `percona-ppg-server` === "Package name on Debian/Ubuntu" diff --git a/docs/yum.md b/docs/yum.md index 1078c528f..851b0cd8a 100644 --- a/docs/yum.md +++ b/docs/yum.md @@ -226,7 +226,7 @@ $ sudo yum -y install curl ### Install packages -=== "Install using meta-package" +=== "Install using meta-package (deprecated)" The [meta package](repo-overview.md#percona-ppg-server){:target=”_blank”} enables you to install several components of the distribution in one go. diff --git a/mkdocs-base.yml b/mkdocs-base.yml index b264f8f66..c06146b98 100644 --- a/mkdocs-base.yml +++ b/mkdocs-base.yml @@ -3,7 +3,7 @@ site_name: Percona Distribution for PostgreSQL site_description: Documentation site_author: Percona LLC -copyright: Percona LLC, © 2024 +copyright: Percona LLC, © 2025 repo_name: percona/postgresql-docs repo_url: https://github.com/percona/postgresql-docs @@ -113,6 +113,7 @@ plugins: section-index: {} search: separator: '[\s\-,:!=\[\]()"`/]+|\.(?!\d)|&[lg]t;|(?!\b)(?=[A-Z][a-z])' +# open-in-new-tab: {} git-revision-date-localized: enable_creation_date: true enabled: !ENV [ENABLED_GIT_REVISION_DATE, True] @@ -131,7 +132,7 @@ plugins: with-pdf: # https://github.com/orzih/mkdocs-with-pdf output_path: '_pdf/PerconaDistributionPostgreSQL-15.pdf' cover_title: 'Distribution for PostgreSQL Documentation' - cover_subtitle: 15.10 (December 5, 2024) + cover_subtitle: 15.12 (March 3, 2025) author: 'Percona Technical Documentation Team' cover_logo: docs/_images/Percona_Logo_Color.png debug_html: false @@ -194,6 +195,7 @@ nav: - Uninstall: uninstalling.md - Release Notes: - "Release notes index": "release-notes.md" + - release-notes-v15.12.md - release-notes-v15.10.md - release-notes-v15.8.md - release-notes-v15.7.md diff --git a/mkdocs-pdf.yml b/mkdocs-pdf.yml index b23037843..57c5a27c9 100644 --- a/mkdocs-pdf.yml +++ b/mkdocs-pdf.yml @@ -3,7 +3,7 @@ INHERIT: mkdocs-base.yml -copyright: Percona LLC, © 2024 +copyright: Percona LLC, © 2025 markdown_extensions: pymdownx.tabbed: {} diff --git a/requirements.txt b/requirements.txt index f1d3d82d1..031d9e13a 100644 --- a/requirements.txt +++ b/requirements.txt @@ -14,4 +14,5 @@ mkdocs-section-index mkdocs-htmlproofer-plugin mkdocs-meta-descriptions-plugin mike -Pillow > 10.1.0 \ No newline at end of file +Pillow > 10.1.0 +mkdocs-open-in-new-tab \ No newline at end of file diff --git a/variables.yml b/variables.yml index b07007573..cd86fff1c 100644 --- a/variables.yml +++ b/variables.yml @@ -2,12 +2,13 @@ # See also mkdocs.yml plugins.with-pdf.cover_subtitle and output_path -release: 'release-notes-v15.10' +release: 'release-notes-v15.12' pgversion: '15' -dockertag: '15.10' -pgsmversion: '2.1.0' +dockertag: '15.12' +pgsmversion: '2.1.1' date: + 15_12: 2025-03-03 15_10: 2024-12-05 15_8: 2024-09-10 \ No newline at end of file