1PG_AUTOCTL PERFORM SWITCHOVER(1)pg_auto_failoverPG_AUTOCTL PERFORM SWITCHOVER(1)
2
3
4

NAME

6       pg_autoctl perform switchover - pg_autoctl perform switchover
7
8       pg_autoctl  perform  switchover - Perform a switchover for given forma‐
9       tion and group
10

SYNOPSIS

12       This command  starts  a  Postgres  switchover  orchestration  from  the
13       pg_auto_switchover monitor:
14
15          usage: pg_autoctl perform switchover  [ --pgdata --formation --group ]
16
17          --pgdata      path to data directory
18          --formation   formation to target, defaults to 'default'
19          --group       group to target, defaults to 0
20

DESCRIPTION

22       The  pg_auto_switchover  monitor  can  be  used to orchestrate a manual
23       switchover, sometimes also  known  as  a  switchover.  When  doing  so,
24       split-brain  are  prevented thanks to intermediary states being used in
25       the Finite State Machine.
26
27       The pg_autoctl perform switchover command waits until the switchover is
28       known  complete on the monitor, or until the hard-coded 60s timeout has
29       passed.
30
31       The switchover orchestration is done in the background by the  monitor,
32       so  even if the pg_autoctl perform switchover stops on the timeout, the
33       switchover orchestration continues at the monitor.
34
35       See also pg_autoctl perform failover, a synonym for this command.
36

OPTIONS

38       --pgdata
39              Location of the Postgres node being managed locally. Defaults to
40              the  environment  variable PGDATA. Use --monitor to connect to a
41              monitor from anywhere, rather than the monitor URI used by a lo‐
42              cal Postgres node managed with pg_autoctl.
43
44       --formation
45              Formation to target for the operation. Defaults to default.
46
47       --group
48              Postgres  group to target for the operation. Defaults to 0, only
49              Citus formations may have more than one group.
50

AUTHOR

52       Microsoft
53
55       Copyright (c) Microsoft Corporation. All rights reserved.
56
57
58
59
601.6                              Aug 04, 2022 PG_AUTOCTL PERFORM SWITCHOVER(1)
Impressum