@@ -48,7 +48,7 @@ details.
48
48
49
49
*show*::
50
50
Show backup history. The timeline option shows timeline of the backup
51
- and the parent's timeline for each backup.
51
+ and the parent's timeline for each backup.
52
52
53
53
*validate*::
54
54
Validate backup files.
@@ -71,12 +71,12 @@ specify it in PGDATA environmental variable or -D/--pgdata option.
71
71
72
72
Backup target can be one of the following types:
73
73
74
- - Full backup, backup a whole database cluster.
74
+ - Full backup, backup a whole database cluster.
75
75
- Incremental backup, backup only files or pages modified after the last
76
- verified backup.
76
+ verified backup.
77
77
78
78
It is recommended to verify backup files as soon as possible after backup.
79
- Unverified backup cannot be used in restore and in incremental backup.
79
+ Unverified backup cannot be used in restore and in incremental backup.
80
80
81
81
=== RESTORE ===
82
82
@@ -93,7 +93,7 @@ has succeeded.
93
93
If "--recovery-target-timeline" is not specifed, the last checkpoint's
94
94
TimeLineID in control file ($PGDATA/global/pg_control) will be the restore
95
95
target. If pg_control is not present, TimeLineID in the full backup used by
96
- the restore will be a restore target.
96
+ the restore will be a restore target.
97
97
98
98
99
99
== EXAMPLES ==
@@ -130,12 +130,12 @@ Here are some commands to restore from a backup:
130
130
=== SHOW A BACKUP ===
131
131
132
132
$ pg_arman show
133
- ==================================================================================================
134
- Start Mode Current TLI Parent TLI Time Data WAL Log Backup Status
135
- ==================================================================================================
136
- 2013-12-25 03:02:31 INCR 1 0 0m 203kB67MB ---- 67MB DONE
137
- 2013-12-25 03:02:31 INCR 1 0 0m 0B---- ---- 0B ERROR
138
- 2013-12-25 03:02:25 FULL 1 0 0m 33MB33MB ---- 64MB OK
133
+ ===================================================================================
134
+ Start Mode Current TLI Parent TLI Time Data Backup Status
135
+ ===================================================================================
136
+ 2013-12-25 03:02:31 INCR 1 0 0m 203kB 67MB DONE
137
+ 2013-12-25 03:02:31 INCR 1 0 0m 0B 0B ERROR
138
+ 2013-12-25 03:02:25 FULL 1 0 0m 33MB364MB OK
139
139
140
140
The fields are:
141
141
@@ -205,7 +205,7 @@ absolute paths; relative paths are not allowed.
205
205
*-c* / *--check*::
206
206
If specifed, pg_arman doesn't perform actual jobs but only checks
207
207
parameters and required resources. The option is typically used with
208
- --verbose option to verify the operation.
208
+ --verbose option to verify the operation.
209
209
210
210
*-v* / *--verbose*::
211
211
If specified, pg_arman works in verbose mode.
@@ -215,15 +215,15 @@ absolute paths; relative paths are not allowed.
215
215
*-b* _BACKUPMODE_ / *--backup-mode*=_BACKUPMODE_::
216
216
Specify backup target files. Available options are: "full",
217
217
"incremental". Abbreviated forms (prefix match) are also available.
218
- For example, -b f means "full" backup.
218
+ For example, -b f means "full" backup.
219
219
220
220
*-Z* / *--compress-data*::
221
- Compress backup files with zlib if specified.
221
+ Compress backup files with zlib if specified.
222
222
223
223
*-C* / *--smooth-checkpoint*::
224
224
Checkpoint is performed on every backups. If the option is specified,
225
225
do smooth checkpoint then. See also the second argument for
226
- pg_start_backup().
226
+ pg_start_backup().
227
227
228
228
*--validate*::
229
229
Validate a backup just after taking it. Other backups taken
@@ -241,16 +241,16 @@ The parameters whose name start are started with --recovery refer to
241
241
the same parameters as the ones in recovery.confin recovery.conf.
242
242
243
243
*--recovery-target-timeline*=_TIMELINE_::
244
- Specifies recovering into a particular timeline.
245
- If not specified, the current timeline is used.
244
+ Specifies recovering into a particular timeline.If not specified,
245
+ the current timeline is used.
246
246
247
247
*--recovery-target-time*=_TIMESTAMP_::
248
248
This parameter specifies the timestamp up to which recovery will
249
249
proceed.
250
250
251
251
*--recovery-target-xid*=_XID::
252
252
This parameter specifies the transaction ID up to which recovery
253
- will proceed.
253
+ will proceed.
254
254
255
255
*--recovery-target-inclusive*::
256
256
Specifies whether server pauses when recovery target is reached.
@@ -276,22 +276,22 @@ Parameters to connect PostgreSQL server.
276
276
which the server is listening for connections.
277
277
278
278
*-U* _USERNAME_ / *--username*=_USERNAME_::
279
- User name to connect as.
279
+ User name to connect as.
280
280
281
281
*-w* / *--no-password*::
282
282
Never issue a password prompt. If the server requires password
283
283
authentication and a password is not available by other means such as
284
284
a .pgpass file, the connection attempt will fail. This option can be
285
285
useful in batch jobs and scripts where no user is present to enter a
286
- password.
286
+ password.
287
287
288
288
*-W* / *--password*::
289
289
Force pg_arman to prompt for a password before connecting to a database.
290
290
This option is never essential, since pg_arman will automatically
291
291
prompt for a password if the server demands password authentication.
292
292
However, pg_arman will waste a connection attempt in order to find out
293
293
if the server wants a password. In some cases it is worth typing -W
294
- to avoid the extra connection attempt.
294
+ to avoid the extra connection attempt.
295
295
296
296
=== GLOBAL OPTIONS ===
297
297
@@ -326,19 +326,17 @@ variables or in configuration file as follows:
326
326
--validate VALIDATEYes
327
327
--keep-data-generationsKEEP_DATA_GENERATIONSYes
328
328
--keep-data-daysKEEP_DATA_DAYSYes
329
- --keep-arclog-filesKEEP_ARCLOG_FILESYes
330
- --keep-arclog-daysKEEP_ARCLOG_DAYSYes
331
329
--recovery-target-timeline RECOVERY_TARGET_TIMELINE Yes
332
330
--recovery-target-xidRECOVERY_TARGET_XIDYes
333
331
--recovery-target-timeRECOVERY_TARGET_TIMEYes
334
332
--recovery-target-inclusive RECOVERY_TARGET_INCLUSIVE Yes
335
333
336
334
Variable names in configuration file are the same as long names or names
337
335
of environment variables. The password can not be specified in command
338
- line and configuration file for security reason.
336
+ line and configuration file for security reason.
339
337
340
338
This utility, like most other PostgreSQL utilities, also uses the
341
- environment variables supported by libpq (see Environment Variables)
339
+ environment variables supported by libpq (see Environment Variables).
342
340
343
341
== RESTRICTIONS ==
344
342
@@ -394,7 +392,7 @@ pg_arman returns exit codes for each error status.
394
392
26ERROR_PID_BROKENpostmaster.pid is broken
395
393
396
394
== AUTHOR ==
397
- pg_arman is a fork of pg_rman that was originally written by NTT, now
398
- maintained by Michael Paquier.
395
+ pg_arman is a fork of pg_rman that was originally written by NTT, now developed
396
+ and maintained by Michael Paquier.
399
397
400
398
Please report bug reports at <https://github.com/michaelpq/pg_arman>.