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

    SERVER_NAME
        Name of the server in barman node

    --archive
        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.

    --archive-timeout
        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.

    --force
        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.

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

AUTHOR
EnterpriseDB

COPYRIGHT
© Copyright EnterpriseDB UK Limited 2011-2025