--wsrep-new-cluster

Overview

This is a command-line option for the mariadbd & mysqld commands.

Used to startup the first node in a Galera Cluster, which is known as bootstrapping.

See also: mariadbd & mysqld for MariaDB Enterprise Server 11.4, in 10.6 ES, in 10.5 ES, in 10.4 ES, in 10.3 ES, in 10.2 ES, in 10.6 CS, in 10.5 CS, in 10.4 CS, in 10.3 CS, and in 10.2 CS

USAGE

DETAILS

The --wsrep-new-cluster command-line option is used for the special procedure that is used to startup the first node in a Galera Cluster, which is known as bootstrapping.

For additional information about bootstrapping a Galera Cluster, see "Bootstrap a Galera Cluster".

SYNONYMS

SCHEMA

PARAMETERS

SKYSQL

PRIVILEGES

EXAMPLES

systemd

When MariaDB Server (mariadbd) is started via systemd, the galera_new_cluster utility can be used:

$ sudo galera_new_cluster

When the galera_new_cluster utility is executed, it starts the mariadb.service systemd unit with the --wsrep-new-cluster command-line option added to the mariadbd command.

Since this command starts the mariadb.service systemd unit, the service should be stopped prior to running this command.

Set on the Command-line

When MariaDB Server (mariadbd) is started via the command-line, the --wsrep-new-cluster command-line option can be specified:

$ mariadbd .. --wsrep-new-cluster ..

Set in a Configuration File

The --wsrep-new-cluster command-line option can be specified in a configuration file:

[mariadb]
wsrep-new-cluster

When the --wsrep-new-cluster command-line option is specified in a configuration file that the node reads during startup, the node forms a new cluster. MariaDB recommends removing the option from the configuration file immediately for safety reasons. If the option is left in the configuration file, the node will form a new cluster every time it is restarted, even if the other cluster nodes are online.

ERROR HANDLING

FEATURE INTERACTION

RESPONSES

DIAGNOSIS

ISO 9075:2016

CHANGE HISTORY

Release Series

History

11.4 Enterprise

  • Not present.

10.6 Enterprise

  • Present starting in MariaDB Enterprise Server 10.6.4-1.

10.6 Community

  • Present starting in MariaDB Community Server 10.6.0.

10.5 Enterprise

  • Present starting in MariaDB Enterprise Server 10.5.3-1.

10.5 Community

  • Present starting in MariaDB Community Server 10.5.0.

10.4 Enterprise

  • Present starting in MariaDB Enterprise Server 10.4.6-1.

10.4 Community

  • Present starting in MariaDB Community Server 10.4.0.

10.3 Enterprise

  • Present starting in MariaDB Enterprise Server 10.3.16-1.

10.3 Community

  • Present starting in MariaDB Community Server 10.3.0.

10.2 Enterprise

  • Present starting in MariaDB Enterprise Server 10.2.25-1.

10.2 Community

  • Present starting in MariaDB Community Server 10.2.0.

EXTERNAL REFERENCES