admin cluster bridge switchover
Feature of Yandex Enterprise Database
This functionality is available only in the Yandex Enterprise Database. In the open-source version of YDB it is absent.
Use the admin cluster bridge switchover command to perform a smooth, planned transition of the specified pile to PRIMARY via the intermediate PROMOTED state. For details, see the scenario description.
Alert
Commands in this section can harm your cluster if used incorrectly. Due to the potentially dangerous nature of these commands, ALL global parameters must be specified explicitly. Profiles are disabled by default and are only used when explicitly specified (--profile <profile-name>). Some commands do not require global options that are otherwise mandatory.
General command syntax:
ydb [global options...] admin cluster bridge switchover [options...]
global options— global parameters for the CLI.options— subcommand parameters.
View command help:
ydb admin cluster bridge switchover --help
Subcommand parameters
|
Name |
Description |
|
|
Name of the pile that should become the new PRIMARY. |
Requirements
- The target pile must be in the
SYNCHRONIZEDstate.
Examples
Transition pile pile-b from SYNCHRONIZED to PRIMARY via the intermediate PROMOTED state:
ydb admin cluster bridge switchover --new-primary pile-b
Verifying the result
After a short time (a few minutes), verify that pile states have changed correctly using the list command:
ydb admin cluster bridge list
pile-a: SYNCHRONIZED
pile-b: PRIMARY