Skip to content

PG-2384 - Add pg_tde warning note to use pg_tde_upgrade (18) #983

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 3 commits into from
May 20, 2026
Merged

PG-2384 - Add pg_tde warning note to use pg_tde_upgrade (18) #983

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
045592d
PG-2384 - Add pg_tde warning note to use pg_tde_upgrade
Andriciuc May 20, 2026
e3748c7
Enhance pg_tde warning with external link
Andriciuc May 20, 2026
08498ef
Update major-upgrade.md
Andriciuc May 20, 2026
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
5 changes: 4 additions & 1 deletion docs/major-upgrade.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,10 @@ To ensure a smooth upgrade path, follow these steps:
!!! note
When running a major upgrade on **RHEL 8 and compatible derivatives**, consider the following:

Percona Distribution for PostgreSQL 16.3, 15.7, 14.12, 13.15 and 12.18 include `llvm` packages 16.0.6, while its previous versions 16.2, 15.6, 14.11, 13.14, and 12.17 include `llvm` 12.0.1. Since `llvm` libraries differ and are not compatible, the direct major version upgrade from 15.6 to 16.3 may cause issues.
Percona Distribution for PostgreSQL 16.3, 15.7, 14.12, 13.15 and 12.18 include `llvm` packages 16.0.6, while its previous versions 16.2, 15.6, 14.11, 13.14, and 12.17 include `llvm` 12.0.1. Since `llvm` libraries differ and are not compatible, the direct major version upgrade from 15.6 to 16.3 may cause issues.

!!! warning
When doing a major version upgrade, if your cluster uses `pg_tde`, you **must** use [`pg_tde_upgrade` :octicons-link-external-16:](https://docs.percona.com/pg-tde/command-line-tools/pg-tde-upgrade.html) instead of `pg_upgrade`. Using `pg_upgrade` on an encrypted cluster is not supported and will result in data corruption. The server may start successfully but queries against encrypted tables will fail.

The in-place upgrade means installing a new version without removing the old version and keeping the data files on the server.

Expand Down
Loading