When you upgrade servers that participate in a replication setup, the procedure for upgrading depends on the current server versions and the version to which you are upgrading.
This section applies to upgrading replication from older versions of MySQL to MySQL 5.7. A 4.0 server should be 4.0.3 or newer.
When you upgrade a master to 5.7 from an earlier MySQL release series, you should first ensure that all the slaves of this master are using the same 5.7.x release. If this is not the case, you should first upgrade the slaves. To upgrade each slave, shut it down, upgrade it to the appropriate 5.7.x version, restart it, and restart replication. Relay logs created by the slave after the upgrade are in 5.7 format.
Changes affecting operations in strict SQL mode may result in
replication failure on an updated slave. For example, as of MySQL
5.7.2, the server restricts insertion of a
DEFAULT value of 0 for temporal data types in
strict mode (
resulting incompatibility for replication if you use
binlog_format=STATEMENT) is that
if a slave is upgraded, a nonupgraded master will execute
statements without error that may fail on the slave and
replication will stop. To deal with this, stop all new statements
on the master and wait until the slaves catch up. Then upgrade the
slaves. Alternatively, if you cannot stop new statements,
temporarily change to row-based logging on the master
binlog_format=ROW) and wait
until all slaves have processed all binary logs produced up to the
point of this change. Then upgrade the slaves.
After the slaves have been upgraded, shut down the master, upgrade it to the same 5.7.x release as the slaves, and restart it. If you had temporarily changed the master to row-based logging, change it back to statement-based logging. The 5.7 master is able to read the old binary logs written prior to the upgrade and to send them to the 5.7 slaves. The slaves recognize the old format and handle it properly. Binary logs created by the master subsequent to the upgrade are in 5.7 format. These too are recognized by the 5.7 slaves.
In other words, when upgrading to MySQL 5.7, the slaves must be MySQL 5.7 before you can upgrade the master to 5.7. Note that downgrading from 5.7 to older versions does not work so simply: You must ensure that any 5.7 binary log or relay log has been fully processed, so that you can remove it before proceeding with the downgrade.
Downgrading a replication setup to a previous version cannot be done once you have switched from statement-based to row-based replication, and after the first row-based statement has been written to the binlog. See Section 17.1.2, “Replication Formats”.
Some upgrades may require that you drop and re-create database objects when you move from one MySQL series to the next. For example, collation changes might require that table indexes be rebuilt. Such operations, if necessary, will be detailed at Section 220.127.116.11, “Upgrading from MySQL 5.6 to 5.7”. It is safest to perform these operations separately on the slaves and the master, and to disable replication of these operations from the master to the slave. To achieve this, use the following procedure:
Stop all the slaves and upgrade them. Restart them with the
--skip-slave-start option so
that they do not connect to the master. Perform any table
repair or rebuilding operations needed to re-create database
objects, such as use of
REPAIR TABLE or
ALTER TABLE, or dumping and reloading
tables or triggers.
Disable the binary log on the master. To do this without
restarting the master, execute a
SET sql_log_bin =
0 statement. Alternatively, stop the master and
restart it without the
--log-bin option. If you
restart the master, you might also want to disallow client
connections. For example, if all clients connect using TCP/IP,
option when you restart the master.
With the binary log disabled, perform any table repair or rebuilding operations needed to re-create database objects. The binary log must be disabled during this step to prevent these operations from being logged and sent to the slaves later.
Re-enable the binary log on the master. If you set
sql_log_bin to 0 earlier,
SET sql_log_bin = 1 statement. If
you restarted the master to disable the binary log, restart it
--log-bin, and without
--skip-networking so that
clients and slaves can connect.
Restart the slaves, this time without the
If you are upgrading an existing replication setup from a version of MySQL that does not support global transaction identifiers to a version that does, you should not enable GTIDs on either the master or the slave before making sure that the setup meets all the requirements for GTID-based replication. See Section 18.104.22.168, “Setting Up Replication Using GTIDs”, which contains information about converting existing replication setups to use GTID-based replication.