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
`pg_probackup` is a utility to manage backup and recovery of PostgreSQL database clusters. It is designed to perform periodic backups of the PostgreSQL instance that enable you to restore the server in case of a failure.
4
+
5
+
The extension is compatible with:
6
+
* PostgreSQL 9.5, 9.6, 10;
7
+
8
+
`PTRACK` backup requires:
9
+
* Postgres Pro Standard 9.5, 9.6;
10
+
or
11
+
* Postgres Pro Enterprise;
12
+
13
+
As compared to other backup solutions, `pg_probackup` offers the following benefits that can help you implement different backup strategies and deal with large amounts of data:
14
+
* Choosing between full and page-level incremental backups to speed up backup and recovery
15
+
* Implementing a single backup strategy for multi-server PostgreSQL clusters
16
+
* Automatic data consistency checks and on-demand backup validation without actual data recovery
17
+
* Managing backups in accordance with retention policy
18
+
* Running backup, restore, and validation processes on multiple parallel threads
19
+
* Storing backup data in a compressed state to save disk space
20
+
* Taking backups from a standby server to avoid extra load on the master server
21
+
* Extended logging settings
22
+
* Custom commands to simplify WAL log archiving
23
+
24
+
To manage backup data, `pg_probackup` creates a backup catalog. This directory stores all backup files with additional meta information, as well as WAL archives required for [point-in-time recovery](https://postgrespro.com/docs/postgresql/current/continuous-archiving.html). You can store backups for different instances in separate subdirectories of a single backup catalog.
25
+
26
+
Using `pg_probackup`, you can take full or incremental backups:
27
+
*`Full` backups contain all the data files required to restore the database cluster from scratch.
28
+
*`Incremental` backups only store the data that has changed since the previous backup. It allows to decrease the backup size and speed up backup operations. `pg_probackup` supports the following modes of incremental backups:
29
+
*`PAGE` backup. In this mode, `pg_probackup` scans all WAL files in the archive from the moment the previous full or incremental backup was taken. Newly created backups contain only the pages that were mentioned in WAL records. This requires all the WAL files since the previous backup to be present in the WAL archive. If the size of these files is comparable to the total size of the database cluster files, speedup is smaller, but the backup still takes less space.
30
+
*`PTRACK` backup. In this mode, PostgreSQL tracks page changes on the fly. Continuous archiving is not necessary for it to operate. Each time a relation page is updated, this page is marked in a special `PTRACK` bitmap for this relation. As one page requires just one bit in the `PTRACK` fork, such bitmaps are quite small. Tracking implies some minor overhead on the database server operation, but speeds up incremental backups significantly.
31
+
32
+
Regardless of the chosen backup type, all backups taken with `pg_probackup` support the following archiving strategies:
33
+
*`Autonomous backups` include all the files required to restore the cluster to a consistent state at the time the backup was taken. Even if continuous archiving is not set up, the required WAL segments are included into the backup.
34
+
*`Archive backups` rely on continuous archiving. Such backups enable cluster recovery to an arbitrary point after the backup was taken (point-in-time recovery).
35
+
36
+
## Limitations
37
+
38
+
`pg_probackup` currently has the following limitations:
39
+
* Creating backups from a remote server is currently not supported.
40
+
* The server from which the backup was taken and the restored server must be compatible by the [block_size](https://postgrespro.com/docs/postgresql/current/runtime-config-preset#guc-block-size) and [wal_block_size](https://postgrespro.com/docs/postgresql/current/runtime-config-preset#guc-wal-block-size) parameters and have the same major release number.
41
+
* Microsoft Windows operating system is not supported.
42
+
* Configuration files outside of PostgreSQL data directory are not included into the backup and should be backed up separately.
43
+
44
+
## Installation and Setup
45
+
46
+
To compile `pg_probackup`, you must have a PostgreSQL installation and raw source tree. To install `pg_probackup`, execute this in the module's directory:
47
+
48
+
```shell
49
+
make USE_PGXS=1 PG_CONFIG=<path_to_pg_config> top_srcdir=<path_to_PostgreSQL_source_tree>
50
+
```
51
+
52
+
Once you have `pg_probackup` installed, complete [the setup](https://postgrespro.com/docs/postgrespro/current/app-pgprobackup.html#pg-probackup-install-and-setup).
53
+
54
+
## Documentation
55
+
56
+
Currently the latest documentation can be found at [Postgres Pro Enterprise documentation](https://postgrespro.com/docs/postgrespro/current/app-pgprobackup).
57
+
58
+
## Licence
59
+
60
+
This module available under the same license as [PostgreSQL](https://www.postgresql.org/about/licence/).
61
+
62
+
## Feedback
63
+
64
+
Do not hesitate to post your issues, questions and new ideas at the [issues](https://github.com/postgrespro/pg_probackup/issues) page.
65
+
66
+
## Authors
67
+
68
+
Postgres Professional, Moscow, Russia.
69
+
70
+
## Credits
71
+
72
+
`pg_probackup` utility is based on `pg_arman`, that was originally written by NTT and then developed and maintained by Michael Paquier.
0 commit comments