mirrors/postgres
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Be more prescriptive in new doc about re-archiving of same WAL file.

Browse Source 
Nathan Bossart, reviewed by David Steele.

Discussion: https://postgr.es/m/20220731065156.GA3694276@rfd.leadboat.com
This commit is contained in:
Noah Misch 2022-08-05 08:30:55 -07:00
parent 90a4b64134
commit d263ced225
1 changed files with 8 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
doc/src/sgml/backup.sgml
View File

@ -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>