About MySQL replication

MySQL replication is a process that allows you to easily maintain multiple copies of a MySQL data by having them copied automatically from a master to a slave database. This can helpful for many reasons including facilating a backup for the data,a way to analyze it without using the main database, or simply as a means to scale out.

This tutorial will cover a very simple example of mysql replication—one master will send information to a single slave. For the process to work you will need two IP addresses: one of the master server and and one of the slave.

This tutorial will use the following IP addresses: Master Database Slave Database


This article assumes that you have user with sudo privileges and have MySQL installed. If you do not have mysql, you can install it with this command:

<span style="color:#0000ff;">sudo apt-get install mysql-server mysql-client</span>

Step One—Configure the Master Database

Open up the mysql configuration file on the master server.

<span style="color:#0000ff;">sudo nano /etc/mysql/my.cnf</span>

Once inside that file, we need to make a few changes.

The first step is to find the section that looks like this, binding the server to the local host:

<span style="color:#0000ff;">bind-address            =</span>

Replace the standard IP address with the IP address of server.

<span style="color:#0000ff;">bind-address            =</span>

The next configuration change refers to the server-id, located in the [mysqld] section. You can choose any number for this spot (it may just be easier to start with 1), but the number must be unique and cannot match any other server-id in your replication group. I’m going to go ahead and call this one 1. Make sure this line is uncommented.

<span style="color:#0000ff;">server-id               = 1</span>

Move on to the log_bin line. This is where the real details of the replication are kept. The slave is going to copy all of the changes that are registered in the log. For this step we simply need to uncomment the line that refers to log_bin:

<span style="color:#0000ff;">log_bin                 = /var/log/mysql/mysql-bin.log</span>

Finally, we need to designate the database that will be replicated on the slave server. You can include more than one database by repeating this line for all of the databases you will need.

<span style="color:#0000ff;">binlog_do_db            = newdatabase</span>

After you make all of the changes, go ahead and save and exit out of the configuration file.

Refresh MySQL.

<span style="color:#0000ff;">sudo service mysql restart</span>

The next steps will take place in the MySQL shell, itself.

Open up the MySQL shell.

<span style="color:#0000ff;">mysql -u root -p</span>

We need to grant privileges to the slave. You can use this line to name your slave and set up their password. The command should be in this format:

<span style="color:#0000ff;">GRANT REPLICATION SLAVE ON *.* TO 'slave_user'@'%' IDENTIFIED BY 'password';</span>

Follow up with:

<span style="color:#0000ff;">FLUSH PRIVILEGES;</span>

The next part is a bit finicky. To accomplish the task you will need to open a new window or tab in addition to the one that you are already using a few steps down the line.

In your current tab switch to “newdatabase”.

<span style="color:#0000ff;">USE newdatabase;</span>

Following that, lock the database to prevent any new changes:

<span style="color:#0000ff;">FLUSH TABLES WITH READ LOCK;</span>

Then type in:

<span style="color:#0000ff;">SHOW MASTER STATUS;</span>

You will see a table that should look something like this:

<span style="color:#0000ff;">mysql> SHOW MASTER STATUS;
| File             | Position | Binlog_Do_DB | Binlog_Ignore_DB |
| mysql-bin.000001 |      107 | newdatabase  |                  |
1 row in set (0.00 sec)</span>

This is the position from which the slave database will start replicating. Record these numbers, they will come in useful later.

If you make any new changes in the same window, the database will automatically unlock. For this reason, you should open the new tab or window and continue with the next steps there.

Proceeding the with the database still locked, export your database using mysqldump in the new window (make sure you are typing this command in the bash shell, not in MySQL).

<span style="color:#0000ff;">mysqldump -u root -p --opt newdatabase > newdatabase.sql</span>

Now, returning to your your original window, unlock the databases (making them writeable again). Finish up by exiting the shell.

<span style="color:#0000ff;">UNLOCK TABLES;</span>
<span style="color:#0000ff;">QUIT;</span>

Now you are all done with the configuration of the the master database.

Step Two—Configure the Slave Database

Once you have configured the master database. You can put it aside for a while, and we will now begin to configure the slave database.

Log into your slave server, open up the MySQL shell and create the new database that you will be replicating from the master (then exit):

<span style="color:#0000ff;">CREATE DATABASE newdatabase;</span>
<span style="color:#0000ff;">EXIT;</span>

Import the database that you previously exported from the master database.

<span style="color:#0000ff;">mysql -u root -p newdatabase < /path/to/newdatabase.sql</span>

Now we need to configure the slave configuration in the same way as we did the master:

<span style="color:#0000ff;">sudo nano /etc/mysql/my.cnf</span>

We have to make sure that we have a few things set up in this configuration. The first is the server-id. This number, as mentioned before needs to be unique. Since it is set on the default (still 1), be sure to change it’s something different.

<span style="color:#0000ff;">server-id               = 2</span>

Following that, make sure that your have the following three criteria appropriately filled out:

<span style="color:#0000ff;">relay-log               = /var/log/mysql/mysql-relay-bin.log</span>
<span style="color:#0000ff;">log_bin                 = /var/log/mysql/mysql-bin.log</span>
<span style="color:#0000ff;">binlog_do_db            = newdatabase</span>

You will need to add in the relay-log line: it is not there by default.

Once you have made all of the necessary changes, save and exit out of the slave configuration file.

Restart MySQL once again:

<span style="color:#0000ff;">sudo service mysql restart</span>

The next step is to enable the replication from within the MySQL shell.

Open up the the MySQL shell once again and type in the following details, replacing the values to match your information:

<span style="color:#0000ff;">CHANGE MASTER TO MASTER_HOST='',MASTER_USER='slave_user', MASTER_PASSWORD='password', MASTER_LOG_FILE='mysql-bin.000001', MASTER_LOG_POS=  107;</span>

This command accomplishes several things at the same time:

1. It designates the current server as the slave of our master server.

1. It provides the server the correct login credentials
  1. Last of all, it lets the slave server know where to start replicating from; the master log file and log position come from the numbers we wrote down previously.

With that—you have configured a master and slave server. Activate the slave server:

<span style="color:#0000ff;">START SLAVE;</span>

You be able to see the details of the slave replication by typing in this command. The G rearranges the text to make it more readable.

<span style="color:#0000ff;">SHOW SLAVE STATUSG</span>

If there is an issue in connecting, you can try starting slave with a command to skip over it:

<span style="color:#0000ff;">SET GLOBAL SQL_SLAVE_SKIP_COUNTER = 1; SLAVE START;</span>

All done.