Skip to content

Commit 0b68d4f

Browse files
committed
Merge branch '17' into add-17.7.1-release-notes
2 parents d9b7259 + 161ef12 commit 0b68d4f

File tree

4 files changed

+25
-27
lines changed

4 files changed

+25
-27
lines changed

.github/workflows/main.yml

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -43,9 +43,8 @@ jobs:
4343
- name: Deploy docs
4444
run: |
4545
mike deploy 17 -b publish -p
46-
mike set-default 17 -b publish -p
47-
mike retitle 17 "17 (LATEST)" -b publish -p
46+
mike retitle 17 "17.6" -b publish -p
4847
4948
5049

51-
50+

docs/migration.md

Lines changed: 10 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,16 @@
1-
# Migrate from PostgreSQL to Percona Distribution for PostgreSQL
2-
1+
# Migrate from PostgreSQL to Percona Distribution for PostgreSQL
32

43
Percona Distribution for PostgreSQL includes the PostgreSQL database and additional extensions that have been selected to cover the needs of the enterprise and are guaranteed to work together. Percona Distribution for PostgreSQL is available as a software collection that is easy to deploy.
54

6-
We encourage users to migrate from their PostgreSQL deployments based on community binaries to Percona Distribution for PostgreSQL. This document provides the migration instructions.
5+
We encourage users to migrate from their PostgreSQL deployments based on community binaries to Percona Distribution for PostgreSQL. This document provides the migration instructions.
76

