Source:Advanced Backup and Restore Options/de: Difference between revisions

From SEPsesam
(Created page with "Anmerkung")
(Updating to match new version of source page)
Line 1: Line 1:
__FORCETOC__  
__FORCETOC__  
<div class="noprint">
<noinclude><div class="noprint"><languages />
{{Copyright SEP AG‎|en}}
{{Copyright SEP AG|en}}
{{Draft}}
{{draft‎}}
 
{{Navigation_latest|release=[[SEP_sesam_Release_Versions|4.4.3 ''Beefalo''/''Beefalo V2'']]|link=[[Special:MyLanguage/SEP_sesam_Documentation#previous|Documentation archive]]}}</div><br />
{{Navigation_latest|release=[[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3 ''Beefalo''/''Beefalo V2'']]|link=[[Special:MyLanguage/SEP_sesam_Documentation#previous|Documentation archive]]}}</div><br />


==Overview==  
==Overview==
<div class="boilerplate metadata" id="Additional resources" style="background-color: #f0f0f0; color:#636f73; border: 1px ridge #cdd3db; margin: 0.5em; padding: 0.5em; float: right; width: 35%; "><center><b>
<div class="boilerplate metadata" id="Additional resources" style="background-color: #f0f0f0; color:#636f73; border: 1px ridge #cdd3db; margin: 0.5em; padding: 0.5em; float: right; width: 35%;"><center><b>Additional resources</b></center>
Additional resources</b></center>


{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
Line 31: Line 29:
|}
|}
</div>
</div>
SEP sesam enables you to specify additional (advanced) backup and restore options which are applicable for different [[Special:MyLanguage/SEP_sesam_Glossary#task_type|task types]], e.g., VMware vSphere, MySQL, etc. You can set additional backup or restore options in their properties or when creating a new backup/restore task.  
SEP sesam allows you to set additional (advanced) backup and restore options that apply to different [[Special:MyLanguage/SEP_sesam_Glossary#task_type|task types]], e.g., VMware vSphere, MySQL, etc. You can set additional backup or restore options in their properties or when creating a new backup/restore task.  


=={{anchor|options}}Setting advanced options==
=={{anchor|options}}Setting advanced options==


You can specify additional backup or restore options in the backup task properties: from ''Main Selection'' -> '''Tasks by Clients''' -> click '''New Backup Task''' or double-click the relevant backup task to open its properties. Under the '''Options''' tab -> '''Additional call arguments''' -> add your backup or restore option in the '''Backup options''' (previously ''Save options'') or '''Restore options''' field, respectively.  
You can specify additional backup or restore options in the backup task properties: from ''Main Selection'' -> '''Tasks by Clients''' -> click '''New Backup Task''' or double-click the relevant backup task to open its properties. Under the '''Options''' tab -> '''Additional call arguments''' -> add your backup or restore option to the '''Backup options''' (previously ''Save options'') or '''Restore options''' field, respectively.  


You can also use the restore wizard to specify additional restore options: From ''Target Seetings'' (fourth step of the restore wizard), under the '''Expert Options''' -> '''Options''' tab -> '''Restore options'''. For details, see [[Special:MyLanguage/4_4_3_Beefalo:Activities#expert_options|Expert Options]].
You can also use the restore wizard to specify additional restore options: From ''Target Settings'' (fourth step of the restore wizard), under the '''Expert Options''' -> '''Options''' tab -> '''Restore options'''. For details, see [[Special:MyLanguage/4_4_3_Beefalo:Activities#expert_options|Expert Options]].


{{Anmerkung|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|As of v. [[Special:MyLanguage/SEP_sesam_Release_Versions|4.4.3. ''Beefalo'']], the ''Expert Options'' button for setting advanced restore options is only available in [[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 ''Expert Options'', you first have to change ''Basic/Advanced'' UI mode to ''Expert'', as described in [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_GUI#UI_mode|Selecting UI mode]].}}


==={{anchor|VMware}}VMware restore===
==={{anchor|VMware}}VMware restore===
A VMware VM consists of data that is stored in a single disk file – the Virtual Machine Disk (VMDK) file format; it stores all contents of the VM's hard disk drive. Each VM can have one or more .vmdk files, which means that a VM can contain several VMDK files (or hard disk drives). The number of .vmdk files depends on the size of the virtual disk. VMDKs can be provisioned in three different formats: ''Thin'', ''Lazy Zero Thick (flat)'' or ''Eager Zero Thick''. To improve restore performance, you may want to change the provisioning method for restore.


When restoring a VMware VM, by default the VM's virtual disks are restored with their original provisioning used at the time of backup. You may force another disk provisioning method: ''thin'', ''eager'' or ''lazy'' that will be applied to all restored VMDKs, by specifying the following command in the restore options field:
A VMware VM consists of data that is stored in a single disk file – the Virtual Machine Disk (VMDK) file format; it stores the entire contents of the VM's hard disk drive. Each VM can have one or more .vmdk files, which means that a VM can contain several VMDK files (or hard disk drives). The number of .vmdk files depends on the size of the virtual disk. VMDKs can be provisioned in three different formats: ''Thin'', ''Lazy Zero Thick (flat)'' or ''Eager Zero Thick''. To improve restore performance, you might want to change the provisioning method for restore.
 
When restoring a VMware VM, the VM's virtual disks are restored with the original provisioning used at the time of backup. You may force a different disk provisioning method: ''thin'', ''eager'' or ''lazy'', which is applied to all restored VMDKs by specifying the following command in the restore options field:
  -a disk[type]=thin|eager|lazy
  -a disk[type]=thin|eager|lazy
If set, this option overrides the VMDK disk type of all VMDKs for VM restore.
If set, this option overrides the VMDK disk type of all VMDKs for VM restore.


==={{anchor|Linux_client}}Linux Client backup===
==={{anchor|Linux_client}}Linux Client backup===
===={{anchor|size_error}}SEP sesam Linux Client may encounter errors or warnings====
===={{anchor|size_error}}SEP sesam Linux Client may encounter errors or warnings====
A SEP sesam Linux Client may encounter errors or warnings during the backup due to the following:
 
*the size of a file has changed during backup
A SEP sesam Linux Client may encounter errors or warnings during backup for the following reasons:
*the size of a file has changed during the backup
*a file is deleted during the backup (between 'find' and data processing)
*a file is deleted during the backup (between 'find' and data processing)
*the 'find' function encountered an error
*the 'find' function has encountered an error


To avoid these warnings and resolve the above errors, double-click the backup task to open its properties and under the ''Options'' tab in the ''Backup options'' field enter the following command:
To avoid these warnings and fix the above errors, double-click the backup task to open its properties and under the ''Options'' tab in the ''Backup options'' field enter the following command:
  -o ignore_finderr=<regex>|ALL
  -o ignore_finderr=<regex>|ALL
If you want to avoid all such errors/warnings, specify:
If you want to avoid all such errors/warnings, specify:
  -o ignore_finderr=ALL
  -o ignore_finderr=ALL


===={{anchor|include_option}}The ''exclude'' list for Linux Client backup can be also used as ''include'' list====
===={{anchor|include_option}}The ''exclude'' list for Linux Client backup can also be used as an ''include'' list====


When specifying the exclude list on the SEP sesam Linux Client, it is possible to change the exclude to the include filter by using the '''+''' (plus) sign at the beginning of a pattern. In this case only the items that match the defined pattern (''regex'') will be included in the backup.
When specifying the exclude list on SEP sesam Linux Client, it is possible to change the exclude to include filter by using the '''+''' (plus) sign at the beginning of a pattern. In this case, only the items that match the defined pattern (''regex'') are included in the backup.


=====GUI=====
====={{anchor|GUI}}GUI=====
The easiest way to turn the exclude list to include is by using the ''GUI Exclude list'': Create or open a backup task and enter the following in the ''Exclude List'' field:
The easiest way to turn the exclude list to an include list is to use the ''GUI Exclude list'': Create or open a backup task and enter the following in the ''Exclude List'' field:
  <span style="color:red">+</span><regex>
  <span style="color:red">+</span><regex>
for example
for example
  +xxx.*
  +xxx.*
or if there are different patterns, you can combine the exclude and include filter as follows:
or if there are different patterns, you can combine the exclude and include filters as follows:
  <span style="color:red">+</span>abc.*,<span style="color:red">+</span>.*xyz.*,*\.bak
  <span style="color:red">+</span>abc.*,<span style="color:red">+</span>.*xyz.*,*\.bak
where the preceding '''+''' defines the include while the pattern without the plus defines the exclude filter.
where the preceding '''+''' defines the include filter, while the pattern without the plus (+) defines the exclude filter.
 
{{note|Regex mandates that every pattern is followed by a comma.}}
{{note|Regex mandates that every pattern is followed by a comma.}}


=====SBC CLI=====
====={{anchor|CLI}}SBC CLI=====
 
Alternatively, to create the include filter and include only the items that match the defined pattern (via the regular expression) using the [[Special:MyLanguage/SBC CLI|SBC CLI]], enter the command <tt>sbc -b</tt> with the <tt>-x</tt> (exclude regex) parameter (for the exclude list), followed by '''+''' at the beginning of the specified pattern, as shown in the following example:  
Alternatively, to create the include filter and include only the items that match the defined pattern (via the regular expression) using the [[Special:MyLanguage/SBC CLI|SBC CLI]], enter the command <tt>sbc -b</tt> with the <tt>-x</tt> (exclude regex) parameter (for the exclude list), followed by '''+''' at the beginning of the specified pattern, as shown in the following example:  
  sbc -b -s @/dev/null -v 1 -x '<span style="color:red">+</span>xxx.*' /tmp/test-regex/1/
  sbc -b -s @/dev/null -v 1 -x '<span style="color:red">+</span>xxx.*' /tmp/test-regex/1/


*For more details on how to use regular expressions, see [[Special:MyLanguage/RegExp:_Examples_for_Excluding_Matched_Patterns|Examples for Excluding Matched Patterns]].
*For more details on using regular expressions, see [[Special:MyLanguage/RegExp:_Examples_for_Excluding_Matched_Patterns|Examples for Excluding Matched Patterns]].
*For more details on exclude lists, see [[Special:MyLanguage/Creating_Exclude_List|Creating Exclude List]].  
*For more details on exclude lists, see [[Special:MyLanguage/Creating_Exclude_List|Creating Exclude List]].


<div class="noprint">
<div class="noprint">


==See also==
==See also==
[[Special:MyLanguage/Standard_Backup_Procedure|Standard Backup Procedure]] – [[Special:MyLanguage/Standard_Restore_Procedure|Standard Restore Procedure]] – [[Special:MyLanguage/4_4_3_Beefalo:Activities#expert_options|Expert Options]]</div>
[[Special:MyLanguage/Standard_Backup_Procedure|Standard Backup Procedure]] – [[Special:MyLanguage/Standard_Restore_Procedure|Standard Restore Procedure]] – [[Special:MyLanguage/4_4_3_Beefalo:Activities#expert_options|Expert Options]]</div>

Revision as of 13:15, 10 June 2021

Other languages:

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.

Draft.png WORK IN PROGRESS
This article is in the initial stage and may be updated, replaced or deleted at any time. It is inappropriate to use this document as reference material as it is a work in progress and should be treated as such.
Docs latest icon.png Willkommen in der aktuellsten Version der SEP sesam Dokumentation 4.4.3 Beefalo/Beefalo V2. Frühere Versionen der Dokumentation finden Sie hier: Documentation archive.


Overview

SEP sesam allows you to set additional (advanced) backup and restore options that apply to different task types, e.g., VMware vSphere, MySQL, etc. You can set additional backup or restore options in their properties or when creating a new backup/restore task.

Setting advanced options

You can specify additional backup or restore options in the backup task properties: from Main Selection -> Tasks by Clients -> click New Backup Task or double-click the relevant backup task to open its properties. Under the Options tab -> Additional call arguments -> add your backup or restore option to the Backup options (previously Save options) or Restore options field, respectively.

You can also use the restore wizard to specify additional restore options: From Target Settings (fourth step of the restore wizard), under the Expert Options -> Options tab -> Restore options. For details, see Expert Options.

Information sign.png Anmerkung
As of v. 4.4.3. Beefalo, the Expert Options button for setting advanced restore options is only available in 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 Expert Options, you first have to change Basic/Advanced UI mode to Expert, as described in Selecting UI mode.

VMware restore

A VMware VM consists of data that is stored in a single disk file – the Virtual Machine Disk (VMDK) file format; it stores the entire contents of the VM's hard disk drive. Each VM can have one or more .vmdk files, which means that a VM can contain several VMDK files (or hard disk drives). The number of .vmdk files depends on the size of the virtual disk. VMDKs can be provisioned in three different formats: Thin, Lazy Zero Thick (flat) or Eager Zero Thick. To improve restore performance, you might want to change the provisioning method for restore.

When restoring a VMware VM, the VM's virtual disks are restored with the original provisioning used at the time of backup. You may force a different disk provisioning method: thin, eager or lazy, which is applied to all restored VMDKs by specifying the following command in the restore options field:

-a disk[type]=thin|eager|lazy

If set, this option overrides the VMDK disk type of all VMDKs for VM restore.

Linux Client backup

SEP sesam Linux Client may encounter errors or warnings

A SEP sesam Linux Client may encounter errors or warnings during backup for the following reasons:

  • the size of a file has changed during the backup
  • a file is deleted during the backup (between 'find' and data processing)
  • the 'find' function has encountered an error

To avoid these warnings and fix the above errors, double-click the backup task to open its properties and under the Options tab in the Backup options field enter the following command:

-o ignore_finderr=<regex>|ALL

If you want to avoid all such errors/warnings, specify:

-o ignore_finderr=ALL

The exclude list for Linux Client backup can also be used as an include list

When specifying the exclude list on SEP sesam Linux Client, it is possible to change the exclude to include filter by using the + (plus) sign at the beginning of a pattern. In this case, only the items that match the defined pattern (regex) are included in the backup.

GUI

The easiest way to turn the exclude list to an include list is to use the GUI Exclude list: Create or open a backup task and enter the following in the Exclude List field:

+<regex>

for example

+xxx.*

or if there are different patterns, you can combine the exclude and include filters as follows:

+abc.*,+.*xyz.*,*\.bak

where the preceding + defines the include filter, while the pattern without the plus (+) defines the exclude filter.

Information sign.png Anmerkung
Regex mandates that every pattern is followed by a comma.
SBC CLI

Alternatively, to create the include filter and include only the items that match the defined pattern (via the regular expression) using the SBC CLI, enter the command sbc -b with the -x (exclude regex) parameter (for the exclude list), followed by + at the beginning of the specified pattern, as shown in the following example:

sbc -b -s @/dev/null -v 1 -x '+xxx.*' /tmp/test-regex/1/