Migrating MySQL 5.0 to 5.1

Now available in Cloud Sites - MySQL 5.1!  

Read on to learn the process of migrating your current Cloud Sites running MySQL 5.0 to begin running on a MySQL 5.1 database.  

Migrating your sites to a newer version of MySQL will require a maintenance period during which your sites will be unavailable.  To minimize the impact of the migration, you just need to plan ahead and control the timing and presentation of your site during the process.Here is an easy-to-follow, five-step process for migrating a MySQL 5.0 database to a MySQL 5.1 database:


Step 1 - Close the Blinds and Lock the Doors

  • Begin by putting up a splash page on your site stating that you are currently migrating and then revoke all user access to the database to be migrated.  You can successfully revoke access to the database by using your administrative priveleges to rename the configuration file containing your database link information to a filename with the .mig extension.  An example would be naming the config.php file to config.php.mig.  Once the filename is changed wait for user transactions to be completed or kill them.  Threads can be killed with the KILL statement.  To learn more, consult the MySQL documentation from their website and see the section KILL Syntax.  To determine if all user connections have been completed or successfully killed, use the command SHOW FULL PROCESSLIST. To learn more about this command, please consult the MySQL documentation from their website and look for the section SHOW PROCESSLIST Syntax


Step 2 - Back it Up!


Step 3 - Create Your New Database

  • You will next need to provision a new MySQL 5.1 database to contain the newly migrated database.  Do this by following the instructions in our Knowledge Center article: Adding a MySQL Database.


Step 4 - Import Your Saved DB Backup

  • The next step is to import your saved database backup into your newly provisioned MySQL 5.1 database. You should be able to use the PHPmyAdmin Database Management Interface to handle imports for databases which are less than 16MB in size without issue.  There may be times where you need to import more than 16MB of data, in which case you should follow the directions in the Knowledge Center article How to Import a Large MySQL Database.


Step 5 - Update Your References

  • Finally, you will need to modify all references in your code/configuration files from the old database server host name, IP address, username, and password to the respective new locations and values on the newly provisioned and migrated database server.  Rename the config file back to its original name without the .mig extension.  Assuming your new user information is valid, the site should begin processing against the new database in the same manner as before.


© 2015 Rackspace US, Inc.

Except where otherwise noted, content on this site is licensed under a Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License

See license specifics and DISCLAIMER