Documentation
System StatusPortal Login

Configure MySQL source-replica replication

Suggest Edits

MySQL® replication enables one database server (referred to as the source
server in this article) to be replicated to one or more database servers
(referred to as the replica servers in this article). With MySQL, replication is
asynchronous. This means the replica servers do not need to be connected
permanently to receive updates from the source server. For example, you can stop
the replica thread on the replica server and restart it at a later time, and it
automatically synchronizes with the source.

This tutorial provides a simple setup (a single source server replicating to a
single replica server) that replicates all databases from the source to the
replica.

Prerequisites

Before beginning this tutorial, complete the following steps.

  • Install your operating system. (The steps in this article are completed using a CentOS® operating system)
  • Install mysql
  • Install mysql-devel
  • Install mysql-server

Note: The procedure in this article describes replication configuration on
a new set of servers with no data or database. This is important because existing
data on servers throws off the replication. You can use this procedure for other
flavors of Linux®

Collect IP Information

The MySQL configuration in this article replicates over the private IPs of your
cloud server. Make note of the private IP of each server.

Source:

[user@mysql-source ~]$ /sbin/ifconfig
 eth0      Link encap:Ethernet  HWaddr 40:40:51:B7:A4:2E
           inet addr:67.23.9.185  Bcast:67.23.9.255  Mask:255.255.255.0
           inet6 addr: fe80::4240:51ff:feb7:a42e/64 Scope:Link
           UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
           RX packets:28878 errors:0 dropped:0 overruns:0 frame:0
           TX packets:15147 errors:0 dropped:0 overruns:0 carrier:0
           collisions:0 txqueuelen:1000
           RX bytes:37708534 (35.9 MiB)  TX bytes:1129533 (1.0 MiB)

 eth1      Link encap:Ethernet  HWaddr 40:40:1A:AF:35:F2
           inet addr:10.176.41.72  Bcast:10.176.63.255 Mask:255.255.224.0
           inet6 addr: fe80::4240:1aff:feaf:35f2/64 Scope:Link
           UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
           RX packets:3 errors:0 dropped:0 overruns:0 frame:0
           TX packets:13 errors:0 dropped:0 overruns:0 carrier:0
           collisions:0 txqueuelen:1000
           RX bytes:230 (230.0 b)  TX bytes:762 (762.0 b)

 lo        Link encap:Local Loopback
           inet addr:127.0.0.1  Mask:255.0.0.0
           inet6 addr: ::1/128 Scope:Host
           UP LOOPBACK RUNNING  MTU:16436  Metric:1
           RX packets:0 errors:0 dropped:0 overruns:0 frame:0
           TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
           collisions:0 txqueuelen:0
           RX bytes:0 (0.0 b)  TX bytes:0 (0.0 b)

You want to note the IP that is shown for eth1. The IP address is listed right
after inet addr:. In this example, the source server's private IP is 10.176.41.72.
Repeat this on the replica server and note the private IP.

Replica:

 [user@mysql-replica ~]$ /sbin/ifconfig
 eth0      Link encap:Ethernet  HWaddr 40:40:BE:90:EB:1E
           inet addr:67.23.10.69  Bcast:67.23.10.255  Mask:255.255.255.0
           inet6 addr: fe80::4240:beff:fe90:eb1e/64 Scope:Link
           UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
           RX packets:29047 errors:0 dropped:0 overruns:0 frame:0
           TX packets:13527 errors:0 dropped:0 overruns:0 carrier:0
           collisions:0 txqueuelen:1000
           RX bytes:37743828 (35.9 MiB)  TX bytes:1473375 (1.4 MiB)

 eth1      Link encap:Ethernet  HWaddr 40:40:AE:5B:35:3A
           inet addr:10.176.41.207  Bcast:10.176.63.255 Mask:255.255.224.0
           inet6 addr: fe80::4240:aeff:fe5b:353a/64 Scope:Link
           UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
           RX packets:3 errors:0 dropped:0 overruns:0 frame:0
           TX packets:13 errors:0 dropped:0 overruns:0 carrier:0
           collisions:0 txqueuelen:1000
           RX bytes:230 (230.0 b)  TX bytes:762 (762.0 b)

 lo        Link encap:Local Loopback
           inet addr:127.0.0.1  Mask:255.0.0.0
           inet6 addr: ::1/128 Scope:Host
           UP LOOPBACK RUNNING  MTU:16436  Metric:1
           RX packets:0 errors:0 dropped:0 overruns:0 frame:0
           TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
           collisions:0 txqueuelen:0
           RX bytes:0 (0.0 b)  TX bytes:0 (0.0 b)

