Akeeba Backup User's Guide
Total Page:16
File Type:pdf, Size:1020Kb
Akeeba Backup User's Guide Nicholas K. Dionysopoulos Akeeba Backup User's Guide by Nicholas K. Dionysopoulos Copyright © 2006-2021 Akeeba Ltd Abstract This book covers the use of the Akeeba Backup site backup component for Joomla!™ -powered web sites. It does not cover any other software of the Akeeba Backup suite, including Kickstart and the other utilities which have documentation of their own. Both the free Akeeba Backup Core and the subscription-based Akeeba Backup Professional editions are covered. If you are looking for a quick start to using the component please watch our video tutorials [https:// www.akeeba.com/videos]. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the appendix entitled "The GNU Free Documentation License". Table of Contents I. User's Guide to Akeeba Backup for Joomla!™ ................................................................................ 1 1. Introduction ...................................................................................................................... 6 1. Introducing Akeeba Backup ........................................................................................ 6 2. What can I use Akeeba Backup for? ............................................................................. 6 3. A typical backup/restoration work flow ......................................................................... 7 4. Server environment requirements ................................................................................. 8 2. Installation, updates and upgrades ........................................................................................ 9 1. Installing Akeeba Backup ........................................................................................... 9 1.1. Installing or manually updating the extension ....................................................... 9 1.1.1. Install from URL .................................................................................. 9 1.1.2. Upload and install. .............................................................................. 10 1.1.3. Manual installation .............................................................................. 11 1.1.4. Troubleshooting the installation ............................................................. 11 1.1.5. The installation / update broke my site! ................................................... 14 2. Upgrading from Core to Professional .......................................................................... 14 3. Automatic updates .................................................................................................... 15 3.1. Troubleshooting the update ............................................................................. 16 3.1.1. Addressing server issues ...................................................................... 16 3.1.2. Check the validity of your Download ID ................................................. 17 3.1.2.1. Check your subscription status .................................................... 17 3.1.2.2. Multiple Professional edition Akeeba extensions with different Download IDs ..................................................................................... 18 3.1.2.3. Entering or changing your Download ID after an update is available ............................................................................................. 18 3.1.3. Updates are showing after installing the latest version ................................ 19 3.1.4. Updates not showing despite having an older version ................................. 19 3.1.4.1. Check the update site ................................................................ 20 3.1.4.2. Refresh the update cache ........................................................... 20 3.1.5. Miscellaneous troubleshooting and information ........................................ 21 3.1.5.1. The update fails to download ...................................................... 21 3.1.5.2. Updating with a third party service fails ....................................... 21 3.1.5.3. Manual update ......................................................................... 22 3.1.5.4. Update installation problems ....................................................... 22 3.2. Entering your Download ID ............................................................................ 22 4. Uninstalling Akeeba Backup ...................................................................................... 25 5. Requesting support and reporting bugs ........................................................................ 26 3. Using the Akeeba Backup component ................................................................................. 27 1. Menu items ............................................................................................................. 27 1.1. Control Panel ................................................................................................ 27 1.2. Backup ........................................................................................................ 27 1.3. Configuration ................................................................................................ 28 1.4. Manage Backups ........................................................................................... 28 1.5. Restore Latest Backup .................................................................................... 28 1.6. Site Transfer Wizard ...................................................................................... 28 1.7. What to do if you don't have any menu items to Akeeba Backup ............................ 29 2. Pages outside the Control Panel panes ......................................................................... 29 2.1. Common navigation elements .......................................................................... 29 2.2. The Control Panel ......................................................................................... 30 2.2.1. Warning and error messages in the Control Panel ..................................... 34 2.2.2. Editing the component's Options ............................................................ 38 3. Basic Operations ...................................................................................................... 46 3.1. Profiles Management ...................................................................................... 47 3.2. Configuration Wizard ..................................................................................... 48 3.3. Configuration ................................................................................................ 49 3.3.1. The main settings ................................................................................ 51 iii Akeeba Backup User's Guide 3.3.1.1. Basic Configuration .................................................................. 51 3.3.1.2. Advanced configuration ............................................................. 56 3.3.1.3. Site overrides ........................................................................... 57 3.3.1.4. Optional filters ......................................................................... 59 3.3.1.5. Quota management ................................................................... 60 3.3.1.6. Fine tuning .............................................................................. 62 3.3.2. Database dump engines ........................................................................ 64 3.3.2.1. Native MySQL Backup Engine ................................................... 64 3.3.3. File and directories scanner engines ....................................................... 67 3.3.3.1. Smart scanner .......................................................................... 67 3.3.3.2. Large site scanner ..................................................................... 67 3.3.4. Archiver engines ................................................................................. 69 3.3.4.1. ZIP format .............................................................................. 69 3.3.4.2. JPA format .............................................................................. 71 3.3.4.3. Encrypted Archives (JPS format) ................................................. 72 3.3.4.4. DirectFTP ............................................................................... 74 3.3.4.5. DirectFTP over cURL ............................................................... 76 3.3.4.6. DirectSFTP .............................................................................. 78 3.3.4.7. DirectSFTP over cURL ............................................................. 80 3.3.4.8. ZIP using ZIPArchive class ........................................................ 82 3.3.5. Data processing engines ....................................................................... 82 3.3.5.1. No post-processing ................................................................... 82 3.3.5.2. Send by email .......................................................................... 82 3.3.5.3. Upload to Amazon S3 ............................................................... 83 3.3.5.4. Upload to BackBlaze B2 ............................................................ 88 3.3.5.5.