![[Important]](/images/stories/docimport58/important.png) | Important |
|---|---|
Some features of this page (like some information columns and the integrated "Restore" feature) are only available in the JoomlaPack Plus builds. |
This page is the single place you can review all your JoomlaPack backup history, as well as administer the backup files. The bulk of the page consists of a standard Joomla! list table. Each row represents a backup attempt and displays a whole lot of information:
- The check box column
Clicking the check box on the leftmost cell of a row selects this backup for an operation to be applied to it. Operations are activated by clicking on tool bar buttons. In case of an operation allowing a single row to be selected, the topmost selected row is considered as the sole selection.
- Description
Displays the description you have set when you started the backup. In case of frontend backups, this contains the default description which was assigned.
- Start
The date when the backup started. The date is expressed in the user's preferred time zone, as it is set in the User Managment page of Joomla! itself.
![[Note]](/images/stories/docimport58/note.png)
Note JoomlaPack 2.1.b1 and earlier always expressed dates in UTC (GMT+0) timezone. This was considered inconvenient and has, therefore, changed.
- Duration
The duration of the backup in hours : minutes : seconds format. This information is not available for failed backups!
- Status
Indicates the status of the backup and can be one of:
- OK
A complete backup whose backup archive is available for download.
- Obsolete
A complete backup whose backup archive is either deleted, or was overwritten by another backup attempt.
Note If you move your backup output directory's location, all your previous backups will appear as "Obsolete", even though you might have moved these backup files as well. This is not a bug. JoomlaPack internally stores the absolute path to the backup files. When you move the output directory its absolute path changes, so JoomlaPack is unable to locate the old backup files.
- Pending
A backup attempt which is still running. You should not see any such record, unless a backup attempt started while you were loading this page. In this case, you should not navigate to the Control Panel page! Doing so would invalidate the backup and wreck havoc. You have been warned! Another reason to see such an entry is a backup attempt which failed with a PHP fatal error, or which was abruptly interrupted (by the user or a PAHP error). In this case, you can safely delete the entry and get rid of the backup file as well.
- Failed
A backup attempt which failed with a catchable error condition.
- Origin
Indicates the origin of the backup and can be either frontend for backups originating from the front-end - or XMLRPC interface - or backend for backups originating from the back-end (regular backups).
- Type
Indicates the backup type and can be Full for full site backups (database and files), DB Only for database only backups or Multi DB for multiple databases backup (an archive containing SQL dumps of the main site's database and the defined multiple databases).
- Profile
Displays the numeric identifier of the backup profile used during the backup. It is possible that since then the profile may have been modified or even deleted!
- Archive
Displays the name of the backup file, if it is available. Clicking on the backup file name will let you download it, directly from your browser. If it is a split archive the file name is not clickable but you will be given as much download links as the parts of your backup are. For example, you might see links labelled "Part 01", "Part 02" through "Part 10" in a split archive consisting of ten files.
On the top of the page you can find a tool bar with operations buttons. The Delete button will remove the selected backup attempt entries along with their backup archives (if applicable). The Download button will download the archive file of the currently selected backup row. It is possible that your server and/or browser don't work well with the download feature of JoomlaPack. In this case you should download your file through FTP, making sure that your FTP client is set up to use the BINARY transfer mode. In fact, we urge you to test restoring your backups. If your backup fails to extract, you can be sure that your browser is not compatible with JoomlaPack's download feature and you'll have to resort to the FTP download method anyway.
![[Tip]](/images/stories/docimport58/tip.png) | Tip |
|---|---|
The Download button will only download the last part of a split archive. Please use the links in the Archive column in otder to download all of the parts of a split archive. Forgetting to download even a single part will result in inability to extract the archive! |
The View / Edit Comment button will open a page showing the description and comment of the currently selected backup row. You can freely edit both the description and the comment on that page and save your changes using the Save button.
The button - available only in the
JoomlaPack Plus builds - is a new and exciting feature of JoomlaPack, as it
allows you to restore full backups, as well as database only backups. In the
former case, it will copy kickstart.php and the backup
archive on your site's root, so that you can restore all of your site's
files and database. You can read Kickstart 's
documentation for more information regarding the restoration process. In the
latter case, JoomlaPack will copy the DataRestore script (
datarestore.php ) on your site's root, so that you can
restore your Joomla! database without Joomla! interfering with the
process.
![[Warning]](/images/stories/docimport58/warning.png) | Warning |
|---|---|
Familiarize yourself with the restoration process on a local test server first. Never restore a live site, unless you have a tested, functional backup file stored in a secure location on local media (for example a USB key or a CD-ROM). Be vary cautious when restoring; the process could potentially break your site! If you are only test driving this feature, do so in a local server! JoomlaPack developers will not be responsible for any loss resulting from the use or misuse of the restoration feature. Common sense should be applied when using this feature. |
In either case, if the necessary files could be copied on the site's root, you will be presented with a page containing a password and a link to open the restoration script. Please note down this password; it is absolutely necessary for the restoration script to run. This is a security feature to protect you against unauthorized or unintentional restoration which could lead to site compromise or inoperability.
| Important |
|---|---|
Pay great attention when writing down the password as it is case sensitive. This means that abc, Abc and ABC are different, as far as the restoration script is concerned! The best approach is to copy the password on your clipboard and paste it as soon as you are prompted for it. Failure to enter this password will result in inability to restore. |
For more information regarding the restoration process, please refer to the Kickstart and DataRestore documentation (not included in the on-line help integrated with the component, but available in the PDF version of the documentation and the full on-line help on our official web site).
