As a general rule, to upgrade from one release series to another, you should go to the next series rather than skipping a series. To upgrade from a release series previous to MySQL 5.0, 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 example, if you currently are running MySQL 4.0 and wish to upgrade to a newer series, upgrade to MySQL 4.1 first before upgrading to 5.0, and so forth. For information on upgrading to MySQL 5.0, see the MySQL 5.0 Reference Manual; for earlier releases, see the MySQL 3.23, 4.0, 4.1 Reference Manual.
To upgrade from MySQL 5.0 to 5.1, use the items in the following checklist as a guide:
Before any upgrade, back up your databases, including the
mysql
database that contains the grant
tables. See Section 6.1, “Database Backups”.
Read all the notes in Section 2.12.1.1, “Upgrading from MySQL 5.0 to 5.1”. These notes enable you to identify upgrade issues that apply to your current MySQL installation. Some incompatibilities discussed in that section require your attention before upgrading. Others should be dealt with after upgrading.
Read Appendix C, MySQL Change History as well, which provides information about features that are new in MySQL 5.1 or differ from those found in MySQL 5.0.
After you upgrade to a new version of MySQL, run mysql_upgrade (see Section 4.4.8, “mysql_upgrade — Check Tables for MySQL Upgrade”). This program checks your tables, and attempts to repair them if necessary. It also updates your grant tables to make sure that they have the current structure so that you can take advantage of any new capabilities. (Some releases of MySQL introduce changes to the structure of the grant tables to add new privileges or features.)
If you are running MySQL Server on Windows, see Section 2.3.14, “Upgrading MySQL on Windows”.
If you are using replication, see Section 16.3.3, “Upgrading a Replication Setup”, for information on upgrading your replication setup.
If you are upgrading an installation originally produced by installing multiple RPM packages, it is best to upgrade all the packages, not just some. For example, if you previously installed the server and client RPMs, do not upgrade just the server RPM.
As of MySQL 5.1.9, the mysqld-max server is included in binary distributions. There is no separate MySQL-Max distribution. As of MySQL 5.1.12, there is no mysqld-max server at all in binary distributions. They contain a server that includes the features previously included in mysqld-max.
If you have created a user-defined function (UDF) with a
given name and upgrade MySQL to a version that implements a
new built-in function with the same name, the UDF becomes
inaccessible. To correct this, use DROP
FUNCTION
to drop the UDF, and then use
CREATE FUNCTION
to re-create
the UDF with a different nonconflicting name. The same is
true if the new version of MySQL implements a built-in
function with the same name as an existing stored function.
See Section 8.2.4, “Function Name Parsing and Resolution”, for the rules
describing how the server interprets references to different
kinds of functions.
You can always move the MySQL format files and data files between different versions on systems with the same architecture as long as you stay within versions for the same release series of MySQL.
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 mysqld.
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 mysql.h
file
and 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
--print-defaults
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.
If your MySQL installation contains a large amount of data that
might take a long time to convert after an in-place upgrade, you
might find it useful to create a “dummy” database
instance for assessing what conversions might be needed and the
work involved to perform them. Make a copy of your MySQL
instance that contains a full copy of the
mysql
database, plus all other databases
without data. Run your upgrade procedure on this dummy instance
to see what actions might be needed so that you can better
evaluate the work involved when performing actual data
conversion on your original database instance.
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 PHP mysql
extensions and the
Python MySQLdb
module.
User Comments
Reality-check:
Upgrading from 5.0.something to 5.1.25... many hours, ultimately a dead-end.
-- Centos 5.1 and trying to let yum manage everything.
-- I obtained the 5.1.25 community RPMs for client and server.
-- Above article fails to discuss whether to uninstall existing version first or not. When I attempted yum upgrade it didn't see existing install (possibly because of name change from "mysql-server" to MYSQL-community-server?). So I did yum uninstall, which also removed dependent Perl, PHP and Python modules.
-- yum install for server failed to complete... later determined to be inability to start server due to inability to create /var/run/mysqlsd. Fixed perms, and was able to run mysql_upgrade, and start server OK (it preserved existing database, users etc.)
-- yum install for client ran OK.
-- client could not connect to server, because one of the installs had renamed my.cnf, and without that, server and client default to different (or no) mysql.sock. This seems a perennial bug. Fixed that, connects OK.
-- Also able to connect from remote client.
-- Now the fatal part: Embarked on reinstating MYSQL-python, dovecot, php-mysql and perl-DBD-MySQL. Yum says all are dependent on "mysql" 5.0.45 . After finding no guidance on this, I let yum proceed... whereupon yum promptly UNinstalled 5.1 community client AND server (with no prompt or warning).
Bottom line: the final sentence of this article "It's a good idea to rebuild and reinstall [Perl, PHP and Python modules]. "Good idea"???? You can't proceed unless you uninstall them, and then where are the replacements that are compatible? I realize that it's not the job of mysql to provide them, but if upgrading MySQL results in no Perl, Python or PHP to interact with it, perhaps something more helpful could be mentioned here.
I just did a upgrade from 5.0 to 5.1
Worked fine with yum. In comment #1 its likely a RPM name that caused issue.
I was on mysql.i386 5.0.22-2.2.el5_1.1 and upgraded to
mysql.i386 5.1.29-2.1
OS :RHEL 5
I did mysql_upgrade /tmp
So far I have not see any major issues.
John
Add your own comment.