mirror of https://github.com/postgres/postgres
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
82 lines
2.6 KiB
82 lines
2.6 KiB
# Install `pg_tde` on Debian or Ubuntu
|
|
|
|
The packages for the tech preview `pg_tde` are available in the experimental repository for Percona Distribution for PostgreSQL 17.
|
|
|
|
Check the [list of supported platforms](install.md#__tabbed_1_2).
|
|
|
|
This tutorial shows how to install `pg_tde` with [Percona Distribution for PostgreSQL](https://docs.percona.com/postgresql/latest/index.html).
|
|
|
|
## Preconditions
|
|
|
|
1. Debian and other systems that use the `apt` package manager include the upstream PostgreSQL server package (`postgresql-{{pgversion17}}`) by default. You need to uninstall this package before you install Percona Server for PostgreSQL and `pg_tde` to avoid conflicts.
|
|
2. You need the `percona-release` repository management tool that enables the desired Percona repository for you.
|
|
|
|
|
|
### Install `percona-release`
|
|
|
|
1. You need the following dependencies to install `percona-release`:
|
|
|
|
- `wget`
|
|
- `gnupg2`
|
|
- `curl`
|
|
- `lsb-release`
|
|
|
|
Install them with the following command:
|
|
|
|
```bash
|
|
sudo apt-get install -y wget gnupg2 curl lsb-release
|
|
```
|
|
|
|
2. Fetch the `percona-release` package
|
|
|
|
```bash
|
|
sudo wget https://repo.percona.com/apt/percona-release_latest.generic_all.deb
|
|
```
|
|
|
|
3. Install `percona-release`
|
|
|
|
```bash
|
|
sudo dpkg -i percona-release_latest.generic_all.deb
|
|
```
|
|
|
|
4. Enable the Percona Distribution for PostgreSQL repository
|
|
|
|
Percona provides [two repositories](repo-overview.md) for Percona Distribution for PostgreSQL. We recommend enabling the Major release repository to timely receive the latest updates.
|
|
|
|
```{.bash data-prompt="$"}
|
|
$ sudo percona-release enable ppg-{{pgversion17}}
|
|
```
|
|
|
|
6. Update the local cache
|
|
|
|
```bash
|
|
sudo apt-get update
|
|
```
|
|
|
|
## Install `pg_tde`
|
|
|
|
!!! important
|
|
|
|
The `pg_tde` {{release}} extension is a part of the `percona-postgresql-17` package. If you installed a previous version of `pg_tde` from the `percona-postgresql-17-pg-tde` package, do the following:
|
|
|
|
* 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.
|
|
|
|
After all [preconditions](#preconditions) are met, run the following command to install `pg_tde`:
|
|
|
|
|
|
```bash
|
|
sudo apt-get install -y percona-postgresql-17
|
|
```
|
|
|
|
|
|
## Next step
|
|
|
|
[Setup](setup.md){.md-button}
|
|
|