After you've made the Complete (Full) backup, you can send this backup file to the new location in several different ways:

+

After you've made the Complete (Full) backup, you can '''send this backup file''' to the new location in several different ways:

+

+

<br />

−

*Upload to the new location through FTP

+

*[[BackupBuddy:_Manual_Migration#Uploading_through_FTP|Upload to the new location through FTP]]

−

*Send the backup file from BackupBuddy in the dashboard of your original site

+

*[[BackupBuddy:_Manual_Migration#Sending_from_the_Dashboard|Send the backup file from BackupBuddy in the dashboard of your original site]]

−

*Upload through ImportBuddy

+

*[[BackupBuddy:_Manual_Migration#Uploading_through_ImportBuddy|Upload through ImportBuddy]]

−

*Select the backup file you want to use from Stash

+

*[[BackupBuddy:_Manual_Migration#Selecting_from_BackupBuddy_Stash|Select the backup file you want to use from Stash]]

<br />

<br />

Line 25:

Line 29:

===Uploading through FTP===

===Uploading through FTP===

−

If you chose to manually migrate through FTP, follow these instructions:

+

If you chose to manually upload the backup file through FTP, follow these instructions:

<br />

<br />

−

#'''Download''' - Navigate to '''BackupBuddy > Restore/Migrate''' in your dashboard and download the backup file you'd like to use for the migration and a copy of the ImportBuddy script.<br /><br /><br />[[File:BUBPrepDownload.png|frame|none|Downloading the ImportBuddy and backup files|link=]]<br /><br /><br />

+

#'''Download the backup file''': Navigate to '''BackupBuddy > Restore/Migrate''' in your dashboard and download the backup file you'd like to use for the migration and a copy of the ImportBuddy script.<br /><br /><br />[[File:BUBPrepDownload.png|frame|none|Downloading the ImportBuddy and backup files|link=]]<br /><br /><br />

−

#'''Decide the Directory for the Migration''' - Decide the FTP directory to migrate or restore the backup to that corresponds to the web URL for your site's destination. '''Note:''' Using an empty directory is best. <br /><br />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>. '''Note:''' The directory structure varies host to host but often follows a similar format.<br /><br />

+

#'''Decide the Directory for the Migration''': Decide the FTP directory to migrate or restore the backup to that corresponds to the web URL for your site's destination. '''Note:''' Using an empty directory is best. <br /><br />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>. '''Note:''' The directory structure varies host to host but often follows a similar format.<br /><br />

−

#'''Upload''' - Once you've decided on the FTP directory, you will then upload the backup file ('''don't rename the zip file!''') and a copy of your Importbuddy file to your chosen directory via FTP.<br /><br />

+

#'''Upload''': Once you've decided on the FTP directory, you will then upload the backup file ('''don't rename the zip file!''') and a copy of your Importbuddy file to your chosen directory via FTP.<br /><br />

−

#'''Navigate to the uploaded ImportBuddy URL''' - Using the example directory configuration above, navigate to <code><nowiki>http://your.com/mybuddy/importbuddy.php</nowiki></code>. ImportBuddy will then walk you through the [[BackupBuddy:_Manual_Migration#The_6_ImportBuddy_Steps_for_Manual_Migrations|6 ImportBuddy Steps for Manual Migrations]].<br /><br />

+

#'''Navigate to the uploaded ImportBuddy URL''': Using the example directory configuration above, navigate to <code><nowiki>http://your.com/mybuddy/importbuddy.php</nowiki></code>. ImportBuddy will then walk you through the [[BackupBuddy:_Manual_Migration#The_6_ImportBuddy_Steps_for_Manual_Migrations|6 ImportBuddy Steps for Manual Migrations]].<br /><br />

#Follow the [[BackupBuddy:_Manual_Migration#The_6_ImportBuddy_Steps_for_Manual_Migrations|6 ImportBuddy Steps for Manual Migrations]] until the restore / migration is complete.

#Follow the [[BackupBuddy:_Manual_Migration#The_6_ImportBuddy_Steps_for_Manual_Migrations|6 ImportBuddy Steps for Manual Migrations]] until the restore / migration is complete.

Line 75:

Line 79:

<br />

<br />

−

===Selecting from Stash===

+

===Selecting from BackupBuddy Stash===

<br />

<br />

−

#In [[BackupBuddy:_Manual_Migration#Step_1:_Choose_your_backup_file|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).<br /><br /><br />[[File:Selectfromstash.png|link=]]<br /><br /><br />

+

#In [[BackupBuddy:_Manual_Migration#Step_1:_Choose_your_backup_file|ImportBuddy's Step 1]], you can login to your [[BackupBuddy_Stash:_Introduction|BackupBuddy Stash]] account and select the backup file that you'd like to use (this will be covered in more detail Step 1).<br /><br /><br />[[File:Selectfromstash.png|link=]]<br /><br /><br />

#You still, however, have to either [[BackupBuddy:_ImportBuddy_Rough_Draft#Uploading_ImportBuddy_to_your_destination_server|upload ImportBuddy to your new server location]] or [[BackupBuddy:_ImportBuddy_Rough_Draft#Sending_ImportBuddy_to_Destination|send it through the dashboard]] to the new location.<br /><br />

