-
Notifications
You must be signed in to change notification settings - Fork 18
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #167 from Percona-Lab/Doc-install-packages
Doc: Added install from packages instructions
- Loading branch information
Showing
9 changed files
with
227 additions
and
118 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.