EXT: Full Backup¶

What does it do?¶

Full Backup extension allows any user to easily make a full TYPO3 installation backup and restore. The backup will consist of:

• typo3conf/localconf.php file or the whole directory (including local extensions!)
• fileadmin directory
• uploads directory
• database mysql dump

It is based on Ramon Bucher's W4 Backup extension.

Screenshots¶

Backup¶

First, select if you want to include the whole typo3conf directory. This directory holds your localconf.php, extTables.php (if any), temporary caches files, ext/ directory with ALL your LOCAL EXTENSIONS, etc.

If you don't select it, then only the localconf.php file will be included in your backup.

Optional: You can disable the permissions check.

To make a backup, just click the “Backup now!” button.

The backup will consist of:

typo3conf/ (only localconf.php if the whole directory option was not selected)

• fileadmin directory
• uploads directory
• database mysql dump

These files/dump will be “-tar”ed and -“gzip”ed to a *-tar.gz. There will appear a link so you can download it manually:

Finally, after many backups, there will appear the full list of available backups (which are being saved to the typo3temp directory), with a link to download anyone of them.

Note that the file will take the site host name and date when it was created as the first part of its name.

If some error appears, and you have the permissions check enabled, an error message will appear.

Otherwise, the backup will be commited. At this moment, there still can be some errors, also true if you disabled the permissions check, and if this happens, a message will appear telling you so and ofering you the operation log.

Clearing¶

Each backup file can total huge ammounts of hard disk space.

When you select the “Clear” function of the module, it will list any *.tar.gz file located on the backup directory.

Clicking on each one of the links that appear on the list will delete that specific file. Clicking on the “Clear All *.gz files!” button will do just so.

Restoring¶

Restoring backup files into a Typo3 installation is as easy as following on-screen instructions!

1. Click the file you want to restore;

2. A screen will appear asking you if the file has to be verified for possible problems: (This step can be ommited, with the appropiate setting configuration. Please check the Setting tool, available at the menu).

3. If no problem appears, another screen will offer you to commit the Restore:

4. When committed the RESTORE, a security backup will be made prior to the restore . It will have “securityBackup” appended to the name.

All these steps were included at the RESTORE tool to make it a little bit more difficult to make an “easy” restore, thus helping to avoid catastrophic errors.

The extension will untar the file using “/” (root) as target directory. This is because the backup tarred file has respected the original server architecture.

If you plan to use this function, please be aware that

• There can be problems when you restore a file on a server that is not the original one , if they dont have the same architecture.
• All tables on the backed up database, will be dropped , created and filled with backed up data. Even the backup users' table. As admin, you are responsable of any undesired outcome this may have.

If you need to restore a file in another server, you will need:

Shell access and appropiate permissions

• Copy the file where you want to descompress it
• Untar the file with “tar -zxf filename.tar.gz”, for example

Note that the tar will most probably have respected your original server architecture. You will find the appropiate folders with your data in there:

• fileadmin
• typo3temp/yourdump.sql
• typo3conf
• uploads

Copy the fileadmin, typo3conf and uploads content into the appropiate directory.

Use the sql dump to populate your site database.

Check permissions so your newly installed files (fileadmin, uploads) can be used by your site.

Errors¶

If there is any error, on any operation, a warning will be issued, and a link to an error report will be provided.

Installation under WINDOWS¶

To run this exension under WINDOWS OS, you will need to install the 7-ZIP compression software, available at www.7-zip.org , and configure the extension accordingly.

Configuration¶

When the extension is installed, it will ask you to set the extension configuration.

You can modify your original settings, later, going to the “Settings” option at the menu.