DataRestore

NAME

SYNOPSIS

DataRestore [ -l ]

DataRestore [ -t ] RESTORENAME

AVAILABILITY

DESCRIPTION

For restores of single files, a copy-paste approach is more recommendable then using DataRestore.

The restores are performed as file copies to a target location.

Restores are defined in configuration files with the name DataRestore.RESTORENAME.cfg in the etc/ directory.

DataRestore uses robocopy internally to copy data. DataRestore aims to be a convenient interface to robocopy.

OPTIONS

-h

usage message.

The usage message also prints a template for the restore definition to be used in the DataRestore.RESTORENAME.cfg file.

To create a DataRestore.RESTORENAME.cfg file, invoke:

  [ D:\bin\WA2LSimpleBackup\etc ]
  [ fred@acme007 ][*wtshell*/cmd]: ..\lib\DataRestore -h > DataRestore.EXAMPLE.cfg

-V

print program version.

-l

list all available restore definitions that can be specified as RESTORENAME.

-t

execute in test mode without actually restoring any data.

RESTORENAME

name of a restore definition.

A restore is represented by a configuration file having the name DataRestore.RESTORENAME.cfg in the etc/ directory.

ENVIRONMENT

%COMPUTERNAME%, %USERNAME%, %USERDOMAIN%, %TEMP% and %TMP%.

The following time and date related variables can also be used:

%TODAY%, %YEAR%, %MONTH%, %DAY%, %HOUR%, %MIN%, %SEC%, %YDAY% and %SEMICOLON%.

Please note that all variables always are specified in upper case.

For a detail description of the variables, see: databackup.bkp.cfg(4)

EXIT STATUS

0

no error.

2

TEMPLATE was specified as RESTORENAME.

3

backup definition file DataRestore.RESTORENAME.cfg does not exist.

4

usage displayed.

FILES

etc/DataRestore.<DATARESTORE>.cfg

restore definition file. In this file a restore is defined.

var/log/DataRestore.<TIMESTAMP>.<RESTORENAME>.log

log file of a restore session with the name RESTORENAME as specified on the command line.

var/tmp/

temporary files.

EXAMPLES

1) Example restore file using drive letters

In this example the data backed up using databackup (1) to D:\var\backup\USBSTICK\ACMEPC\u is restored back to the USB stick currently located on the U: drive letter:

  #
  # DataRestore.EXAMPLE1.cfg - Restore USB stick backup
  #
  # [00] 01.04.2019 CWa    Initial Version
  #
  
  DESCRIPTION=Restore Backup from %COMPUTERNAME% to USB Stick
  
  SOURCE_DIRECTORY=D:\var\backup\USBSTICK\ACMEPC\u
  DESTINATION_DIRECTORY=U:
  
  RESTORE_FOLDERS=\
                      _USB-STICK_  \
                      dat          \
                      tmp          \
                      doc          \
                      bin

2) Example restore file using labels

This is identical to example 1) with the differences, that labels are used to go around changing drive letters on removable devices.

The label of the PC is ACMEPC and the label on the USB stick is _USB-STICK_.

A label can be a directory on the related device or the drive name that you see in the Windows™ Explorer beside the drive letter.

  #
  # DataRestore.EXAMPLE2.cfg - Restore USB stick backup
  #
  # [00] 01.04.2019 CWa    Initial Version
  #
  
  DESCRIPTION=Restore Backup from %COMPUTERNAME% to USB Stick
  
  SOURCE_DIRECTORY=ACMEPC:\var\backup\USBSTICK\ACMEPC\u
  DESTINATION_DIRECTORY=_USB-STICK_:
  
  RESTORE_FOLDERS=\
                      _USB-STICK_  \
                      dat          \
                      tmp          \
                      doc          \
                      bin

SEE ALSO

NOTES

BUGS

WA2LSimpleBackup\lib\caffeine.exe

The application has failed to start because its side-by-side configuration is incorrect. Please see the application event log or use the command-line sxstrace.exe tool for more detail.

Fix:

Download and install the 'Microsoft Visual C++ 2008 Redistributable Package (x86)' from:

https://www.microsoft.com/en-us/download/details.aspx?id=29

For more information see: http://www.zhornsoftware.co.uk/support/kb.pl?q=00085.

AUTHOR

COPYRIGHT

This is free software; see WA2LSimpleBackup/man/COPYING for copying conditions. There is ABSOLUTELY NO WARRANTY; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.