BackupBuddy: Manual Migration

(Difference between revisions)
Jump to: navigation, search
m
Line 1: Line 1:
====Restoring/Migrating Using a Database Backup====
+
=Manual Migration=
[[File:Databasebackup.png]]
+
  
You need 3 things for using a database backup to restore or migrate your site:
 
  
* database backup
+
==Getting Started: Make a Backup==
* importbuddy.php
+
* all of your site files from the site you are trying to copy
+
  
 +
When migrating a site with BackupBuddy, you need to make sure that the new location you are migrating to is "clean."  There should be no WordPress files at the new location.
  
1. (Assuming you have already created database backup) Download the database backup you want to use, and importbuddy.php.
+
Before you start the manual migration process, '''make a complete backup''' by going to BackupBuddy > Backup in your WordPress dashboard.
  
2. Now use FTP, SSH, or your hosts control panel to copy/move all of the site files from the site you wish to restore/migrate.
+
<br />
  
3. Move/upload the Database backup, importbuddy.php, and all of your site files to the directory where you want your site to take place.  
+
[[File:CompleteBackup.png|CompleteBackup.png|link=]]
  
4. Navigate to http://yourwebaddress.com/importbuddy.php in your browser and run through the import process as normal.
+
<br />
 +
 
 +
==Manual Migration Methods==
 +
 
 +
You can send the backup file to the new location a couple of different ways:
 +
 
 +
*Upload to the new location through FTP
 +
*Send the backup file from BackupBuddy in the dashboard of your original site
 +
*Upload through ImportBuddy
 +
*Select the backup file you want to use from Stash
 +
 
 +
<br />
 +
 
 +
----
 +
 
 +
<br />
 +
 
 +
===Uploading through FTP===
 +
 
 +
If you chose to do this through FTP, you will need to upload the backup file and and a copy of the importbuddy.php file to your chosen location. 
 +
 
 +
To get these files, you can go to '''BackupBuddy > Restore/Migrate''' in your dashboard and download both the backup file you'd like to use and a copy of ImportBuddy.
 +
 
 +
<br />
 +
 
 +
[[File:BUBPrepDownload.png|frame|none|Downloading the ImportBuddy and backup files|link=]]
 +
 
 +
<br />
 +
 
 +
You then need to decide on the FTP directory that you would like to migrate or restore the backup to (using an empty directory is best) that corresponds to the web URL you want your destination site to be at.
 +
 
 +
For example, if you want your new site's URL to be <code><nowiki>http://your.com/mybuddy/</nowiki></code> then your server directory MIGHT be something like this: <code>/user/username/public_html/mybuddy/</code>. This is the directory you will then put importbuddy.php and backup file ('''don't rename the zip file!''') into. The directory structure varies host to host but often follows a similar format.
 +
 
 +
<br />
 +
 
 +
----
 +
 
 +
<br />
 +
 
 +
===Sending from the Dashboard===
 +
 
 +
Instead of having to upload the backup file and your copy of importbuddy.php to your new server, you can send them directly from BackupBuddy in your dashboard. 
 +
 
 +
To do this go to BackupBuddy > Restore/Migrate and click the Send ImportBuddy to a Destination button to send your importbuddy.php file to the new server.  Then hover over the backup file you'd like to use and click the Send File link.
 +
 
 +
<br />
 +
 
 +
[[File:BUBPrepSend.png|frame|none|Sending ImportBuddy and Backup File|link=]]
 +
 
 +
<br />
 +
 
 +
Clicking both the Send ImportBuddy to a Destination button and the Send File link will open your destinations window.
 +
 
 +
<br />
 +
 
 +
[[File:BUBPrepSendDestinations.png|BUBPrepSendDestinations.png|link=]]
 +
 
 +
<br />
 +
 
 +
There, you can either create a new destination to send your files to or select from one of the remote destinations you've created previously.  You can also check to "'''Delete local backup''' after successful send" if you'd like the file to be removed from your current server after the send. 
 +
 
 +
<br />
 +
 
 +
----
 +
 
 +
<br />
 +
 
 +
===Uploading through ImportBuddy===
 +
 
 +
In ImportBuddy's Step 1, you can opt to upload your backup file there (this will be covered in more detail Step 1).  You still, however, have to either upload importbuddy.php to your new server location or send it through the dashboard to the new location. 
 +
 
 +
<br />
 +
 
 +
----
 +
 
 +
<br />
 +
 
 +
===Selecting from Stash===
 +
 
 +
In ImportBuddy's Step 1, you can login to your Stash account and select the backup file that you'd like to use (this will be covered in more detail Step 1).  You still, however, have to either upload importbuddy.php to your new server location or send it through the dashboard to the new location. 
 +
 
 +
<br />
 +
 
 +
----
 +
 
 +
<br />
 +
 
 +
==The 6 ImportBuddy Steps for Manual Migrations==
 +
 
 +
ImportBuddy will now walk you through the 6 migration steps.
 +
 
 +
<br />
 +
 
 +
===Step 1: Choose your backup file===
 +
 
 +
Step 1 allows you to select the backup file that you'd like to use.  When doing a manual migration, you can:
 +
 
 +
<br />
 +
 
 +
* '''Select a backup on your server'''
 +
 
 +
<br />
 +
 
 +
[[File:Step1Server.png|Step1Server.png|link=]]
 +
 
 +
<br />
 +
 
 +
*'''Upload your backup file'''
 +
 
 +
<br />
 +
 
 +
[[File:Step1Upload.png|Step1Upload.png|link=]]
 +
 
 +
<br />
 +
 
 +
* '''Login to your Stash account and select the backup you'd like to use.'''
 +
 
 +
