BackupBuddy Multisite

From IThemes Codex
(Difference between revisions)
Jump to: navigation, search
(Limitations of Multisite)
(Introduction)
 
(24 intermediate revisions by 5 users not shown)
Line 1: Line 1:
BackupBuddy Multisite is the '''NEW BETA''' feature of the latest BackupBuddy which allows you to backup, migrate, restore OR copy your Multisite from one location to another, or back to the same location. '''BETA''' means that at this time, any new error or problem may occur including, but not limited to, the restore not importing image links properly, sub-domains OR sub-directory paths giving permalink errors, helping your cat escape from your home, and more.
+
=Introduction=
  
This page is updated regularly every week, since we are working with all our Multisite customers DAILY in getting more features, fixes and enhancements into BackupBuddy Beta updates as fast as we can. Soon, the BETA status will be removed to signify the official fully supported and fully tested '''BackupBuddy Multisite''' release. [http://ithemes.com/codex/index.php?title=BackupBuddy_Multisite&action=submit#Support_Questions Please let us know of any suggestions or questions in the forums]!
+
Multisite support is an '''EXPERIMENTAL FEATURE''' provided in BackupBuddy to AID you in importing and exporting subsites with Multisite. Due to the nature of Multisite, we cannot provide the same level of thoroughness in migrations as with standalone sites. You should NOT expect as smooth of an experience and we only recommend advanced users attempt to use Multisite functionality due to this. As WordPress Multisite functionality is much more technically complex, some BackupBuddy features available for standalone sites are NOT supported for Multisite environments. Please carefully review the features, differences and limitations so that you are aware of them and are sure it will meet your needs.
  
As of version 2.2.14, the single BackupBuddy product contains BOTH the standard BackupBuddy AND the new BackupBuddy Multisite Beta. Your single BackupBuddy does it all!
 
  
=Getting BackupBuddy Multisite=
+
'''BackupBuddy Multisite is an EXPERIMENTAL product.'''  As such, you ''may encounter issues'' using it and we cannot necessarily insure flawless functionality or that issues encountered will be resolved in as timely manner as non-experimental features.  Usage of it in a production environment is at your own risk; Import/Export functionality is quite solid but Network migrations have some issues which require additional intervention to fully complete if the URL changes (see limitations below for full details). There is currently not a specific ETA on when the EXPERIMENTAL tag will be removed. It will be removed once we believe Multisite functionality to be as solid and reliable as the BackupBuddy standalone many have come to love.
  
====BackupBuddy Backup Plugin====
 
BackupBuddy Multisite BETA is now an integral part of BackupBuddy itself. You simply [http://pluginbuddy.com/purchase/backupbuddy/ Get BackupBuddy] and then download it from your [http://ithemes.com/member/member.php Member's Area].
 
  
====BackupBuddy's IMPORTBUDDY.PHP File====
+
'''Installation note:'''
The importbuddy.php file, which is the awesome file that helps you MIGRATE/RESTORE your BackupBuddy backups, now has a BETA version also that is used when you want to migrate or restore your BackupBuddy Multisite backups. You must use the BETA importbuddy.php to restore/migrate any BackupBuddy Multisite backup file.
+
BackupBuddy Multisite support is EXPERIMENTAL software and should NOT be used on live sites. BackupBuddy should be Network Activated when installed on a Multisite Network for experimental testing. You must add the following line to your wp-config.php to activate these experimental features: define( 'PB_BACKUPBUDDY_MULTISITE_EXPERIMENT', true );
  
* Here is an image of your '''BackupBuddy --> Backup & Restore''' area, where the latest BETA importbuddy.php download link is:
+
=Features & Limitation Notes=
**[[File:Download-importbuddy-bes-zain.png|Image of where the latest BETA importbuddy.php download link is]]
+
  
=Installing BackupBuddy Multisite=
+
'''IMPORTANT: BackupBuddy Multisite does NOT support migrating entire Networks to a different URL. If you attempt to do so then only the main site URLs will be migrated and you must manually update all subsite URLs, for instance using the Server Information Page's Mass Database Replace Tool.'''
  
Since BackupBuddy Multisite BETA is now part of BackupBuddy, the Installation steps are now integrated and the differences explained in the [http://ithemes.com/codex/page/Installing_BackupBuddy standard BackupBuddy Installation] section.
+
* '''Backup entire Multisite Network'''
 +
** Limitations:
 +
***As a Network can contain many subsites, each subsite increases the amount of time needed to perform a backup, especially if the sites are large.  This can demand more server resources or more PHP runtime.  Most shared hosting does not permit increasing these resources so BackupBuddy may not be able to finish backups under these conditions.  If you have access to modify these settings, Maximum PHP runtime is a key setting to increase as needed.
 +
*** WordPress 3.5 Multisite has introduced multiple problems with site imports related with both file uploads and user imports. Some workarounds: http://ithemes.com/forum/topic/37186-backupbuddy-ms-import-not-working-on-wp-35-multisite/
  
=Running Backup, Migrating OR Restoring with BackupBuddy Multisite BETA=
+
* '''Restore entire Multisite Network (same server & URLs)'''
 +
** Limitation: As a Network can contain many subsites, each subsite increases the amount of time needed to perform a restore, especially if the sites are large.  This can demand more server resources or more PHP runtime.  Most shared hosting does not permit increasing these resources so BackupBuddy may not be able to finish restores under these conditions.  If you have access to modify these settings, Maximum PHP runtime is a key setting to increase as needed.
  
Here is an actual video, from one of our many webinars (we have many regular webinars planned), with details on how to migrate or restore with BackupBuddy:
+
* '''Migrate entire Multisite Network (different server or URLs)'''
 +
** Limitation: When migrating a Network to a new server or changing URLs, domains, or moving a Network in or out of a subdirectory, BackupBuddy will only migrate the database tables associated with the MAIN site. Due to technical reasons BackupBuddy currently will not automatically migrate URLs or paths of any other subsites within the migrated network.  If the URLs or paths of subsites need to be updated you may perform this procedure by using the 'Mass Database Text Replacement' tool on the 'Server Information' page within BackupBuddy for each subsite you need to update.
 +
** Limitation: You cannot change from sub-domains to sub-directory URL structure using BackupBuddy Multisite nor can you change from sub-directories to sub-domain URL structure.
 +
** Limitation: As a Network can contain many subsites, each subsite increases the amount of time needed to perform a migration, especially if the sites are large.  This can demand more server resources or more PHP runtime.  Most shared hosting does not permit increasing these resources so BackupBuddy may not be able to finish migrations under these conditions.  If you have access to modify these settings, Maximum PHP runtime is a key setting to increase as needed.
  
{{#ev:youtube|WYhLIK3KfK4|600|BackupBuddy Multisite}}
+
* '''Export a subsite from the Network'''
 +
** Exported subsites may be imported back into the same network (AKA Duplicated), imported into another Network, or restored as a standalone WordPress site using the importbuddy.php tool.
 +
** Limitation: The main Network [sub]site cannot be exported as it is tied to the Network. It is still included in the main Network backup however.
  
 +
* '''Import an exported subsite into the Network'''
 +
** No known limitations beyond those of normal BackupBuddy.
  
== How To Copy, Clone or Duplicate a Sub-Site ==
+
* '''Import a backed up standalone site into the Network'''
 +
** No known limitations beyond those of normal BackupBuddy.
  
 +
* '''Restore or Migrate an exported subsite as a standalone site'''
 +
** No known limitations beyond those of normal BackupBuddy.
  
Before you begin, ensure that BackupBuddy is enabled for multisite as detailed earlier within this codex.
+
=Running Backup, Migrating OR Restoring with BackupBuddy Multisite EXPERIMENTAL=
  
1. Within the Multisite Network Admin panel, create your "template" subsite in the usual manner.
+
Here is an actual video, from one of our many webinars (we have many regular webinars planned), with details on how to migrate or restore with BackupBuddy. Note: Some functionality has changed and improved since this video was made. It is not the latest version.
  
2. Visit the dashboard of your template subsite and and configure it with the needed theme, plugins, categories, etc.
+
{{#ev:youtube|WYhLIK3KfK4|600|BackupBuddy Multisite}}
  
3. Under the BackupBuddy menu, click "Duplicate (Beta)."
+
=Frequently Asked Questions=
  
4. Enter a name to duplicate your "template" site into.  
+
====Are multiple Multisite databases supported?====
 
+
No. A couple of plugins, such as Multi-DB allow Multisite networks to run on multiple databases instead of the normal one. We do not currently support this custom 3rd party configuration.
5. Click "Duplicate Site."
+
 
+
6. All done!
+
 
+
=Frequently Asked Questions=
+
  
 
====WordPress Multisite Domain Mapping and BackupBuddy Multisite====
 
====WordPress Multisite Domain Mapping and BackupBuddy Multisite====
  
BackupBuddy Multisite works perfectly with WordPress Multisite Domain Mapping. Here is a detailed video of what is possible and how it's exactly done (better to see something in addition to reading about it too ;) ):
+
Domain mapping was confirmed by customers to work in pre-v3.0 BackupBuddy versions. It has not been officially tested with > 3.0 versions. Customer reports of success/failure are welcomed. Note: Some functionality has changed and improved since this video was made. It is not the latest version.
  
 
{{#ev:youtube|oDM5v2Ymk1M|600|BackupBuddy Multisite}}
 
{{#ev:youtube|oDM5v2Ymk1M|600|BackupBuddy Multisite}}
 
====Limitations of Multisite====
 
 
There are 2 limitations (and for good reasons) in WordPress Multisite itself which BackupBuddy of course goes through automatically:
 
* 1 : If your multisite install is sub-domain based, you cannot migrate or restore to a sub-directory within your web root.
 
* 2 : You cannot change from sub-domains to sub-directories using BackupBuddy Multisite.  You can not use BackupBuddy to migrate from a sub-domain based install to sub-directories or vice-versa.
 
* 3 : You can not move a Network in or out of a subdirectory with BackupBuddy normally; this feature is only available for standalone sites and exported Multisite subsites. Ie http://yoursite.com/mynetwork/ to http://newsite.com/ or vice-versa. If you attempt to do so then only the main site / network URLs will be updated to reflect this. There is a feature on the BackupBuddy Server Information page to do mass URL replacements which you may use to manually update URLs of subsites if you must have this functionality.
 
 
====Known Issues====
 
 
The following are known issues of BackupBuddy Multisite:
 
 
* 1 : You can not currently migrate a Multiste installation to a sub-directory, or migrate a Multisite installation based in a sub-directory back to the root of the domain.  We are currently working on enabling this feature.
 
* 2:  You can not duplicate a mapped domain.  We are currently working on enabling this feature.
 
  
 
====Support Questions====
 
====Support Questions====
  
All BackupBuddy Multisite support questions can be asked in the official [http://ithemes.com/forum/backupbuddy-ms/ BackupBuddy Multisite Forums].  
+
BackupBuddy Multisite support questions can be asked in the official [http://ithemes.com/forum/forum/120-backupbuddy-multisite/ BackupBuddy Multisite Forums].  
  
All non-Multisite related BackupBuddy support questions can be asked in the official [http://ithemes.com/forum/backupbuddy/ BackupBuddy Forums].
+
non-Multisite related BackupBuddy support questions can be asked in the official [http://ithemes.com/forum/backupbuddy/ BackupBuddy Forums].
  
All BackupBuddy Pre-Sales questions, for Multisite OR non-Multisite backups and restores/migrations, can be asked on the [http://ithemes.com/forum/pre-sales-and-other-inquiries/ Pre-Sales Forums], via the Live Chat (the Panda icon on top of [http://pluginbuddy.com/purchase/backupbuddy/ Get BackupBuddy Multisite] page), or by emailing sales@ithemes.com
+
BackupBuddy Pre-Sales questions, for Multisite OR non-Multisite backups and restores/migrations, can be asked on the [http://ithemes.com/forum/pre-sales-and-other-inquiries/ Pre-Sales Forums], via the Live Chat (the Panda icon on top of [http://pluginbuddy.com/purchase/backupbuddy/ Get BackupBuddy Multisite] page), or by emailing sales@ithemes.com
  
 
=Additional Resources=
 
=Additional Resources=

Latest revision as of 09:34, August 5, 2013

Contents

Introduction

Multisite support is an EXPERIMENTAL FEATURE provided in BackupBuddy to AID you in importing and exporting subsites with Multisite. Due to the nature of Multisite, we cannot provide the same level of thoroughness in migrations as with standalone sites. You should NOT expect as smooth of an experience and we only recommend advanced users attempt to use Multisite functionality due to this. As WordPress Multisite functionality is much more technically complex, some BackupBuddy features available for standalone sites are NOT supported for Multisite environments. Please carefully review the features, differences and limitations so that you are aware of them and are sure it will meet your needs.


BackupBuddy Multisite is an EXPERIMENTAL product. As such, you may encounter issues using it and we cannot necessarily insure flawless functionality or that issues encountered will be resolved in as timely manner as non-experimental features. Usage of it in a production environment is at your own risk; Import/Export functionality is quite solid but Network migrations have some issues which require additional intervention to fully complete if the URL changes (see limitations below for full details). There is currently not a specific ETA on when the EXPERIMENTAL tag will be removed. It will be removed once we believe Multisite functionality to be as solid and reliable as the BackupBuddy standalone many have come to love.


Installation note: BackupBuddy Multisite support is EXPERIMENTAL software and should NOT be used on live sites. BackupBuddy should be Network Activated when installed on a Multisite Network for experimental testing. You must add the following line to your wp-config.php to activate these experimental features: define( 'PB_BACKUPBUDDY_MULTISITE_EXPERIMENT', true );

Features & Limitation Notes

IMPORTANT: BackupBuddy Multisite does NOT support migrating entire Networks to a different URL. If you attempt to do so then only the main site URLs will be migrated and you must manually update all subsite URLs, for instance using the Server Information Page's Mass Database Replace Tool.

  • Backup entire Multisite Network
    • Limitations:
      • As a Network can contain many subsites, each subsite increases the amount of time needed to perform a backup, especially if the sites are large. This can demand more server resources or more PHP runtime. Most shared hosting does not permit increasing these resources so BackupBuddy may not be able to finish backups under these conditions. If you have access to modify these settings, Maximum PHP runtime is a key setting to increase as needed.
      • WordPress 3.5 Multisite has introduced multiple problems with site imports related with both file uploads and user imports. Some workarounds: http://ithemes.com/forum/topic/37186-backupbuddy-ms-import-not-working-on-wp-35-multisite/
  • Restore entire Multisite Network (same server & URLs)
    • Limitation: As a Network can contain many subsites, each subsite increases the amount of time needed to perform a restore, especially if the sites are large. This can demand more server resources or more PHP runtime. Most shared hosting does not permit increasing these resources so BackupBuddy may not be able to finish restores under these conditions. If you have access to modify these settings, Maximum PHP runtime is a key setting to increase as needed.
  • Migrate entire Multisite Network (different server or URLs)
    • Limitation: When migrating a Network to a new server or changing URLs, domains, or moving a Network in or out of a subdirectory, BackupBuddy will only migrate the database tables associated with the MAIN site. Due to technical reasons BackupBuddy currently will not automatically migrate URLs or paths of any other subsites within the migrated network. If the URLs or paths of subsites need to be updated you may perform this procedure by using the 'Mass Database Text Replacement' tool on the 'Server Information' page within BackupBuddy for each subsite you need to update.
    • Limitation: You cannot change from sub-domains to sub-directory URL structure using BackupBuddy Multisite nor can you change from sub-directories to sub-domain URL structure.
    • Limitation: As a Network can contain many subsites, each subsite increases the amount of time needed to perform a migration, especially if the sites are large. This can demand more server resources or more PHP runtime. Most shared hosting does not permit increasing these resources so BackupBuddy may not be able to finish migrations under these conditions. If you have access to modify these settings, Maximum PHP runtime is a key setting to increase as needed.
  • Export a subsite from the Network
    • Exported subsites may be imported back into the same network (AKA Duplicated), imported into another Network, or restored as a standalone WordPress site using the importbuddy.php tool.
    • Limitation: The main Network [sub]site cannot be exported as it is tied to the Network. It is still included in the main Network backup however.
  • Import an exported subsite into the Network
    • No known limitations beyond those of normal BackupBuddy.
  • Import a backed up standalone site into the Network
    • No known limitations beyond those of normal BackupBuddy.
  • Restore or Migrate an exported subsite as a standalone site
    • No known limitations beyond those of normal BackupBuddy.

Running Backup, Migrating OR Restoring with BackupBuddy Multisite EXPERIMENTAL

Here is an actual video, from one of our many webinars (we have many regular webinars planned), with details on how to migrate or restore with BackupBuddy. Note: Some functionality has changed and improved since this video was made. It is not the latest version.


Frequently Asked Questions

Are multiple Multisite databases supported?

No. A couple of plugins, such as Multi-DB allow Multisite networks to run on multiple databases instead of the normal one. We do not currently support this custom 3rd party configuration.

WordPress Multisite Domain Mapping and BackupBuddy Multisite

Domain mapping was confirmed by customers to work in pre-v3.0 BackupBuddy versions. It has not been officially tested with > 3.0 versions. Customer reports of success/failure are welcomed. Note: Some functionality has changed and improved since this video was made. It is not the latest version.


Support Questions

BackupBuddy Multisite support questions can be asked in the official BackupBuddy Multisite Forums.

non-Multisite related BackupBuddy support questions can be asked in the official BackupBuddy Forums.

BackupBuddy Pre-Sales questions, for Multisite OR non-Multisite backups and restores/migrations, can be asked on the Pre-Sales Forums, via the Live Chat (the Panda icon on top of Get BackupBuddy Multisite page), or by emailing sales@ithemes.com

Additional Resources

Official Pages

Blog Posts

Personal tools
Namespaces
Variants
Actions
iThemes Codex
Codex Navigation
Toolbox