diff options
| author | Noah Misch | 2022-08-05 15:30:55 +0000 |
|---|---|---|
| committer | Noah Misch | 2022-08-05 15:30:55 +0000 |
| commit | d263ced225bffe2c340175125b0270d1869138fe (patch) | |
| tree | e9fa3486eb79cc3f40b68eb6d9838e09cbc7941e | |
| parent | 90a4b64134ce0cb9a31cdceb49e265e8e2f88b56 (diff) | |
Be more prescriptive in new doc about re-archiving of same WAL file.
Nathan Bossart, reviewed by David Steele.
Discussion: https://postgr.es/m/[email protected]
| -rw-r--r-- | doc/src/sgml/backup.sgml | 18 |
1 files changed, 8 insertions, 10 deletions
diff --git a/doc/src/sgml/backup.sgml b/doc/src/sgml/backup.sgml index e432bb015a..cd83646407 100644 --- a/doc/src/sgml/backup.sgml +++ b/doc/src/sgml/backup.sgml @@ -688,16 +688,14 @@ test ! -f /mnt/server/archivedir/00000001000000A900000065 && cp pg_wal/0 <para> In rare cases, <productname>PostgreSQL</productname> may attempt to re-archive a WAL file that was previously archived. For example, if the - system crashes before the server makes a durable record of archival success, - the server will attempt to archive the file again after restarting (provided - archiving is still enabled). When an archive library encounters a - pre-existing file, it may return <literal>true</literal> if the WAL file has - identical contents to the pre-existing archive and the pre-existing archive - is fully persisted to storage. Alternatively, the archive library may - return <literal>false</literal> anytime a pre-existing file is encountered, - but this will require manual action by an administrator to resolve. If a - pre-existing file contains different contents than the WAL file being - archived, the archive library <emphasis>must</emphasis> return + system crashes before the server makes a durable record of archival + success, the server will attempt to archive the file again after + restarting (provided archiving is still enabled). When an archive library + encounters a pre-existing file, it should return <literal>true</literal> + if the WAL file has identical contents to the pre-existing archive and the + pre-existing archive is fully persisted to storage. If a pre-existing + file contains different contents than the WAL file being archived, the + archive library <emphasis>must</emphasis> return <literal>false</literal>. </para> |