In this KB:
- How to create backup of webfiles before migration
- How to download webfiles backup to Cloudways server
- How to backup database before migration
- How to restore backup to your new Cloudways server
- How to configure Magento post-migration
- How to take your Magento site live from Cloudways
In this tutorial, we will show you how you can migrate your Magento store to Cloudways using an SSH terminal (command line). You need some basic knowledge of command line usage to be able to complete the process.
Step 1: Creating Backup of Webfiles
If you have SSH access to your current server, you can simplify the process by making an archive of your entire site first by using ‘tar’ command. Run the following in your Magento’s webroot/public_html directory.
tar -czf backup.tar.gz *
This will create a compressed file which we will need to download to our Cloudways server.
Step 2: Downloading the Backup File to Your Cloudways Server
You can transfer the backup file to your Cloudways servers by using ‘wget’ or ‘scp’ command. In this tutorial we are using wget to transfer the backup.
To do this, login to your Cloudways server using your SSH user, Make sure you are in the “Public_html” directory where your site should be located. Then run the following commands.
tar -xzf backup.tar.gz
This will decompress contents in the current folder.
Once above is done you should remove the “backup.tar.gz” from your old server.
Step 3: Backup the Database
In this step you will make a backup of the database in your old server. To backup your database we recommend using SSH or a tool like phpMyAdmin.
Log in to your old server with SSH as we did in step 1. Once there run the following command (replace dbUsername and dbName with the database name and database user name from your old setup):
mysqldump -u dbUsername -p dbName > db_backup.sql
This will create a “dump” of your database and save it as db_backup.sql in the current directory. If you don’t have SSH access, contact your current host for assistance on how to backup the database.
Step 4: Restoring the Database on Your New Cloudways Server
Now we will restore the database dump we took into our Cloudways server. Again, open an SSH session to your Cloudways server with the appropiate credentials and run the following commands (replace dbUsername and dbName with the database name and user name that you can find in the application tab of your Cloudways console):
mysql -u dbUsername -p password dbName < db_backup.sql
This will download the backup file from your old server to your Cloudways server and restore the data into the database named as “dbName”.
Remove the ‘db_backup.sql’ from your old server once you successfully restored the database.
Step 5: Update Magento Configuration Settings
Edit Magento configuration file to use the cloudways server database.
Open the file “local.xml” under the “public_html/app/etc/” directory with your favorite text editor. Here we have used vim to edit the “local.xml” file as shown above. Remove the old entries and input the new cloudways application details.
(tip: You can also use the SFTP File Manager for file modification)
Save the file and exit.
Step 6: Clear the Magento Cache
Go to the folder “var/cache” inside your magento root directory (“Public_html”) and remove any file or folder that may exist.
Make sure you are in “/var/cache” before running the command above!
You are all set!. You should now be able to open your Magento website from your Cloudways server. You can check that all is working fine updating your local hosts file and pointing to your Cloudways server.
Once you are happy with how your site works on the new server, you can proceed to make the necessary DNS changes to take your website live from Cloudways.