From 8bdfc7db708eca154ec39a806238d0feaa83b6cc Mon Sep 17 00:00:00 2001
From: Anastasia Alexandrova <anastasia.alexandrova@percona.com>
Date: Wed, 30 Aug 2023 16:02:29 +0300
Subject: [PATCH] DISTPG-620 Release notes 14.9 (#437)

* DISTPG-620 Release notes 14.9

modified:   .github/workflows/main.yml
	modified:   docs/apt.md
	modified:   docs/index.md
	modified:   docs/major-upgrade.md
	new file:   docs/release-notes-v14.9.md
	modified:   docs/release-notes.md
	modified:   docs/yum.md
	modified:   mkdocs-base.yml
	modified:   variables.yml

* Updated nav.html for 9.2 version of Material theme
modified:   _resource/overrides/partials/nav.html

* Updated pg_gather version and release date

* Updated versions and release date

* DISTPG-635 Added Debian 12 packages
---
 .github/workflows/main.yml            |  2 +-
 _resource/overrides/partials/nav.html |  4 +-
 docs/apt.md                           |  6 +++
 docs/index.md                         |  5 ++-
 docs/installing.md                    |  6 ++-
 docs/major-upgrade.md                 | 10 +++--
 docs/release-notes-v14.9.md           | 54 +++++++++++++++++++++++++++
 docs/release-notes.md                 |  4 +-
 docs/yum.md                           |  6 +++
 mkdocs-base.yml                       |  3 +-
 variables.yml                         |  6 +--
 11 files changed, 91 insertions(+), 15 deletions(-)
 create mode 100644 docs/release-notes-v14.9.md

diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
index 7a701c946..11cdeeb87 100644
--- a/.github/workflows/main.yml
+++ b/.github/workflows/main.yml
@@ -45,7 +45,7 @@ jobs:
       - name: Deploy docs
         run: |
           mike deploy 14 -b publish -p
-          mike retitle 14 "14.8" -b publish -p
+          mike retitle 14 "14.9" -b publish -p
 
 # - name: Install Node.js 14.x
 #        uses: percona-platform/setup-node@v2
diff --git a/_resource/overrides/partials/nav.html b/_resource/overrides/partials/nav.html
index f75acbcbd..dab404440 100644
--- a/_resource/overrides/partials/nav.html
+++ b/_resource/overrides/partials/nav.html
@@ -1,6 +1,7 @@
 {#-
   This file was automatically generated - do not edit
 -#}
+{% import "partials/nav-item.html" as item with context %}
 {% set class = "md-nav md-nav--primary" %}
 {% if "navigation.tabs" in features %}
   {% set class = class ~ " md-nav--lifted" %}
@@ -23,8 +24,7 @@
   <ul class="md-nav__list" data-md-scrollfix>
     {% for nav_item in nav %}
       {% set path = "__nav_" ~ loop.index %}
-      {% set level = 1 %}
-      {% include "partials/nav-item.html" %}
+      {{ item.render(nav_item, path, 1) }}
     {% endfor %}
     <br>
    <label class="md-nav__title" for="__drawer">
diff --git a/docs/apt.md b/docs/apt.md
index 198428b62..18da542a7 100644
--- a/docs/apt.md
+++ b/docs/apt.md
@@ -129,6 +129,12 @@ Run all the commands in the following sections as root or using the `sudo` comma
           $ sudo apt install percona-pgpool2
           ```
           
+          Install `pg_gather`
+
+          ```{.bash data-prompt="$"}
+          $ sudo apt install percona-pg-gather
+          ```
+
           Some extensions require additional setup in order to use them with Percona Distribution for PostgreSQL. For more information, refer to [Enabling extensions](enable-extensions.md).
 
 ### Start the service
diff --git a/docs/index.md b/docs/index.md
index 2f5f5e4f2..8c33e6bf7 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -20,6 +20,9 @@ PostgreSQL
 
 * [PgBouncer](https://www.pgbouncer.org/) - a lightweight connection pooler for PostgreSQL
 
+* [pg_gather](https://github.com/jobinau/pg_gather) - an SQL script to assess the health of PostgreSQL cluster by gathering performance and configuration data from PostgreSQL databases.
+
+
 * [pgpool2](https://www.pgpool.net/mediawiki/index.php/Main_Page) - a middleware between PostgreSQL server and client for high availability, connection pooling and load balancing.
 
 * [pg_repack](https://github.com/reorg/pg_repack) rebuilds
@@ -31,7 +34,7 @@ PostgreSQL database objects
 
 * [wal2json](https://github.com/eulerto/wal2json) - a PostgreSQL logical decoding JSON output plugin.
 
-* A collection of [additional PostgreSQL contrib extensions](https://www.postgresql.org/docs/15/contrib.html)
+* A collection of [additional PostgreSQL contrib extensions](https://www.postgresql.org/docs/14/contrib.html)
 
 
 [Get started](installing.md){ .md-button }
diff --git a/docs/installing.md b/docs/installing.md
index 31164c7f1..3ef550874 100644
--- a/docs/installing.md
+++ b/docs/installing.md
@@ -50,8 +50,8 @@ The `percona-ppg-server-ha` meta-package installs high-availability components t
 | ---------------- | --------------------------------------- | 
 | `percona-patroni`| A high-availability solution for PostgreSQL. | 
 | `percona-haproxy`| A high-availability and load-balancing solution |
-| `etcd`           | A consistent, distributed key-value store | 
-| `python3-python-etcd` | A Python client for ETCD.[^1]
+| `python3-python-etcd` | A Python client for ETCD.[^1] |
+| `etcd-client`, `etcd-server` | The client/server of the distributed key-value store. [^2]| 
 
 To install Percona Distribution for PostgreSQL, refer to the following tutorials:
 
@@ -60,4 +60,6 @@ To install Percona Distribution for PostgreSQL, refer to the following tutorials
 
 
 
+
 [^1]: Is included in repositories for RHEL 8 / CentOS 8 operating systems
+[^2]: Are included in repositories for Debian 12 operating system
\ No newline at end of file
diff --git a/docs/major-upgrade.md b/docs/major-upgrade.md
index 22ee83eef..76600e2f2 100644
--- a/docs/major-upgrade.md
+++ b/docs/major-upgrade.md
@@ -76,8 +76,9 @@ The exact steps may differ depending on the package manager of your operating sy
        percona-pgbadger \
        percona-postgresql-14-wal2json \
        percona-pg-stat-monitor14 \
-       percona-postgresql-contrib
-       percona-pgpool2
+       percona-postgresql-contrib \
+       percona-pgpool2 \
+       percona-pg-gather
       ```
 
     !!! admonition "See also"
@@ -267,8 +268,9 @@ The exact steps may differ depending on the package manager of your operating sy
        percona-pgaudit14_set_user \
        percona-pgbadger \
        percona-wal2json14 \
-       percona-postgresql14-contrib
-       percona-pgpool-II-pg14
+       percona-postgresql14-contrib \
+       percona-pgpool-II-pg14 \
+       percona-pg_gather
        ```
 
 !!! admonition "See also"
diff --git a/docs/release-notes-v14.9.md b/docs/release-notes-v14.9.md
new file mode 100644
index 000000000..9cf573e57
--- /dev/null
+++ b/docs/release-notes-v14.9.md
@@ -0,0 +1,54 @@
+# Percona Distribution for PostgreSQL 14.9 (2023-08-30)
+
+
+| Release date:     | August 30, 2023        |
+|:------------------|:-----------------------|
+| **Installation**: | [Installing Percona Distribution for PostgreSQL](installing.md) |
+
+Percona Distribution for PostgreSQL is 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 [PostgreSQL 14.9](https://www.postgresql.org/docs/14/release-14-9.html). 
+
+## Release Highlights
+
+* Percona Distribution for PostgreSQL components now include [pg_gather](https://github.com/jobinau/pg_gather) - the open source extension to assess the health of PostgreSQL cluster by gathering performance and configuration data from PostgreSQL databases. This tool helps you run diagnostics of your PosrgreSQL cluster and is also actively used by Percona Support.
+* Percona Distribution for PostgreSQL is now available on Debian 12 (bookworm).
+* The support of Ubuntu 18.04 is deprecated.
+
+------------------------------------------------------------------------------
+
+The following is the list of extensions available in Percona Distribution for PostgreSQL.
+
+| Extension           | Version        | Description                  |
+| ------------------- | -------------- | ---------------------------- |
+|[HAProxy](http://www.haproxy.org/) | 2.8.1 | a high-availability and load-balancing solution |
+| [Patroni](https://patroni.readthedocs.io/en/latest/) | 3.1.0 | a HA (High Availability) solution for PostgreSQL |
+| [PgAudit](https://www.pgaudit.org/)             | 1.6.2   | provides detailed session or object audit logging via the standard logging facility provided by PostgreSQL                |
+| [pgAudit set_user](https://github.com/pgaudit/set_user)| 4.0.1 | 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](https://pgbackrest.org/)           | 2.47    | a backup and restore solution for PostgreSQL       |
+|[pgBadger](https://github.com/darold/pgbadger)   | 12.1     | a fast PostgreSQL Log Analyzer.|
+|[PgBouncer](https://www.pgbouncer.org/)          |1.20.0    | a lightweight connection pooler for PostgreSQL|
+| [pg_gather](https://github.com/jobinau/pg_gather)| v22     | an SQL script for running the diagnostics of the health of PostgreSQL cluster |
+| [pgpool2](https://git.postgresql.org/gitweb/?p=pgpool2.git;a=summary) | 4.4.3 | a middleware between PostgreSQL server and client for high availability, connection pooling and load balancing.|
+| [pg_repack](https://github.com/reorg/pg_repack) | 1.4.8   | rebuilds PostgreSQL database objects           |
+| [pg_stat_monitor](https://github.com/percona/pg_stat_monitor)|2.0.1 | collects and aggregates statistics for PostgreSQL and provides histogram information.|
+| [PostGIS](https://github.com/postgis/postgis) | 3.3.4 | a spatial extension for PostgreSQL.|
+| [PostgreSQL Common](https://salsa.debian.org/postgresql/postgresql-common)| 252 | PostgreSQL database-cluster manager. It provides a structure under which multiple versions of PostgreSQL may be installed and/or multiple clusters may be maintained at one time.|
+|[wal2json](https://github.com/eulerto/wal2json)  |2.5       | a PostgreSQL logical decoding JSON output plugin|
+
+
+Percona Distribution for PostgreSQL also includes the following packages:
+
+* `llvm` 12.0.1 packages for Red Hat Enterprise Linux 8 and derivatives. This fixes compatibility issues with LLVM from upstream.
+* supplemental `ETCD` packages which can be used for setting up Patroni clusters. These packages are available for the following operating systems:
+
+|  Operating system  | Package              | Version | Description        |
+| ------------------ | ---------------------| --------| ------------------ |
+| RHEL 7              |`python3-python-etcd` | 0.4.5   | A Python client for ETCD     |
+| RHEL 8             | `etcd`               | 3.3.11  | A consistent, distributed key-value store |
+|                    | `python3-python-etcd`| 0.4.5   | A Python client for ETCD |
+                                                      
+Percona Distribution for PostgreSQL is also shipped with the [libpq](https://www.postgresql.org/docs/14/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 d607ffddf..8bfd44ec0 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,6 +1,8 @@
 # Release notes index
 
-* [Percona Distribution for PostgreSQL 14.8](release-notes-v14.7.md) (2023-06-29)
+* [Percona Distribution for PostgreSQL 14.9](release-notes-v14.9.md) (2023-08-30)
+
+* [Percona Distribution for PostgreSQL 14.8](release-notes-v14.8.md) (2023-06-29)
 
 * [Percona Distribution for PostgreSQL 14.7 Update](release-notes-v14.7.upd.md) (2023-05-22)
 
diff --git a/docs/yum.md b/docs/yum.md
index 001f4ad12..62882f996 100644
--- a/docs/yum.md
+++ b/docs/yum.md
@@ -162,6 +162,12 @@ Run all the commands in the following sections as root or using the `sudo` comma
 
         For Red Hat Enterprise Linux 8, replace the operating system version in the commands accordingly.
 
+        Install `pg_gather`
+
+        ```{.bash data-prompt="$"}
+        $ sudo yum install percona-pg_gather
+        ```
+
         Install HAProxy
         
         ```{.bash data-prompt="$"}
diff --git a/mkdocs-base.yml b/mkdocs-base.yml
index e3c480ebd..35edc4ae8 100644
--- a/mkdocs-base.yml
+++ b/mkdocs-base.yml
@@ -103,7 +103,7 @@ plugins:
   with-pdf: # https://github.com/orzih/mkdocs-with-pdf
           output_path: '_pdf/PerconaDistributionPostgreSQL-14.pdf'
           cover_title: 'Percona Distribution for PostgreSQL Documentation'
-          cover_subtitle: 14.8 (June 28, 2023)
+          cover_subtitle: 14.9 (August 30, 2023)
           author: 'Percona Technical Documentation Team'
           cover_logo: docs/_images/Percona_Logo_Color.png
           debug_html: false
@@ -132,6 +132,7 @@ nav:
   - Home: index.md
   - Release notes:
       - "Release notes index": "release-notes.md"
+      - release-notes-v14.9.md
       - release-notes-v14.8.md
       - release-notes-v14.7.upd.md
       - release-notes-v14.7.md
diff --git a/variables.yml b/variables.yml
index 5479326db..34c68d561 100644
--- a/variables.yml
+++ b/variables.yml
@@ -1,6 +1,6 @@
 # PG Variables set for HTML output
 # See also mkdocs.yml plugins.with-pdf.cover_subtitle and output_path
 
-release: 'release-notes-v14.8'
-version: '14.8'
-release_date: 2023-05-
\ No newline at end of file
+release: 'release-notes-v14.9'
+version: '14.9'
+release_date: 2023-08-30
\ No newline at end of file