BackupBuddy: Error Codes

From IThemes Codex
Revision as of 17:37, August 29, 2011 by Dustin (Talk | contribs)
Jump to: navigation, search

Contents

9001

Unable to read database table wp_redirection_logs. Your backup will not include data from this table (you may ignore this warning if you do not need this specific data). This is due to the following error: MySQL client ran out of memory in /www/wp-content/plugins/backupbuddy/backupbuddy.php on line 1757

  • MySQL client ran out of memory
    • This is typically caused by your PHP memory limit being low, resulting in part of the data returned being clipped. If you do not need the data from this specific table of the database to be backed up then you may safely ignore this. Some tables, such as wp_redirection_logs, contain logs that you most likely do not need.
    • BackupBuddy attempts to increase the PHP memory limit on runtime but many hosts block this.
    • Add/modify this line in your php.ini with a higher number than the default, such as: php_value memory_limit 128M
    • PHP memory is separate from mysql memory. Your host has to up the mysql memory as it is not possible for you the client to do so at all.
  • Unable to save result set
    • This is typically caused by a corrupt database/table. Citation of problem.
    • Repair the database/table using a tool such as phpMyAdmin or the free plugin WP-dbManager
    • Add this line to wp-config.php to allow WordPress to repair tables: define('WP_ALLOW_REPAIR', true)
  • MySQL server has gone away
    • MySQL server is dying, this is mostly a host issue. Probably need to contact host to get them to fix the issue.
  • WordPress Revisions may also be clogging up the system

9002

