diff --git a/doc/xml/release.xml b/doc/xml/release.xml index 49717a546..2a4c20bb6 100644 --- a/doc/xml/release.xml +++ b/doc/xml/release.xml @@ -189,6 +189,15 @@

Update TeX Live to 2016 version.

+ + + + + + + +

Added documentation for asynchronous archiving to the user guide.

+
diff --git a/doc/xml/user-guide.xml b/doc/xml/user-guide.xml index 1e7b3c960..16cbe0746 100644 --- a/doc/xml/user-guide.xml +++ b/doc/xml/user-guide.xml @@ -26,6 +26,8 @@ /var/lib/postgresql/{[pg-version]}/{[postgres-cluster-demo]} /var/lib/pgsql/{[pg-version]}/data + /var/spool/pgbackrest + /etc/postgresql/{[pg-version]}/{[postgres-cluster-demo]}/postgresql.conf {[db-path]}/postgresql.conf @@ -398,21 +400,6 @@ {[db-cluster-wait]} - - - @@ -1352,6 +1339,46 @@ + + +
+ Asynchronous Archiving + +

The archive-async option offloads WAL archiving to a separate process to improve throughput. WAL segments are temporarily stored in a local queue on the database server, specified by the spool-path option, before being transferred to the repository on the backup server.

+ +

The spool directory is created to hold the WAL segments while they are waiting to be (optionally) compressed and transferred.

+ + + Create the spool directory + + + mkdir -m 750 {[spool-path]} + + + chown postgres:postgres {[spool-path]} + + + +

The spool path must be configured and asynchronous archiving enabled.

+ + + Configure the spool path and asynchronous archiving + + {[spool-path]} + y + + +

The check command ensures that asynchronous archiving is working.

+ + + Check asynchronous archiving + + + {[project-exe]} {[dash]}-stanza={[postgres-cluster-demo]} {[dash]}-log-level-console=info check + WAL segment + + +
@@ -1789,18 +1816,4 @@ - -