4 4 3 Beefalo:Restore: Difference between revisions

From SEPsesam
(Update in progress)
m (expert -> advanced UI mode)
(11 intermediate revisions by the same user not shown)
Line 7: Line 7:
<translate>=== {{anchor|restore_overview}}Restore overview === <!--T:2--></translate>
<translate>=== {{anchor|restore_overview}}Restore overview === <!--T:2--></translate>


<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>
<translate><!--T:118--> 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>
<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'']].
<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:119-->
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>
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>
<translate><!--T:4-->
<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]].
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:120-->
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]].
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]].


<!--T:121-->
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]].
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]].


Line 28: Line 32:


===={{anchor|wizard}}Restore wizard==== <!--T:12-->
===={{anchor|wizard}}Restore wizard==== <!--T:12-->
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.
The restore wizard can be accessed from the ''menu bar'' -> '''Activities''' -> '''Restore'''. The following restore options are available in the restore wizard to define how your data will be restored.
<!--
<!--
{{Note|In v. ≥ 5.0.0. ''Jaglion'', the operations and options available after logging in may differ depending on the ''user type''. Other Web UI display restrictions may depend on the custom roles with specific permissions and the [[Special:MyLanguage/SEP_sesam_Glossary#UI_mode|''UI mode'']]. <br />For details, see [[Special:MyLanguage/5_0_0:About_Authentication_and_Authorization|About Authentication and Authorization]] and [[Special:MyLanguage/5_0_0:User_Roles_and_Permissions|User Roles and Permissions]].}}-->
{{Note|In v. ≥ 5.0.0. ''Jaglion'', the operations and options available after logging in may differ depending on the ''user type''. Other ''Web UI'' display restrictions may depend on the custom roles with specific permissions and the [[Special:MyLanguage/SEP_sesam_Glossary#UI_mode|''UI mode'']]. <br />For details, see [[Special:MyLanguage/5_0_0:About_Authentication_and_Authorization|About Authentication and Authorization]] and [[Special:MyLanguage/5_0_0:User_Roles_and_Permissions|User Roles and Permissions]].}}-->


<!--T:13-->
<!--T:13-->
'''Step 1: Welcome page'''<br />
'''Step 1: Welcome page'''<br />
By default, the welcome page is not displayed when starting the wizard. It provides only general information on specifying restore process.
By default, the welcome page is not displayed when the wizard starts. It contains only general information on specifying the restore process.


<!--T:14-->
<!--T:14-->
'''Step 2: Filter'''<br />
'''Step 2: Filter'''<br />
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''.  
You can select how you want to search for your backed up data. Savesets can be searched by the ''task name'' in the saveset or by ''filename'' or ''path''.  


<!--T:15-->
<!--T:15-->
[[image:Restore_filter_Beefalo.jpg|750px|link=]]</translate>
[[image:rst-wiz_filter_Jaglion.jpg|750px|link=]]</translate>
<br clear=all>
<br clear=all>


<!--T:16-->
<!--T:16-->
<translate><!--T:61-->
<translate><!--T:61-->
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.   
You can select among tasks for which backups are available from the '''''Task''''' drop-down list or enter a regular expression in the '''''Search pattern''''' field to search for files by their name or path. Note that the search may take some time (depending on the number of processed tasks).  
<br />'''''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.   


<!--T:17-->
<!--T:17-->
'''Step 3: Select task'''<br />  
'''Step 3: Select task'''<br />  
You can select a task for the restore.
Select a task for the restore.


<!--T:18-->
<!--T:18-->
[[image:Restore_select_task_Beefalo.jpg|750px|link=]]</translate>
[[image:rst-wiz_task_Jaglion.jpg|750px|link=]]</translate>
<br clear=all>
<br clear=all>
<!--<translate><!--T:114--> [[image:Restore_select_task_Jaglion.jpg|750px|link=]]</translate>
<!--<translate><!--T:114--> [[image:Restore_select_task_Jaglion.jpg|750px|link=]]</translate>
Line 60: Line 65:
<!--T:19-->
<!--T:19-->
<translate><!--T:62-->
<translate><!--T:62-->
You can enable any of the following options:
The following options depend on the type of data ([[Special:MyLanguage/SEP_sesam_Glossary#task_type|task type]]) you want to restore. You will see only see the options that are relevant to your data restore.


<!--T:20-->
<!--T:20-->
<ul><li>'''''Complete restore of selected task''''' will restore everything in the task.</li>  
<ul><li>'''''Complete restore of selected task''''' will restore everything in the task.</li>
<!--<li>'''''Broken tasks''''' will also .</li>--> 
<li>'''''Hide migrated''''' means that the savesets that have been moved with a migration task will not appear in the results.</li></translate>
<li>'''''Hide migrated''''' means that the savesets that have been moved with a migration task will not appear in the results.</li></translate>
<translate><!--T:113--> {{Note|As of v. [[SEP_sesam_Release_Versions|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 [[4_4_3_Beefalo:Restore#target|''Target Settings'' window (step 5)]].}}</translate>  
<translate><!--T:113--> {{Note|As of v. [[SEP_sesam_Release_Versions|5.0.0 ''Jaglion'']], the ''Hide migrated'' option is no longer available. The migrated savesets are now displayed only if there is no original (backup) saveset. If you want to use the migrated saveset instead of the original saveset, you need to select it as ''Preferred Media pool'' in the [[4_4_3_Beefalo:Restore#target|''Target Settings'' window (step 5)]].}}</translate>  
<translate><!--T:63-->
<translate><!--T:63-->
<li>'''''Generation restore''''' must be enabled if you are restoring from an ''incremental'' or ''differential'' backup.</li>
<li>Normally, '''''Generation restore''''' is selected by default. Make sure this option is 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 the ''Restore Assistant'' option ''Restore (any) backup to file system'') should be enabled if you have backed up data using a task type other than default ''Path'', such as 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 want to restore a server after a disaster scenario.</li></ul>  


<!--T:21-->
<!--T:21-->
Line 78: Line 84:


<!--T:23-->
<!--T:23-->
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 [[Special:MyLanguage/SEP_sesam_Glossary#data_store| SEP sesam data store]] (''Path'', ''Si3'', etc.). Mounting is not possible if the savesets are stored to tapes.<!-- In v. ≥ 5.0.0 ''Jaglion'', you can also select ''RDS to mount'' from the drop-down list and specify ''advanced mount options''.--> For more details, see [[Special:MyLanguage/Cross-Platform_Recovery_File_System_Layer| Cross-Platform Recovery File System Layer]].</translate>
The checkbox '''Mount saveset''' under the ''Single File Restore via Mount'' is available after selecting the saveset for restore. You can mount any non-compressed and non-encrypted file-based saveset stored on [[Special:MyLanguage/SEP_sesam_Glossary#data_store| SEP sesam data store]] (''Path'', ''Si3'', etc.). Mounting is not possible if the savesets are stored on tapes. In v. ≥ 5.0.0 ''Jaglion'', you can also select ''RDS to mount on'' from the drop-down list and specify ''advanced mount options''. For more details on mount requirements and limitations, see [[Special:MyLanguage/Cross-Platform_Recovery_File_System_Layer| Cross-Platform Recovery File System Layer]].
 
<!--T:122-->
[[image:rst-wiz_mount-option_Jaglion.jpg|600px|link=]]</translate>
<br clear=all>


<!--T:24-->
<!--T:24-->
Line 84: Line 94:
note</translate>|
note</translate>|
<translate><!--T:65-->
<translate><!--T:65-->
*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'''.</translate><translate> <!--T:86-->
*It is recommended to enable this option for restore of specific data, such as ''Exchange'', ''Hyper-V'' and ''V-Sphere'' backups, as it provides '''faster restore time and performance'''.</translate><translate> <!--T:86-->
The target saveset is mounted to the SEP sesam home directory <tt>var\tmp\mnt</tt>, e.g., <tt>C:\Program Files\SEPsesam\var\tmp\mnt\''save_set_ID''</tt>. </translate><translate><!--T:87-->
By default, the target saveset is mounted to the SEP sesam home directory <tt>var\tmp\mnt</tt>, e.g., <tt>C:\Program Files\SEPsesam\var\tmp\mnt\''saveset_ID''</tt>. </translate><translate><!--T:87-->
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.</translate>
This way, the saveset is immediately accessible for browsing and searching before the actual restore is triggered, giving you 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.</translate>
*<translate><!--T:112--> As of v. [[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3. ''Beefalo'']], the ''Mount saveset'' option is only available in the [[Special:MyLanguage/SEP_sesam_Glossary#UI_mode|''Expert'' UI mode]]. If you run the GUI in ''Basic'' or ''Advanced'' UI mode, first change the mode to ''Expert'', as described in [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_GUI#UI_mode|Selecting UI mode]].</translate>}}
*<translate><!--T:112--> The ''Mount saveset'' option is available only in [[Special:MyLanguage/SEP_sesam_Glossary#UI_mode|''advanced'' UI mode]] (formerly ''expert'' GUI mode). To use the mount option, make sure your UI mode is set to ''advanced'', as described in [[Special:MyLanguage/SEP_sesam_GUI#UI_mode|Selecting UI mode]].</translate>}}


<!--T:25-->
<!--T:25-->
<translate><!--T:66-->
<translate><!--T:66-->
'''Step 4: Select files'''<br />  
'''Step 4: Select files'''<br />  
You can select individual files for the restore.  
You can select individual items for restore.  


<!--T:26-->
<!--T:26-->
[[image:Restore_select_files_Beefalo.jpg|750px|link=]]</translate>
[[image:rst-wiz_files_Jaglion.jpg|750px|link=]]</translate>
<br clear=all>
<br clear=all>
<!--<translate><!--T:115--> [[Image:>Restore_select_files_Jaglion.jpg|750px|link=]]</translate>
<!--<translate><!--T:115--> [[Image:>Restore_select_files_Jaglion.jpg|750px|link=]]</translate>
Line 107: Line 117:


<!--T:30-->
<!--T:30-->
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.   
This step provides an overview of the restore target settings. These settings differ slightly when restoring a virtual machine. The saveset selected for restore is displayed with its attributes at the top. In the '''''Restore task name''''' field, the name of the task is assigned automatically and can be modified.   


<!--T:31-->
<!--T:31-->
[[image:Restore_target_settings_Beefalo.jpg|750px|link=]]</translate>
[[image:rst-wiz_target_Jaglion.jpg|750px|link=]]</translate>
<br clear=all>
<br clear=all>


<!--T:32-->
<!--T:32-->
<translate><!--T:68-->
<translate><!--T:68-->
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.
Most of the following options already have default values or are enabled by default and can be used in most cases. Some allow fine-tuning, which is required for more specific data restore.


<!--T:35-->
<!--T:35-->
Line 121: Line 131:


<!--T:38-->
<!--T:38-->
'''''Target path settings''''' provides the following options which are slightly different when restoring VMs:</translate>  
The '''''Target path settings''''' provide the following options, which differ slightly for VM restore:</translate>  


<!--T:39-->
<!--T:39-->
* <translate><!--T:69-->
* <translate><!--T:69-->
'''''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.</translate>
'''''Restore to original target path''''' or '''''Restore to original VM''''' (for 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., if the source and target server are the same.</translate>
<!--T:40-->
<!--T:40-->
* <translate><!--T:70-->
** <translate><!--T:70-->
'''''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). </translate>
The '''''Original tree structure''''' checkbox is selected by default when restoring to the 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). </translate>
<!--T:41-->
<!--T:41-->
* <translate><!--T:71-->
* <translate><!--T:71-->
'''''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.  
Select '''''New restore target''''' or for VM '''Restore with new VM name''' (formerly ''Change VM target selection'') if you want to restore the data to a different location. You can ''manually'' enter the path to the directory where the data is to be restored or use the ''Browse'' 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''.
** If you choose '''''Restore with new VM name''''', use the ''Browser'' button to select the restore location for your VM. Expand the ''Change VM target selection'' option to set additional options, e.g., define the target node or set data store path.


<!--T:42-->
<!--T:42-->
'''''Execution options''''' or '''''VM restore options''''' (in case of VM restore) provides the following options:</translate>
'''''Execution options''''' or '''''VM restore options''''' (for VM restore) provides the following options:</translate>
* <translate><!--T:72-->
* <translate><!--T:72-->
'''''Do not overwrite existing items''''' is selected by default. Files will be restored only if they are not already present on the target system.</translate>
'''''Do not overwrite existing items''''' is selected by default. Files are restored only if they do not already exist on the target system.</translate>
* <translate><!--T:73-->
* <translate><!--T:73-->
'''''Overwrite existing items''''' will replace files on the target system with their restored version.</translate>  
'''''Overwrite existing items''''' replaces the files on the target system with their restored version.</translate>  
* <translate><!--T:74-->
* <translate><!--T:74-->
'''''Create a new version''''' will restore files under a new name.  
'''''Create a new version''''' restores the files under a new name (not available for all restore types).
When performing a VM restore you can also define if you want to ''start a virtual machine after restore''.
When performing a VM restore, you can also specify whether to ''start a virtual machine after restore''.


<!--T:105-->
<!--T:105-->
'''''Optional data source selection:'''''
'''''Optional data source selection:'''''
<!--T:36-->
*'''''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.
<!--T:37-->
*'''''Used media | barcode'':''' If the data was migrated, the migrated copy is stored to another media. Here you can select the source media from which to restore from the drop-down list of available media.


<!--T:33-->
<!--T:33-->
*'''''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 [[Special:MyLanguage/Configuring_a_Data_Store#drive_parameter|Configuring a Data Store]].  
*'''''Drive''''': The number of the drive with the backed up data (more relevant for tape backups without a loader). Optionally, select the drive number of the drive to be used for reading the data. Typically, you use this if you have configured additional drives and want to assign dedicated drives for restore. For details, see the option ''Create second drive'' in [[Special:MyLanguage/Configuring_a_Data_Store#drive_parameter|Configuring a Data Store]].  


<!--T:34-->
<!--T:34-->
*'''''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.  
*'''''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.  
<!--T:36-->
*'''''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.
<!--T:37-->
*'''''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.


<!--T:43-->
<!--T:43-->
{{anchor|expert}}'''''Expert options''''' <br />
{{anchor|expert}}'''''Expert options''''' <br />
Clicking the button ''Expert options'' will open a new window with different tabs, where you can specify more specific options and actions.
When you click the ''Expert options'', a new window opens with different tabs where you can set more specific options and actions.
{{note|As of v. [[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3. ''Beefalo'']], the ''Expert Options'' button for specifying advanced restore options is only available in the [[Special:MyLanguage/SEP_sesam_Glossary#UI_mode|''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 [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_GUI#UI_mode|Selecting UI mode]].}}
{{note|The ''Expert Options'' button for setting advanced restore options is available only in [[Special:MyLanguage/SEP_sesam_Glossary#UI_mode|''advanced'' mode]] (formerly ''expert'' GUI mode). If you are running the GUI in ''simple'' mode (formerly ''basic'' GUI mode) and want to access ''Expert Options'', change ''simple'' UI mode to ''advanced'', as described in [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_GUI#UI_mode|Selecting UI mode]].}}


<!--T:88-->
<!--T:88-->
[[image:Restore_expert_options_Beefalo.jpg|500px|link=]]</translate>
[[image:rst-wiz_expert-options_Jaglion.jpg|650px|link=]]</translate>
<br clear=all>
<br clear=all>
<!--<translate><!--T:116--> [[Image:Restore_expert_options_Jaglion.jpg|500px|link=]]</translate>
<br clear=all>-->


<!--T:44-->
<!--T:44-->
Line 175: Line 183:


<!--T:45-->
<!--T:45-->
''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 [[Special:MyLanguage/Setting_Log_Level|Setting Log Level]].</translate>
The ''Verbose level'' allows you to change the verbosity of the main and trace logs to display more information than in standard logging mode. For details, see [[Special:MyLanguage/Setting_Log_Level|Setting Log Level]].</translate>


{| border="2" cellpadding="4" cellspacing="0" style="width:60%; margin: 1em 1em 1em 0; background: #fcfcfc; border: 1px #aaa solid; border-collapse: collapse;"
{| border="2" cellpadding="4" cellspacing="0" style="width:60%; margin: 1em 1em 1em 0; background: #fcfcfc; border: 1px #aaa solid; border-collapse: collapse;"
Line 188: Line 196:
  |style="text-align: center;"|'''0'''||  <translate>
  |style="text-align: center;"|'''0'''||  <translate>
<!--T:97-->
<!--T:97-->
print only standard and error messages together with summary</translate>       
print only standard and error messages together with a summary</translate>       
  |-
  |-
  |style="text-align: center;"|'''1''' || <translate>
  |style="text-align: center;"|'''1''' || <translate>
Line 216: Line 224:


<translate><!--T:49-->
<translate><!--T:49-->
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.</translate>
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 override the specifications defined in the previous steps.</translate>
<!--T:50-->
<!--T:50-->
* <translate><!--T:81-->
* <translate><!--T:81-->
'''''Restore the complete saveset''''' will restore all files of the saveset. </translate>
'''''Restore the complete saveset''''' restores all files in the saveset. </translate>
* <translate><!--T:82-->
* <translate><!--T:82-->
'''''Restore according to the composed list''''' will create a selective restore according to the regular expression-based filtering; see ''Filter'' tab below. </translate>
'''''Restore according to the composed list''''' performs a selective restore according to regular expression-based filtering; see ''Filter'' tab below. </translate>
* <translate><!--T:83-->
* <translate><!--T:83-->
'''''disk_info disaster recovery''''' will restore disk info, for example, a master boot record and registry during disaster recovery. </translate>
'''''disk_info disaster recovery''''' restores disk information, e.g., a master boot record and the registry during a disaster recovery. </translate>


<!--T:51-->
<!--T:51-->
<translate><!--T:84-->
<translate><!--T:84-->
'''''Relocation tab'''''<br />  
'''''Relocation tab'''''<br />  
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.
By default, ''No relocation'' is selected; this restores savesets to the original target path. If the ''With relocation'' option is enabled, you have to specify a new target location for the restored files. Individual files can be restored to different paths.
 
<!--T:123-->
[[image:rst-wiz_expert-options-relocation_Jaglion.jpg|650px|link=]]</translate>
<br clear=all>


<!--T:52-->
<translate><!--T:52-->
'''''Filter tab'''''</translate><br />
'''''Filter tab'''''</translate><br />
<translate><!--T:106--> Files for a selective restore can be defined using pattern-based filtering.</translate>
<translate><!--T:106--> Files for selective restore can be defined using pattern-based filtering.</translate>
{{<translate><!--T:107--> Note</translate>|
{{<translate><!--T:107--> Note</translate>|
*<translate> <!--T:108--> Use something like <tt>*.txt</tt> to restore all Text documents.</translate>
*<translate> <!--T:108--> Use something like <tt>*.txt</tt> to restore all text documents.</translate>
* <translate><!--T:109--> For an individual file you have to provide the complete path, e.g., <tt>var/opt/sesam/var/ini/sm_lic.ini</tt> or <tt>C:/ProgramData/SEPsesam/var/ini/sm_lic.ini</tt>.</translate>
* <translate><!--T:109--> For an individual file you have to provide the full path, e.g., <tt>var/opt/sesam/var/ini/sm_lic.ini</tt> or <tt>C:/ProgramData/SEPsesam/var/ini/sm_lic.ini</tt>.</translate>
* <translate><!--T:110--> To restore all files of certain name regardless of place use <tt>*/file.txt</tt>.</translate>
* <translate><!--T:110--> To restore all files of a given name regardless of location, use <tt>*/file.txt</tt>.</translate>
* <translate><!--T:111--> Click ''New'' to add additional pattern per line.</translate>}}
* <translate><!--T:111--> Click ''New'' to add more patterns per line.</translate>}}


<translate><!--T:53-->
<translate><!--T:53-->
'''''Task type tab'''''<br />
'''''Task type tab'''''<br />
By default, the [[Special:MyLanguage/SEP_sesam_Glossary#task_type|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.).  
By default, the [[Special:MyLanguage/SEP_sesam_Glossary#task_type|task type]] by which the data is backed up is selected (default is ''Path''; other task types include ''Hyper-V, SAP Hana, Exchange Server, Lotus Notes, MySQL, VMware vSphere'', etc.).  


<!--T:54-->
<!--T:54-->
*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.</translate>  
*If you have backed up data with task type other than the default ''Path'', e.g., 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.</translate>  
<translate><!--T:85-->
<translate><!--T:85-->
*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.
*The option '''''Write saveset into file''''' (corresponds to the ''Restore Assistant'' option ''Write backup into dump file'') allows you to restore the entire saveset to a single file rather than to its original location.


<!--T:55-->
<!--T:55-->
'''''Pre/Post tab'''''<br />
'''''Pre/Post tab'''''<br />
Specifies whether any [[Special:MyLanguage/SEP_sesam_Glossary#pre|pre]] or [[Special:MyLanguage/SEP_sesam_Glossary#post|post]] script should be applied for this restore task.  
Specifies whether to apply a [[Special:MyLanguage/SEP_sesam_Glossary#pre|pre]] or [[Special:MyLanguage/SEP_sesam_Glossary#post|post]] script for this restore task.  


<!--T:92-->
<!--T:92-->
{{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 <tt><SESAM_ROOT>/bin/sesam</tt> directory. For more details, see [[Special:MyLanguage/Using_Pre_and_Post_Scripts|Using Pre and Post Scripts]].}}
{{note|To use a pre/post interface, you must first activate it 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 <tt><SESAM_ROOT>/bin/sesam</tt> directory. For more details, see [[Special:MyLanguage/Using_Pre_and_Post_Scripts|Using Pre and Post Scripts]].}}


<!--T:56-->
<!--T:56-->
'''''EOL tab'''''<!--'''''Retention Time tab'''''--><br />
'''''Retention Time tab''''' (formerly ''EOL'')<br />
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.
Specifies for how long (in days) this restore task is kept and can be accessed by using GUI. The default value is 7 days. The value 0 means that a restore task is kept permanently unless you manually delete it.


<!--T:91-->
<!--T:91-->
'''''Start time tab'''''<!--'''''Execution Time tab'''''--> 
'''''Execution Time tab''''' (formerly ''Start time'')
*Instead of starting your restore immediately, you can specify the '''''Start time''''' by entering the desired date and hour.  
*Instead of starting your restore immediately, you can specify the start time by entering the desired date and time. </translate>
*'''''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.  
*<translate><!--T:125--> '''''Start time frame''''': You can specify the maximum allowed start time (the amount of time an event can be in the queue) in days and/or hours. The actual start time of the event depends on the processor load of the system. At the start time of the event, every event is forwarded into the queue, where it might wait until jobs with a higher priority finish. 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.</translate>
*<!--'''''Cancel execution after'''''-->'''''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.  
*<translate><!--T:126--> '''''Cancel execution after''''' (formerly '''Stop task if it runs longer than'''): You can specify the amount of time (days and/or hours) after the event's scheduled start time, after which the event will be cancelled.</translate>
*<!--'''''Cancel execution at'''''-->'''''Stop task at''''': Additionally, you can define the exact date and time when the task should be stopped.
*<translate><!--T:127--> '''''Cancel execution at''''' (formerly '''Stop task at'''): Depending on the previous setting, it specifies the exact date and time when the task will be stopped.</translate>
*'''''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 [[Special:MyLanguage/Follow-up_Events|Follow-up Events]].
*<translate><!--T:128--> '''''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 [[Special:MyLanguage/Follow-up_Events|Follow-up Events]].</translate>
 
<translate><!--T:124-->
[[image:rst-wiz_execution_Jaglion.jpg|650px|link=]]</translate>
<br clear=all>


<!--T:103-->
<translate><!--T:103-->
'''Step 6: Summary'''<br />
'''Step 6: Summary'''<br />
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.
In the final step of the restore wizard, review the summary of your restore configuration. Click '''Start''' to run the restore or '''Save''' to save the task under the assigned name in the ''Name'' field.


<!--T:117-->
<!--T:117-->
{{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'''.}}</translate>  
{{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 via the menu item '''Activities''' -> '''Restore''' or via ''Main selection'' -> '''Job state''' -> '''Restore''' -> ''right-click selected restore'' -> '''Immediate start'''.}}</translate>  


<translate><div class="noprint"><noinclude>
<translate><div class="noprint"><noinclude>

Revision as of 16:59, 11 May 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

The restore wizard can be accessed 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 the wizard starts. It contains only general information on specifying the restore process.

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

Rst-wiz filter Jaglion.jpg

You can select among tasks for which backups are available from the Task drop-down list or enter a regular expression in the Search pattern field to search for files by their name or path. Note that the search may take some time (depending on the number 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
Select a task for the restore.

Rst-wiz task Jaglion.jpg

The following options depend on the type of data (task type) you want to restore. You will see only see the options that are relevant to your data restore.

  • 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 now displayed only if there is no original (backup) saveset. If you want to use the migrated saveset instead of the original saveset, you need to select it as Preferred Media pool in the Target Settings window (step 5).
  • Normally, Generation restore is selected by default. Make sure this option is enabled if you are restoring from an incremental or differential backup.
  • As path restore (corresponds to the Restore Assistant option Restore (any) backup to file system) should be enabled if you have backed up data using a task type other than default Path, such as 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 want to restore a server after 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 via Mount is available after selecting the saveset for restore. You can mount any non-compressed and non-encrypted file-based saveset stored on SEP sesam data store (Path, Si3, etc.). Mounting is not possible if the savesets are stored on tapes. In v. ≥ 5.0.0 Jaglion, you can also select RDS to mount on from the drop-down list and specify advanced mount options. For more details on mount requirements and limitations, see Cross-Platform Recovery File System Layer.

Rst-wiz mount-option Jaglion.jpg

Information sign.png Note
  • It is recommended to enable this option for restore of specific data, such as Exchange, Hyper-V and V-Sphere backups, as it provides faster restore time and performance. By default, the target saveset is mounted to the SEP sesam home directory var\tmp\mnt, e.g., C:\Program Files\SEPsesam\var\tmp\mnt\saveset_ID. This way, the saveset is immediately accessible for browsing and searching before the actual restore is triggered, giving you 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.
  • The Mount saveset option is available only in advanced UI mode (formerly expert GUI mode). To use the mount option, make sure your UI mode is set to advanced, as described in Selecting UI mode.

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

Rst-wiz files Jaglion.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 the restore target settings. These settings differ slightly when restoring a virtual machine. The saveset selected for restore is displayed with its attributes at the top. In the Restore task name field, the name of the task is assigned automatically and can be modified.

Rst-wiz target Jaglion.jpg

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

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

The Target path settings provide the following options, which differ slightly for VM restore:

  • Restore to original target path or Restore to original VM (for 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., if the source and target server are the same.
    • The Original tree structure checkbox is selected by default when restoring to the 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).
  • Select New restore target or for VM Restore with new VM name (formerly Change VM target selection) if you want to restore the data to a different location. You can manually enter the path to the directory where the data is to be restored or use the Browse button.
    • If you choose Restore with new VM name, use the Browser button to select the restore location for your VM. Expand the Change VM target selection option to set additional options, e.g., define the target node or set data store path.

Execution options or VM restore options (for VM restore) provides the following options:

  • Do not overwrite existing items is selected by default. Files are restored only if they do not already exist on the target system.
  • Overwrite existing items replaces the files on the target system with their restored version.
  • Create a new version restores the files under a new name (not available for all restore types).

When performing a VM restore, you can also specify whether to start a virtual machine after restore.

Optional data source selection:

  • 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 you can select the source media from which to restore from the drop-down list of available media.
  • Drive: The number of the drive with the backed up data (more relevant for tape backups without a loader). Optionally, select the drive number of the drive to be used for reading the data. Typically, you use this if you have configured additional drives and want to assign dedicated drives for restore. 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.

Expert options
When you click the Expert options, a new window opens with different tabs where you can set more specific options and actions.

Information sign.png Note
The Expert Options button for setting advanced restore options is available only in advanced mode (formerly expert GUI mode). If you are running the GUI in simple mode (formerly basic GUI mode) and want to access Expert Options, change simple UI mode to advanced, as described in Selecting UI mode.

Rst-wiz expert-options Jaglion.jpg

Options tab

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

Setting Log level details
0 print only standard and error messages together with a 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 override the specifications defined in the previous steps.

  • Restore the complete saveset restores all files in the saveset.
  • Restore according to the composed list performs a selective restore according to regular expression-based filtering; see Filter tab below.
  • disk_info disaster recovery restores disk information, e.g., a master boot record and the registry during a disaster recovery.

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

Rst-wiz expert-options-relocation Jaglion.jpg

Filter tab
Files for 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 full 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 a given name regardless of location, use */file.txt.
  • Click New to add more patterns per line.

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

  • If you have backed up data with task type other than the default Path, e.g., 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 the Restore Assistant option Write backup into dump file) allows you to restore the entire saveset to a single file rather than to its original location.

Pre/Post tab
Specifies whether to apply a pre or post script for this restore task.

Information sign.png Note
To use a pre/post interface, you must first activate it 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.

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

Execution Time tab (formerly Start time)

  • Instead of starting your restore immediately, you can specify the start time by entering the desired date and time.
  • Start time frame: You can specify the maximum allowed start time (the amount of time an event can be in the queue) in days and/or hours. The actual start time of the event depends on the processor load of the system. At the start time of the event, every event is forwarded into the queue, where it might wait until jobs with a higher priority finish. 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.
  • Cancel execution after (formerly Stop task if it runs longer than): You can specify the amount of time (days and/or hours) after the event's scheduled start time, after which the event will be cancelled.
  • Cancel execution at (formerly Stop task at): Depending on the previous setting, it specifies the exact date and time when the task will 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.

Rst-wiz execution Jaglion.jpg

Step 6: Summary
In the final step of the restore wizard, review the summary of 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 via the menu item Activities -> Restore or via 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.