Missing important information in backup.sgml

From: "Gunnar \"Nick\" Bluth" <gunnar(dot)bluth(dot)extern(at)elster(dot)de>
To: pgsql-docs(at)postgresql(dot)org
Cc: Gunnar Nick Bluth <gunnar(dot)bluth(at)pro-open(dot)de>
Subject: Missing important information in backup.sgml
Date: 2016-11-16 10:37:12
Message-ID: cb648ec1-5212-60c5-b73a-9572d21b2ae9@elster.de
Views: Raw Message | Whole Thread | Download mbox
Thread:
Lists: pgsql-docs

Hi,

I ran into this issue (see patch) a few times over the past years, and
tend to forget it again (sigh!). Today I had to clean up a few hundred
GB of unarchived WALs, so I decided to write a patch for the
documentation this time.

diff --git a/doc/src/sgml/backup.sgml b/doc/src/sgml/backup.sgml
index 6eaed1e..460a4f2 100644
--- a/doc/src/sgml/backup.sgml
+++ b/doc/src/sgml/backup.sgml
@@ -636,7 +636,13 @@ test ! -f
/mnt/server/archivedir/00000001000000A900000065 &amp;&amp; cp pg_wal/0
<productname>PostgreSQL</> will assume that the file has been
successfully archived, and will remove or recycle it. However, a
nonzero
status tells <productname>PostgreSQL</> that the file was not archived;
- it will try again periodically until it succeeds.
+ it will try again periodically until it succeeds. Note that an exit
+ status of 128 or higher will cause the archiver to exit and
<emphasis>not
+ </> try to archive the affected WAL segment anymore. E.g.,
<command>rsync</>
+ tends to return an exit status of 255 when it is unable to resolve a
+ hostname, which - when returned unfiltered - will result in permanent
+ failure to archive the segment, even if the resolving problem is only
+ temporarily.
</para>

<para>

Best regards,
--
Gunnar "Nick" Bluth
DBA ELSTER

Tel: +49 911/991-4665
Mobil: +49 172/8853339

Attachment Content-Type Size
archiving-doc-exit-status-v1.patch text/x-patch 1.0 KB

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Alexander Law 2016-11-16 11:30:32 Re: Docbook 5.x
Previous Message Peter Eisentraut 2016-11-13 02:49:40 Re: SET AUTOCOMMIT TO OFF is no longer supported