BackupBuddy: ImportBuddy

From iThemes Codex
Revision as of 19:22, 24 April 2012 by Akers (talk | contribs) (Step 3)
Jump to: navigation, search

Getting Started

The following will describe what is needed to start migrating or restoring a backup.

  • Download ImportBuddy from within BackupBuddy by navigating to the `Backup & Restore` page and clicking the `ImportBuddy` or `Restore / Migrate` button depending on your version.
  • Decide on the server directory that you would like to migrate or restore the backup to (using an empty directory is best).
  • Upload importbuddy.php and the backup zip file (don't rename the zip file!) to that directory.
  • Navigate to the importbuddy.php file in your web browser after it has been uploaded.
    • Example:
  • Follow the directions provided for each ImportBuddy step.
  • If you encounter problems note the logging information displayed on the problem step when contacting support.

Step 0: Password Authentication

This step asks for the password associated with the importbuddy.php file.

  • Is set in BackupBuddy's Settings page and required to continue.
    • The password is attached to the importbuddy.php file when it is made so if you change the password will need to download and upload a new importbuddy.php file

Step 1

On this step there is a dropdown list of the backup zip files that can be restored or use to migrate with. Also has an Upload tab to upload a backup .zip file by browsing for it.

This step also allows the user to set advanced troubleshooting options to customize the importbuddy process.

  • Wipe database on import. Use with caution.
    • This option will blank out the current database at the location so can use same database for import, if not the option you needed/wanted to use then could lose data in the database
  • Ignore SQL errors & hide them.
  • Skip zip file extraction.
    • This option is mainly used if the files are manually being unzipped instead of using the importbuddy file extraction process.
  • Skip import of database.
  • Skip migration of database.
  • Skip migration of .htaccess file.
  • Force medium speed compatibility mode (ZipArchive).
  • Force slow speed compatibility mode (PCLZip).
  • Show detailed PHP warnings.
  • PHP Maximum Execution Time
    • Setting this a little lower can help force importbuddy to chunk the importing and migration of the database into multiple steps if large
  • Error Logging to importbuddy.txt

Step 2

The file extraction process occurs during this step, and the extraction method used is displayed.

Step 3

This step is used to set the URL and database connection information. The information shown in parentheses is what importbuddy sees the values where previously, useful for a restore when most if not all of the information will be the same.

  • WordPress Address
    • This field will be pre-set using the information for the current directory the user is restoring/migrating to.
  • 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.
    • The most common prefix is wp_ which is fine to use but if you want to use something else that is fine.

After entering the database information there is a button labelled "test database settings" that will test the validity of that connection information.

Step 4

The database information is imported straight into the database.

Step 5

Importbuddy looks through the database and updates any URLs, paths, settings, etc. The wp-config.php information is set and the links are changed during this step.

  • Use the link of the site provided to verify that the site is fully migrated and complete before continuing to step 6.
  • Can choose which of the import files get deleted in next step if desired. By default is all of them.

Step 6

Cleanup step. This step attempts to delete

  • backup zip archive
  • importbuddy.php
  • temporary import files (db_1.sql, backupbuddy_dat.php, etc.)
  • importbuddy.txt log file