Scroll to navigation

BARMAN-SWITCH-WAL(1) Barman BARMAN-SWITCH-WAL(1)

NAME

barman-switch-wal - Barman Sub-Commands

SYNOPSIS

switch-wal


    [ --archive ]


    [ --archive-timeout ]


    [ --force ]


    [ { -h | --help } ]


    SERVER_NAME [ SERVER_NAME ... ]


DESCRIPTION

Execute pg_switch_wal() on the target server (Postgres versions 10 and later) or pg_switch_xlog() (for Postgres versions 8.3 to 9.6).

PARAMETERS

Name of the server in barman node
Waits for one WAL file to be archived. If no WAL file is archived within a specified time (default: 30 seconds), Barman will terminate with a failure exit code. This option is also available on standby servers.
Specify the amount of time in seconds (default: 30 seconds) that the archiver will wait for a new WAL file to be archived before timing out. This option is also available on standby servers.
Forces the switch by executing a CHECKPOINT before pg_switch_wal().

NOTE:

Running a CHECKPOINT may increase I/O load on the Postgres server, so use this option cautiously.


Show a help message and exit. Provides information about command usage.

AUTHOR

EnterpriseDB

COPYRIGHT

© Copyright EnterpriseDB UK Limited 2011-2025

June 18, 2025 3.14