8 File restore process

Section 8 - File Restore

This section describes the process on how to restore files.

8.2 How to start a restore

There are three methods for restoring data:

8.2.1 Using the OBM user interface
8.2.2 Using the Web console interface
8.2.3 Using the Decrypt File Wizard for physical data copied from OBS
8.2.4 Restore using Script File

8.2.1 Restore using the OBM user interface

Refer to the following steps to restore using the backup application's (OBM / ACB) user interface:

Click on the [Restore] button on the backup application's main window to open the Restore Menu.

Select the [Show files as of Job] to display files available as of a particular backup job.

To display the files available for restore since the backup job performed on 11:00 AM, Mar 11th, 2011, select [Show files as of Job], [2011/03/11] and [11:00:00]

Select the [Show all files] to display all files available for restore.

Expand the directories by selecting the button beside a folder.
Make use of the other options such as [Filter], [Search] and [Advanced] option available, more details can be found in the sections above.
For restore to the original location on the client machine, select the [Original location] radio button.

For restore to an alternate location, select the [Alternate location] radio button, and click [Change] to change the directory path which you would like to restore to.

Click [Start Restore] to begin the restore process.

8.2.2 Restore using the web interface

Refer to the following steps for restore using the web interface:

Note:
For restore of a large amount of data, it is recommended to restore using the AhsayOBM user interface instead of the web restorer applet.

Click on the [File Explorer] tab at the top menu of the web interface.

Click on the [Restore] button to open the web restorer applet:

Once the applet has loaded the screen showing the plans backup sets will appear

Select the backup set containing the files you want to restore and press [Next]
Select the [Show files as of Job] to display files available as of a particular backup job.

For example, select [Show files as of Job], [2011/03/11] and [11:00:00] to display the files available for restore since the backup job performed on 11:00am of Mar 11th, 2011.

Select the [Show all files] to display all files available for restore.

For example, select [Show files as of Job], [2011/03/11] and [11:00:00] to display the files available for restore since the backup job performed on 11:00am of Mar 11th, 2011.

Select the [Show all files] to display all files available for restore.

Expand the directories by selecting the button beside a folder.
Make use of the other options such as [Filter], [Search] and [Advanced] option available, more details can be found in the earlier sections of this guide.
For restore to the original location on the client machine, select the [Original location] radio button.
For restore to an alternate location, select the [Alternate location] radio button, and click [Change] to change the directory path which you would like to restore to.
Click [Start Restore] to begin the restore process.

You will potentially be asked to enter the appropriate encryption key prior to restore, enter and click ok

A "Restore Progress" properties box will appear and advise when the restore has completed.

8.2.3 Restore using Decrypt File Wizard

Data stored on the backup server can be copied onto a removable hard disk (or other storage medium) for direct restore on the client computer, bypassing the network bottleneck. This is especially useful for restore of large backup set.

However, as data stored on the backup server are compressed and encrypted for security purposes, a utility called Decrypt File Wizard must be used to decrypt the data.

Refer to the following steps for restore using Decrypt File Wizard:

Connect the removable hard disk with the data to your computer.
Login to the backup application's user interface.

Click on the [Decrypt File Wizard] button on the backup application's main window to open the Decrypt File Wizard.

Select the [Change] button and browse to the [files] directory of the copied data, and click [Next].

Note:
Data copied onto the removable hard disk must be in the same directory structure as they are on the backup server, which is:

${Username}\files

Please contact your service provider if you cannot locate the [files] directory.

Select the corresponding backup set and press [Next]

Select the [Show files as of Job] to display files available as of a particular backup job.

For example, to display the files available for restore since the backup job performed on 11:00 AM, Mar 11th, 2011. Select [Show files as of Job], [2011/03/11] and [11:00:00] Select the [Show all files] to display all files available for restore.

Expand the directories by selecting the button beside a folder.
Make use of the other options such as [Filter], [Search] and [Advanced] option available, more details can be found in the sections above.
For decrypt to the original location on the client machine, select the [Original location] radio button.

For decrypt to an alternate location, select the [Alternate location] radio button, and click [Change] to change the directory path which you would like to restore to.

Click [Start Decrypt] to begin the decrypt process.

8.2.4 Restore using Script File

Data restore can be executed by the script file in the %OBM_HOME%\bin folder.

Windows

%OBM_HOME\bin\Restore.bat

Linux

%OBM_HOME/bin/Restore.sh

Mac OSX

/Applications/AhsayOBM/bin/Restore.sh

Parameters	Description
BACKUP_SET	The name or ID of the backup set that you want to restore. If the backup set name is not in English, please use BackupSetID e.g. BACKUP_SET="1119083740107" or BACKUP_SET="FileBackupSet-1"
RESTORE_TO	The directory that you want the files to restore to. e.g. Windows RESTORE_TO="C:\Temp" Linux, Mac OSX RESTORE_TO="/tmp" If you set it to "" e.g. RESTORE_TO="" The files will be restored to the original location.
RESTORE_FROM	The file/directory on the backup sertver that you would like to restore. e.g. Windows RESTORE_FROM="C:\Data" Linux, Mac OSX RESTORE_FROM="/Data"
POINT_IN_TIME	The point-in-time snapshot of a successful backup that you want to restore from the backup server. Use "Current" for the latest backup snapshot e.g. SET POINT_IN_TIME="Current" You can specify a particular point-in-time e.g. SET POINT_IN_TIME="2006-10-04-12-57-13" For the available point in time on the backup server, you can execute the following script. Windows ListBackupJob.bat Linux, Mac OSX ListBackupJob.sh
RESTORE_PERMISSION	If you want to restore file permission, set the value to "N", otherwise set the value to "Y" to restore file permission.
SKIP_INVALID_KEY	If you want to prompt user to input a correct encryption key, set the value to "N", otherwise set the value to "Y", it will skip the restore file if the file has an invalid encryption key.
SYNC_OPTION	Set this value to "Y" if you want to enable the sync option, ie. delete extra file option. Set this value to "N" if you do not want to enable the sync option. If you set the option with "", it will prompt for selection.
REPLACE_EXISTING_FILE	Set this value to "-all" to replace all existing file(s) of the same filename. If the value is set to "-none", it will skip the file restore if same filename exists. If you set the option with "", it will prompt for selection.
SETTING_HOME	Optional parameter for you to set the user home. By default, the option "" will points to your home directory with the .obm folder. e.g. (Windows) "C:\Documents and Settings\John\.obm" (Linux) "/home/john/.obm"
FILTER	This parameter can help you to filter the files that you want to restore. There are 3 options. -Pattern=xxx -Type=yyy -Target=zzz Where xxx is the file pattern, yyy is the filter type, which can be one of the following: [exact \| exactMatchCase \| contains \| containsMatchCase \| startWith \| startWithMatchCase \| endWithMatchCase \| endWith ] zzz is the filter target, which can be one of the following: [toFile \| toFileDir \| toDir] e.g. FILTER="-Pattern=.txt-Type=exact-Target=toFile"