barman-wal-archive man page

barman-wal-archive — archive_command based on Barman’s put-wal

Synopsis

barman-wal-archive [Options] BARMAN_HOST SERVER_NAME WAL_PATH

Description

This script can be used in the archive_command of a PostgreSQL server to ship WAL files to a Barman host using the `put-wal' command (introduced in Barman 2.6). An SSH connection will be opened to the Barman host. barman-wal-archive allows the integration of Barman in PostgreSQL clusters for better business continuity results.

This script and Barman are administration tools for disaster recovery of PostgreSQL servers written in Python and maintained by 2ndQuadrant.

Positional Arguments

BARMAN_HOST

the host of the Barman server.

SERVER_NAME

the server name configured in Barman from which WALs are taken.

WAL_PATH

the value of the `%p' keyword (according to `archive_command').

Options

-h, –help

show a help message and exit

-V, –version

show program’s version number and exit

-U USER, –user USER

the user used for the ssh connection to the Barman server. Defaults to `barman'.

-c CONFIG, –config CONFIG

configuration file on the Barman server

-t, –test

test both the connection and the configuration of the requested PostgreSQL server in Barman for WAL retrieval. With this option, the `WAL_PATH' mandatory argument is ignored.

Exit Status

0

Success

Not zero

Failure

See Also

barman (1), barman (5).

Bugs

Barman has been extensively tested, and is currently being used in several production environments. However, we cannot exclude the presence of bugs.

Any bug can be reported via the Github issue tracker.

Resources

Copying

Barman is the property of 2ndQuadrant Limited and its code is distributed under GNU General Public License v3.

Copyright (C) 2011-2019 2ndQuadrant Ltd - <http://www.2ndQuadrant.com/>.

Authors

2ndQuadrant <http://www.2ndQuadrant.com>.

Info

August 1, 2019 Barman User manuals Version 2.9