barman-wal-archive1
Barman-cli commands
Usage
barman-wal-archive
[ { -h | --help } ]
[ { -V | --version } ]
[ { -U | --user } USER ]
[ --port PORT ]
[ { -c | --config } CONFIG ]
[ { -t | --test } ]
[ --md5 ]
BARMAN_HOST SERVER_NAME WAL_PATH
Overview
This script can be utilized in the archive_command of a Postgres server to transfer WAL files to a Barman host using the put-wal command (introduced in Barman 2.6). It establishes an SSH connection to the Barman host, enabling seamless integration of Barman within Postgres clusters for improved business continuity.
Exit Statuses are:
•
|
|
|---|---|
•
|
|
Parameters
SERVER_NAME-
The server name configured in Barman for the Postgres server from which the WAL file is retrieved.
BARMAN_HOST-
The host of the Barman server.
WAL_PATH-
The value of the '%p' keyword (according to
archive_command).
- -h / --help
-
Display a help message and exit.
- -V / --version
-
Display the program's version number and exit.
- -U / --user
-
Specify the user for the SSH connection to the Barman server (defaults to
barman).
--port-
Define the port used for the SSH connection to the Barman server.
- -c / --config
-
Specify the configuration file on the Barman server.
- -t / --test
-
Test the connection and configuration of the specified Postgres server in Barman to ensure it is ready to receive WAL files. This option ignores the mandatory argument
WAL_PATH.
--md5-
Use MD5 instead of SHA256 as the hash algorithm to calculate the checksum of the WAL file when transmitting it to the Barman server. This is used to maintain compatibility with older server versions, as older versions of Barman server used to support only MD5.
Releases
4 releases since Debian 10 (Buster); the text changed 3 times.
--config until Debian 12 (Bookworm);
--help until Debian 12 (Bookworm);
--port until Debian 12 (Bookworm);
--test until Debian 12 (Bookworm);
--user until Debian 12 (Bookworm);
--version until Debian 12 (Bookworm);
-U until Debian 12 (Bookworm);
-V until Debian 12 (Bookworm);
-c until Debian 12 (Bookworm);
-h until Debian 12 (Bookworm);
-t until Debian 12 (Bookworm).