The IP address for our replica server in this example is 10.176.41.207. When you
have both private IPs noted somewhere, you're good to start configuring.

Configure the server

Source

  • Edit the /etc/my.cnf file on the source server to enable binary logging
    and set the server's name.

        [user@mysql-source ~]$ sudo vi /etc/my.cnf

  • Add these lines under the mysqld section.

      log-bin=/var/lib/mysqllogs/RackspaceServerID-theServerShortName-binary-log
  expire_logs_days=7
  server-name=<server_number>

  • Set the replication user.

      mysql> GRANT REPLICATION SLAVE ON *.* to 'replicant'@'slaveIP' IDENTIFIED BY 'somepassword';

The source my.cnf configuration is complete.

Replica preparation

  • Verify that the time zones match between source and replica.

  • Set the following items:

      relay-log=/var/lib/mysqllogs/RackspaceServerID-theServerShortName-relay-log
  relay-log-space-limit = 16G
  read-only=1
  server-name=<server_number>

Initial copy of data to replica

Choose one of the following options to copy data over to the replica.

  • mysqldump
  • Copy the flat files

mysqldump

Consider this option if the data directory is a reasonable size, and if you can
have your tables locked for the duration of the procedure.

 mysqldump -A --flush-privileges --master-data=1 | gzip -1 > ~rack/master.sql.gz

Transfer the dump file to the replica and import it.

Copy the flat files

For this method, stop MySQL on both servers and move the data directory out of
the way on the replica. If MySQL is not stopped on both servers, it is necessary
to make a backup:

 # mv /var/lib/mysql{,.prereplication}

Use one of the methods listed above to make the data directory on the replica
into a copy from the source. For example:

 # rsync -azv --progress --delete /var/lib/mysql/ slave:/var/lib/mysql/

When the data copy is finished, restart MySQL on both servers. Verify that innodb-log-file-size in /etc/my.cnf is set the same for replica and source, or MySQL will not start on the replica.

If replica is a newer version of MySQL, run mysql_upgrade on replica
before issuing the start slave command.

Attach replica to source

You need the binary log filename and position from the source that corresponds
with the backup. If you are using mysqldump, this will be included in the
master.sql.gz file itself.

 # zgrep -m 1 -P 'CHANGE MASTER' master.sql.gz
 CHANGE MASTER TO MASTER_LOG_FILE = '<binary log filename>', MASTER_LOG_POS = <binary log position>;

For a file level copy such as a cold copy obtained by shutting down MySQL and
using rsync, the binary log filename and position will be the first log file
created after restarting MySQL.

You can obtain this by following these steps:

 # service mysqld stop
 # tail -n 1 /var/lib/mysqllogs/db1-1234-bin-log.index
 /var/lib/mysqllogs/db1-1234-bin-log.000001
 # rsync ...
 # service mysqld start

In this case, start at filename db1-bin-log.000001 + 1 = db1-1234-bin-log.000002
at the beginning of this file. You will get this result:

 MASTER_LOG_FILE = 'db1-1234-bin-log.000002', MASTER_LOG_POS = 4

