Skip to content

Commit

Permalink
PG-1260 Documented a precondition to drop tde package before the upgr…
Browse files Browse the repository at this point in the history
…ade (#706)

* PG-1260 Documented a precondition to drop tde package before the upgrade
  • Loading branch information
nastena1606 authored Dec 26, 2024
1 parent f471a27 commit 6b4ac16
Showing 1 changed file with 19 additions and 3 deletions.
22 changes: 19 additions & 3 deletions docs/minor-upgrade.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,10 +7,10 @@ Though minor upgrades do not change the behavior, we recommend you to back up yo
Minor upgrade of Percona Distribution for PostgreSQL includes the following steps:


1. Stop the `postgresql` cluster;
1. Stop the `postgresql` cluster

2. Update `percona-release`
3. Install new version packages;
3. Install new version packages

4. Restart the `postgresql` cluster.

Expand All @@ -22,7 +22,23 @@ Minor upgrade of Percona Distribution for PostgreSQL includes the following step

For more information about Percona repositories, refer to [Installing Percona Distribution for PostgreSQL](installing.md).

Before the upgrade, [update the `percona-release` :octicons-link-external-16:](https://www.percona.com/doc/percona-repo-config/percona-release.html#updating-percona-release-to-the-latest-version) utility to the latest version. This is required to install the new version packages of Percona Distribution for PostgreSQL.
## Before you start

1. [Update the `percona-release` :octicons-link-external-16:](https://www.percona.com/doc/percona-repo-config/percona-release.html#updating-percona-release-to-the-latest-version) utility to the latest version. This is required to install the new version packages of Percona Distribution for PostgreSQL.

2. Starting with version 17.2.1, `pg_tde` is part of the Percona Server for PostgreSQL package. If you installed `pg_tde` from its dedicated package, do the following to avoid conflicts during the upgrade:

* Drop the extension using the `DROP EXTENSION` with `CASCADE` command.

<i warning>:material-alert: Warning:</i> The use of the `CASCADE` parameter deletes all tables that were created in the database with `pg_tde` enabled and also all dependencies upon the encrypted table (e.g. foreign keys in a non-encrypted table used in the encrypted one).

```sql
DROP EXTENSION pg_tde CASCADE
```

* Uninstall the `percona-postgresql-17-pg-tde` package for Debian/Ubuntu or the `percona-pg_tde_17` package for RHEL and derivatives.

## Procedure

Run **all** commands as root or via **sudo**:
{.power-number}
Expand Down

0 comments on commit 6b4ac16

Please sign in to comment.