Changed: | |||||||||||||||||
< < | Backup & Restore Plugin - Beta Version | ||||||||||||||||
> > | Backup & Restore Plugin | ||||||||||||||||
<-- Contributions to this plugin are appreciated. Please update the plugin page at http://twiki.org/cgi-bin/view/Plugins/BackupRestorePlugin or provide feedback at http://twiki.org/cgi-bin/view/Plugins/BackupRestorePluginDev. If you are a TWiki contributor please update the plugin in the SVN repository. --> Overview | |||||||||||||||||
Changed: | |||||||||||||||||
< < | This is a solution to backup, restore and upgrade TWiki sites. It can be used via browser and on the command line. This plugin is pre-installed in TWiki-5.1 and later releases; it can be installed in older TWiki releases as low as TWiki-2001-09-01 (Athens Release) to easily create a backup that can be restored on a new TWiki release. This offers an easy upgrade path for TWiki. | ||||||||||||||||
> > | This is a solution to backup, restore, and upgrade TWiki sites. It can be used via the browser and on the command line. This plugin is pre-installed in TWiki-5.1 and later releases. It can be installed in older TWiki releases as oldas TWiki-2001-09-01 (Athens Release) to easily create a backup that can be restored on a new TWiki release. This offers an easy upgrade path for TWiki. | ||||||||||||||||
Changed: | |||||||||||||||||
< < | This plugin backs up page data, attachment data, the plugin workspace area and the TWiki configuration. However, it does not backup the TWiki engine, additional plugins and skins you might have installed. It is recommended to do a manual backup of the whole twiki directory after installing plugins and skins. | ||||||||||||||||
> > | This plugin backs up page data, attachment data, the plugin workspace area, and the TWiki configuration. However, it does not backup the TWiki engine, additional plugins, and skins you might have installed. It is recommended to do a manual backup of the whole twiki directory after installing plugins and skins. | ||||||||||||||||
Web-based OperationThe backup and restore functionality is restricted to members of the TWikiAdminGroup. | |||||||||||||||||
Changed: | |||||||||||||||||
< < | Once configured, visit the BackupRestoreConsole to: | ||||||||||||||||
> > | Once configured, visit the BackupRestoreConsole to: | ||||||||||||||||
How to Upgrade TWikiThe TWikiUpgradeGuide describes how to manually upgrade TWiki. It is much easier to use the BackupRestorePlugin to do a TWiki upgrade. Follow these steps:
Command Line Utility and Cron | |||||||||||||||||
Changed: | |||||||||||||||||
< < | The backuprestore utility can be used to create a backup (scheduled or manually), to copy a backup and to check on the status of the backup process. | ||||||||||||||||
> > | The backuprestore utility can be used to create a backup (scheduled or manually), to copy a backup, and to check on the status of the backup process. | ||||||||||||||||
10 0 * * 0 (cd /path/to/twiki/bin; ./backuprestore create_backup >/dev/null 2>&1)Make sure the plugin is configured properly before creating backups. The backup destination can be local or remote. If remote, the remote server needs to be mounted on the TWiki server via NFS or the like. Specification
Syntax RulesThis section is only relevant to plugin developers. This plugin handles a%BACKUPRESTORE{"..."}% variable to perform all web-based operations. The variable is used in the BackupRestoreConsole page.
%BACKUPRESTORE{"..."}% parameters:
| |||||||||||||||||
Changed: | |||||||||||||||||
< < |
| ||||||||||||||||
> > |
| ||||||||||||||||
Limitations and To-Do | |||||||||||||||||
Changed: | |||||||||||||||||
< < |
| ||||||||||||||||
> > |
| ||||||||||||||||
Added: | |||||||||||||||||
> > |
| ||||||||||||||||
License and Bug ReportingThis plugin has been reasonably tested. If you find any issues please file a bug report at TWikibug:BackupRestorePlugin. This plugin is distributed under GPL (GNU General Public License) in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.Plugin Installation & Configuration | |||||||||||||||||
Changed: | |||||||||||||||||
< < | Note: You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the TWiki server. This plugin is pre-installed in TWiki-5.1.0 and newer. | ||||||||||||||||
> > | This plugin is pre-installed from TWiki-5.1 on. TWiki administrators can upgrade the plugin as needed on the TWiki server. | ||||||||||||||||
Added: | |||||||||||||||||
> > | <--/twistyPlugin twikiMakeVisibleInline--> | ||||||||||||||||
| |||||||||||||||||
Added: | |||||||||||||||||
> > | <--/twistyPlugin--> | ||||||||||||||||
Plugin Info
| |||||||||||||||||
Changed: | |||||||||||||||||
< < |
| ||||||||||||||||
> > |
| ||||||||||||||||
Added: | |||||||||||||||||
> > |
| ||||||||||||||||
| |||||||||||||||||
Changed: | |||||||||||||||||
< < |
| ||||||||||||||||
> > |
| ||||||||||||||||
Added: | |||||||||||||||||
> > | mode="div"
showlink="Show Change History https://wiki.ivoa.net/internal/TWiki/TWikiDocGraphics/toggleopen.gif"
hidelink="Hide Change History "
}%
| ||||||||||||||||
| |||||||||||||||||
Added: | |||||||||||||||||
> > | </> <--/twistyPlugin--> | ||||||||||||||||
| |||||||||||||||||
Changed: | |||||||||||||||||
< < |
| ||||||||||||||||
> > |
| ||||||||||||||||
Added: | |||||||||||||||||
> > |
| ||||||||||||||||
Backup & Restore Plugin - Beta Version<-- Contributions to this plugin are appreciated. Please update the plugin page at http://twiki.org/cgi-bin/view/Plugins/BackupRestorePlugin or provide feedback at http://twiki.org/cgi-bin/view/Plugins/BackupRestorePluginDev. If you are a TWiki contributor please update the plugin in the SVN repository. --> | |||||||||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||||||||
< < | Introduction | ||||||||||||||||||||||||||||||
> > | Overview | ||||||||||||||||||||||||||||||
This is a solution to backup, restore and upgrade TWiki sites. It can be used via browser and on the command line. This plugin is pre-installed in TWiki-5.1 and later releases; it can be installed in older TWiki releases as low as TWiki-2001-09-01 (Athens Release) to easily create a backup that can be restored on a new TWiki release. This offers an easy upgrade path for TWiki. | |||||||||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||||||||
< < | Note: The initial plugin release does not yet offer the restore functionality. Check TWiki:Plugins.BackupRestorePlugin for updates. | ||||||||||||||||||||||||||||||
> > | This plugin backs up page data, attachment data, the plugin workspace area and the TWiki configuration. However, it does not backup the TWiki engine, additional plugins and skins you might have installed. It is recommended to do a manual backup of the whole twiki directory after installing plugins and skins. | ||||||||||||||||||||||||||||||
Added: | |||||||||||||||||||||||||||||||
> > | |||||||||||||||||||||||||||||||
Web-based OperationThe backup and restore functionality is restricted to members of the TWikiAdminGroup. Once configured, visit the BackupRestoreConsole to:
| |||||||||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||||||||
< < | Screenshot: | ||||||||||||||||||||||||||||||
> > | Screenshot of Backup & Restore Console, overview: | ||||||||||||||||||||||||||||||
Added: | |||||||||||||||||||||||||||||||
> > |
How to Upgrade TWikiThe TWikiUpgradeGuide describes how to manually upgrade TWiki. It is much easier to use the BackupRestorePlugin to do a TWiki upgrade. Follow these steps:
| ||||||||||||||||||||||||||||||
Command Line Utility and Cron | |||||||||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||||||||
< < | The bin/backuprestore utility can be used to create a backup (scheduled or manually), to copy a backup and to check on the status of the backup process. | ||||||||||||||||||||||||||||||
> > | The backuprestore utility can be used to create a backup (scheduled or manually), to copy a backup and to check on the status of the backup process. | ||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||||||||
< < |
| ||||||||||||||||||||||||||||||
> > |
| ||||||||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||||||||
< < | Important: The utility must run as the same user as the CGI scripts executed by the webserver. This can be apache , nobody , www-data , wwwrun or the like, and depends on the webserver configuration. | ||||||||||||||||||||||||||||||
> > | Important Notes: | ||||||||||||||||||||||||||||||
Added: | |||||||||||||||||||||||||||||||
> > |
| ||||||||||||||||||||||||||||||
Scheduled backups can be done with a cron job. Example crontab entry that creates a backup at 10 minutes past midnight every Sunday:
10 0 * * 0 (cd /path/to/twiki/bin; ./backuprestore create_backup >/dev/null 2>&1)Make sure the plugin is configured properly before creating backups. The backup destination can be local or remote. If remote, the remote server needs to be mounted on the TWiki server via NFS or the like. | |||||||||||||||||||||||||||||||
Added: | |||||||||||||||||||||||||||||||
> > | |||||||||||||||||||||||||||||||
Specification
| |||||||||||||||||||||||||||||||
Added: | |||||||||||||||||||||||||||||||
> > | |||||||||||||||||||||||||||||||
Syntax RulesThis section is only relevant to plugin developers. This plugin handles a%BACKUPRESTORE{"..."}% variable to perform all web-based operations. The variable is used in the BackupRestoreConsole page.
%BACKUPRESTORE{"..."}% parameters:
| |||||||||||||||||||||||||||||||
Added: | |||||||||||||||||||||||||||||||
> > | |||||||||||||||||||||||||||||||
Limitations and To-Do | |||||||||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||||||||
< < |
| ||||||||||||||||||||||||||||||
> > |
| ||||||||||||||||||||||||||||||
Added: | |||||||||||||||||||||||||||||||
> > |
| ||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||||||||
< < |
| ||||||||||||||||||||||||||||||
> > |
| ||||||||||||||||||||||||||||||
Added: | |||||||||||||||||||||||||||||||
> > |
| ||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||
Added: | |||||||||||||||||||||||||||||||
> > |
License and Bug ReportingThis plugin has been reasonably tested. If you find any issues please file a bug report at TWikibug:BackupRestorePlugin. This plugin is distributed under GPL (GNU General Public License) in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. | ||||||||||||||||||||||||||||||
Plugin Installation & ConfigurationNote: You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the TWiki server. This plugin is pre-installed in TWiki-5.1.0 and newer.
| |||||||||||||||||||||||||||||||
Added: | |||||||||||||||||||||||||||||||
> > |
| ||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||||||||
< < |
| ||||||||||||||||||||||||||||||
> > |
| ||||||||||||||||||||||||||||||
# Path to backup destination directory. Can be a volume mounted to the file system.
$TWiki::cfg{Plugins}{BackupRestorePlugin}{BackupDir} = '/tmp';
# Keep number of backups (e.g. delete old backups), 0 to keep all.
$TWiki::cfg{Plugins}{BackupRestorePlugin}{KeepNumberOfBackups} = '7';
# Path to temp directory, used by BackupRestorePlugin daemon for temporary data.
$TWiki::cfg{Plugins}{BackupRestorePlugin}{TempDir} = '/tmp';
# Path to zip command with options to recursively archive files and directory.
$TWiki::cfg{Plugins}{BackupRestorePlugin}{createZipCmd} = '/usr/bin/zip -r';
# Path to unzip command with options to list all files.
$TWiki::cfg{Plugins}{BackupRestorePlugin}{listZipCmd} = '/usr/bin/unzip -l';
# Path to unzip command with options to unzip all files with option to overwrite existing files.
$TWiki::cfg{Plugins}{BackupRestorePlugin}{unZipCmd} = '/usr/bin/unzip -o';
# Debug plugin. See output in data/debug.txt
$TWiki::cfg{Plugins}{BackupRestorePlugin}{Debug} = 0;
| |||||||||||||||||||||||||||||||
Added: | |||||||||||||||||||||||||||||||
> > | |||||||||||||||||||||||||||||||
Plugin Info
| |||||||||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||||||||
< < |
| ||||||||||||||||||||||||||||||
> > |
| ||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||
Changed: | |||||||||||||||||||||||||||||||
< < |
| ||||||||||||||||||||||||||||||
> > |
| ||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||
Added: | |||||||||||||||||||||||||||||||
> > |
| ||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||
Added: | |||||||||||||||||||||||||||||||
> > |
| ||||||||||||||||||||||||||||||
Backup & Restore Plugin - Beta Version<-- Contributions to this plugin are appreciated. Please update the plugin page at http://twiki.org/cgi-bin/view/Plugins/BackupRestorePlugin or provide feedback at http://twiki.org/cgi-bin/view/Plugins/BackupRestorePluginDev. If you are a TWiki contributor please update the plugin in the SVN repository. --> IntroductionThis is a solution to backup, restore and upgrade TWiki sites. It can be used via browser and on the command line. This plugin is pre-installed in TWiki-5.1 and later releases; it can be installed in older TWiki releases as low as TWiki-2001-09-01 (Athens Release) to easily create a backup that can be restored on a new TWiki release. This offers an easy upgrade path for TWiki. Note: The initial plugin release does not yet offer the restore functionality. Check TWiki:Plugins.BackupRestorePlugin for updates.Web-based OperationThe backup and restore functionality is restricted to members of the TWikiAdminGroup. Once configured, visit the BackupRestoreConsole to:
Command Line Utility and CronThebin/backuprestore utility can be used to create a backup (scheduled or manually), to copy a backup and to check on the status of the backup process.
apache , nobody , www-data , wwwrun or the like, and depends on the webserver configuration.
Scheduled backups can be done with a cron job. Example crontab entry that creates a backup at 10 minutes past midnight every Sunday:
10 0 * * 0 (cd /path/to/twiki/bin; ./backuprestore create_backup >/dev/null 2>&1)Make sure the plugin is configured properly before creating backups. The backup destination can be local or remote. If remote, the remote server needs to be mounted on the TWiki server via NFS or the like. Specification
Syntax RulesThis section is only relevant to plugin developers. This plugin handles a%BACKUPRESTORE{"..."}% variable to perform all web-based operations. The variable is used in the BackupRestoreConsole page.
%BACKUPRESTORE{"..."}% parameters:
Limitations and To-Do
Plugin Installation & ConfigurationNote: You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the TWiki server. This plugin is pre-installed in TWiki-5.1.0 and newer.
Plugin Info
|