aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPeter Eisentraut <peter_e@gmx.net>2014-11-07 20:15:22 -0500
committerPeter Eisentraut <peter_e@gmx.net>2014-11-07 20:15:22 -0500
commit552faefd68f1cec6bbaf0a038d8d410b59edb17f (patch)
treeb275b719b8047d6c1d806398ad4939ca4bee9021
parent0b03e5951bf0a1a8868db13f02049cf686a82165 (diff)
downloadpostgresql-552faefd68f1cec6bbaf0a038d8d410b59edb17f.tar.gz
postgresql-552faefd68f1cec6bbaf0a038d8d410b59edb17f.zip
doc: Update pg_receivexlog note
The old note about how to use pg_receivexlog as an alternative to archive_command was obsoleted by replication slots.
-rw-r--r--doc/src/sgml/ref/pg_receivexlog.sgml19
1 files changed, 8 insertions, 11 deletions
diff --git a/doc/src/sgml/ref/pg_receivexlog.sgml b/doc/src/sgml/ref/pg_receivexlog.sgml
index 2ab392e82c2..74ed45db97c 100644
--- a/doc/src/sgml/ref/pg_receivexlog.sgml
+++ b/doc/src/sgml/ref/pg_receivexlog.sgml
@@ -324,17 +324,14 @@ PostgreSQL documentation
<para>
When using <application>pg_receivexlog</application> instead of
- <xref linkend="guc-archive-command">, the server will continue to
- recycle transaction log files even if the backups are not properly
- archived, since there is no command that fails. This can be worked
- around by having an <xref linkend="guc-archive-command"> that fails
- when the file has not been properly archived yet, for example:
-<programlisting>
-archive_command = 'sleep 5 &amp;&amp; test -f /mnt/server/archivedir/%f'
-</programlisting>
- The initial timeout is necessary because
- <application>pg_receivexlog</application> works using asynchronous
- replication and can therefore be slightly behind the master.
+ <xref linkend="guc-archive-command"> as the main WAL backup method, it is
+ strongly recommended to use replication slots. Otherwise, the server is
+ free to recycle or remove transaction log files before they are backed up,
+ because it does not have any information, either
+ from <xref linkend="guc-archive-command"> or the replication slots, about
+ how far the WAL stream has been archived. Note, however, that a
+ replication slot will fill up the server's disk space if the receiver does
+ not keep up with fetching the WAL data.
</para>
</refsect1>