mirror of
https://github.com/EnterpriseDB/repmgr.git
synced 2026-03-27 17:06:29 +00:00
Update barman-wal-restore documentation
Barman 2.0 provides this in a separate, more convenient `barman-cli` package; document this and add note about previous `barman-wal-restore.py` script.
This commit is contained in:
30
README.md
30
README.md
@@ -599,8 +599,8 @@ ensure that:
|
|||||||
- the `barman_server` setting in `repmgr.conf` is set to the SSH
|
- the `barman_server` setting in `repmgr.conf` is set to the SSH
|
||||||
hostname of the Barman server;
|
hostname of the Barman server;
|
||||||
- the `restore_command` setting in `repmgr.conf` is configured to
|
- the `restore_command` setting in `repmgr.conf` is configured to
|
||||||
use a copy of the `barman-wal-restore.py` script shipped with Barman
|
use a copy of the `barman-wal-restore` script shipped with the
|
||||||
(see below);
|
`barman-cli package` (see below);
|
||||||
- the Barman catalogue includes at least one valid backup for this
|
- the Barman catalogue includes at least one valid backup for this
|
||||||
server.
|
server.
|
||||||
|
|
||||||
@@ -616,26 +616,24 @@ ensure that:
|
|||||||
> corresponding to the value of `barman_server` in `repmgr.conf`. See
|
> corresponding to the value of `barman_server` in `repmgr.conf`. See
|
||||||
> the "Host" section in `man 5 ssh_config` for more details.
|
> the "Host" section in `man 5 ssh_config` for more details.
|
||||||
|
|
||||||
`barman-wal-restore.py` is a Python script provided by the Barman
|
`barman-wal-restore` is a Python script provided by the Barman
|
||||||
development team, which must be copied in a location accessible to
|
development team as part of the `barman-cli` package (Barman 2.0
|
||||||
`repmgr`, and marked as executable; `restore_command` must then be
|
and later; for Barman 1.x the script is provided separately as
|
||||||
set in `repmgr.conf` as follows:
|
`barman-wal-restore.py`).
|
||||||
|
|
||||||
|
`restore_command` must then be set in `repmgr.conf` as follows:
|
||||||
|
|
||||||
<script> <Barman hostname> <cluster_name> %f %p
|
<script> <Barman hostname> <cluster_name> %f %p
|
||||||
|
|
||||||
For instance, suppose that we have installed Barman on the `barmansrv`
|
For instance, suppose that we have installed Barman on the `barmansrv`
|
||||||
host, and that we have placed a copy of `barman-wal-restore.py` into
|
host, and that `barman-wal-restore` is located as an executable at
|
||||||
the `/usr/local/bin` directory. First, we ensure that the script is
|
`/usr/bin/barman-wal-restore`; `repmgr.conf` should include the following
|
||||||
executable:
|
lines:
|
||||||
|
|
||||||
sudo chmod +x /usr/local/bin/barman-wal-restore.py
|
|
||||||
|
|
||||||
Then we check that `repmgr.conf` includes the following lines:
|
|
||||||
|
|
||||||
barman_server=barmansrv
|
barman_server=barmansrv
|
||||||
restore_command=/usr/local/bin/barman-wal-restore.py barmansrv test %f %p
|
restore_command=/usr/bin/barman-wal-restore barmansrv test %f %p
|
||||||
|
|
||||||
To use a non-default Barman configuration file on the Barman server,
|
NOTE: to use a non-default Barman configuration file on the Barman server,
|
||||||
specify this in `repmgr.conf` with `barman_config`:
|
specify this in `repmgr.conf` with `barman_config`:
|
||||||
|
|
||||||
barman_config=/path/to/barman.conf
|
barman_config=/path/to/barman.conf
|
||||||
@@ -688,7 +686,7 @@ and destination server as the contents of files existing on both servers need
|
|||||||
to be compared, meaning this method is not necessarily faster than making a
|
to be compared, meaning this method is not necessarily faster than making a
|
||||||
fresh clone with `pg_basebackup`.
|
fresh clone with `pg_basebackup`.
|
||||||
|
|
||||||
> *NOTE*: `barman-wal-restore.py` supports command line switches to
|
> *NOTE*: `barman-wal-restore` supports command line switches to
|
||||||
> control parallelism (`--parallel=N`) and compression (`--bzip2`,
|
> control parallelism (`--parallel=N`) and compression (`--bzip2`,
|
||||||
> `--gzip`).
|
> `--gzip`).
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user