#You still, however, have to either [[BackupBuddy:_ImportBuddy_Rough_Draft#Uploading_ImportBuddy_to_your_destination_server|upload ImportBuddy to your new server location]] or [[BackupBuddy:_ImportBuddy_Rough_Draft#Sending_ImportBuddy_to_Destination|send it through the dashboard]] to the new location.<br /><br />

#'''Navigate to the uploaded ImportBuddy URL''' - Using your directory configuration, navigate to the location of the ImportBuddy file you just sent. '''Example:''' <code><nowiki>http://your.com/mybuddy/importbuddy.php</nowiki></code>. ImportBuddy will then walk you through the [[BackupBuddy:_Manual_Migration#The_6_ImportBuddy_Steps_for_Manual_Migrations|6 ImportBuddy Steps for Manual Migrations]].<br /><br />

#'''Navigate to the uploaded ImportBuddy URL''' - Using your directory configuration, navigate to the location of the ImportBuddy file you just sent. '''Example:''' <code><nowiki>http://your.com/mybuddy/importbuddy.php</nowiki></code>. ImportBuddy will then walk you through the [[BackupBuddy:_Manual_Migration#The_6_ImportBuddy_Steps_for_Manual_Migrations|6 ImportBuddy Steps for Manual Migrations]].<br /><br />

Line 126:

Line 130:

==='''Step 3: URL and Database Settings'''===

==='''Step 3: URL and Database Settings'''===

−

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

+

