From 37cbb0eeb2948d79358c0a9774342c735a12339d Mon Sep 17 00:00:00 2001 From: Dragos Andriciuc Date: Wed, 20 May 2026 12:09:39 +0300 Subject: [PATCH] PG-2380 - Update Minor Upgrade guide with pg_tde version update (18) This PR adds an extra procedure step in the minor update tells the user how to update pg_tde to the latest installed version. --- 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 88101f221..590e5d1ef 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-17 + $ sudo systemctl start postgresql-18 ``` +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: