Skip to content

Commit b27f223

Browse files
authored
PG-2384 - Add pg_tde warning note to use pg_tde_upgrade (18) (#983)
This PR adds a warning note informing the user they need to use pg_tde_upgrade instead of pg_upgrade in their distribution in case pg_tde is used to encrypt the cluster.
1 parent baa434a commit b27f223

1 file changed

Lines changed: 4 additions & 1 deletion

File tree

docs/major-upgrade.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,10 @@ To ensure a smooth upgrade path, follow these steps:
1010
!!! note
1111
When running a major upgrade on **RHEL 8 and compatible derivatives**, consider the following:
1212

13-
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.
13+
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.
14+
15+
!!! warning
16+
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.
1417

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

0 commit comments

Comments
 (0)