From 29735367fed0188708d9ac60662cb56d51deac47 Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Wed, 20 May 2026 12:16:15 +0300 Subject: [PATCH] PG-2380 - Update Minor Upgrade guide with pg_tde version update (17) This PR adds an extra procedure step in the minor update tells the user how to update pg_tde to the latest installed version. It also updates the command to restart the server from 17 to 18 and removes a stale paragraph. --- docs/minor-upgrade.md | 23 +++++++++++------------ 1 file changed, 11 insertions(+), 12 deletions(-) diff --git a/docs/minor-upgrade.md b/docs/minor-upgrade.md index 40939c276..9f1f4955b 100644 --- a/docs/minor-upgrade.md +++ b/docs/minor-upgrade.md @@ -4,15 +4,6 @@ Minor releases of PostgreSQL include bug fixes and feature enhancements. We reco Though minor upgrades do not change the behavior, we recommend you to back up your data first, in order to be on the safe side. -Minor upgrade of Percona Distribution for PostgreSQL includes the following steps: - -1. Stop the `postgresql` cluster - -2. Update `percona-release` -3. Install new version packages - -4. Restart the `postgresql` cluster. - !!! note These steps apply if you installed Percona Distribution for PostgreSQL from the Major Release repository. In this case, you are always upgraded to the latest available release. @@ -42,7 +33,7 @@ Minor upgrade of Percona Distribution for PostgreSQL includes the following step Run **all** commands as root or via **sudo**: {.power-number} -1. Stop the `postgresql` service. +1. Stop the `postgresql` service: === ":material-debian: On Debian / Ubuntu" @@ -60,7 +51,7 @@ Run **all** commands as root or via **sudo**: 3. Install new version packages. See [Installing Percona Distribution for PostgreSQL](installing.md). -4. Restart the `postgresql` service. +4. Restart the `postgresql` service: === ":material-debian: On Debian / Ubuntu" @@ -71,9 +62,17 @@ 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 ``` +5. If you use `pg_tde`, update the extension. After restarting the cluster, connect to each database where `pg_tde` is installed and run: + + ```sql + ALTER EXTENSION pg_tde UPDATE; + ``` + + This updates the extension to the latest installed version and needs to be run in each database where the extension is installed. + !!! note "For minor upgrades (RHEL only)" During a minor upgrade on RHEL, you may encounter the following error: