# Configuring MariaDB Replication between MariaDB Galera Cluster and MariaDB Server

[MariaDB replication](/docs/server/ha-and-performance/standard-replication.md) can be used to replicate between [MariaDB Galera Cluster](/docs/galera-cluster/readme.md) and MariaDB Server. This article will discuss how to do that.

## Configuring the Cluster

Before we set up replication, we need to ensure that the cluster is configured properly. This involves the following steps:

* Set [log\_slave\_updates=ON](/docs/server/ha-and-performance/standard-replication/replication-and-binary-log-system-variables.md#log_slave_updates) on all nodes in the cluster. See [Configuring MariaDB Galera Cluster: Writing Replicated Write Sets to the Binary Log](/docs/galera-cluster/galera-management/configuration/configuring-mariadb-galera-cluster.md#writing-replicated-write-sets-to-the-binary-log) and [Using MariaDB Replication with MariaDB Galera Cluster: Configuring a Cluster Node as a Replication Master](/docs/galera-cluster/high-availability/using-mariadb-replication-with-mariadb-galera-cluster/using-mariadb-replication-with-mariadb-galera-cluster-using-mariadb-replica.md#configuring-a-cluster-node-as-a-replication-master) for more information on why this is important. It is also needed to [enable wsrep GTID mode](/docs/galera-cluster/high-availability/using-mariadb-replication-with-mariadb-galera-cluster/using-mariadb-gtids-with-mariadb-galera-cluster.md#enabling-wsrep-gtid-mode).
* Set [server\_id](/docs/server/ha-and-performance/standard-replication/gtid.md#server_id) to the same value on all nodes in the cluster. See [Using MariaDB Replication with MariaDB Galera Cluster: Setting server\_id on Cluster Nodes](/docs/galera-cluster/high-availability/using-mariadb-replication-with-mariadb-galera-cluster/using-mariadb-replication-with-mariadb-galera-cluster-using-mariadb-replica.md#setting-server_id-on-cluster-nodes) for more information on what this means.

### Configuring Wsrep GTID Mode

If you want to use [GTID](/docs/server/ha-and-performance/standard-replication/gtid.md) replication, then you also need to configure some things to [enable wsrep GTID mode](/docs/galera-cluster/high-availability/using-mariadb-replication-with-mariadb-galera-cluster/using-mariadb-gtids-with-mariadb-galera-cluster.md#enabling-wsrep-gtid-mode). For example:

* [wsrep\_gtid\_mode=ON](/docs/galera-cluster/reference/galera-cluster-system-variables.md#wsrep_gtid_mode) needs to be set on all nodes in the cluster.
* [wsrep\_gtid\_domain\_id](/docs/galera-cluster/reference/galera-cluster-system-variables.md#wsrep_gtid_domain_id) needs to be set to the same value on all nodes in the cluster so that each cluster node uses the same domain when assigning [GTIDs](/docs/server/ha-and-performance/standard-replication/gtid.md) for Galera Cluster's write sets.
* [log\_slave\_updates](/docs/server/ha-and-performance/standard-replication/replication-and-binary-log-system-variables.md#log_slave_updates) needs to be enabled on all nodes in the cluster. See [MDEV-9855](https://jira.mariadb.org/browse/MDEV-9855) about that.
* [log\_bin](/docs/server/ha-and-performance/standard-replication/replication-and-binary-log-system-variables.md#log_bin) needs to be set to the same path on all nodes in the cluster. See [MDEV-9856](https://jira.mariadb.org/browse/MDEV-9856) about that.

And as an extra safety measure:

* [gtid\_domain\_id](/docs/server/ha-and-performance/standard-replication/gtid.md#gtid_domain_id) should be set to a different value on all nodes in a given cluster, and each of these values should be different than the configured [wsrep\_gtid\_domain\_id](/docs/galera-cluster/reference/galera-cluster-system-variables.md#wsrep_gtid_domain_id) value. This is to prevent a node from using the same domain used for Galera Cluster's write sets when assigning [GTIDs](/docs/server/ha-and-performance/standard-replication/gtid.md) for non-Galera transactions, such as DDL executed with [wsrep\_sst\_method=RSU](/docs/galera-cluster/reference/galera-cluster-system-variables.md#wsrep_sst_method) set or DML executed with [wsrep\_on=OFF](/docs/galera-cluster/reference/galera-cluster-system-variables.md#wsrep_on) set.

## Configuring the Replica

Before we set up replication, we also need to ensure that the MariaDB Server replica is configured properly. This involves the following steps:

* Set [server\_id](/docs/server/ha-and-performance/standard-replication/replication-and-binary-log-system-variables.md#server_id) to a different value than the one that the cluster nodes are using.
* Set [gtid\_domain\_id](/docs/server/ha-and-performance/standard-replication/gtid.md#gtid_domain_id) to a value that is different than the [wsrep\_gtid\_domain\_id](/docs/galera-cluster/reference/galera-cluster-system-variables.md#wsrep_gtid_domain_id) and [gtid\_domain\_id](/docs/server/ha-and-performance/standard-replication/gtid.md#gtid_domain_id) values that the cluster nodes are using.
* Set [log\_bin](/docs/server/ha-and-performance/standard-replication/replication-and-binary-log-system-variables.md) and [log\_slave\_updates=ON](/docs/server/ha-and-performance/standard-replication/replication-and-binary-log-system-variables.md#log_slave_updates) if you want the replica to log the transactions that it replicates.

## Setting up Replication

Our process to set up replication is going to be similar to the process described at [Setting up a Replication Slave with mariadb-backup](/docs/server/server-usage/backup-and-restore/mariadb-backup/full-backup-and-restore-with-mariadb-backup.md), but it will be modified a bit to work in this context.

### Start the cluster

The very first step is to start the nodes in the first cluster. The first node will have to be [bootstrapped](/docs/galera-cluster/galera-management/installation-and-deployment/getting-started-with-mariadb-galera-cluster.md#bootstrapping-a-new-cluster). The other nodes can be started normally.

Once the nodes are started, you need to pick a specific node that will act as the replication primary for the MariaDB Server.

{% stepper %}
{% step %}

### Backup the Database on the Cluster's Primary Node and Prepare It

The first step is to simply take and prepare a fresh [full backup](/docs/server/server-usage/backup-and-restore/mariadb-backup/full-backup-and-restore-with-mariadb-backup.md) of the node that you have chosen to be the replication primary. For example:

```bash
$ mariadb-backup --backup \
   --target-dir=/var/mariadb/backup/ \
   --user=mariadb-backup --password=mypassword
```

And then you would prepare the backup as you normally would. For example:

```bash
$ mariadb-backup --prepare \
   --target-dir=/var/mariadb/backup/
```

{% endstep %}

{% step %}

### Copy the Backup to the Replica

Once the backup is done and prepared, you can copy it to the MariaDB Server that will be acting as replica. For example:

```bash
$ rsync -avrP /var/mariadb/backup dc2-dbserver1:/var/mariadb/backup
```

{% endstep %}

{% step %}

### Restore the Backup on the Second Cluster's Replica

At this point, you can restore the backup to the [datadir](/docs/server/server-management/variables-and-modes/server-system-variables.md#datadir), as you normally would. For example:

```bash
$ mariadb-backup --copy-back \
   --target-dir=/var/mariadb/backup/
```

And adjusting file permissions, if necessary:

```bash
$ chown -R mysql:mysql /var/lib/mysql/
```

{% endstep %}
{% endstepper %}

### Start the New Replica

Now that the backup has been restored to the MariaDB Server replica, you can start the MariaDB Server process.

{% stepper %}
{% step %}

### Create a Replication User on the Cluster's Primary

Before the MariaDB Server replica can begin replicating from the cluster's primary, you need to [create a user account](/docs/server/security/authentication-with-enterprise-server/authentication-with-gssapi.md#create-user) on the primary that the replica can use to connect, and you need to [grant](/docs/server/reference/sql-statements/account-management-sql-statements/grant.md) the user account the [REPLICATION SLAVE](/docs/server/reference/sql-statements/account-management-sql-statements/grant.md#replication-slave) privilege. For example:

```sql
CREATE USER 'repl'@'dc2-dbserver1' IDENTIFIED BY 'password';
GRANT REPLICATION SLAVE ON *.*  TO 'repl'@'dc2-dbserver1';
```

{% endstep %}

{% step %}

### Start Replication on the New Replica

At this point, you need to get the replication coordinates of the primary from the original backup.

The coordinates will be in the [xtrabackup\_binlog\_info](/docs/server/server-usage/backup-and-restore/mariadb-backup/files-created-by-mariadb-backup.md#xtrabackup_binlog_info) file.

mariadb-backup dumps replication coordinates in two forms: [GTID strings](/docs/server/ha-and-performance/standard-replication/gtid.md) and [binary log](/docs/server/server-management/server-monitoring-logs/binary-log.md) file and position coordinates, like the ones you would normally see from [SHOW MASTER STATUS](/docs/server/reference/sql-statements/administrative-sql-statements/show/show-binlog-status.md) output. In this case, it is probably better to use the [GTID](/docs/server/ha-and-performance/standard-replication/gtid.md) coordinates.

For example:

```
mariadb-bin.000096 568 0-1-2
```

Regardless of the coordinates you use, you will have to set up the primary connection using [CHANGE MASTER TO](/docs/server/reference/sql-statements/administrative-sql-statements/replication-statements/change-master-to.md) and then start the replication threads with [START SLAVE](/docs/server/reference/sql-statements/administrative-sql-statements/replication-statements/legacy-replication-statements/legacy-commands-start-slave.md).

{% tabs %}
{% tab title="GTIDs" %}
If you want to use GTIDs, then you will have to first set [gtid\_slave\_pos](/docs/server/ha-and-performance/standard-replication/gtid.md#gtid_slave_pos) to the [GTID](/docs/server/ha-and-performance/standard-replication/gtid.md) coordinates that we pulled from the [xtrabackup\_binlog\_info](/docs/server/server-usage/backup-and-restore/mariadb-backup/files-created-by-mariadb-backup.md#xtrabackup_binlog_info) file, and we would set `MASTER_USE_GTID=slave_pos` in the [CHANGE MASTER TO](/docs/server/reference/sql-statements/administrative-sql-statements/replication-statements/change-master-to.md) command. For example:

```sql
SET GLOBAL gtid_slave_pos = "0-1-2";
CHANGE MASTER TO 
   MASTER_HOST="c1dbserver1", 
   MASTER_PORT=3310, 
   MASTER_USER="repl",  
   MASTER_PASSWORD="password", 
   MASTER_USE_GTID=slave_pos;
START SLAVE;
```

{% endtab %}

{% tab title="File and Position" %}
If you want to use the [binary log](/docs/server/server-management/server-monitoring-logs/binary-log.md) file and position coordinates, then you would set `MASTER_LOG_FILE` and `MASTER_LOG_POS` in the [CHANGE MASTER TO](/docs/server/reference/sql-statements/administrative-sql-statements/replication-statements/change-master-to.md) command to the file and position coordinates that we pulled from the [xtrabackup\_binlog\_info](/docs/server/server-usage/backup-and-restore/mariadb-backup/files-created-by-mariadb-backup.md#xtrabackup_binlog_info) file. For example:

```sql
CHANGE MASTER TO 
   MASTER_HOST="c1dbserver1", 
   MASTER_PORT=3310, 
   MASTER_USER="repl",  
   MASTER_PASSWORD="password", 
   MASTER_LOG_FILE='mariadb-bin.000096',
   MASTER_LOG_POS=568,
START SLAVE;
```

{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

### Check the Status of the New Replica

You should be done setting up the replica now, so you should check its status with [SHOW SLAVE STATUS](/docs/server/reference/sql-statements/administrative-sql-statements/replication-statements/legacy-replication-statements/legacy-commands-show-slave-status.md). For example:

```sql
SHOW SLAVE STATUS\G
```

Now that the MariaDB Server is up, ensure that it does not start accepting writes yet if you want to set up [circular replication](/docs/server/ha-and-performance/standard-replication/replication-overview.md#ring-replication) between the cluster and the MariaDB Server.
{% endstep %}
{% endstepper %}

## Setting up Circular Replication

You can also set up [circular replication](/docs/server/ha-and-performance/standard-replication/replication-overview.md#ring-replication) between the cluster and MariaDB Server, which means that the MariaDB Server replicates from the cluster, and the cluster also replicates from the MariaDB Server.

{% stepper %}
{% step %}

### Create a Replication User on the MariaDB Server Primary

Before circular replication can begin, you also need to [create a user account](/docs/server/security/authentication-with-enterprise-server/authentication-with-gssapi.md#create-user) on the MariaDB Server, since it will be acting as the replication primary to the cluster's replica, and you need to [grant](/docs/server/reference/sql-statements/account-management-sql-statements/grant.md) the user account the [REPLICATION SLAVE](/docs/server/reference/sql-statements/account-management-sql-statements/grant.md#replication-slave) privilege. For example:

```sql
CREATE USER 'repl'@'c1dbserver1' IDENTIFIED BY 'password';
GRANT REPLICATION SLAVE ON *.*  TO 'repl'@'c1dbserver1';
```

{% endstep %}

{% step %}

### Start Circular Replication on the Cluster

How this is done would depend on whether you want to use the [GTID](/docs/server/ha-and-performance/standard-replication/gtid.md) coordinates or the [binary log](/docs/server/server-management/server-monitoring-logs/binary-log.md) file and position coordinates.

Regardless, you need to ensure that the second cluster is not accepting any writes other than those that it replicates from the cluster at this stage.

{% tabs %}
{% tab title="GTIDs" %}
To get the GTID coordinates on the MariaDB server, you can check [gtid\_current\_pos](/docs/server/ha-and-performance/standard-replication/gtid.md#gtid_current_pos) by executing:

```sql
SHOW GLOBAL VARIABLES LIKE 'gtid_current_pos';
```

Then on the node acting as a replica in the cluster, you can set up replication by setting [gtid\_current\_pos](/docs/server/ha-and-performance/standard-replication/gtid.md#gtid_current_pos) to the GTID that was returned and then executing [CHANGE MASTER TO](/docs/server/reference/sql-statements/administrative-sql-statements/replication-statements/change-master-to.md) :

```sql
SET GLOBAL gtid_slave_pos = "0-1-2";
CHANGE MASTER TO 
   MASTER_HOST="c2dbserver1", 
   MASTER_PORT=3310, 
   MASTER_USER="repl",  
   MASTER_PASSWORD="password", 
   MASTER_USE_GTID=slave_pos;
START SLAVE;
```

{% endtab %}

{% tab title="File and Position" %}
To get the [binary log](/docs/server/server-management/server-monitoring-logs/binary-log.md) file and position coordinates on the MariaDB server, you can execute [SHOW MASTER STATUS](/docs/server/reference/sql-statements/administrative-sql-statements/show/show-binlog-status.md):

```sql
SHOW MASTER STATUS
```

Then on the node acting as a replica in the cluster, you would set `master_log_file` and `master_log_pos` in the [CHANGE MASTER TO](/docs/server/reference/sql-statements/administrative-sql-statements/replication-statements/change-master-to.md) command. For example:

```sql
CHANGE MASTER TO 
   MASTER_HOST="c2dbserver1", 
   MASTER_PORT=3310, 
   MASTER_USER="repl",  
   MASTER_PASSWORD="password", 
   MASTER_LOG_FILE='mariadb-bin.000096',
   MASTER_LOG_POS=568;
START SLAVE;
```

{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

### Check the Status of the Circular Replication

You should be done setting up the circular replication on the node in the first cluster now, so you should check its status with [SHOW SLAVE STATUS](/docs/server/reference/sql-statements/administrative-sql-statements/replication-statements/legacy-replication-statements/legacy-commands-show-slave-status.md). For example:

```sql
SHOW SLAVE STATUS\G
```

{% endstep %}
{% endstepper %}

<sub>*This page is licensed: CC BY-SA / Gnu FDL*</sub>

{% @marketo/form formId="4316" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mariadb.com/docs/galera-cluster/high-availability/using-mariadb-replication-with-mariadb-galera-cluster/configuring-mariadb-replication-between-mariadb-galera-cluster-and-mariadb.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.