8-
Depending on your business requirements, you may migrate to Percona Distribution for PostgreSQL either [on the same server](#migrate-on-the-same-server) or [onto a different server](#migrate-on-a-different-server).
7+
Depending on your business requirements, you may migrate to Percona Distribution for PostgreSQL either [on the same server](#migrate-on-the-same-server) or [onto a different server](#migrate-on-a-different-server).
98

109
## Migrate on the same server
1110

12-
=== ":material-debian: :material-debian: On Debian and Ubuntu Linux"
11+
=== ":material-debian: On Debian and Ubuntu Linux"
1312

14-
>To ensure that your data is safe during the migration, we recommend to make a backup of your data and all configuration files (such as `pg_hba.conf`, `postgresql.conf`, `postgresql.auto.conf`) using the tool of your choice. The backup process is out of scope of this document. You can use `pg_dumpall` or other tools of your choice. For more information, see the blog post [PostgreSQL Upgrade Using pg_dumpall](https://www.percona.com/blog/postgresql-upgrade-using-pg_dumpall/) by _Avinash Vallarapu_, _Fernando Laudares Camargos_, _Jobin Augustine_ and _Nickolay Ihalainen_.
13+
>To ensure that your data is safe during the migration, we recommend to make a backup of your data and all configuration files (such as `pg_hba.conf`, `postgresql.conf`, `postgresql.auto.conf`) using the tool of your choice. The backup process is out of scope of this document. You can use `pg_dumpall` or other tools of your choice. For more information, see the blog post [PostgreSQL Upgrade Using pg_dumpall :octicons-link-external-16:](https://www.percona.com/blog/postgresql-upgrade-using-pg_dumpall/) by _Avinash Vallarapu_, _Fernando Laudares Camargos_, _Jobin Augustine_ and _Nickolay Ihalainen_.
1514

1615
Run **all** commands as root or via **sudo**:
1716
{.power-number}
@@ -49,7 +48,6 @@ Depending on your business requirements, you may migrate to Percona Distribution
4948
$ sudo systemctl start postgresql.service
5049
```
5150

52-
5351
=== ":material-redhat: On RHEL and derivatives"
5452

5553
> To ensure that your data is safe during the migration, we recommend to make a backup of your data and all configuration files (such as `pg_hba.conf`, `postgresql.conf`, `postgresql.auto.conf`) using the tool of your choice. The backup process is out of scope of this document. You can use `pg_dumpall` or other tools of your choice.
@@ -84,15 +82,13 @@ Depending on your business requirements, you may migrate to Percona Distribution
8482
$ sudo systemctl start postgresql-{{pgversion}}
8583
```
8684

87-
8885
## Migrate on a different server
8986

9087
In this scenario, we will refer to the server with PostgreSQL Community as the "source" and to the server with Percona Distribution for PostgreSQL as the "target".
9188

9289
To migrate from PostgreSQL Community to Percona Distribution for PostgreSQL on a different server, do the following:
9390

94-
**On the source server**:
95-
{.power-number}
91+
### **On the source server** {.power-number}
9692

9793
1. Back up your data and all configuration files (such as `pg_hba.conf`, `postgresql.conf`, `postgresql.auto.conf`) using the tool of your choice.
9894
2. Stop the `postgresql` service
@@ -109,12 +105,11 @@ To migrate from PostgreSQL Community to Percona Distribution for PostgreSQL on a
109105
$ sudo systemctl stop postgresql-{{pgversion}}
110106
```
111107

112-
3. Optionally, remove PostgreSQL Community packages
108+
3. Optionally, remove PostgreSQL Community packages
113109

114-
**On the target server**:
115-
{.power-number}
110+
### **On the target server** {.power-number}
116111

117-
1. [Install percona-release :octicons-link-external-16:](https://docs.percona.com/percona-software-repositories/installing.html)
112+
1. [Install percona-release :octicons-link-external-16:](https://docs.percona.com/percona-software-repositories/installing.html)
118113
2. Enable the repository
119114

120115
```{.bash data-prompt="$"}
@@ -135,4 +130,4 @@ To migrate from PostgreSQL Community to Percona Distribution for PostgreSQL on a
135130

136131
```{.bash data-prompt="$"}
137132
$ sudo systemctl start postgresql-{{pgversion}}
138-
```
133+
```

docs/postgresql-server.md

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,18 @@
11
# Percona Server for PostgreSQL
22

3-
Percona Server for PostgreSQL is a binary-compatible, open source drop-in replacement for PostgreSQL 17. It introduces additional features to the upstream server, including:
3+
Percona Server for PostgreSQL is a binary-compatible, open source drop-in replacement for PostgreSQL 17. It introduces additional features on top of the upstream server, including:
44

5-
* Storage Manager (SMGR) API Exposure: Allows PostgreSQL extensions to integrate custom storage managers. This change was inspired by the [patchset](https://www.postgresql.org/message-id/flat/CAJ7c6TOqqrzjYsU6LgDkcJ0yVgzdkx2juJjgAjzP2jPOpZ1qUA%40mail.gmail.com#8e68cfc57fcac14c8e24b00b41e61baf) introduced to the community.
6-
* WAL Read/Write API Exposure to hook into WAL read and write functions.
5+
* Storage Manager (SMGR) API Exposure: Allows PostgreSQL extensions to integrate custom storage managers. This change was inspired by the [patchset :octicons-link-external-16:](https://www.postgresql.org/message-id/flat/CAJ7c6TOqqrzjYsU6LgDkcJ0yVgzdkx2juJjgAjzP2jPOpZ1qUA%40mail.gmail.com#8e68cfc57fcac14c8e24b00b41e61baf) introduced to the community.
6+
* WAL Read/Write API Exposure: Allows extensions to hook into WAL read and write functions.
77

8-
These modifications have no impact on existing use cases and operation of PostgreSQL. They are required to enable additional encryption capabilities such as index-level and Write-Ahead Logging (WAL) encryption of indexes through the [`pg_tde` :octicons-link-external-16:](https://docs.percona.com/pg-tde/index.html) extension. These encryption features provided by the `pg_tde` are still under active development and are planned for future releases.
8+
These changes do not affect existing use cases and PostgreSQL behavior. They enable additional encryption features, such as index-level and Write-Ahead Logging (WAL) encryption, through the [`pg_tde` :octicons-link-external-16:](https://docs.percona.com/pg-tde/index.html) extension.
99

10-
Percona Server and upstream PostgreSQL function identically enabling you to migrate from one to another.
10+
Percona Server and the upstream PostgreSQL operate identically, making migrations between the two straightforward.
1111

12-
[Get started :material-arrow-right:](installing.md){.md-button}
12+
[Get started :material-arrow-right:](installing.md){.md-button}
13+
14+
!!! note
15+
16+
The PostgreSQL Compatibility Index [(PCI)](https://pgscorecard.com/) test suite reported **100% compatibility**. PCI validates behavioral equivalence by running a suite of compatibility checks against upstream PostgreSQL.
17+
18+
These results were obtained using [Percona Server for PostgreSQL 17.6.1 :octicons-link-external-16:](https://docs.percona.com/postgresql/17/index.html). [View the PCI test results here :octicons-link-external-16:](https://github.com/secp256k1-sha256/postgres-compatibility-index/blob/main/postgres-compatibility-index/outputs/Percona.json).

docs/solutions/tde-tools-compatibility.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -153,6 +153,4 @@ operate at the SQL and memory level.
153153
- TDE does not change their functionality.
154154
- No additional configuration is required.
155155

156-
## See also
157-
158-
- [Percona `pg_tde` documentation](https://docs.percona.com/postgresql/pg_tde)
156+
For more information see the [`pg_tde` documentation](https://docs.percona.com/pg-tde/index.html).

0 commit comments

Comments
 (0)