Now execute CHANGE MASTER on the replica to set the credentials for
connecting to the source, as well as the binary log file and position to start
replication from.

 mysql> change master to master_host='master-ip',master_user='userSetAbove', master_password='passwordSetAbove',master_log_file='logfile-from-above-command', master_log_pos=4;
 mysql> start slave;

MySQL root credentials

Make sure that the new replica has the same credentials in the /root/.my.cnf
file as the source server. The MySQL database and user grants table also syncs
over to the replica.

Holland

Because you imported the MySQL database from the source, all passwords are now
the same. Just as you updated the /root/.my.cnf on dbReplica to match dbSource,
you might need to update the /etc/holland/backupsets/default.conf file to
use the same credentials as the source for rackspace_backup.

Testing

Test your settings by creating a dummy database on the source and verifying that
it shows up on the replica. Once verified, you can drop the dummy database and
confirm the replica automatically drops it.

If you see an error like Last_IO_Error: error connecting to master, manually
test the replication user. From the replica, try two things:

nc masterIP 3306

If you see an error here, your grant is wrong, probably because you are in a
different network segment than you thought. The error will look like
Host dbSlave is not allowed to connect to this MySQL server.

mysql -ureplicant -hmasterDb -p

If you get an error, your grant is wrong.

If either of those fail to connect, you might need to adjust the firewall or
verify that you are making correct assumptions about how the network is configured
for this customer.

Filtering

It is recommended that you not use replication filtering. If you want to exclude
some tables from the replica, the only recommended method is with one of the
following my.cnf options configured on the replica:

 replicate-wild-do-table=dbase1.%
 replicate-wild-do-table=dbase3.%

 replicate-wild-ignore-table=dbase2.%
 replicate-wild-ignore-table=dbase4.someTable

Patterns can contain the wildcard characters % and \_, which have the same
meaning as the LIKE pattern-matching operator. If you need to use a literal
_ character, escape it as follows:

 replicate-wild-ignore-table=%.%\_tmp

In MySQL 5.5, database-level filtering options are case sensitive on platforms
supporting case sensitivity in filenames. Table-level filtering options are not
case sensitive on any platform, regardless of the value of the
lower_case_table_names system variable.

Events

If my.cnf has been enabled on the source, you can disable it on the replica.
If the event scheduler does need to be enabled on the replica, verify that the
existing events were created with CREATE EVENT ... DISABLE ON SLAVE with
something like: select db, name from mysql.event where status not in

Monitoring

Always monitor replication. In Emerging, we generally use
SiteScope Content Match with check_replication.php, which typically lives
in snamee httpd running on the replica.

You need to issue the GRANT for this on the source, which replicates to the replica:

 GRANT REPLICATION CLIENT ON *.* TO 'rep_monitor'@'slavePrimaryIP' IDENTIFIED BY 'somePassword';

Assuming you are behind a firewall, the 'slavePrimaryIP' should be the internal
IP address of the replica server [192.168.100.x]. In the check_replication.php
script, set host='192.168.100.x, the internal IP of the server the
script is running on. This is usually the same as slavePrimaryIP.

Contact your account manager and request setup of the SiteScope monitor. The URL
should be the public IP of the monitoring server, for example
https://68.23.45.32/check_replication.php

Note: The script can have additional elements in the dsn list
array and check multiple replicas with a single SiteScope probe. The PHP
documentation states that the comma after the last array element is optional
and can be omitted. However, with the SiteScope probe checking multiple replicas,
it might be less clear which replica had a problem when the alert clears quickly.
In this regard, it can make sense to have a check_replication.php and
corresponding SiteScope probe running on each replica.

Now sit back and let your replica server replicate from the source. Be sure not
to perform any writes to the replica server because that breaks replication!
All writes performed on the source are sent automatically to the replica through
the binary log and replication. For more information on MySQL replication, see
https://dev.mysql.com/doc/refman/5.0/en/replication.html.

Updated 12 months ago