BackupBuddy: ImportBuddy - Revision history

Chrisjaeger: /* Step 1 */

2013-04-24T18:30:07Z

Step 1

Chrisjaeger: /* Step 1 */

2013-04-24T18:28:42Z

Step 1

Dustin at 09:25, October 11, 2012

2012-10-11T09:25:19Z

Dustin at 09:15, October 11, 2012

2012-10-11T09:15:14Z

Akers: /* Step 3 */

2012-04-24T19:22:41Z

Step 3

Akers: updated whole page: steps up to date, spacing

2012-01-24T20:47:30Z

updated whole page: steps up to date, spacing

Akers at 20:36, January 24, 2012

2012-01-24T20:36:43Z

Akers at 20:35, January 24, 2012

2012-01-24T20:35:51Z

Akers: getting started section, clarifications

2011-12-31T00:55:53Z

getting started section, clarifications

Skylermoore at 14:26, April 28, 2011

2011-04-28T14:26:15Z

@@ Line 38: / Line 38: @@
 ==Step 1==
-NOTE: You do not need to first install WordPress on the target hosting server.
+NOTE: You DO NOT need to first install WordPress on the target hosting server.
 On this step a listing of backup files that were found in the same directory as the importbuddy.php script are listed for your selection to restore / migrate. If you have not already uploaded your backup file along with the importbuddy.php file an upload feature is available for convenience. However, ''FTP is the best way to upload your backup archives (.zip files), especially for larger files.''.

@@ Line 38: / Line 38: @@
 ==Step 1==
 On this step a listing of backup files that were found in the same directory as the importbuddy.php script are listed for your selection to restore / migrate. If you have not already uploaded your backup file along with the importbuddy.php file an upload feature is available for convenience. However, ''FTP is the best way to upload your backup archives (.zip files), especially for larger files.''.
@@ Line 70: / Line 72: @@
 * 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
 ==Step 2==

@@ Line 17: / Line 17: @@
 * Follow the directions provided for each ImportBuddy step.
 * If you encounter problems note the logging information displayed on the problem step when contacting support.
 ==Log In - Password Authentication==
@@ Line 95: / Line 100: @@
 ==Step 4==
-The database information is imported straight into the database.
+The database information is imported straight into the database. Your database with any old URLs / paths from the source server exist temporarily on the destination server. The next step will update this data in 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.
+If your destination URL and/or file paths need to be updating due to using a new site URL or server directory stucture then ImportBuddy will proceed to migrate various data inside your database. Importbuddy searches through the database and updates any URLs, paths, settings, etc. that match your source site's settings (BackupBuddy recorded these settings for you in the backup for this functionality to work). The wp-config.php information (such as any new database settings) is set.
 * 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.
@@ Line 105: / Line 110: @@
 ==Step 6==
-Cleanup step. This step attempts to delete
+Cleanup step. This step attempts to delete any temporary files created by ImportBuddy or uploaded by you. If your restore is fully complete you can delete all of these files (assuming you have your backup zip stored elsewhere). Leaving these files could potentially be a security risk. If ImportBuddy is unable to delete these files please use your FTP client or web host's file management tools to delete them.
-* backup zip archive
+* Backup zip archive (.zip file)
-* importbuddy.php
+* ImportBuddy Tool - importbuddy.php file (the tool you are using right now)
-* temporary import files (db_1.sql, backupbuddy_dat.php, etc.)
+* Any temporary import files (db_1.sql, backupbuddy_dat.php, etc.)
-* importbuddy.txt log file
+* importbuddy-XXXXXXX.txt log file
 [[Category:PluginBuddy]]

@@ Line 1: / Line 1: @@
 {{#ev:vimeo|22918787|400|right}}
 ==Getting Started==
-The following will describe what is needed to start migrating or restoring a backup.
+===Getting the ImportBuddy tool===
-* Download ImportBuddy from within BackupBuddy by navigating to the `Backup & Restore` page and clicking the `ImportBuddy` or `Restore / Migrate` button depending on your version.
+The ImportBuddy tool can be downloaded in BackupBuddy.
-* 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 `Backup & Restore` page.
 * Navigate to the importbuddy.php file in your web browser after it has been uploaded.
 ** Example: <nowiki>http://newsite.com/importbuddy.php</nowiki>
@@ Line 10: / Line 18: @@
 * 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. ImportBuddy requires this to protect unauthorized access to your site and backup files before you have finished restoring. This password was previously set by you (or someone) on BackupBuddy's Settings page.
 This step asks for the password associated with the importbuddy.php file.
-* Is set in BackupBuddy's Settings page and required to continue.
+''Typical Usage''
-** 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
+* Enter your password.
 ==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.
+On this step a listing of backup files that were found in the same directory as the importbuddy.php script are listed for your selection to restore / migrate. If you have not already uploaded your backup file along with the importbuddy.php file an upload feature is available for convenience. However, ''FTP is the best way to upload your backup archives (.zip files), especially for larger files.''.
-This step also allows the user to set advanced troubleshooting options to customize the importbuddy process.
+''Typical Usage''
-* Wipe database on import. Use with caution.
+* Select the backup you want to restore or migrate to this destination.
-** 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
+* Select any optional advanced options if needed or directed by technical support.
-* Ignore SQL errors & hide them.
+* Submit the form to continue.
 * Skip zip file extraction.
-** This option is mainly used if the files are manually being unzipped instead of using the importbuddy file extraction process.
+** If enabled then Step 2 of ImportBuddy will skip unzipping / extracting your backup ZIP file. You will need to manually unzip the file somehow, such as on your local system and then uploading all files, or with a server-side tool such as within your host's control panel file manager (if available).
 * 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
 ==Step 2==
-The file extraction process occurs during this step, and the extraction method used is displayed.
+The file extraction process occurs during this step. ImportBuddy attempts to unzip / extract your backup ZIP archive (.zip file) into the same directory as the importbuddy.php script.
 ==Step 3==

@@ Line 55: / Line 55: @@
 * 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.
-After entering the database information there is a button labelled "test database settings" that will test the validity of that connection information.
+** 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==