<br />
 +
 
 +
[[File:Step1Stash.png|Step1Stash.png|link=]]
 +
 
 +
<br />
 +
 
 +
On Step 1 is where you'll find the Advanced Options.  Select any optional advanced options if needed or directed by technical support.  Once you've selected your Advanced Options or if you do not need to select any of these options, click Next Step
 +
 
 +
<br />
 +
 
 +
[[File:Step1AdvancedOptions.png|Step1AdvancedOptions.png|link=]]
 +
 
 +
<br />
 +
 
 +
==='''Step 2: Unzipping Backup File'''===
 +
 
 +
Step 2 unzips the backup file.  There is nothing you need to do for this step.  Just select Next Step once the extraction has completed.
 +
 
 +
<br />
 +
 
 +
[[File:Step2.png|Step2.png|link=]]
 +
 
 +
<br />
 +
 
 +
==='''Step 3: URL and Database Settings'''===
 +
 
 +
Step 3 is where you will enter all the database settings for the new location.
 +
 
 +
<br />
 +
 
 +
[[File:BUBStep3IB.png|BUBStep3IB.png|link=]]
 +
 
 +
<br />
 +
 
 +
If you haven't set up a database for the new location, but have access to cPanel for the new site, you can create your new database in ImportBuddy's Step 3.
 +
 
 +
<br />
 +
 
 +
[[File:Step3CreateDB.png|Step3CreateDB.png|link=]]
 +
 
 +
<br />
 +
 
 +
<br />
 +
 
 +
[[File:Step3cPanel.png|Step3cPanel.png|link=]]
 +
 
 +
<br />
 +
 
 +
Once you've entered all the new database information or created your new database, you will need to test the settings before you can move on to the next step.
 +
 
 +
<br />
 +
 
 +
[[File:Step3Test.png|Step3Test.png|link=]]
 +
 
 +
<br />
 +
 
 +
If the test is successful, you will be able to move on to Step 4.  If the test fails, however, verify all of your database settings are correct and run the test again.
 +
 
 +
==='''Step 4: Database Import'''===
 +
 
 +
Step 4 imports the database information into the database of your new site.  Once the import is completed, click the Next Step button.
 +
 
 +
<br />
 +
 
 +
[[File:BUBStep4IB.png|BUBStep4IB.png|link=]]
 +
 
 +
<br />
 +
 
 +
==='''Step 5: Database Migration'''===
 +
 
 +
Step 5 updates all of the URLs, paths, etc. on your site to match your new site.  Before you move to the final step, be sure to go to your new site and check all of your links to ensure they have changed.  Once you've tested your new site, you can move to the final step. 
 +
 
 +
<br />
 +
 
 +
[[File:Step5.png|Step5.png|link=]]
 +
 
 +
<br />
 +
 
 +
==='''Step 6: Final Cleanup'''===
 +
 
 +
Step 6 removes any temporary files from your new site that were used for the migration. 
 +
 
 +
<br />
 +
 
 +
[[File:Step6.png|Step6.png|link=]]
 +
 
 +
<br />
 +
 
 +
