@@ -29,7 +29,7 @@ It proposes the following features:
29
29
command
30
30
- Recovery from backup with just one command, with customized targets
31
31
to facilitate the use of PITR.
32
- - Support for full and differential backup
32
+ - Support for full and differential backup + ptrack differential backup
33
33
- Management of backups with integrated catalog
34
34
35
35
##COMMANDS
@@ -79,9 +79,11 @@ LSN position of pg_start_backup is done and all the blocks touched are
79
79
recorded and tracked as part of the backup. As the WAL segments scanned
80
80
need to be located in the WAL archive, the last segment after pg_start_backup
81
81
has 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".
82
84
83
85
It is recommended to verify backup files as soon as possible after backup.
84
- Unverified backup cannot be used in restore and in differentialbackup .
86
+ Unverified backup cannot be used in restore and in differentialbackups .
85
87
86
88
###RESTORE
87
89
@@ -147,7 +149,7 @@ Start Mode Current TLI Parent TLI Time Data Backup Stat
147
149
The fields are:
148
150
149
151
* 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)
151
153
* Current TLI: current timeline of backup
152
154
* Parent TLI: parent timeline of backup
153
155
* Time: total time necessary to take this backup
@@ -238,6 +240,12 @@ absolute paths; relative paths are not allowed.
238
240
--keep-data-days means days to be kept.
239
241
Only files exceeded one of those settings are deleted.
240
242
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
+
241
249
###RESTORE OPTIONS
242
250
243
251
The 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.
258
266
** --recovery-target-inclusive** :
259
267
Specifies whether server pauses when recovery target is reached.
260
268
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
+
261
277
###CATALOG OPTIONS
262
278
263
279
** -a** /** --show-all** :
@@ -341,7 +357,7 @@ line and configuration file for security reason.
341
357
This utility, like most other PostgreSQL utilities, also uses the
342
358
environment variables supported by libpq (see Environment Variables).
343
359
344
- ##RESTRICTIONS ##
360
+ ##RESTRICTIONS
345
361
346
362
pg_arman has the following restrictions.
347
363
@@ -354,7 +370,7 @@ pg_arman has the following restrictions.
354
370
WAL directory or archived WAL directory, the backup or restore will fail
355
371
depending on the backup mode selected.
356
372
357
- ##DETAILS ##
373
+ ##DETAILS
358
374
359
375
###RECOVERY TO POINT-IN-TIME
360
376
pg_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
368
384
"#" and are automatically ignored. Whitespaces and tabs are ignored
369
385
excluding values.
370
386
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.
375
394
376
395
###EXIT CODE
377
396
pg_arman returns exit codes for each error status.
@@ -387,5 +406,7 @@ Code Name Description
387
406
##AUTHOR ##
388
407
pg_arman is a fork of pg_arman that was originally written by NTT, now
389
408
developed 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.
390
411
391
- Please report bug reports at< https://github.com/michaelpq /pg_arman > .
412
+ Please report bug reports at< https://github.com/stalkerg /pg_arman > .