As a general rule, we recommend that when you upgrade from one
release series to another, you should go to the next series rather
than skipping a series. For example, if you currently are running
MySQL 4.0 and wish to upgrade to a newer series, upgrade to MySQL
4.1 rather than to 5.0 or 5.1.
The following items form a checklist of things that you should do
whenever you perform an upgrade:
Before upgrading from MySQL 5.0 to
5.1, read Section 2.10.1, “Upgrading from MySQL 5.0”,
as well as Appendix D, MySQL Change History. These provide information
about features that are new in MySQL 5.1 or
differ from those found in MySQL 5.0. If you
wish to upgrade from a release series previous to MySQL
5.0, you should upgrade to each successive
release series in turn until you have reached MySQL
5.0, and then proceed with the upgrade to MySQL
5.1. For information on upgrading from MySQL
5.0, see the
MySQL 5.0 Reference Manual; for earlier
releases, see the MySQL 3.23, 4.0, 4.1 Reference Manual.
Before you perform an upgrade, back up your databases,
mysql database that contains
the grant tables.
Some releases of MySQL introduce incompatible changes to
tables. (Our aim is to avoid these changes, but occasionally
they are necessary to correct problems that would be worse
than an incompatibility between releases.) Some releases of
MySQL introduce changes to the structure of the grant tables
to add new privileges or features.
To avoid problems due to such changes, after you upgrade to a
new version of MySQL, you should check your tables (and repair
them if necessary), and update your grant tables to make sure
that they have the current structure so that you can take
advantage of any new capabilities. See
Section 5.5.2, “mysql_upgrade — Check Tables for MySQL Upgrade”.
If you are running MySQL Server on Windows, see
Section 2.3.14, “Upgrading MySQL on Windows”.
If you are using replication, see
Section 6.7, “Upgrading a Replication Setup”, for information on
upgrading your replication setup.
As of MySQL 5.1.6, the mysqld-max server no
longer exists. If you previously installed a MySQL-Max
distribution that includes a server named
mysqld-max, you should remove it.
You can always move the MySQL format files and data files between
different versions on the same architecture as long as you stay
within versions for the same release series of MySQL. If you
change the character set when running MySQL, you must run
myisamchk -r -q
MyISAM tables. Otherwise, your indexes
may not be ordered correctly, because changing the character set
may also change the sort order.
If you are cautious about using new versions, you can always
rename your old mysqld before installing a
newer one. For example, if you are using MySQL
5.0.13 and want to upgrade to 5.1.10,
rename your current server from mysqld to
mysqld-5.0.13. If your new
mysqld then does something unexpected, you can
simply shut it down and restart with your old
If, after an upgrade, you experience problems with recompiled
client programs, such as
Commands out of sync
or unexpected core dumps, you probably have used old header or
library files when compiling your programs. In this case, you
should check the date for your
libmysqlclient.a library to verify that
they are from the new MySQL distribution. If not, recompile your
programs with the new headers and libraries.
If problems occur, such as that the new mysqld
server does not start or that you cannot connect without a
password, verify that you do not have an old
my.cnf file from your previous installation.
You can check this with the
option (for example, mysqld --print-defaults).
If this command displays anything other than the program name, you
have an active
my.cnf file that affects
server or client operation.
It is a good idea to rebuild and reinstall the Perl
DBD::mysql module whenever you install a new
release of MySQL. The same applies to other MySQL interfaces as
well, such as the PHP
mysql extension and the