==Manual Migration Tutorial==
 +
 
 +
{{#ev:vimeo|59949774|400}}
 +
 
 +
<br />
 +
 
 +
=Migrating Using a Database Backup=
 +
 
 +
<br />
 +
 
 +
[[File:DBOnlyBackup.png|DBOnlyBackup.png|link=]]
 +
 
 +
<br />
 +
 
 +
The only difference between migrating a site with a complete backup and a database only backup is that in your new location, you'll go ahead and upload WordPress to the new location. 
 +
 
 +
You'll place a copy of importbuddy.php and your database only backup file in the new location via any of the [[#Manual Migration Methods|methods]] listed in the manual migration steps, go to <nowiki>yourdomainname.com/importbuddy.php</nowiki> and follow the [[#The 6 ImportBuddy Steps for Manual Migrations|6 ImportBuddy steps]]

Revision as of 15:00, August 8, 2013

Contents

Manual Migration

Getting Started: Make a Backup

When migrating a site with BackupBuddy, you need to make sure that the new location you are migrating to is "clean." There should be no WordPress files at the new location.

Before you start the manual migration process, make a complete backup by going to BackupBuddy > Backup in your WordPress dashboard.


CompleteBackup.png


Manual Migration Methods

You can send the backup file to the new location a couple of different ways:

  • Upload to the new location through FTP
  • Send the backup file from BackupBuddy in the dashboard of your original site
  • Upload through ImportBuddy
  • Select the backup file you want to use from Stash




Uploading through FTP

If you chose to do this through FTP, you will need to upload the backup file and and a copy of the importbuddy.php file to your chosen location.

To get these files, you can go to BackupBuddy > Restore/Migrate in your dashboard and download both the backup file you'd like to use and a copy of ImportBuddy.


Downloading the ImportBuddy and backup files


You then need to decide on the FTP directory that you would like to migrate or restore the backup to (using an empty directory is best) that corresponds to the web URL you want your destination site to be at.

For example, if you want your new site's URL to be http://your.com/mybuddy/ then your server directory MIGHT be something like this: /user/username/public_html/mybuddy/. This is the directory you will then put importbuddy.php and backup file (don't rename the zip file!) into. The directory structure varies host to host but often follows a similar format.




Sending from the Dashboard

Instead of having to upload the backup file and your copy of importbuddy.php to your new server, you can send them directly from BackupBuddy in your dashboard.

To do this go to BackupBuddy > Restore/Migrate and click the Send ImportBuddy to a Destination button to send your importbuddy.php file to the new server. Then hover over the backup file you'd like to use and click the Send File link.


Sending ImportBuddy and Backup File


Clicking both the Send ImportBuddy to a Destination button and the Send File link will open your destinations window.


BUBPrepSendDestinations.png


There, you can either create a new destination to send your files to or select from one of the remote destinations you've created previously. You can also check to "Delete local backup after successful send" if you'd like the file to be removed from your current server after the send.




Uploading through ImportBuddy

In ImportBuddy's Step 1, you can opt to upload your backup file there (this will be covered in more detail Step 1). You still, however, have to either upload importbuddy.php to your new server location or send it through the dashboard to the new location.




Selecting from Stash

In ImportBuddy's Step 1, you can login to your Stash account and select the backup file that you'd like to use (this will be covered in more detail Step 1). You still, however, have to either upload importbuddy.php to your new server location or send it through the dashboard to the new location.




The 6 ImportBuddy Steps for Manual Migrations

ImportBuddy will now walk you through the 6 migration steps.


Step 1: Choose your backup file

Step 1 allows you to select the backup file that you'd like to use. When doing a manual migration, you can:


  • Select a backup on your server


Step1Server.png


  • Upload your backup file


Step1Upload.png


  • Login to your Stash account and select the backup you'd like to use.


Step1Stash.png


On Step 1 is where you'll find the Advanced Options. Select any optional advanced options if needed or directed by technical support. Once you've selected your Advanced Options or if you do not need to select any of these options, click Next Step


Step1AdvancedOptions.png


Step 2: Unzipping Backup File

Step 2 unzips the backup file. There is nothing you need to do for this step. Just select Next Step once the extraction has completed.


Step2.png


Step 3: URL and Database Settings

Step 3 is where you will enter all the database settings for the new location.


BUBStep3IB.png


If you haven't set up a database for the new location, but have access to cPanel for the new site, you can create your new database in ImportBuddy's Step 3.


Step3CreateDB.png



Step3cPanel.png


Once you've entered all the new database information or created your new database, you will need to test the settings before you can move on to the next step.


Step3Test.png


If the test is successful, you will be able to move on to Step 4. If the test fails, however, verify all of your database settings are correct and run the test again.

Step 4: Database Import

Step 4 imports the database information into the database of your new site. Once the import is completed, click the Next Step button.


BUBStep4IB.png


Step 5: Database Migration

Step 5 updates all of the URLs, paths, etc. on your site to match your new site. Before you move to the final step, be sure to go to your new site and check all of your links to ensure they have changed. Once you've tested your new site, you can move to the final step.


Step5.png


Step 6: Final Cleanup

Step 6 removes any temporary files from your new site that were used for the migration.


Step6.png


Manual Migration Tutorial


Migrating Using a Database Backup


DBOnlyBackup.png


The only difference between migrating a site with a complete backup and a database only backup is that in your new location, you'll go ahead and upload WordPress to the new location.

You'll place a copy of importbuddy.php and your database only backup file in the new location via any of the methods listed in the manual migration steps, go to yourdomainname.com/importbuddy.php and follow the 6 ImportBuddy steps

Personal tools
Namespaces
Variants
Actions
iThemes Codex
Codex Navigation
Toolbox