You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/migration.md
+10-15Lines changed: 10 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff 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
3
2
4
3
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.
5
4
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.
7
6
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).
9
8
10
9
## Migrate on the same server
11
10
12
-
=== ":material-debian: :material-debian: On Debian and Ubuntu Linux"
11
+
=== ":material-debian: On Debian and Ubuntu Linux"
13
12
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_.
15
14
16
15
Run **all** commands as root or via **sudo**:
17
16
{.power-number}
@@ -49,7 +48,6 @@ Depending on your business requirements, you may migrate to Percona Distribution
49
48
$ sudo systemctl start postgresql.service
50
49
```
51
50
52
-
53
51
=== ":material-redhat: On RHEL and derivatives"
54
52
55
53
> 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
84
82
$ sudo systemctl start postgresql-{{pgversion}}
85
83
```
86
84
87
-
88
85
## Migrate on a different server
89
86
90
87
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".
91
88
92
89
To migrate from PostgreSQL Community to Percona Distribution for PostgreSQL on a different server, do the following:
93
90
94
-
**On the source server**:
95
-
{.power-number}
91
+
### **On the source server** {.power-number}
96
92
97
93
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.
98
94
2. Stop the `postgresql` service
@@ -109,12 +105,11 @@ To migrate from PostgreSQL Community to Percona Distribution for PostgreSQL on a
109
105
$ sudo systemctl stop postgresql-{{pgversion}}
110
106
```
111
107
112
-
3. Optionally, remove PostgreSQL Community packages
108
+
3. Optionally, remove PostgreSQL Community packages
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:
4
4
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.
7
7
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.
9
9
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.
11
11
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).
0 commit comments