Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Commit5102ff5

Browse files
committed
Fix doc.
1 parent8f0de84 commit5102ff5

File tree

1 file changed

+31
-10
lines changed

1 file changed

+31
-10
lines changed

‎doc/pg_arman.md

Lines changed: 31 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -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
7979
recorded and tracked as part of the backup. As the WAL segments scanned
8080
need to be located in the WAL archive, the last segment after pg_start_backup
8181
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".
8284

8385
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.
8587

8688
###RESTORE
8789

@@ -147,7 +149,7 @@ Start Mode Current TLI Parent TLI Time Data Backup Stat
147149
The 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

243251
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.
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.
341357
This utility, like most other PostgreSQL utilities, also uses the
342358
environment variables supported by libpq (see Environment Variables).
343359

344-
##RESTRICTIONS ##
360+
##RESTRICTIONS
345361

346362
pg_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
360376
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
368384
"#" and are automatically ignored. Whitespaces and tabs are ignored
369385
excluding 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
377396
pg_arman returns exit codes for each error status.
@@ -387,5 +406,7 @@ Code Name Description
387406
##AUTHOR ##
388407
pg_arman is a fork of pg_arman that was originally written by NTT, now
389408
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.
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

Comments
 (0)

[8]ページ先頭

©2009-2025 Movatter.jp