Skip to content

Commit 8964f2a

Browse files
committed
Merge branch 'master' into pgpro-2065
2 parents b99097a + f0de44e commit 8964f2a

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

71 files changed

+10871
-4434
lines changed

Makefile

+1-1
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ endif
4747

4848
PG_CPPFLAGS = -I$(libpq_srcdir) ${PTHREAD_CFLAGS} -Isrc -I$(top_srcdir)/$(subdir)/src
4949
override CPPFLAGS := -DFRONTEND $(CPPFLAGS) $(PG_CPPFLAGS)
50-
PG_LIBS = $(libpq_pgport) ${PTHREAD_CFLAGS}
50+
PG_LIBS_INTERNAL = $(libpq_pgport) ${PTHREAD_CFLAGS}
5151

5252
all: checksrcdir $(INCLUDES);
5353

README.md

+20-4
Original file line numberDiff line numberDiff line change
@@ -10,11 +10,13 @@ As compared to other backup solutions, `pg_probackup` offers the following benef
1010
* Implementing a single backup strategy for multi-server PostgreSQL clusters
1111
* Automatic data consistency checks and on-demand backup validation without actual data recovery
1212
* Managing backups in accordance with retention policy
13-
* Running backup, restore, and validation processes on multiple parallel threads
13+
* Merging incremental into full backups without actual data recovery
14+
* Running backup, restore, merge and validation processes on multiple parallel threads
1415
* Storing backup data in a compressed state to save disk space
1516
* Taking backups from a standby server to avoid extra load on the master server
1617
* Extended logging settings
1718
* Custom commands to simplify WAL log archiving
19+
* External to PGDATA directories, such as directories with config files and scripts, can be included in backup
1820

1921
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.
2022

@@ -39,8 +41,7 @@ Regardless of the chosen backup type, all backups taken with `pg_probackup` supp
3941
`pg_probackup` currently has the following limitations:
4042
* Creating backups from a remote server is currently not supported.
4143
* 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.
42-
* Microsoft Windows operating system is not supported.
43-
* Configuration files outside of PostgreSQL data directory are not included into the backup and should be backed up separately.
44+
* Microsoft Windows operating system support is in beta stage.
4445

4546
## Installation and Setup
4647
### Linux Installation
@@ -71,13 +72,28 @@ yum install pg_probackup-{11,10,9.6,9.5}
7172
yumdownloader --source pg_probackup-{11,10,9.6,9.5}
7273
```
7374

75+
Once you have `pg_probackup` installed, complete [the setup](https://postgrespro.com/docs/postgrespro/current/app-pgprobackup.html#pg-probackup-install-and-setup).
76+
77+
## Building from source
78+
### Linux
79+
7480
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:
7581

7682
```shell
7783
make USE_PGXS=1 PG_CONFIG=<path_to_pg_config> top_srcdir=<path_to_PostgreSQL_source_tree>
7884
```
85+
### Windows
7986

80-
Once you have `pg_probackup` installed, complete [the setup](https://postgrespro.com/docs/postgrespro/current/app-pgprobackup.html#pg-probackup-install-and-setup).
87+
Currently pg_probackup can be build using only MSVC 2013.
88+
Build PostgreSQL using [pgwininstall](https://github.com/postgrespro/pgwininstall) or [PostgreSQL instruction](https://www.postgresql.org/docs/10/install-windows-full.html) with MSVC 2013.
89+
If zlib support is needed, src/tools/msvc/config.pl must contain path to directory with compiled zlib. [Example](https://gist.githubusercontent.com/gsmol/80989f976ce9584824ae3b1bfb00bd87/raw/240032950d4ac4801a79625dd00c8f5d4ed1180c/gistfile1.txt)
90+
91+
```shell
92+
CALL "C:\Program Files (x86)\Microsoft Visual Studio 12.0\VC\vcvarsall" amd64
93+
SET PATH=%PATH%;C:\Perl64\bin
94+
SET PATH=%PATH%;C:\msys64\usr\bin
95+
gen_probackup_project.pl C:\path_to_postgresql_source_tree
96+
```
8197

8298
## Documentation
8399

0 commit comments

Comments
 (0)