DRest (David's Restore application)

The DRest application restores backups taken with DBack. The restored data can be all of the original; alternatively, exclusions or inclusions can be specified so as to restore only some of the data.

The companion application DBack is required to back up the data in a form suitable for DRest to restore.

Licence

DBack and DRest are distributed under the GNU General Public Licence, Version 2, a copy of which is supplied in the archive.

Installation

Drag the contents of the archive to somewhere convenient. The Apps dir will do as well as anywhere else.

You will also need:

• the companion DBack application, which should most logically be installed (by the same method) alongside DRest;

• the zlib module, which is part of recent HardDisc4 distributions. If you don't already have zlib, you can get a current HardDisc4 from the RISC OS Open site's Downloads section.

Configuration

There is nothing to configure.

Use

Run the DRest application by double-clicking it. Its icon arrives on the icon bar, with the state showing as "Idle"; click Select on it to open the main window.

The "Source:" writable icon specifies a folder that contains all the files generated by DBack. There must be a file named "IndexLog" and one named "0000" in the folder; there may be others with names such as "0001", "0002", etc. depending on how many data DBack backed up. Drag the directory to the writable icon, then edit it if/as necessary.

Similarly, the "Destination:" writable icon specifies where DRest will put the restored data. Fill it in using the same method as for the source above. DRest will create the last directory level, if it does not already exist, but only the last level - no more. To restore an entire drive, the entry should end in ".$", so it's easiest to drag in a directory or file from the root directory, then delete backwards from the end until the last character is the "$".

You may wish to prevent some files or directory trees from being restored. You can specify a list of exclusions (i.e. restore everything except what is listed), or a list of inclusions (i.e. restore only what is listed). To do so, create a text file somewhere with the items, one on each line; then drag the file into the "Exclude:" or "Include"writable icon. Clicking the button allows you to select Exclude or Include. Note: you MUST put them in a file; DRest treats the exclude entry as a file, not as a literal string. The file can contain up to 100 such exclusions or inclusions. Any more are ignored.

If you want to restore everything, leave the exclude/include entry blank.

When you're ready to go, click "Start". DRest performs some checks before starting. If the checks succeed, the state changes to "Running" and the restore is on its way.

Restore operations can be paused by clicking the "Pause" button. The state changes to "Paused" and the button's legend changes to "Continue". This may be useful when restoring from a network destination and you wish to run another application that might single-task the computer for long enough for the network operation to time out and cause an error. The restore can be resumed by clicking "Continue".

When the restore has completed, the state changes back to "Idle" and the summary window opens, showing the total number of files restored.

To stop a restore, click the "Stop" button. This aborts the restore. It cannot be resumed, it must be restarted. The state changes to "Stopped" as a reminder that the restore did not run to successful completion. A second click on "Stop" brings the state back to "Idle".

Checking the results

The destination directory contains a text file named LogFile. Using your text editor, open it and search for any messages containing the word "Error". (Note that it's quite common to find filenames that contain "Error" - you can ignore these.) If any files could not be restored, each will have an error entry here. Hopefully, when you ran DBack, you followed the instructions and checked for any files that were not backed up, and took separate copies of them. You can copy them back again now.

Download

You can download DRest here and DBack here.

If it goes wrong

Contact me by email as dave@davehigton.me.uk and I will do my best to fix the problem.

Revision history

0.02 2017 May 10 First issue

0.03 2017 May 15 Corrected inclusion/exclusion behaviour; updated help

Page last updated 2017 May 15