Skip to content

PG-2380 - Update Minor Upgrade guide with pg_tde version update (18) #985

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Andriciuc merged 1 commit into from
May 20, 2026
Merged

PG-2380 - Update Minor Upgrade guide with pg_tde version update (18) #985

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 11 additions & 12 deletions docs/minor-upgrade.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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"

Expand All @@ -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"

Expand All @@ -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:
Expand Down
Loading