Skip to content

Commit d263ced

Browse files
committed
Be more prescriptive in new doc about re-archiving of same WAL file.
Nathan Bossart, reviewed by David Steele. Discussion: https://postgr.es/m/20220731065156.GA3694276@rfd.leadboat.com
1 parent 90a4b64 commit d263ced

File tree

1 file changed

+8
-10
lines changed

1 file changed

+8
-10
lines changed

doc/src/sgml/backup.sgml

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -688,16 +688,14 @@ test ! -f /mnt/server/archivedir/00000001000000A900000065 && cp pg_wal/0
688688
<para>
689689
In rare cases, <productname>PostgreSQL</productname> may attempt to
690690
re-archive a WAL file that was previously archived. For example, if the
691-
system crashes before the server makes a durable record of archival success,
692-
the server will attempt to archive the file again after restarting (provided
693-
archiving is still enabled). When an archive library encounters a
694-
pre-existing file, it may return <literal>true</literal> if the WAL file has
695-
identical contents to the pre-existing archive and the pre-existing archive
696-
is fully persisted to storage. Alternatively, the archive library may
697-
return <literal>false</literal> anytime a pre-existing file is encountered,
698-
but this will require manual action by an administrator to resolve. If a
699-
pre-existing file contains different contents than the WAL file being
700-
archived, the archive library <emphasis>must</emphasis> return
691+
system crashes before the server makes a durable record of archival
692+
success, the server will attempt to archive the file again after
693+
restarting (provided archiving is still enabled). When an archive library
694+
encounters a pre-existing file, it should return <literal>true</literal>
695+
if the WAL file has identical contents to the pre-existing archive and the
696+
pre-existing archive is fully persisted to storage. If a pre-existing
697+
file contains different contents than the WAL file being archived, the
698+
archive library <emphasis>must</emphasis> return
701699
<literal>false</literal>.
702700
</para>
703701

0 commit comments

Comments
 (0)
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy