@@ -29,7 +29,7 @@ It proposes the following features:
2929 command
3030- Recovery from backup with just one command, with customized targets
3131 to facilitate the use of PITR.
32- - Support for full and differential backup
32+ - Support for full and differential backup + ptrack differential backup
3333- Management of backups with integrated catalog
3434
3535## COMMANDS
@@ -79,9 +79,11 @@ LSN position of pg_start_backup is done and all the blocks touched are
7979recorded and tracked as part of the backup. As the WAL segments scanned
8080need to be located in the WAL archive, the last segment after pg_start_backup
8181has been run needs to be forcibly switched.
82+ - ptrack differential backup, use bitmap ptrack file for detect changed pages.
83+ For use it you need set ptrack_enable option to "on".
8284
8385It is recommended to verify backup files as soon as possible after backup.
84- Unverified backup cannot be used in restore and in differential backup .
86+ Unverified backup cannot be used in restore and in differential backups .
8587
8688### RESTORE
8789
@@ -147,7 +149,7 @@ Start Mode Current TLI Parent TLI Time Data Backup Stat
147149The fields are:
148150
149151* Start: start time of backup
150- * Mode: Mode of backup: FULL (full) or PAGE (page differential)
152+ * Mode: Mode of backup: FULL (full) or PAGE (page differential) or PTRACK (differential by ptrack)
151153* Current TLI: current timeline of backup
152154* Parent TLI: parent timeline of backup
153155* Time: total time necessary to take this backup
@@ -238,6 +240,12 @@ absolute paths; relative paths are not allowed.
238240 --keep-data-days means days to be kept.
239241 Only files exceeded one of those settings are deleted.
240242
243+ ** -j** =NUMBER / ** --threads** =NUMBER:
244+ Number of threads for backup.
245+
246+ ** --stream** :
247+ Enable stream replication for save WAL during backup process.
248+
241249### RESTORE OPTIONS
242250
243251The parameters whose name start are started with --recovery refer to
@@ -258,6 +266,14 @@ the same parameters as the ones in recovery.confin recovery.conf.
258266** --recovery-target-inclusive** :
259267 Specifies whether server pauses when recovery target is reached.
260268
269+ ** -j** =NUMBER / ** --threads** =NUMBER:
270+ Number of threads for restore.
271+
272+ ** --stream** :
273+ Restore without recovery.conf and use pg_xlog WALs. Before you need
274+ backup with ** --stream** option. This option will disable all ** --recovery-**
275+ options.
276+
261277### CATALOG OPTIONS
262278
263279** -a** / ** --show-all** :
@@ -341,7 +357,7 @@ line and configuration file for security reason.
341357This utility, like most other PostgreSQL utilities, also uses the
342358environment variables supported by libpq (see Environment Variables).
343359
344- ## RESTRICTIONS ##
360+ ## RESTRICTIONS
345361
346362pg_arman has the following restrictions.
347363
@@ -354,7 +370,7 @@ pg_arman has the following restrictions.
354370 WAL directory or archived WAL directory, the backup or restore will fail
355371 depending on the backup mode selected.
356372
357- ## DETAILS ##
373+ ## DETAILS
358374
359375### RECOVERY TO POINT-IN-TIME
360376pg_arman can recover to point-in-time if timeline, transaction ID, or
@@ -368,10 +384,13 @@ are required if the value contains whitespaces. Comments should start with
368384"#" and are automatically ignored. Whitespaces and tabs are ignored
369385excluding values.
370386
371- ### Restrictions
372- In order to work, the PostgreSQL instance on which backups are taken need
373- to have data checksums enabled or to enable wal_log_hints. pg_arman is
374- aimed at working with PostgreSQL 9.5 and newer versions.
387+ ### RESTRICTIONS
388+ * In order to work, the PostgreSQL instance on which backups are taken need
389+ to have data checksums enabled or to enable wal_log_hints.
390+ * pg_arman is aimed at working with PostgreSQL 9.5 and newer versions.
391+ * For ptrack feature you need special version of Postgres and set wal_level to
392+ archive or hot_standby and ptrack_enable.
393+ * For stream feature you need configure streaming replication in your postgres.
375394
376395### EXIT CODE
377396pg_arman returns exit codes for each error status.
@@ -387,5 +406,7 @@ Code Name Description
387406## AUTHOR ##
388407pg_arman is a fork of pg_arman that was originally written by NTT, now
389408developed and maintained by Michael Paquier.
409+ Threads, WAL diff, ptrack diff, stream WAL and some other features developed by
410+ Yury Zhuravlev aka stalkerg from PostgresPro.
390411
391- Please report bug reports at < https://github.com/michaelpq /pg_arman > .
412+ Please report bug reports at < https://github.com/stalkerg /pg_arman > .
0 commit comments