4 4 3 Beefalo:Restore: Difference between revisions

From SEPsesam
(Marked this version for translation)
(Update in progress)
Line 7: Line 7:
<translate>=== {{anchor|restore_overview}}Restore overview === <!--T:2--></translate>
<translate>=== {{anchor|restore_overview}}Restore overview === <!--T:2--></translate>


<translate><!--T:3-->
<translate>The SEP sesam restore is a process that browses for different versions of savesets and copies data from savesets to a client. SEP sesam provides two restore interfaces: the [[Special:MyLanguage/About_Restore#GUI|''GUI restore wizard'']] and the web-based [[Special:MyLanguage/About_Restore#restore_assistant|''Restore Assistant'']].</translate>
SEP sesam provides three restore types: ''complete restore'' (all files of a saveset), ''selective restore'' (selected files) and ''generation restore''. Restore is triggered from the ''Menu bar'' -> '''Activities''' -> '''Restore'''. Restore wizard guides you through the process of restoring your data. For step-by-step procedure, see [[Special:MyLanguage/Standard_Restore_Procedure|Standard Restore Procedure]].
<br /><translate><!--T:93--> This article describes the features and functions of the ''GUI restore wizard''. It is also possible to restore savesets using the ''Restore Assistant'' web interface, if you have the appropriate permissions. For details, see [[Special:MyLanguage/4_4_3_Beefalo:Restore_Assistant|''Restore Assistant'']].


<!--T:4-->
The restore procedure is configured using a ''restore task'', where savesets are selected by date/time and task name/file name, and the restore type and restore target (e.g., a file system folder) are specified. Restore granularity depends on the selected data type.</translate>
Restore tasks can be saved, scheduled and run automatically in continuous intervals to check and control the data integrity. For details, see [[Special:MyLanguage/4_4_3_Beefalo:SEPuler_-_an_event_calendar|SEPuler]].
<translate><!--T:4-->
Restore tasks can be saved, scheduled and run automatically at regular intervals to check and control data integrity. For details, see [[Special:MyLanguage/4_4_3_Beefalo:SEPuler_-_an_event_calendar|SEPuler]].


<!--T:93-->
Restore in GUI is triggered from the ''Menu bar'' -> '''Activities''' -> '''Restore'''. The restore wizard guides you through the process of restoring your data. For step-by-step instructions, see [[Special:MyLanguage/Standard_Restore_Procedure|Standard Restore Procedure]].
It is also possible to restore the savesets through the web interface ''Restore Assistant'', if you are granted appropriate permissions. For details, see [[Special:MyLanguage/4_4_3_Beefalo:Restore_Assistant|Restore Assistant]].
 
To learn how to recover server data from savesets after data loss due to a disaster, see [[Special:MyLanguage/SEP_sesam_Server_Disaster_Recovery|SEP sesam Server Disaster Recovery]].


===={{anchor|restore_type}}Restore types==== <!--T:94-->
===={{anchor|restore_type}}Restore types==== <!--T:94-->
Line 66: Line 68:
<translate><!--T:63-->
<translate><!--T:63-->
<li>'''''Generation restore''''' must be enabled if you are restoring from an ''incremental'' or ''differential'' backup.</li>
<li>'''''Generation restore''''' must be enabled if you are restoring from an ''incremental'' or ''differential'' backup.</li>
<li>'''''As path restore''''' (corresponds to Restore Assistant option ''Restore (any) backup to file system'') should be enabled when you have backed up data with task type other than default Path, for example Hyper-V, and you want to perform a simple path restore of your VM data directly to a directory on any system.</li>
<li>'''''As path restore''''' (corresponds to ''Restore Assistant'' option ''Restore (any) backup to file system'') should be enabled when you have backed up data with task type other than default Path, for example Hyper-V, and you want to perform a simple path restore of your VM data directly to a directory on any system.</li>
<li>'''''Disaster restore''''' should be enabled if you are restoring a server from a disaster scenario.</li></ul>  
<li>'''''Disaster restore''''' should be enabled if you are restoring a server from a disaster scenario.</li></ul>  


Line 275: Line 277:
===See also=== <!--T:57-->
===See also=== <!--T:57-->
[[Special:MyLanguage/Scheduling_Restore|Scheduling Restore]] – [[Special:MyLanguage/4_4_3_Beefalo:Schedules|Schedules]] </translate>–<translate> <!--T:90-->
[[Special:MyLanguage/Scheduling_Restore|Scheduling Restore]] – [[Special:MyLanguage/4_4_3_Beefalo:Schedules|Schedules]] </translate>–<translate> <!--T:90-->
[[Special:MyLanguage/Standard_Restore_Procedure|Standard Restore Procedure]] – [[Special:MyLanguage/Restore_Assistant|Restore Assistant]] – [[Special:MyLanguage/Cross-Platform_Recovery_File_System_Layer|Cross-Platform Recovery File System Layer (XPRFS)]] – [[Special:MyLanguage/Follow-up_Events|Follow-up Events]]</div>
[[Special:MyLanguage/Standard_Restore_Procedure|Standard Restore Procedure]] – [[Special:MyLanguage/Restore_Assistant|''Restore Assistant'']] – [[Special:MyLanguage/Cross-Platform_Recovery_File_System_Layer|Cross-Platform Recovery File System Layer (XPRFS)]] – [[Special:MyLanguage/Follow-up_Events|Follow-up Events]] – [[Special:MyLanguage/SEP_sesam_Server_Disaster_Recovery|SEP sesam Server Disaster Recovery]]</div>


<!--T:104-->
<!--T:104-->
{{Footer/en}}</noinclude></translate>
{{Footer/en}}</noinclude></translate>

Revision as of 15:21, 11 April 2022

Other languages:
<<<Back
Backup
User Manual
Next>>>
Duplication and Migration



Restore overview

The SEP sesam restore is a process that browses for different versions of savesets and copies data from savesets to a client. SEP sesam provides two restore interfaces: the GUI restore wizard and the web-based Restore Assistant.
This article describes the features and functions of the GUI restore wizard. It is also possible to restore savesets using the Restore Assistant web interface, if you have the appropriate permissions. For details, see Restore Assistant.

The restore procedure is configured using a restore task, where savesets are selected by date/time and task name/file name, and the restore type and restore target (e.g., a file system folder) are specified. Restore granularity depends on the selected data type. Restore tasks can be saved, scheduled and run automatically at regular intervals to check and control data integrity. For details, see SEPuler.

Restore in GUI is triggered from the Menu bar -> Activities -> Restore. The restore wizard guides you through the process of restoring your data. For step-by-step instructions, see Standard Restore Procedure.

To learn how to recover server data from savesets after data loss due to a disaster, see SEP sesam Server Disaster Recovery.

Restore types

Restore Type/en

Scheduled restores

Scheduled restores are performed by creating an event or task. It is also possible to schedule a restore for data that has not yet been backed up. The selective restore can be set to run at the completion of the daily backup routine, e.g., the last backed up file can be restored, preferably to a new directory and the data validity established. For details, see Scheduling Restore.

Restore wizard

Restore wizard is triggered from the menu bar -> Activities -> Restore. The following restore options are available in the restore wizard to define how your data will be restored.

Step 1: Welcome page
By default, the welcome page is not displayed when starting the wizard. It provides only general information on specifying restore process.

Step 2: Filter
You can select how you want to search for your backed up data. Savesets can be searched by task name in the saveset, or by filename or path.

Restore filter Beefalo.jpg

All task for which backups are available can be selected from the Task drop-down list, or a regular expression can be entered into the Search pattern field to search for files by their name or path. In the latter case, if all tasks should be searched, use the All button. Note that searching might take some time (depending on the amount of processed tasks). Saved in period allows searching for savesets only within the specified time frame. Show external results extends the search to the savesets generated with supplementary backup tools and interfaces, such as BSR Pro, MySQL, DB2, etc.

Step 3: Select task
You can select a task for the restore.

Restore select task Beefalo.jpg

You can enable any of the following options:

  • Complete restore of selected task will restore everything in the task.
  • Hide migrated means that the savesets that have been moved with a migration task will not appear in the results.
  • Information sign.png Note
    As of v. 5.0.0 Jaglion, the Hide migrated option is no longer available. The migrated savesets are only displayed if there is no original (backup) saveset. If you want to use the migrated saveset instead of the original saveset for the restore, you need to select it as Preferred Media pool in the Target Settings window (step 5).
  • Generation restore must be enabled if you are restoring from an incremental or differential backup.
  • As path restore (corresponds to Restore Assistant option Restore (any) backup to file system) should be enabled when you have backed up data with task type other than default Path, for example Hyper-V, and you want to perform a simple path restore of your VM data directly to a directory on any system.
  • Disaster restore should be enabled if you are restoring a server from a disaster scenario.

For details on disaster recovery, see SEP sesam Server Disaster Recovery. If a client server is being recovered, simply select the server’s disaster recovery backup task.

Option Mount saveset – Cross-Platform Recovery File System Layer (XPRFS)

The checkbox Mount saveset under the Single File Restore is available after selecting the saveset for restore. You can mount any non-compressed and non-encrypted file-based saveset stored to SEP sesam data store (Path, Si3, etc.). Mounting is not possible if the savesets are stored to tapes. For more details, see Cross-Platform Recovery File System Layer.

Information sign.png Note
  • It is recommended that this option is enabled for restoring specific data, such as Exchange, Hyper-V and V-Sphere backups, because it provides faster restore time and performance. The target saveset is mounted to the SEP sesam home directory var\tmp\mnt, e.g., C:\Program Files\SEPsesam\var\tmp\mnt\save_set_ID. This way the saveset is instantly accessible for browsing and searching before the actual restore is even triggered, providing you with quick access to your data, such as single mailboxes. The mounted saveset is basically a virtual read-only file system, therefore it cannot be altered or otherwise damaged.
  • As of v. 4.4.3. Beefalo, the Mount saveset option is only available in the Expert UI mode. If you run the GUI in Basic or Advanced UI mode, first change the mode to Expert, as described in Selecting UI mode.

Step 4: Select files
You can select individual files for the restore.

Restore select files Beefalo.jpg

The Search button below provides an additional option to search for files within the target saveset.

Step 5: Target settings

This step provides an overview of restore target settings. These settings differ slightly when restoring a virtual machine. In the table above the saveset that is selected for the restore is displayed with its attributes. In the Restore task name field, the name of the task is assigned automatically and can be modified.

Restore target settings Beefalo.jpg

Most of the following options already have default values or are enabled by default and can be used in most cases. Some provide fine-tuning needed for more specific data restore.

Target node: The name of the server where the files will be restored.

Target path settings provides the following options which are slightly different when restoring VMs:

  • Restore to original target path or Restore to original VM (in case of VM restore) is selected by default and restores the data to the same location from which it was backed up. Note that this only applies if the target node is the same server from which the data was backed up, i.e., when the source and target server are the same.
  • Original tree structure is enabled by default when restoring to original location. The directory structure of the restored files is the same as the original directory structure of the backed up data. If this option is disabled, the directory structure is not recreated and only the files are restored (flat structure).
  • New restore target or Change VM target selection (in case of VM restore) should be selected when restoring files to another location. You can enter the path to the directory to which the data should be restored manually or by using the Browser button.
  • Restore with new VM name should be used when restoring a VM to the original or a different location with a different VM name. If you are restoring a VM to a different location with a different VM name, you also have to specify a new target path under Change VM target selection.

Execution options or VM restore options (in case of VM restore) provides the following options:

  • Do not overwrite existing items is selected by default. Files will be restored only if they are not already present on the target system.
  • Overwrite existing items will replace files on the target system with their restored version.
  • Create a new version will restore files under a new name.

When performing a VM restore you can also define if you want to start a virtual machine after restore.

Optional data source selection:

  • Drive: The number of the drive with backed up data (more relevant for tape backups without a loader). Optionally, select the drive number of the drive that will be used to read the data. Typically, you use this if you have configured additional drives and you want to assign dedicated drives for the restores. For details, see the option Create second drive in Configuring a Data Store.
  • Interface: The name of the server from which the files are being restored. This is either a Remote Device Server (RDS) or the SEP sesam Server.
  • Preferred media pool: If the data was migrated or replicated and different media pools were used for the process, the source media pool to restore from can be selected from the drop-down list of available media pools.
  • Used media | barcode: If the data was migrated, the migrated copy is stored to another media. Here the source media to restore from can be selected from the drop-down list of available media.

Expert options
Clicking the button Expert options will open a new window with different tabs, where you can specify more specific options and actions.

Information sign.png Note
As of v. 4.4.3. Beefalo, the Expert Options button for specifying advanced restore options is only available in the Expert UI mode. It is not available for users that run the GUI in Basic or Advanced mode. In the latter case, if you want to access the Expert Options you first have to change the Basic/Advanced UI mode to Expert, as described in Selecting UI mode.

Restore expert options Beefalo.jpg

Options tab

Verbose level allows you to change the verbosity of the main and trace logs to display more information than the default logging mode. For details, see Setting Log Level.

Setting Log level details
0 print only standard and error messages together with summary
1 display a line for every item when its processing starts: sbc-3008: Info: Processing item: [xxx]...
2 display a line for every item when its processing finishes: sbc-3108: Info: Item processed successfully: [xxx]
3 display backup module processing information (with DB_API modules)
4 display underlying module processing XBSA and detailed DB_API modules
5 display packing data (mtf, cpio, sidf) trace messages

Restore options text box allows you to enter other specific options.

Based on the specification in the previous steps of the wizard, one of the following is already selected: Restore the complete saveset, Restore according to the composed list or disk_info disaster recovery. Changes of these restore options will override the specification defined in the previous steps.

  • Restore the complete saveset will restore all files of the saveset.
  • Restore according to the composed list will create a selective restore according to the regular expression-based filtering; see Filter tab below.
  • disk_info disaster recovery will restore disk info, for example, a master boot record and registry during disaster recovery.

Relocation tab
By default, No relocation is selected; this restores the savesets to the original target path. If With relocation option is enabled, you have to specify a new target location for the restored files. Individual files can be restored to the different paths.

Filter tab
Files for a selective restore can be defined using pattern-based filtering.

Information sign.png Note
  • Use something like *.txt to restore all Text documents.
  • For an individual file you have to provide the complete path, e.g., var/opt/sesam/var/ini/sm_lic.ini or C:/ProgramData/SEPsesam/var/ini/sm_lic.ini.
  • To restore all files of certain name regardless of place use */file.txt.
  • Click New to add additional pattern per line.

Task type tab
By default, the task type according to which the data is backed up is selected (default is Path; other task types are, for example, Hyper-V, SAP Hana, Exchange Server, Lotus Notes, MySQL, VMware vSphere etc.).

  • When you have backed up data with task type other than default Path, for example Hyper-V, you can still use the option As path backup. This option allows you to restore your data directly to the file system without any additional action.
  • The option Write saveset into file (corresponds to Restore Assistant option Write backup into dump file) allows you to restore the entire saveset into a single file rather than to its original location.

Pre/Post tab
Specifies whether any pre or post script should be applied for this restore task.

Information sign.png Note
To use a pre/post interface, you have to activate it first and create your own commands. Interfaces can be activated in GUI: in the menu bar, click Configuration -> Interfaces -> select the interface you want to activate and the client. The interface script window opens, allowing you to configure the desired action. Once done, click Save to activate the interface. The interface is saved to the <SESAM_ROOT>/bin/sesam directory. For more details, see Using Pre and Post Scripts.

EOL tab
Specifies for how long (in days) this restore task will be kept and can be accessed by using GUI. Default is 7 days. The value 0 means that a restore task will be kept permanently unless you manually delete it.

Start time tab

  • Instead of starting your restore immediately, you can specify the Start time by entering the desired date and hour.
  • Start time frame: You can specify the maximum allowed startup time (the amount of time an event can be in the queue) in days and/or hours. The actual event startup depends on the processor load of the system. At the starting time of the event, every event is forwarded into the queue, where it might wait until jobs with a higher priority are finished. For jobs with the same priority, the FIFO rule (first in first out) applies. If the event cannot be executed within this specified time frame, it will not be executed at all.
  • Stop task if it runs longer than: You can set up the amount of time (days and/or hours) after the event's scheduled start time at which the event will be cancelled.
  • Stop task at: Additionally, you can define the exact date and time when the task should be stopped.
  • Follow up: You can specify the follow-up event to trigger the predefined event on the SEP sesam Server once the restore is completed. For details, see Follow-up Events.

Step 6: Summary
In the final step of the restore wizard, check the summary for your restore configuration. Click Start to run the restore or Save to save the task under the assigned name in the Name field.

Information sign.png Note
All, started and scheduled restores are saved in SEP sesam under Main selection -> Tasks -> Tasks by clients/Tasks by groups with the current timestamp. A restore can be restarted by using the menu item Activities -> Restore or from Main selection -> Job state -> Restore -> right-click selected restore -> Immediate start.


Copyright © SEP AG 1999-2024. All rights reserved.

Any form of reproduction of the contents or parts of this manual is allowed only with the express written permission from SEP AG. When compiling and designing user documentation SEP AG uses great diligence and attempts to deliver accurate and correct information. However, SEP AG cannot issue a guarantee for the contents of this manual.