Difference between revisions of "BackupBuddy Multisite: Introduction"

From iThemes Codex
Jump to: navigation, search
Line 1: Line 1:
BackupBuddy Multisite support is an '''EXPERIMENTAL FEATURE''' provided in BackupBuddy to AID you in importing and exporting sub-sites 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'''.  
+
'''Important''': BackupBuddy Multisite functionality is EXPERIMENTAL and NOT officially supported. Multiple issues are known. Usage of it is at your own risk and should not be relied upon. Standalone WordPress sites are suggested. You may use the "Export" feature to export your subsites into standalone WordPress sites. Not all Standalone features are available  for Multisite installations. Please carefully review the features, differences and limitations so that you are aware of them and are sure it will meet your needs.
  
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.
 
  
'''Again, BackupBuddy Multisite is an EXPERIMENTAL product'''. As such, we cannot support any issues encountered. '''Usage of it in a production environment is at your own risk.'''
+
You must add the following line to your <code>wp-config.php</code> to activate these experimental features:
 +
<pre class="brush: php gutter:false">
 +
define( 'PB_BACKUPBUDDY_MULTISITE_EXPERIMENT', true );
 +
</pre>
 +
 
 +
 
 +
==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) -- Use Caution==
 +
* 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.
  
'''There is currently not a specific ETA on when the EXPERIMENTAL tag will be removed'''. 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 for full details).  
+
* '''Restore or Migrate an exported subsite as a standalone site'''
 +
** No known limitations beyond those of normal BackupBuddy.
  
'''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 <code>wp-config.php</code> to activate these experimental features:
+
==WordPress Multisite Domain Mapping and BackupBuddy Multisite==
  
<br />
+
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.
  
<pre class="brush: php gutter:false">
+
{{#ev:youtube|oDM5v2Ymk1M|600|center|BackupBuddy Multisite}}
define( 'PB_BACKUPBUDDY_MULTISITE_EXPERIMENT', true );
+
 
</pre>
+
=Running Backup, Migrating OR Restoring with BackupBuddy Multisite EXPERIMENTAL=
  
=See also=
+
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.
  
*[[BackupBuddy_Multisite:_Introduction|Introduction]]
+
{{#ev:youtube|WYhLIK3KfK4|600|center|BackupBuddy Multisite}}
*[[BackupBuddy_Multisite:_Features_and_Limitations|Features and Limitations]]
 
  
 
<br />
 
<br />
 
[[:BackupBuddy|← Back to BackupBuddy Codex Home]]
 
[[:BackupBuddy|← Back to BackupBuddy Codex Home]]

Revision as of 05:20, 5 May 2015

Important: BackupBuddy Multisite functionality is EXPERIMENTAL and NOT officially supported. Multiple issues are known. Usage of it is at your own risk and should not be relied upon. Standalone WordPress sites are suggested. You may use the "Export" feature to export your subsites into standalone WordPress sites. Not all Standalone features are available for Multisite installations. Please carefully review the features, differences and limitations so that you are aware of them and are sure it will meet your needs.


You must add the following line to your wp-config.php to activate these experimental features:

define( 'PB_BACKUPBUDDY_MULTISITE_EXPERIMENT', true );


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) -- Use Caution

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

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.

BackupBuddy Multisite

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.

BackupBuddy Multisite


← Back to BackupBuddy Codex Home