Unable to create temporary storage directory ((/www/wp-content/uploads/temp_xxxxxxxxxx)

  • This error means that BackupBuddy was unable to create a temporary storage directory at the location listed in the error message. BackupBuddy must temporarily create this directory to place temporary files to be backed up into the ZIP file.
  • Adjust permissions to allow write & directory creation access to your uploads folder. ie: /www/wp-content/uploads/

9003

BackupBuddy data file (backupbuddy_dat.php) missing or unreadable. There may be a problem with the backup file, the files could not be extracted (you may manually extract the zip file in this directory to manually do this portion of restore), or the files were deleted before this portion of the restore was reached. Start the import process over or try manually extracting (unzipping) the files then starting over. Restore will not continue to protect integrity of any existing data.

  • This error is often caused by the importbuddy.php script being replaced by an older version during the unzip step. See importbuddy overwriting on unzip
  • This error is often caused by the server timing out before zip file extraction could complete.
    • Manually extract files using either cPanel or extracting (unzipping) the files locally then uploading them & selecting the importbuddy.php advanced option to skip file extraction.
    • Ask your server host to extend the maximum script execution time.
    • Create a custom php.ini file if your host allows for this.
    • Change hosts & let your current host know why you changed.
  • Additional potential causes (very rare):
    • File permissions not allowing reading of the backupbuddy_dat.php file.
    • Incomplete backup. Verify the backup is marked as Good on the source site.

9004

Error! The unzip process reported success but the backup data file, backupbuddy_dat.php was not found in the extracted files. The unzip process either failed (most likely) or the zip file is not a proper BackupBuddy backup. (importbuddy.php)

  • Manually extract backup ZIP. This usually resolves this issue.
  • Force compatibility mode to see if it able to unzip to completion.
  • Contact the host to see if they can verify that the Linux command line ZIP is set up properly.

9005

File extraction process did not complete successfully. Unable to continue to next step. Manually extract the backup ZIP file and choose to "Skip File Extraction" from the advanced options on Step 1. (importbuddy.php)

  • This ZIP file was unable to be extracted for some reason.
    • Unzipping may have taken too long and the PHP process halted.
    • Server memory usage may have been exceeded.
    • Server configuration may be blocking extracting of ZIP files.
  • Attempt manual extraction & disable File Extraction from the advanced debugging options of Step 1.

9006

ERROR: Unable to connect to database server and/or log in. Verify the database server name, username, and password. (importbuddy.php)

  • Verify the server address, your username, and your password. One of these settings is wrong.
  • cPanel sometimes prefixes your username with a prefix. Check if this exists.

9007

Unable to select your specified database. Verify the database name and that you have set up proper permissions for your specified username to access it. (importbuddy.php)

  • Verify the database name exists.
  • Verify the mysql username has been granted ALL permissions to this database.

9008

ERROR: A database prefix is required for importing. (importbuddy.php)

  • You must specify a WordPress database table prefix. Default is "wp_" without quotes.

9009

ERROR: Unable to find any database backup data in the selected backup. (importbuddy.php)

  • Database file is missing from the backup.

9010

ERROR: Unable to import SQL query: (importbuddy.php)

  • Something went wrong attempting to import this row into the database.
  • If it says duplicate table or row then the user is importing/migrating into a database that has an existing WordPress installation with the same prefix. This could cause problems if it's a different install or a lot has changed.

9011

ERROR #9011. FTP/FTPs login failed on scheduled FTP. Credentials: username:password@server.com.

  • Unable to log in to FTP or FTPs server due to a problem with the login credentials. Verify your username and password.

9012

FTP/FTPs file upload failed. Check file permissions & disk quota. Details: [additional details here]

  • BackupBuddy was able to connect to the FTP server but was not able to upload the file.
  • Verify file permissions allow writing and that enough disk space is available.

9013

Sorry! PHP version x.x or newer is required for BackupBuddy to properly run. You are running PHP version x.x.x.

  • BackupBuddy currently requires PHP 5.x. See the Sales page or BackupBuddy codex page for the latest version requirements.
  • Most hosts allow you to change the PHP version from their control panel.

9014

Fatal error. The database already contains a WordPress installation with this prefix (27 tables). Restore has been stopped to prevent overwriting existing data. Please go back and enter a new database name and/or prefix OR clear our your database prior to restoring again.

  • WordPress already exists in the database/prefix combo entered.
  • Choose a new prefix, database, or delete the existing WordPress tables from the database.

9015

Temp data directory is not writable. Check your permissions. (#directory#)

  • Verify user permissions for this directory. Make sure the user can create & write files.
  • Use SUPHP so PHP will run as your user. This insures it will have proper file/directory permissions.

9016

Archive file is not writable. is not writable. Check your permissions. (#directory#)

  • Verify user permissions for this directory. Make sure the user can create & write files.
  • Use SUPHP so PHP will run as your user. This insures it will have proper file/directory permissions.

9017

Temp data file is not creatable/writable. Check your permissions. (#directory#)

  • Verify user permissions for this directory. Make sure the user can create & write files.
  • Use SUPHP so PHP will run as your user. This insures it will have proper file/directory permissions.

9018

Database file is not creatable/writable. Check your permissions. (#directory#)

  • Verify user permissions for this directory. Make sure the user can create & write files.
  • Use SUPHP so PHP will run as your user. This insures it will have proper file/directory permissions.

9019

Invalid or corrupt AJAX data. (#DATA#)

  • The backup data sent by the browser was invalid. Refresh and try again.
  • Make sure you are using a modern browser on a stable internet connection.

9020

Unable to write to file [.htaccess/wp-config.php]. Permissions are preventing this file from being modified.

  • Verify write permissions are properly configured for this file. Suggestion: 755.
  • For .htaccess: Another option is to delete the .htaccess file & in the WordPress admin navigate to Settings: Permalinks & click the Save button to regenerate the file.

9021

PHP Timeout or Fatal Error Occurred

  • "The page did not finish loading as expected. The most common cause for this is the PHP process taking more time than it has been allowed by your host (php.ini setting max_execution_time). If a PHP error is displayed above this can also cause this error. "
  • Increase the maximum allowed PHP runtime by contacting your host or creating a php.ini file to override host settings (if allowed).
  • If on the unzip step, manually extract the ZIP file on your local PC then upload or use another server-based software such as cpanel.

Additional Resources

  1. BackupBuddy: Advanced Debugging
  2. Purchase BackupBuddy
  3. PluginBuddy Tutorials
  4. PluginBuddy.com
  5. Support Forums
Personal tools
Namespaces
Variants
Actions
iThemes Codex
Codex Navigation
Toolbox