Step 3 is where you will enter the database settings for the new location. Use your host's cPanel to create a database or use the [[BackupBuddy:_Manual_Migration#Creating_a_Database_through_cPanel|'''Have cPanel? Click to create a database''']] option.

+

+

<br />

+

+

[[File:Step3-URLDatabasesettings.png|link=]]

+

+

<br />

#Enter the following '''URL settings''':

#Enter the following '''URL settings''':

Line 137:

Line 147:

##'''Database Pass''' - This is the password for the database user.

##'''Database Pass''' - This is the password for the database user.

##'''Database Prefix''' - This is the prefix given to all tables in the database. If you are cloning the site on the same server AND the same database name then you will want to change this or else the imported database will overwrite the existing tables.

##'''Database Prefix''' - This is the prefix given to all tables in the database. If you are cloning the site on the same server AND the same database name then you will want to change this or else the imported database will overwrite the existing tables.

+

#Once you've entered all the new database information or created your new database, you will need to test the settings. 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. Click '''Test Database Settings''' to start the test.<br /><br /><br />[[File:Step3-testsettings.png|link=]]<br /><br /><br />

+

#Once the test is successful, click '''Next Step'''.

<br />

<br />

Line 142:

Line 154:

====Creating a Database through cPanel====

====Creating a Database through cPanel====

−

#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 through cPanel''' in ImportBuddy's Step 3. To create your database, click the '''Have cPanel? Create <br /><br /><br />[[File:Step3CreateDB.png|Step3CreateDB.png|link=]]<br /><br /><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 through cPanel''' in ImportBuddy's Step 3. To create your database, click the '''Have cPanel? Click to create a database''' button. <br /><br /><br />[[File:Step3CreateDB.png|Step3CreateDB.png|link=]]<br /><br /><br />

−

+

#In the window that opens, you can automatically create a database along with a new database user with permissions. Fill out the required information and then click '''Create Database'''.<br /><br /><br />[[File:Cpanel-database.png|link=]]<br /><br /><br />

−

<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. 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.

−

+

−

[[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.

+

<br />

<br />

Line 173:

Line 171:

[[File:Screen_Shot_2013-08-13_at_12.33.53_PM.png|link=]]

[[File:Screen_Shot_2013-08-13_at_12.33.53_PM.png|link=]]

+

+

<br />

+

+

Note: '''Advanced options''' are also available during Step 4. These advanced options allow customizations of various ImportBuddy functionality for custom purposes or troubleshooting. Exercise caution as some advanced options may have unforseen effects if not used properly, such as overwriting existing files or erasing existing database content.

Uploading through FTP

If you chose to manually upload the backup file through FTP, follow these instructions:

Download the backup file: Navigate to BackupBuddy > Restore/Migrate in your dashboard and download the backup file you'd like to use for the migration and a copy of the ImportBuddy script.

Downloading the ImportBuddy and backup files

Decide the Directory for the Migration: Decide the FTP directory to migrate or restore the backup to that corresponds to the web URL for your site's destination. Note: Using an empty directory is best.

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/. Note: The directory structure varies host to host but often follows a similar format.

Upload: Once you've decided on the FTP directory, you will then upload the backup file (don't rename the zip file!) and a copy of your Importbuddy file to your chosen directory via FTP.

Navigate to the uploaded ImportBuddy URL: Using the example directory configuration above, navigate to http://your.com/mybuddy/importbuddy.php. ImportBuddy will then walk you through the 6 ImportBuddy Steps for Manual Migrations.

Sending from the Dashboard

Instead of manually uploading the backup file and your copy of ImportBuddy to your new server, you can send them directly from within BackupBuddy.
To send from the dashboard, follow these instructions:

Go to BackupBuddy > Restore/Migrate and click the Send ImportBuddy to a Destination button to send your ImportBuddy file to the new server.

Next, hover over the backup file you'd like to use and click the Send File link.

Clicking both the Send ImportBuddy to a Destination button and the Send File link will open your destinations window. From here, 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.

Navigate to the uploaded ImportBuddy URL - Using your directory configuration, navigate to the location of the ImportBuddy file you just sent. Example:http://your.com/mybuddy/importbuddy.php. ImportBuddy will then walk you through the 6 ImportBuddy Steps for Manual Migrations.

Navigate to the uploaded ImportBuddy URL - Using your directory configuration, navigate to the location of the ImportBuddy file you just sent. Example:http://your.com/mybuddy/importbuddy.php. ImportBuddy will then walk you through the 6 ImportBuddy Steps for Manual Migrations.

Navigate to the uploaded ImportBuddy URL - Using your directory configuration, navigate to the location of the ImportBuddy file you just sent. Example:http://your.com/mybuddy/importbuddy.php. ImportBuddy will then walk you through the 6 ImportBuddy Steps for Manual Migrations.

The 6 ImportBuddy Steps for Manual Migrations

After navigating to the URL file location of ImportBuddy, ImportBuddy will walk you through the 6 ImportBuddy Steps for manual migrations.

Step 1: Authentication Required & Choose Your Backup File

You'll be prompted to Enter your ImportBuddy password to continue. For more information about setting your ImportBuddy password, visit the ImportBuddy Password page.

Step 1 also prompts you to choose your backup file for the migration. These file options are divided into three tabs: Server, Upload and Stash.

Server - This tab lists backup files currently on the server. Select one to use for the migration.

Upload - Upload a backup file from your computer's web browser up to this server.

Stash - Retrieve a backup file stored on BackupBuddy Stash (iThemes' cloud backup storage) and pull it to this server for restoring. Login to your Stash account and select the backup you'd like to use by clicking the Import button.

WordPress Address - This is the address where you want the final WordPress site you are restoring / migrating to reside. Ex: http://foo.com/wp

Use optional custom site address (Home URL)? - OPTIONAL. This is also known as the site address. This is the home address where your main site resides. This may differ from your WordPress URL. For example: http://foo.com

Enter the following Database Settings: These settings control where your backed up database will be restored to. If you are restoring to the same server, the settings below will import the database to your existing WordPress database location, overwriting your existing WordPress database already on the server. If you are moving to a new host you will need to create a database to import into. The database settings MUST be unique for each WordPress installation. If you use the same settings for multiple WordPress installations then all blog content and settings will be shared, causing conflicts!

MySQL Server - This is the address to the mySQL server where your database will be stored. 99% of the time this is localhost. The location of your mySQL server will be provided to you by your host if it differs.

Database Name - This is the name of the database you want to import your blog into. The database user must have permissions to be able to access this database. If you are migrating this blog to a new host you will need to create this database (ie using CPanel or phpmyadmin) and create a mysql database user with permissions.

Database User - This is the database user account that has permission to access the database name in the input above. This user must be given permission to this database for the import to work.

Database Pass - This is the password for the database user.

Database Prefix - This is the prefix given to all tables in the database. If you are cloning the site on the same server AND the same database name then you will want to change this or else the imported database will overwrite the existing tables.

Once you've entered all the new database information or created your new database, you will need to test the settings. 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. Click Test Database Settings to start the test.

Once the test is successful, click Next Step.

Creating a Database through cPanel

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 through cPanel in ImportBuddy's Step 3. To create your database, click the Have cPanel? Click to create a database button.

In the window that opens, you can automatically create a database along with a new database user with permissions. Fill out the required information and then click Create Database.

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. 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.

Note: Advanced options are also available during Step 4. These advanced options allow customizations of various ImportBuddy functionality for custom purposes or troubleshooting. Exercise caution as some advanced options may have unforseen effects if not used properly, such as overwriting existing files or erasing existing database content.

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. You may view your entire import log for providing to support by clicking the View Import Log button.

Once you've tested your new site, you can move to the final step by clicking Clean up & remove temporary files.

Simple Problems & Solutions

Clicking on a posts results in a 404 Not Found - This is typically caused by a problem with your .htaccess file. Log into your wp-admin, navigate to Settings: Permalinks in the WordPress menu and click the "Save" button to update permalink settings to your .htaccess file. This typically resolves this problem.

Logging in redirects back to the old site - This is usually caused by entering the source site URL as the destination URL on Step 3. Re-restoring using the correct URL should fix this problem.

Source site has changed to the destination URL - This is caused if you restored over your source site database by entering the source site database settings on Step 3. You may re-restore using correct settings. You may correct the modified URL on the source site by using the Server Information page's Mass Text Replace tool.

Step 6: Final Cleanup

Step 6 removes any temporary files from your new site that were used for the migration. Your site will then be ready at the URL indicated on this page.