mirror of https://github.com/postgres/postgres
Anastasia Alexadrova
1 year ago
parent
50b55b722a
commit
b3b7beb240
@ -0,0 +1,66 @@ |
|||||||
|
# Install `pg_tde` on Debian or Ubuntu |
||||||
|
|
||||||
|
In version Aplha1, `pg_tde` packages are available in the testing repository for Percona Distribution for PostgreSQL 16.2. 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 |
||||||
|
|
||||||
|
You need the `percona-release` repository management tool that enables the desired Percona repository for you. |
||||||
|
|
||||||
|
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 |
||||||
|
|
||||||
|
```bash |
||||||
|
sudo percona-release enable-only ppg-16.2 testing |
||||||
|
``` |
||||||
|
|
||||||
|
5. Update the local cache |
||||||
|
|
||||||
|
```bash |
||||||
|
sudo apt-get update |
||||||
|
``` |
||||||
|
|
||||||
|
## Install Percona Distribution for PostgreSQL |
||||||
|
|
||||||
|
To install Percona Distribution for PostgreSQL 16 and the required packages, run the following command: |
||||||
|
|
||||||
|
```bash |
||||||
|
sudo apt-get install -y percona-postgresql-16 percona-postgresql-contrib percona-postgresql-server-dev-all |
||||||
|
``` |
||||||
|
|
||||||
|
## Install `pg_tde` packages |
||||||
|
|
||||||
|
To install `pg_tde` packages, run the following command: |
||||||
|
|
||||||
|
```bash |
||||||
|
sudo apt-get install percona-postgresql-16-pg-tde |
||||||
|
``` |
||||||
|
|
||||||
|
## Next step |
||||||
|
|
||||||
|
[Setup](setup.md){.md-button} |
||||||
@ -0,0 +1,34 @@ |
|||||||
|
# Use external reference to parameters |
||||||
|
|
||||||
|
To allow storing secrets or any other parameters in a more secure, external location, `pg_tde` |
||||||
|
allows users to specify an external reference instead of hardcoded parameters. |
||||||
|
|
||||||
|
In Alpha1 version, `pg_tde` supports the following external storage methods: |
||||||
|
|
||||||
|
* `file`, which just stores the data in a simple file specified by a `path`. The file should be |
||||||
|
readable to the postgres process. |
||||||
|
* `remote`, which uses a HTTP request to retrieve the parameter from the specified `url`. |
||||||
|
|
||||||
|
## Examples |
||||||
|
|
||||||
|
To use the file provider with a file location specified by the `remote` method, |
||||||
|
use the following command: |
||||||
|
|
||||||
|
```sql |
||||||
|
SELECT pg_tde_add_key_provider_file( |
||||||
|
'file-provider', |
||||||
|
json_object( 'type' VALUE 'remote', 'url' VALUE 'http://localhost:8888/hello' ) |
||||||
|
);" |
||||||
|
``` |
||||||
|
|
||||||
|
Or to use the `file` method, use the following command: |
||||||
|
|
||||||
|
```sql |
||||||
|
SELECT pg_tde_add_key_provider_file( |
||||||
|
'file-provider', |
||||||
|
json_object( 'type' VALUE 'remote', 'path' VALUE '/tmp/datafile-location' ) |
||||||
|
);" |
||||||
|
``` |
||||||
|
|
||||||
|
Any parameter specified to the `add_key_provider` function can be a `json_object` instead of the string, |
||||||
|
similar to the above examples. |
||||||
@ -0,0 +1,62 @@ |
|||||||
|
# Install `pg_tde` on Red Hat Enterprise Linux and derivatives |
||||||
|
|
||||||
|
In version Aplha1, `pg_tde` packages are available in the testing repository for Percona Distribution for PostgreSQL 16.2. 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 |
||||||
|
|
||||||
|
### Enable / disable modules |
||||||
|
|
||||||
|
=== "CentOS 7" |
||||||
|
|
||||||
|
Install the `epel-release` package: |
||||||
|
|
||||||
|
```bash |
||||||
|
sudo yum -y install epel-release |
||||||
|
sudo yum repolist |
||||||
|
``` |
||||||
|
|
||||||
|
=== "RHEL8/Oracle Linux 8/Rocky Linux 8" |
||||||
|
|
||||||
|
Disable the ``postgresql`` and ``llvm-toolset``modules: |
||||||
|
|
||||||
|
```bash |
||||||
|
sudo dnf module disable postgresql llvm-toolset |
||||||
|
``` |
||||||
|
|
||||||
|
### Install `percona-release` |
||||||
|
|
||||||
|
You need the `percona-release` repository management tool that enables the desired Percona repository for you. |
||||||
|
|
||||||
|
1. Install `percona-release`: |
||||||
|
|
||||||
|
```bash |
||||||
|
sudo yum -y install https://repo.percona.com/yum/percona-release-latest.noarch.rpm |
||||||
|
``` |
||||||
|
|
||||||
|
2. Enable the repository |
||||||
|
|
||||||
|
```bash |
||||||
|
sudo percona-release enable-only ppg-16.2 testing |
||||||
|
``` |
||||||
|
|
||||||
|
## Install Percona Distribution for PostgreSQL |
||||||
|
|
||||||
|
To install Percona Distribution for PostgreSQL 16 and the required packages, run the following command: |
||||||
|
|
||||||
|
```bash |
||||||
|
sudo yum -y install percona-postgresql-client-common percona-postgresql-common percona-postgresql-server-dev-all percona-postgresql16 percona-postgresql16-contrib percona-postgresql16-devel percona-postgresql16-libs |
||||||
|
``` |
||||||
|
|
||||||
|
## Install `pg_tde` |
||||||
|
|
||||||
|
To install `pg_tde` packages, run the following command: |
||||||
|
|
||||||
|
```bash |
||||||
|
sudo yum install percona-pg_tde_16 |
||||||
|
``` |
||||||
|
|
||||||
|
## Next steps |
||||||
|
|
||||||
|
[Setup](setup.md){.md-button} |
||||||
Loading…
Reference in new issue