diff --git a/docs/extensions.md b/docs/extensions.md index e2c21c1ea..083c695d5 100644 --- a/docs/extensions.md +++ b/docs/extensions.md @@ -8,7 +8,7 @@ Percona Distribution for PostgreSQL includes the extensions that have been teste * [Extensions authored by Percona](percona-ext.md) * [Third-party components](third-party.md) -Percona also supports [extra modules](https://repo.percona.com/ppg-17-extras/), not included in Percona Distribution for PostgreSQL but tested to work with it. +Percona also supports [extra modules](https://repo.percona.com/ppg-18-extras/), not included in Percona Distribution for PostgreSQL but tested to work with it. Additionally, see the list of [PostgreSQL software](https://www.percona.com/services/support/support-tiers-postgresql) covered by Percona Support. diff --git a/docs/faq.md b/docs/faq.md index b5e7ad326..76e13f893 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -1,12 +1,12 @@ # Frequently Asked Questions -This FAQ answers common questions about using Percona Server for PostgreSQL 17. +This FAQ answers common questions about using Percona Server for PostgreSQL 18. If you're looking for help with errors or runtime issues, see the [Troubleshooting guide](troubleshooting.md). ## Does MINOR cover both upstream feature and patch releases? -Yes, if we ship a future minor of PG17+ this always includes the patchset from Percona as well. +Yes, if we ship a future minor of PG18+ this always includes the patch set from Percona as well. ## When upstream bumps MINOR, should PATCH always reset to 1? diff --git a/docs/index.md b/docs/index.md index cab4542e7..def083f10 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,9 +1,9 @@ -# Percona Distribution for PostgreSQL 17 Documentation +# Percona Distribution for PostgreSQL 18 Documentation -Percona Distribution for PostgreSQL is a suite of open source software, tools and services required to deploy and maintain a reliable production cluster for PostgreSQL. +Percona Distribution for PostgreSQL is a suite of open source software, tools and services required to deploy and maintain a reliable production cluster for PostgreSQL. + +Percona Distribution for PostgreSQL includes [Percona Server for PostgreSQL](postgresql-server.md) packaged with extensions from open source community that are certified and tested to work together for high availability, backups, security, and monitoring that help ensure the cluster's peak performance. -Percona Distribution for PostgreSQL includes [Percona Server for PostgreSQL](postgresql-server.md) packaged with extensions from open source community that are certified and tested to work together for high availability, backups, security, and monitoring that help ensure the cluster's peak performance. - Part of the solution, Percona Operator for PostgreSQL, makes it easy to orchestrate the cluster reliably and repeatably in Kubernetes. [What's included in Percona Distribution for PostgreSQL? :material-arrow-right:](extensions.md){.md-button} @@ -12,10 +12,10 @@ Part of the solution, Percona Operator for PostgreSQL, makes it easy to orchestr - No vendor lock in - all components of Percona Distribution for PostgreSQL are fully open source - No guesswork on finding the right version of a component – they all undergo thorough testing to ensure compatibility -- Freely available reference architectures for solutions like high-availability, backups and disaster recovery +- Freely available reference architectures for solutions like high-availability, backups and disaster recovery - Spatial data handling support via PostGIS - Monitoring of the database health, performance and infrastructure usage via open source [Percona Management and Monitoring :octicons-link-external-16:](https://www.percona.com/doc/percona-monitoring-and-management/2.x/index.html) with PostgreSQL-specific dashboards -- Run PostgreSQL on Kubernetes using open source [Percona Operator for PostgreSQL :octicons-link-external-16:](https://docs.percona.com/percona-operator-for-postgresql/2.0/index.html). It not only automates deployment and management of PostgreSQL clusters on Kubernetes, but also includes enterprise-ready features for high-availability, backup and restore, replication, logging, and more +- Run PostgreSQL on Kubernetes using open source [Percona Operator for PostgreSQL :octicons-link-external-16:](https://docs.percona.com/percona-operator-for-postgresql/2.0/index.html). It not only automates deployment and management of PostgreSQL clusters on Kubernetes, but also includes enterprise-ready features for high-availability, backup and restore, replication, logging, and more - Automate PostgreSQL provisioning and management in Kubernetes, in the cloud or on-premises with [Percona Everest :octicons-link-external-16:](https://docs.percona.com/everest/index.html#why-percona-everest) - the cloud-native database platform
diff --git a/docs/major-upgrade.md b/docs/major-upgrade.md index 24fd9f298..3a6c84259 100644 --- a/docs/major-upgrade.md +++ b/docs/major-upgrade.md @@ -1,11 +1,11 @@ -# Upgrading Percona Distribution for PostgreSQL from 16 to 17 +# Upgrading Percona Distribution for PostgreSQL from 17 to 18 This document describes the in-place upgrade of Percona Distribution for PostgreSQL using the `pg_upgrade` tool. To ensure a smooth upgrade path, follow these steps: -* Upgrade to the latest minor version within your current major version (e.g., from 16.6 to 16.9). -* Then, perform the major upgrade to your desired version (e.g., from 16.9 to 17.5). +* Upgrade to the latest minor version within your current major version (e.g., from 17.4 to 17.5). +* Then, perform the major upgrade to your desired version (e.g., from 17.5 to 18.1). !!! note When running a major upgrade on **RHEL 8 and compatible derivatives**, consider the following: @@ -48,23 +48,23 @@ The exact steps may differ depending on the package manager of your operating sy Run **all** commands as root or via **sudo**: {.power-number} -1. Install Percona Distribution for PostgreSQL 17 packages. +1. Install Percona Distribution for PostgreSQL 18 packages. !!! note - When installing version 17, if prompted via a pop-up to upgrade to the latest available version, select **No**. + When installing version 18, if prompted via a pop-up to upgrade to the latest available version, select **No**. * [Install percona-release :octicons-link-external-17:](https://docs.percona.com/percona-software-repositories/installing.html). If you have installed it before, [update it to the latest version](https://docs.percona.com/percona-software-repositories/updating.html) * Enable Percona repository ```{.bash data-prompt="$"} - $ sudo percona-release setup ppg-17 + $ sudo percona-release setup ppg-18 ``` - * Install Percona Distribution for PostgreSQL 17 package + * Install Percona Distribution for PostgreSQL 18 package ```{.bash data-prompt="$"} - $ sudo apt install percona-postgresql-17 + $ sudo apt install percona-postgresql-18 ``` 2. Stop the `postgresql` service. @@ -73,7 +73,7 @@ Run **all** commands as root or via **sudo**: $ sudo systemctl stop postgresql.service ``` - This stops both Percona Distribution for PostgreSQL 16 and 17. + This stops both Percona Distribution for PostgreSQL 17 and 18. 3. Run the database upgrade. @@ -83,10 +83,10 @@ Run **all** commands as root or via **sudo**: $ sudo su postgres ``` - * Check if you can upgrade Percona Distribution for PostgreSQL from 16 to 17 + * Check if you can upgrade Percona Distribution for PostgreSQL from 17 to 18 ```{.bash data-prompt="$"} - $ pg_upgradecluster 16 main --check + $ pg_upgradecluster 17 main --check # Sample output: pg_upgradecluster pre-upgrade checks ok ``` @@ -95,30 +95,30 @@ Run **all** commands as root or via **sudo**: * Upgrade the Percona Distribution for PostgreSQL ```{.bash data-prompt="$"} - $ pg_upgradecluster 16 main + $ pg_upgradecluster 17 main ```
Sample output (click to expand) ```bash - Upgrading cluster 16/main to 17/main ... + Upgrading cluster 17/main to 18/main ... Stopping old cluster... Restarting old cluster with restricted connections... ... Success. Please check that the upgraded cluster works. If it does, you can remove the old cluster with: - pg_dropcluster 16 main + pg_dropcluster 17 main Ver Cluster Port Status Owner Data directory Log file - 17 main 5432 online postgres /var/lib/postgresql/17/main /var/log/postgresql/postgresql-17-main.log + 18 main 5432 online postgres /var/lib/postgresql/18/main /var/log/postgresql/postgresql-18-main.log Sample output: - Upgrading cluster 16/main to 17/main ... + Upgrading cluster 17/main to 18/main ... Stopping old cluster... Restarting old cluster with restricted connections... Notice: extra pg_ctl/postgres options given, bypassing systemctl for start operation - Creating new PostgreSQL cluster 17/main ... - /usr/lib/postgresql/17/bin/initdb -D /var/lib/postgresql/17/main --auth-local peer --auth-host scram-sha-256 --no-instructions --encoding UTF8 --lc-collate C.UTF-8 --lc-ctype C.UTF-8 --locale-provider libc + Creating new PostgreSQL cluster 18/main ... + /usr/lib/postgresql/18/bin/initdb -D /var/lib/postgresql/18/main --auth-local peer --auth-host scram-sha-256 --no-instructions --encoding UTF8 --lc-collate C.UTF-8 --lc-ctype C.UTF-8 --locale-provider libc The files belonging to this database system will be owned by user "postgres". This user must also own the server process. @@ -127,7 +127,7 @@ Run **all** commands as root or via **sudo**: Data page checksums are disabled. - fixing permissions on existing directory /var/lib/postgresql/17/main ... ok + fixing permissions on existing directory /var/lib/postgresql/18/main ... ok creating subdirectories ... ok selecting dynamic shared memory implementation ... posix selecting default max_connections ... 100 @@ -174,12 +174,12 @@ Run **all** commands as root or via **sudo**: Success. Please check that the upgraded cluster works. If it does, you can remove the old cluster with - pg_dropcluster 16 main + pg_dropcluster 17 main Ver Cluster Port Status Owner Data directory Log file - 16 main 5433 down postgres /var/lib/postgresql/16/main /var/log/postgresql/postgresql-16-main.log + 17 main 5433 down postgres /var/lib/postgresql/17/main /var/log/postgresql/postgresql-17-main.log Ver Cluster Port Status Owner Data directory Log file - 17 main 5432 online postgres /var/lib/postgresql/17/main /var/log/postgresql/postgresql-17-main.log + 18 main 5432 online postgres /var/lib/postgresql/18/main /var/log/postgresql/postgresql-18-main.log ```
@@ -209,7 +209,7 @@ Run **all** commands as root or via **sudo**: Before deleting the old cluster, verify that the newly upgraded cluster is fully operational. Keeping the old cluster does not negatively affect the functionality or performance of your upgraded cluster. ```{.bash data-prompt="$"} - $ pg_dropcluster 16 main + $ pg_dropcluster 17 main ``` ## On Red Hat Enterprise Linux and CentOS using `yum` @@ -217,7 +217,7 @@ Run **all** commands as root or via **sudo**: Run **all** commands as root or via **sudo**: {.power-number} -1. Install Percona Distribution for PostgreSQL 17 packages +1. Install Percona Distribution for PostgreSQL 18 packages * [Install percona-release :octicons-link-external-16:](https://docs.percona.com/percona-software-repositories/installing.html) @@ -254,10 +254,10 @@ Run **all** commands as root or via **sudo**: $ /usr/pgsql-{{pgversion}}/bin/initdb -D /var/lib/pgsql/{{pgversion}}/data ``` -3. Stop the `postgresql` 16 service +3. Stop the `postgresql` 17 service ```{.bash data-prompt="$"} - $ systemctl stop postgresql-16 + $ systemctl stop postgresql-17 ``` 4. Run the database upgrade. @@ -268,13 +268,13 @@ Run **all** commands as root or via **sudo**: $ sudo su postgres ``` - * Check the ability to upgrade Percona Distribution for PostgreSQL from 16 to 17: + * Check the ability to upgrade Percona Distribution for PostgreSQL from 17 to 18: ```{.bash data-prompt="$"} $ /usr/pgsql-{{pgversion}}/bin/pg_upgrade \ - --old-bindir /usr/pgsql-16/bin \ + --old-bindir /usr/pgsql-17/bin \ --new-bindir /usr/pgsql-{{pgversion}}/bin \ - --old-datadir /var/lib/pgsql/16/data \ + --old-datadir /var/lib/pgsql/17/data \ --new-datadir /var/lib/pgsql/{{pgversion}}/data \ --check ``` @@ -305,9 +305,9 @@ Run **all** commands as root or via **sudo**: ```{.bash data-prompt="$"} $ /usr/pgsql-{{pgversion}}/bin/pg_upgrade \ - --old-bindir /usr/pgsql-16/bin \ + --old-bindir /usr/pgsql-17/bin \ --new-bindir /usr/pgsql-{{pgversion}}/bin \ - --old-datadir /var/lib/pgsql/16/data \ + --old-datadir /var/lib/pgsql/17/data \ --new-datadir /var/lib/pgsql/{{pgversion}}/data \ --link ``` @@ -341,7 +341,7 @@ Run **all** commands as root or via **sudo**: $ /usr/pgsql-{{pgversion}}/bin/vacuumdb --all --analyze-in-stages ``` -8. Delete Percona Distribution for PostgreSQL 16 configuration files +8. Delete Percona Distribution for PostgreSQL 17 configuration files ```{.bash data-prompt="$"} $ ./delete_old_cluster.sh @@ -350,7 +350,7 @@ Run **all** commands as root or via **sudo**: 9. Delete Percona Distribution old data files ```{.bash data-prompt="$"} - $ rm -rf /var/lib/pgsql/16/data + $ rm -rf /var/lib/pgsql/17/data ``` !!! note "For major upgrades (RHEL only)" diff --git a/docs/minor-upgrade.md b/docs/minor-upgrade.md index 40939c276..dc3d186b8 100644 --- a/docs/minor-upgrade.md +++ b/docs/minor-upgrade.md @@ -53,7 +53,7 @@ Run **all** commands as root or via **sudo**: === ":material-redhat: On Red Hat Enterprise Linux / derivatives" ```{.bash data-prompt="$"} - $ sudo systemctl stop postgresql-16 + $ sudo systemctl stop postgresql-17 ``` 2. [Update `percona-release` to the latest version](https://docs.percona.com/percona-software-repositories/updating.html). @@ -71,7 +71,7 @@ Run **all** commands as root or via **sudo**: === ":material-redhat: On Red Hat Enterprise Linux / derivatives" ```{.bash data-prompt="$"} - $ sudo systemctl start postgresql-16 + $ sudo systemctl start postgresql-17 ``` !!! note "For minor upgrades (RHEL only)" @@ -85,6 +85,5 @@ Run **all** commands as root or via **sudo**: ``` To resolve this, remove the `percona-postgresql-common-dev` package and reinstall it with the new intended upgraded PPG/PSP server. - -If you wish to upgrade Percona Distribution for PostgreSQL to the major version, refer to [Upgrading Percona Distribution for PostgreSQL from 16 to 17](major-upgrade.md). +If you wish to upgrade Percona Distribution for PostgreSQL to the major version, refer to [Upgrading Percona Distribution for PostgreSQL from 17 to 18](major-upgrade.md). diff --git a/docs/postgresql-server.md b/docs/postgresql-server.md index 004dcbe42..e8ae3b027 100644 --- a/docs/postgresql-server.md +++ b/docs/postgresql-server.md @@ -1,6 +1,6 @@ # Percona Server for PostgreSQL -Percona Server for PostgreSQL is a binary-compatible, open source drop-in replacement for PostgreSQL 17. It introduces additional features to the upstream server, including: +Percona Server for PostgreSQL is a binary-compatible, open source drop-in replacement for PostgreSQL {{pgversion}}. It introduces additional features to the upstream server, including: * Storage Manager (SMGR) API Exposure: Allows PostgreSQL extensions to integrate custom storage managers. This change was inspired by the [patchset](https://www.postgresql.org/message-id/flat/CAJ7c6TOqqrzjYsU6LgDkcJ0yVgzdkx2juJjgAjzP2jPOpZ1qUA%40mail.gmail.com#8e68cfc57fcac14c8e24b00b41e61baf) introduced to the community. * WAL Read/Write API Exposure to hook into WAL read and write functions. diff --git a/docs/sboms.md b/docs/sboms.md index acaaaf457..b3a1c2ec7 100644 --- a/docs/sboms.md +++ b/docs/sboms.md @@ -6,21 +6,21 @@ Percona provides Software Bill of Materials (SBOMs), these files can help with c SBOMs are available for: === "Debian" - - [Debian 11 (Bullseye, x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-bullseye-x86_64.json) - - [Debian 11 (Bullseye, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-bullseye-aarch64.json) - - [Debian 12 (Bookworm, x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-bookworm-x86_64.json) - - [Debian 12 (Bookworm, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-bookworm-aarch64.json) + - [Debian 11 (Bullseye, x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-bullseye-x86_64.json) + - [Debian 11 (Bullseye, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-bullseye-aarch64.json) + - [Debian 12 (Bookworm, x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-bookworm-x86_64.json) + - [Debian 12 (Bookworm, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-bookworm-aarch64.json) === "Ubuntu" - - [Ubuntu 22.04 (Jammy, x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-jammy-x86_64.json) - - [Ubuntu 22.04 (Jammy, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-jammy-aarch64.json) - - [Ubuntu 24.04 (Noble, x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-noble-x86_64.json) - - [Ubuntu 24.04 (Noble, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-noble-aarch64.json) + - [Ubuntu 22.04 (Jammy, x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-jammy-x86_64.json) + - [Ubuntu 22.04 (Jammy, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-jammy-aarch64.json) + - [Ubuntu 24.04 (Noble, x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-noble-x86_64.json) + - [Ubuntu 24.04 (Noble, aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-noble-aarch64.json) === "Red Hat Enterprise Linux (RHEL) and derivatives" - - [RHEL 8 (x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-ol8-x86_64.json) - - [RHEL 8 (aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-ol8-aarch64.json) - - [RHEL 9 (x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-ol9-x86_64.json) - - [RHEL 9 (aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-ol9-aarch64.json) - - [RHEL 10 (x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-ol10-x86_64.json) - - [RHEL 10 (aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-17/17.6/binary/tarball/sbom-percona-postgresql-17.6-ol10-aarch64.json) + - [RHEL 8 (x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-ol8-x86_64.json) + - [RHEL 8 (aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-ol8-aarch64.json) + - [RHEL 9 (x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-ol9-x86_64.json) + - [RHEL 9 (aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-ol9-aarch64.json) + - [RHEL 10 (x86_64)](https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-ol10-x86_64.json) + - [RHEL 10 (aarch64)](https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{pgsubversion}}/binary/tarball/sbom-percona-postgresql-{{pgsubversion}}-ol10-aarch64.json) diff --git a/docs/tarball.md b/docs/tarball.md index b4db2a382..a4408659d 100644 --- a/docs/tarball.md +++ b/docs/tarball.md @@ -10,10 +10,10 @@ You can download the tarballs using the links below. The following tarballs are available for the x86_64 and ARM64 architectures: -* [percona-postgresql-{{dockertag}}-ssl1.1-linux-aarch64.tar.gz](https://downloads.percona.com/downloads/postgresql-distribution-17/{{dockertag}}/binary/tarball/percona-postgresql-17.6-ssl1.1-linux-aarch64.tar.gz) - for operating systems on ARM64 architecture that run OpenSSL version 1.x -* [percona-postgresql-{{dockertag}}-ssl1.1-linux-x86_64.tar.gz](https://downloads.percona.com/downloads/postgresql-distribution-17/{{dockertag}}/binary/tarball/percona-postgresql-17.6-ssl1.1-linux-x86_64.tar.gz) - for operating systems on x86_64 architecture that run OpenSSL version 1.x -* [percona-postgresql-{{dockertag}}-ssl3-linux-aarch64.tar.gz](https://downloads.percona.com/downloads/postgresql-distribution-17/{{dockertag}}/binary/tarball/percona-postgresql-17.6-ssl3-linux-aarch64.tar.gz) - for operating systems on ARM64 architecture that run OpenSSL version 3.x -* [percona-postgresql-{{dockertag}}-ssl3-linux-x86_64.tar.gz](https://downloads.percona.com/downloads/postgresql-distribution-17/{{dockertag}}/binary/tarball/percona-postgresql-17.6-ssl3-linux-x86_64.tar.gz) - for operating systems on x86_64 architecture that run OpenSSL version 3.x +* [percona-postgresql-{{dockertag}}-ssl1.1-linux-aarch64.tar.gz](https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{dockertag}}/binary/tarball/percona-postgresql-{{pgsubversion}}-ssl1.1-linux-aarch64.tar.gz) - for operating systems on ARM64 architecture that run OpenSSL version 1.x +* [percona-postgresql-{{dockertag}}-ssl1.1-linux-x86_64.tar.gz](https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{dockertag}}/binary/tarball/percona-postgresql-{{pgsubversion}}-ssl1.1-linux-x86_64.tar.gz) - for operating systems on x86_64 architecture that run OpenSSL version 1.x +* [percona-postgresql-{{dockertag}}-ssl3-linux-aarch64.tar.gz](https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{dockertag}}/binary/tarball/percona-postgresql-{{pgsubversion}}-ssl3-linux-aarch64.tar.gz) - for operating systems on ARM64 architecture that run OpenSSL version 3.x +* [percona-postgresql-{{dockertag}}-ssl3-linux-x86_64.tar.gz](https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{dockertag}}/binary/tarball/percona-postgresql-{{pgsubversion}}-ssl3-linux-x86_64.tar.gz) - for operating systems on x86_64 architecture that run OpenSSL version 3.x To check what OpenSSL version you have, run the following command: @@ -103,7 +103,7 @@ The steps below install the tarballs for OpenSSL 3.x on x86_64 architecture. Use 3. Fetch the binary tarball. ```{.bash data-prompt="$"} - $ wget https://downloads.percona.com/downloads/postgresql-distribution-17/{{dockertag}}/binary/tarball/percona-postgresql-{{dockertag}}-ssl3-linux-x86_64.tar.gz + $ wget https://downloads.percona.com/downloads/postgresql-distribution-{{pgversion}}/{{dockertag}}/binary/tarball/percona-postgresql-{{dockertag}}-ssl3-linux-x86_64.tar.gz ``` 4. Extract the tarball to the directory for binaries that you created on step 1. diff --git a/docs/templates/pdf_cover_page.tpl b/docs/templates/pdf_cover_page.tpl index 8eb76ee0e..d8ff62d71 100644 --- a/docs/templates/pdf_cover_page.tpl +++ b/docs/templates/pdf_cover_page.tpl @@ -7,6 +7,6 @@ {% if config.site_description %}

{{ config.site_description }}

{% endif %} -

17.6.1 (September 10, 2025)

+

18.1.1 (November 15, 2025)

diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md index e2e7c1b1c..c4ef9c755 100644 --- a/docs/troubleshooting.md +++ b/docs/troubleshooting.md @@ -1,6 +1,6 @@ # Troubleshooting guide -This guide helps you identify and resolve common issues when installing, configuring, or running Percona Server for PostgreSQL 17. +This guide helps you identify and resolve common issues when installing, configuring, or running Percona Server for PostgreSQL {{pgversion}}. If you're looking for general information or usage tips, check the [FAQ](faq.md). diff --git a/docs/versioning.md b/docs/versioning.md index 1a5db5600..fbb9974da 100644 --- a/docs/versioning.md +++ b/docs/versioning.md @@ -10,18 +10,18 @@ For example: Where: -- **MAJOR** = The upstream PostgreSQL major version (e.g. 17 → PostgreSQL 17) +- **MAJOR** = The upstream PostgreSQL major version (e.g. {{pgversion}} → PostgreSQL {{pgversion}}) - **MINOR** = The upstream PostgreSQL release number - **PATCH** = Percona's internal build number (specific to packaging or Percona-only updates) | **Release type** | **Version example** | **What changes?** | | --- | --- | --- | -| **First Percona build** | 17.0.1 | Initial Percona build on upstream 17.0, build #1 | -| **Percona-only update** | 17.0.2 | Build #2 on the same upstream 17.0 | -| **Upstream patch/feature** | 17.1.1 | Upstream release → MINOR bump to 1, PATCH reset to 1 | -| **Next Percona build** | 17.1.2 | Build #2 on upstream 17.1 | +| **First Percona build** | {{pgversion}}.0.1 | Initial Percona build on upstream {{pgversion}}.0, build #1 | +| **Percona-only update** | {{pgversion}}.0.2 | Build #2 on the same upstream {{pgversion}}.0 | +| **Upstream patch/feature** | {{pgversion}}.1.1 | Upstream release → MINOR bump to 1, PATCH reset to 1 | +| **Next Percona build** | {{pgversion}}.1.2 | Build #2 on upstream {{pgversion}}.1 | -The above versioning is only applicable to PSP 17.x.x as it is the only Percona forked server. The **third digit** is **always** PSP’s build number, never an upstream patch. If you see it go from …1 → …2 this means a PSP-specific update was shipped. +The above versioning is only applicable to PSP {{pgversion}}.x.x as it is the only Percona forked server. The **third digit** is **always** PSP’s build number, never an upstream patch. If you see it go from …1 → …2 this means a PSP-specific update was shipped. Since PPG 13 to 16 are pure community versions, only the first 2 digits scheme is used for them.