Source:Citrix Hypervisor Single File Restore: Difference between revisions

From SEPsesam
mNo edit summary
(replacing screenshots)
 
(18 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Draft}}<div class="noprint">{{Copyright SEP AG‎|en}}
<noinclude><div class="noprint"><languages />
<br />


{{Navigation_latest|release=[[SEP_sesam_Release_Versions|5.0.0 ''Jaglion'']]|link=[[Special:MyLanguage/Citrix_XEN_Server|Documentation archive]]}}</div><br />
<translate>==Overview== <!--T:3--></translate>


==Overview==
</div></noinclude><translate><!--T:8-->
<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>
 
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP_next.png|45px|link=5_0_0:Restore_Assistant]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | See also: [[Special:MyLanguage/Citrix_XenServer_Restore|Citrix XenServer Restore]] – [[Special:MyLanguage/5_0_0:Web_Single_File_Restore_for_Virtual_Machines|Web Single File Restore for Virtual Machines]] – [[Special:MyLanguage/5_0_0:Restore_Assistant|Restore Assistant]] –  [[Special:MyLanguage/5_0_0:About_Authentication_and_Authorization|About Authentication and Authorization]]
|}
 
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP Tip.png|45px|link=Special:MyLanguage/FAQ|FAQ]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
Check [[Special:MyLanguage/FAQ|FAQ]] to find the answers to most common questions.
|}
 
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP Troubleshooting.png|45px|link=Troubleshooting_Guide]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | Problems? Check the [[Special:MyLanguage/Troubleshooting_Guide|Troubleshooting Guide]].
|}</div>
SEP sesam supports single file restore – item-level restore of files, folders and volumes from the ''FULL'', ''DIFF'' or ''INCR'' backup of the Citrix Hypervisor virtual machine if the saveset is stored on a SEP sesam [[Special:MyLanguage/SEP_sesam_Glossary#data_store|data store]] (Path, Si3 deduplication store, etc.). By mounting the VHD, the operating system creates a virtual drive from the file, assigns it a drive letter, and makes the drive available locally on your server.
SEP sesam supports single file restore – item-level restore of files, folders and volumes from the ''FULL'', ''DIFF'' or ''INCR'' backup of the Citrix Hypervisor virtual machine if the saveset is stored on a SEP sesam [[Special:MyLanguage/SEP_sesam_Glossary#data_store|data store]] (Path, Si3 deduplication store, etc.). By mounting the VHD, the operating system creates a virtual drive from the file, assigns it a drive letter, and makes the drive available locally on your server.


You can restore single files using the [[Special:MyLanguage/5_0_0:Citrix_Hypervisor_Single_File_Restore#GUI|''GUI restore wizard'']] or through the web interface [[Special:MyLanguage/5_0_0:Citrix_Hypervisor_Single_File_Restore#restore_assistant|''Restore Assistant'']] (in v. ≥ 5.0.0 ''Jaglion''). Although most options are the same in both restore interfaces, the web interface Restore Assistant is more intuitively designed and offers additional advanced options.  
<!--T:9-->
You can restore single files using the [[#GUI|''GUI restore wizard'']] or via the web interface [[#restore_assistant|''Restore Assistant'']] (in v. ≥ 5.0.0 ''Jaglion''). Although most options are the same in both restore interfaces, the web interface Restore Assistant is more intuitively designed and offers additional advanced options.  


Note that this article only describes the procedure for restoring individual Citrix virtual machine (VM) files. For details on complete VM restore, see the Citrix VM restore procedures in the [[Special:MyLanguage/Citrix_XenServer_Restore|GUI]] and [[Special:MyLanguage/5_0_0:Restore_Assistant|web Restore Assistant]].
<!--T:10-->
Note that this article only describes the procedure for restoring individual files of a Citrix VM. For details on complete VM restore, see [[Special:MyLanguage/Citrix_XenServer_Restore|Citrix XenServer Restore in the GUI]] or [[Special:MyLanguage/Restore_Assistant#VMs_restore|VMs restore via web interface Restore Assistant]].


===Prerequisites===  
===Prerequisites=== <!--T:11-->


<!--T:12-->
Before attempting to restore a single file, all preparation steps have to be performed properly, including configuration and VM backup. For details, see the [[Special:MyLanguage/Citrix_XEN_Server|Citrix documentation]].  
Before attempting to restore a single file, all preparation steps have to be performed properly, including configuration and VM backup. For details, see the [[Special:MyLanguage/Citrix_XEN_Server|Citrix documentation]].  


To ensure error-free operation of SEP sesam and improve performance, make sure that the following conditions are met:
<!--T:13-->
*SEP sesam Server version ≥ [[SEP_sesam_Release_Versions|5.0.0 ''Jaglion'']]. For the list of supported systems, see [[4_4_3_Beefalo:SEP_sesam_OS_and_Database_Support_Matrix#Citrix|Citrix Support Matrix]].
To ensure error-free operation of SEP sesam and improve performance, make sure that the following conditions are met:</translate>
*Backups must not be [[Special:MyLanguage/SEP_sesam_Glossary#encryption|encrypted]], [[Special:MyLanguage/SEP_sesam_Glossary#compression|compressed]] or stored on tape.
*<translate><!--T:14--> SEP sesam Server version ≥ [[SEP_sesam_Release_Versions|5.0.0 ''Jaglion'']]. For the list of supported systems, see [[SEP_sesam_OS_and_Database_Support_Matrix#Citrix|Citrix Support Matrix]].</translate>
*To restore single files via the web interface ''Restore Assistant'', appropriate permissions are required. For details, see [[Special:MyLanguage/5_0_0:About_Authentication_and_Authorization|About Authentication and Authorization]].
*<translate><!--T:91--> Single file restore (SFR) of backups from virtualization platforms, e.g. Citrix, requires the ''guestfs-tools package'' to be installed on Linux in order to access and mount VM disk image on Linux. If the package is not installed on your SEP sesam Server or Linux RDS, it is not possible to mount VMDK and perform SFR. Refer to [[Special:MyLanguage/Installing_guestfs-tools_on_Linux|Installing guestfs-tools on Linux]].</translate>
*Before starting a restore, check the [[Special:MyLanguage/Cross-Platform_Recovery_File_System_Layer#restrictions|restrictions]] for mounting the virtual disk (VHD file).
*<translate><!--T:15--> Backups must not be [[Special:MyLanguage/SEP_sesam_Glossary#encryption|encrypted]], [[Special:MyLanguage/SEP_sesam_Glossary#compression|compressed]] or stored on tape.</translate>
*<translate><!--T:16--> To restore single files via the web interface ''Restore Assistant'', appropriate permissions are required. For details, see [[Special:MyLanguage/About_Authentication_and_Authorization|About Authentication and Authorization]].</translate>
*<translate><!--T:17-->
Before starting a restore, check the [[Special:MyLanguage/Cross-Platform_Recovery_File_System_Layer#restrictions|restrictions]] for mounting the virtual disk (VHD file).</translate>
 
==={{anchor|restore_options}}<translate><!--T:18-->
Restore options===


==={{anchor|restore_options}}Restore options===
<!--T:19-->
When restoring individual files from Citrix VM backups, you can choose from the following ''VM restore options'' to perform restore according to your needs:</translate>
<ul><li><translate><!--T:20--> '''''Do not overwrite an items''''': (default) Files are only restored if they do not already exist on the target system.</translate></li>
<li><translate><!--T:21--> '''''Overwrite an existing items''''': If the data exists on the target server, it is replaced with the restored version.</translate></li>
<li><translate><!--T:22--> '''''Create new version:''''' Restore files under a new name.</translate></li>
<li><translate><!--T:23--> '''''Keep original tree structure''''': When restoring to the original location, the ''Keep original tree structure'' option is selected by default. The directory structure of the restored files is the same as the original directory structure of the backed up data.</translate></li>
<li><translate><!--T:24--> '''''Restore all items flat in the selected target directory''''': The backup is simply restored to a file without recreating the directory structure.</translate></li>
<li><translate><!--T:25--> You can also select to '''''skip ACL settings during restore'''''.</translate></li></ul>


When restoring individual files from Citrix VM backups, you can choose from the following ''VM restore options'' to perform restore according to your needs:
=={{anchor|single_file}}<translate><!--T:26-->
<ul><li>'''''Do not overwrite an existing virtual machine:''''' (default) The VM will not be restored if a VM with the same name already exists on the target server. In this case, the following error is displayed: ''Error: Restore failed. A virtual machine with the same name already exists.''. A new VM name has to be specified as the target. The MAC address of a restored VM is recreated.</li>
Restoring single file (SFR)==
<li>'''''Overwrite an existing virtual machine''''': If a VM with the same name exists on the target server, it will be replaced with the restored version, but its MAC address will remain the same. Note that if two VMs with the same name exist on the target server, the restore fails with: ''Error: Restore failed. A virtual machine with the same name already exists.''</li>
<li>'''''Restore an existing virtual machine with a new name''''': Restores the VM under a new name.</li>
<li>You can also choose whether to start your virtual machine automatically after restore by selecting '''''Start virtual machine after restore'''''/'''''Do not start''''' (selected by default).</li></ul>


=={{anchor|single_file}}Restoring single files==
<!--T:27-->
Depending on the interface you are using, follow the appropriate procedure to restore individual Citrix Hypervisor VM files:</translate>
*<translate><!--T:28--> [[#GUI|''Single file restore via GUI'']]</translate>
*<translate><!--T:29-->
[[#restore_assistant|Single file restore via ''Restore Assistant'']]


You can restore individual files using the [[Special:MyLanguage/5_0_0:Citrix_Hypervisor_Single_File_Restore#GUI|SEP sesam GUI]] or the [[Special:MyLanguage/5_0_0:Citrix_Hypervisor_Single_File_Restore#restore_assistant|web Restore Assistant]]. The single file restore is only supported in ''advanced'' (''Expert'') UI mode. Therefore, you must first switch from basic to advanced mode, as described in [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_GUI#UI_mode|Setting UI mode in the GUI]] and [[Special:MyLanguage/5_0_0:Restore_Assistant#UI_mode|Setting UI mode in the Restore Assistant]].
<!--T:30-->
Restoring a single file (SFR) is supported only in [[Special:MyLanguage/SEP_sesam_GUI#UI_mode|''advanced'']] UI mode (formerly ''expert'' mode in the GUI). For details on switching the UI mode, see [[Special:MyLanguage/SEP_sesam_GUI#UI_mode|Setting the UI mode in the GUI]] and [[Special:MyLanguage/Restore_Assistant#UI_mode|Setting the UI mode in the ''Restore Assistant'']].</translate>


==={{anchor|GUI}}Using the GUI restore wizard===
==={{anchor|GUI}}<translate><!--T:31-->
Single file restore via the GUI===  


After [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_GUI#UI_mode|setting the UI mode to ''Expert'']], create a new restore task for the individual item(s) you want to restore.
<!--T:32-->
Make sure your UI mode is set to [[Special:MyLanguage/SEP_sesam_GUI#UI_mode|advanced]] (formerly ''expert'') and create a new restore task for the individual item(s) you want to restore.</translate>


<ol><li>From the SEP sesam GUI menu bar, select '''Activities''' -> '''Restore'''. The ''New Restore Task'' window opens.</li>
<ol><li><translate><!--T:33--> From the SEP sesam GUI menu bar, select '''Activities''' -> '''Restore'''. The ''New Restore Task'' window opens.</translate></li>
<li>Select what you want to restore. You can search savesets by ''task name'' or by ''filename or path''.
<li><translate><!--T:34--> Select what you want to restore. You can search savesets by ''task name'' or by ''filename or path''.</translate>
* When searching by ''task name'', use the drop-down list of available tasks and select the one you want to restore from. This option is selected by default.
*<translate><!--T:35--> When searching by ''task name'', use the drop-down list of available tasks and select the one you want to restore from. This option is selected by default.</translate>
* If you are searching by filename/path, select the option '''Filename or path in a saveset''' and enter your search expression in the search pattern field.</li>
*<translate><!--T:36--> If you are searching by filename/path, select the option '''Filename or path in a saveset''' and enter your search expression in the search pattern field.</translate></li>
<li>In the '''Saved in period''' drop-down lists, specify the time frame for which you want to conduct the search. Click '''Next'''.</li>
<li><translate><!--T:37--> In the '''Saved in period''' drop-down lists, specify the time frame for which you want to conduct the search. Click '''Next'''.</translate></li>
<li>The search results are displayed. From the list of savesets matching your query, select the version from which you want to restore an individual file. Then select the '''Mount virtual disk(s)''' check box. Note that some [[Special:MyLanguage/Cross-Platform_Recovery_File_System_Layer#restrictions|restrictions]] apply.</li>
<li><translate><!--T:38--> The search results are displayed. From the list of savesets matching your query, select the version from which you want to restore an individual file. Then select the '''Mount virtual disk(s)''' check box. Note that some [[Special:MyLanguage/Cross-Platform_Recovery_File_System_Layer#restrictions|restrictions]] apply.</translate></li>
You can also select ''RDS to mount'' from the drop-down list and specify ''advanced mount options''.
<translate><!--T:39--> You can also select ''RDS to mount'' from the drop-down list and specify ''advanced mount options''.</translate>
<!--[[image:Citrix_restore_mount_Jaglion.jpg|760px|link=]]
*{{note|<translate><!--T:92--> To be able to access and mount VM disk image on Linux, the ''guestfs-tools package'' must be installed on your SEP sesam Server or Linux RDS. If the ''guestfs-tools package'' is not installed, it is not possible to mount VMDK and perform SFR. Refer to [[Special:MyLanguage/Installing_guestfs-tools_on_Linux|Installing guestfs-tools on Linux]].</translate>}}
<br clear=all>-->
<br />
<li>[[Special:MyLanguage/SEP_sesam_Glossary#mount|Mount]] is triggered and all VHDs of the selected VM are mounted to the device server using one or more unused drive letters of the Windows system e.g., ''D:'', ''E:'', etc. This may take a few seconds. Click '''OK'''.<br />
<translate><!--T:40--> [[image:Citrix_restore_mount_Apollon.jpg|830px|link=]]</translate>
<!--[[image:Citrix_restore_mount_to_device_server_Jaglion.jpg|760px|link=]]
<br clear=all>
<br clear=all>-->
<li><translate><!--T:41--> [[Special:MyLanguage/SEP_sesam_Glossary#mount|Mount]] is triggered and all VHDs of the selected VM are mounted to the device server using one or more unused drive letters of the Windows system e.g., ''D:'', ''E:'', etc. This may take a few seconds. Click '''OK'''.</translate><br />
<li>You can now either use the file explorer on your server to browse and copy the needed files directly to the target location, or click '''Next''' to select the required files in the ''Select Files'' dialog.</li>
<translate><!--T:42--> [[image:Citrix_restore_mount_to_device_server_Apollon.jpg|830px|link=]]</translate>
<li>If you clicked '''Next''', in the '''Select Files''' window select the data you want to restore and click '''Next'''.</li>
<br clear=all>
<!--[[image:Citrix_select_files_Jaglion.jpg|760px|link=]]
<li><translate><!--T:88--> In the '''Select Files''' window, select the data you want to restore and click '''Next'''.</translate></li>
<br clear=all>-->
<translate><!--T:45--> [[image:Citrix_select_files_Apollon.jpg|830px|link=]]</translate>
<li>On the fourth step of the restore wizard (''Target Settings''), select a restore target where you want to restore your files.</li>
<br clear=all>
Then select an appropriate '''VM restore option''' (''Overwrite existing virtual machine'', etc.) as [[Special:MyLanguage/5_0_0:Citrix_Hypervisor_Single_File_Restore#restore_options|described in the above section]].
<li><translate><!--T:46--> On the fourth step of the restore wizard (''Target Settings''), select a restore target where you want to restore your files.</translate></li>
<li>In the final step of the restore wizard, you can review all the settings of your restore task. You can start your single file restore immediately by clicking '''Start'''. If you want to save the restore task, click '''Save'''.</li>
<translate><!--T:47--> Then select an appropriate '''Execution option''' (''Overwrite existing items'', etc.) as [[#restore_options|described in the above section]].</translate><br />
<li>Click '''OK''' to unmount the saveset and close your restore session.></li>
<translate><!--T:89--> [[image:Citrix_select_target_Apollon.jpg|830px|link=]]</translate>
<br clear=all>
<li><translate><!--T:48--> In the final step of the restore wizard, you can review all the settings of your restore task. You can start your single file restore immediately by clicking '''Start'''. If you want to save the restore task, click '''Save'''.</translate></li>
<translate><!--T:90--> [[image:Citrix_final_Apollon.jpg|830px|link=]]</translate>
<br clear=all>
<li><translate><!--T:49--> Click '''OK''' to unmount the saveset and close your restore session.</translate></li>
</ol>
</ol>
In the GUI, the restore task can be scheduled like any other task. If you want to add a restore task to the schedule, see [[Special:MyLanguage/Scheduling_Restore|Scheduling Restore]].


==={{anchor|restore_assistant}}Using the web Restore Assistant===
==={{anchor|restore_assistant}}<translate><!--T:50-->
Single file restore via the Restore Assistant===  
 
<!--T:51-->
You can access the ''Restore Assistant'' in one of the following ways:</translate>
*<translate><!--T:52--> via the GUI: by clicking the ''Restore Assistant icon'' in the toolbar or from ''Activities'' -> ''Restore Assistant''</translate>
*<translate><!--T:53--> from SEP sesam Web UI: left menu -> ''Restore Assistant''</translate>
*<translate><!--T:54--> or by entering the following address in the browser bar: ''http://[sesamserver]:11401/sep/ui/restore/''.</translate>


With ''Jaglion'', you can also restore individual items in the web interface Restore Assistant if you have the appropriate permissions. Note that while Restore Assistant provides additional advanced options, it does not support scheduling. Currently it is only supported in the SEP sesam GUI.
{{note|
*<translate><!--T:56--> If you cannot access the web ''Restore Assistant'', check if you have received the appropriate permissions for online restore.</translate>
*<translate><!--T:57--> 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'']].</translate><br /><translate><!--T:58--> For details, see [[Special:MyLanguage/About_Authentication_and_Authorization|About Authentication and Authorization]] and [[Special:MyLanguage/User_Roles_and_Permissions|User Roles and Permissions]].</translate>}}


<ol><li>Open the ''Restore Assistant'' in the browser. There are three ways to do this:</li>
<translate><!--T:59-->
*via the GUI: by clicking the ''Restore Assistant icon'' in the toolbar or from ''Activities'' -> ''Restore Assistant''
You can restore individual files of a Citrix Hypervisor VM in the web interface in the ''advanced'' UI mode if you have the appropriate permissions. For more details on the UI mode, see
*from SEP sesam Web UI: left menu -> ''Restore Assistant''
[[Special:MyLanguage/Restore_Assistant#UI_mode|Setting UI mode in the Restore Assistant]].</translate>  
*or by entering the following address in the browser bar: ''http://[sesamserver]:11401/sep/ui/restore/''.
<ol><li><translate><!--T:60--> Open the ''Restore Assistant'' in the browser.</translate></li>
<li>In the ''Start'' window, select '''Citrix Hypervisor'''restore type. Then select the option '''Advanced View'''. The ''VM or single file restore'' option is selected by default. Click '''Next'''.
<li><translate><!--T:61--> In the ''Start'' window, select '''Citrix Hypervisor'''. Then select the option '''Advanced View'''. The ''VM or single file restore'' option is selected by default. Click '''Next'''.</translate></li>
[[image:Restore_assistant_SFR_Citrix_start_Jaglion.jpg|680px|link=]]
<translate><!--T:62--> [[image:Restore_assistant_SFR_Citrix_start_Apollon.jpg|660px|link=]]</translate>
<br clear=all>
<br clear=all>
<li>In the ''Virtual Machine'' window, under ''Selection of the server'', select your target server.</li>
<li><translate><!--T:63--> In the ''Virtual Machine'' window, under ''Selection of the server'', select your target Citrix server to which the data will be restored.</translate></li>
Then, under ''Selection of the virtual machine'', select the VM that you want to restore.</li>
<translate><!--T:64--> Then, under ''Selection of the virtual machine'', select the VM that you want to restore and click '''Next'''.</translate><br />
Click '''Next'''.<br />
<translate><!--T:65--> [[image:Restore_assistant_Citrix_select_server_Apollon.jpg|660px|link=]]</translate>
[[image:Restore_assistant_Citrix_select_server_Jaglion.jpg|680px|link=]]
<br clear=all>
<br clear=all>
<li>In the ''Task'' window, under ''Task selection'', select your source task. A [[Special:MyLanguage/SEP_sesam_Glossary#backup_task|backup task]] defines the source data that was backed up by the client.</li>  
<li><translate><!--T:66--> In the ''Task'' window, under ''Task selection'', select your source task. A [[Special:MyLanguage/SEP_sesam_Glossary#backup_task|backup task]] defines the source data that was backed up by the client.</translate></li>  
Then, under ''Backup selection'', select the exact backup version you want to restore. You can use the calendar feature in the upper right corner to filter a date range for the backups displayed. Select the '''Single file restore''' option and click '''Next'''.</li>  
<translate><!--T:67--> Then, under ''Backup selection'', select the exact backup version you want to restore. You can use the calendar function in the upper right corner to set a date range for the displayed backups. Select the '''Single file restore''' option (in the lower right corner) and click '''Next'''.</translate>  
[[image:Restore_assistant_SFR_Citrix_select_task_Jaglion.jpg|680px|link=]]
<translate><!--T:68--> [[image:Restore_assistant_SFR_Citrix_select_task_Apollon.jpg|660px|link=]]</translate>
<br clear=all>
<br clear=all>
<li>In the ''Files'' window, you have to select the SEP sesam Server or RDS to which you want to ''mount'' the backup. You can also specify an ''alternate mount path'' and/or ''advanced mount options''.</li>
<li><translate><!--T:69--> In the ''Files'' window, select the SEP sesam Server or RDS to which you want to ''mount'' the backup. You can also specify an ''alternate mount path'' and/or ''advanced mount options''. Then click the button '''Mount this backup in filesystem'''. A new window will appear showing the progress of the mount process.</translate></li>
{{Note|Mounting is not possible if the savesets are stored on tapes or if the data is compressed or encrypted. Some other [[Special:MyLanguage/Cross-Platform_Recovery_File_System_Layer#restrictions|XPRFS restrictions]] also apply to mounting.}}
{{note|
[[image:Restore_assistant_SFR_Citrix_mount_Jaglion.jpg|680px|link=]]
<translate><!--T:93--> *To be able to access and mount VM disk image on Linux, the ''guestfs-tools package'' must be installed on your SEP sesam Server or Linux RDS. If the ''guestfs-tools package'' is not installed, it is not possible to mount VMDK and perform SFR. Refer to [[Special:MyLanguage/Installing_guestfs-tools_on_Linux|Installing guestfs-tools on Linux]].</translate>
*<translate><!--T:71--> Mounting is not possible if the savesets are stored on tapes or if the data is compressed or encrypted. Some other [[Special:MyLanguage/Cross-Platform_Recovery_File_System_Layer#restrictions|XPRFS restrictions]] also apply to mounting.</translate>}}
<translate><!--T:72--> [[image:Restore_assistant_SFR_Citrix_mount_Apollon.jpg|660px|link=]]</translate>
<br clear=all>
<br clear=all>
<li>Once a virtual disk is mounted on the device server, select the files you want to restore and click '''Next'''. </li>
<li><translate><!--T:73--> Once a virtual disk is mounted on the device server, select the files you want to restore and click '''Next'''.</translate></li>
[[image:Restore_assistant_SFR_Citrix_files_Jaglion.jpg|680px|link=]]
<translate><!--T:74--> [[image:Restore_assistant_SFR_Citrix_files_Apollon.jpg|660px|link=]]</translate>
<br clear=all>
<br clear=all>
<li>In the ''Target'' window, under ''Target selection'', select your target environment for restore. You can use the drop-down list to select or filter VMs by name.</li>
<li><translate><!--T:75--> In the ''Target'' window, under ''Target selection'', select your target environment for the restore. You can use the drop-down list to select or filter VMs by name.</translate></li>
[[image:Restore_assistant_SFR_select_Citrix_target_Jaglion.jpg|700px|link=]]
<translate><!--T:76--> Then enter or browse for your target path and select an appropriate '''Execution option''' (''Overwrite existing files'', etc.) as [[#restore_options|described in the above section]]. Click '''Next'''.</translate><br />
<translate><!--T:77--> [[image:Restore_assistant_SFR_select_Citrix_target_Apollon.jpg|660px|link=]]</translate>
<br clear=all>
<br clear=all>
Then select an appropriate '''VM restore option''' (''Overwrite existing virtual machine'', etc.) as [[Special:MyLanguage/5_0_0:Citrix_Hypervisor_Single_File_Restore#restore_options|described in the above section]]. Click '''Next'''.<br />
<li><translate><!--T:78--> In the ''Options'' window, you can specify additional advanced options, such as selecting a data source (media pool, drive, etc.), set include/exclude filters, etc. For details on the available options, see [[Special:MyLanguage/Restore_Assistant#advanced_restore|Online restore in advanced UI mode]].</translate></li>
[[File:Restore_assistant_SFR_Citrix_execution_options_Jaglion.jpg|680px|link=]]
<translate><!--T:79--> Click '''Next'''.</translate><br />
<li>In the ''Options'' window, you can specify additional advanced options, such as selecting a data mover and a data store, specifying target and recovery options, and so on. For details on the available options, see [[Special:MyLanguage/5_0_0:Restore_Assistant#VMs_advanced_restore|Restoring virtual machines in advanced UI mode]].</li>
<translate><!--T:80--> [[image:Restore_assistant_SFR_Citrix_recovery_options_Apollon.jpg|660px|link=]]</translate>
Click '''Next'''.<br />
<br clear=all>
[[image:Restore_assistant_SFR_Citrix_recovery_options_Jaglion.jpg|680px|link=]]
<li><translate><!--T:81--> In the last step, check the summary of your restore task (restore type (based on task type, selected backup, its date and details, restore options, etc.) and click '''Start restore'''.</translate></li>
<translate><!--T:82--> [[image:Restore_assistant_SFR_Citrix_final_Apollon.jpg|660px|link=]]</translate>
<br clear=all>
<br clear=all>
<li>In the final step, review your restore task and click '''Start restore'''.</li>
</ol>
</ol>


=={{anchor|monitor}}Monitoring restore==
=={{anchor|monitor}}<translate><!--T:83-->
 
Monitoring restore==
You can view the status of your restores in the GUI (''Job State'' -> ''Restores'') or [[Special:MyLanguage/5_0_0:SEP_sesam_Web_UI|SEP sesam Web UI]] (''Monitoring'' -> ''Restores''). Restore overview provides detailed information about the last run of restore jobs, including the task name, status (successful, error, in queue ...), start and stop time of the last backup, data size, throughput, client, and message.


<div class="noprint">
<!--T:87-->
==See also==
You can view the status of your restore jobs in the ''Restore Assistant'' by clicking the ''monitoring'' icon (second icon in the upper right corner), via SEP sesam ''Web UI'' (''Monitoring'' -> ''Restores'') or SEP sesam GUI (''Main Selection'' -> ''Job State'' -> ''Restores''). For details, see [[Special:MyLanguage/Monitoring_and_Reporting|Monitoring and Reporting]].</translate>


[[Special:MyLanguage/Citrix_XenServer_Restore|Citrix XenServer Restore]] – [[Special:MyLanguage/5_0_0:Web_Single_File_Restore_for_Virtual_Machines|Web Single File Restore for Virtual Machines]] – [[Special:MyLanguage/5_0_0:Restore_Assistant|Restore Assistant]] –  [[Special:MyLanguage/5_0_0:About_Authentication_and_Authorization|About Authentication and Authorization]]</div>
<noinclude>{{Copyright}}</noinclude>

Latest revision as of 12:46, 29 May 2023

SEP sesam supports single file restore – item-level restore of files, folders and volumes from the FULL, DIFF or INCR backup of the Citrix Hypervisor virtual machine if the saveset is stored on a SEP sesam data store (Path, Si3 deduplication store, etc.). By mounting the VHD, the operating system creates a virtual drive from the file, assigns it a drive letter, and makes the drive available locally on your server.

You can restore single files using the GUI restore wizard or via the web interface Restore Assistant (in v. ≥ 5.0.0 Jaglion). Although most options are the same in both restore interfaces, the web interface Restore Assistant is more intuitively designed and offers additional advanced options.

Note that this article only describes the procedure for restoring individual files of a Citrix VM. For details on complete VM restore, see Citrix XenServer Restore in the GUI or VMs restore via web interface Restore Assistant.

Prerequisites

Before attempting to restore a single file, all preparation steps have to be performed properly, including configuration and VM backup. For details, see the Citrix documentation.

To ensure error-free operation of SEP sesam and improve performance, make sure that the following conditions are met:

  • SEP sesam Server version ≥ 5.0.0 Jaglion. For the list of supported systems, see Citrix Support Matrix.
  • Single file restore (SFR) of backups from virtualization platforms, e.g. Citrix, requires the guestfs-tools package to be installed on Linux in order to access and mount VM disk image on Linux. If the package is not installed on your SEP sesam Server or Linux RDS, it is not possible to mount VMDK and perform SFR. Refer to Installing guestfs-tools on Linux.
  • Backups must not be encrypted, compressed or stored on tape.
  • To restore single files via the web interface Restore Assistant, appropriate permissions are required. For details, see About Authentication and Authorization.
  • Before starting a restore, check the restrictions for mounting the virtual disk (VHD file).

Restore options

When restoring individual files from Citrix VM backups, you can choose from the following VM restore options to perform restore according to your needs:

  • Do not overwrite an items: (default) Files are only restored if they do not already exist on the target system.
  • Overwrite an existing items: If the data exists on the target server, it is replaced with the restored version.
  • Create new version: Restore files under a new name.
  • Keep original tree structure: When restoring to the original location, the Keep original tree structure option is selected by default. The directory structure of the restored files is the same as the original directory structure of the backed up data.
  • Restore all items flat in the selected target directory: The backup is simply restored to a file without recreating the directory structure.
  • You can also select to skip ACL settings during restore.

Restoring single file (SFR)

Depending on the interface you are using, follow the appropriate procedure to restore individual Citrix Hypervisor VM files:

Restoring a single file (SFR) is supported only in advanced UI mode (formerly expert mode in the GUI). For details on switching the UI mode, see Setting the UI mode in the GUI and Setting the UI mode in the Restore Assistant.

Single file restore via the GUI

Make sure your UI mode is set to advanced (formerly expert) and create a new restore task for the individual item(s) you want to restore.

  1. From the SEP sesam GUI menu bar, select Activities -> Restore. The New Restore Task window opens.
  2. Select what you want to restore. You can search savesets by task name or by filename or path.
    • When searching by task name, use the drop-down list of available tasks and select the one you want to restore from. This option is selected by default.
    • If you are searching by filename/path, select the option Filename or path in a saveset and enter your search expression in the search pattern field.
  3. In the Saved in period drop-down lists, specify the time frame for which you want to conduct the search. Click Next.
  4. The search results are displayed. From the list of savesets matching your query, select the version from which you want to restore an individual file. Then select the Mount virtual disk(s) check box. Note that some restrictions apply.
  5. You can also select RDS to mount from the drop-down list and specify advanced mount options.
    Information sign.png Note
    To be able to access and mount VM disk image on Linux, the guestfs-tools package must be installed on your SEP sesam Server or Linux RDS. If the guestfs-tools package is not installed, it is not possible to mount VMDK and perform SFR. Refer to Installing guestfs-tools on Linux.


    Citrix restore mount Apollon.jpg

  6. Mount is triggered and all VHDs of the selected VM are mounted to the device server using one or more unused drive letters of the Windows system e.g., D:, E:, etc. This may take a few seconds. Click OK.
    Citrix restore mount to device server Apollon.jpg
  7. In the Select Files window, select the data you want to restore and click Next.
  8. Citrix select files Apollon.jpg
  9. On the fourth step of the restore wizard (Target Settings), select a restore target where you want to restore your files.
  10. Then select an appropriate Execution option (Overwrite existing items, etc.) as described in the above section.
    Citrix select target Apollon.jpg
  11. In the final step of the restore wizard, you can review all the settings of your restore task. You can start your single file restore immediately by clicking Start. If you want to save the restore task, click Save.
  12. Citrix final Apollon.jpg
  13. Click OK to unmount the saveset and close your restore session.

Single file restore via the Restore Assistant

You can access the Restore Assistant in one of the following ways:

  • via the GUI: by clicking the Restore Assistant icon in the toolbar or from Activities -> Restore Assistant
  • from SEP sesam Web UI: left menu -> Restore Assistant
  • or by entering the following address in the browser bar: http://[sesamserver]:11401/sep/ui/restore/.
Information sign.png Note
  • If you cannot access the web Restore Assistant, check if you have received the appropriate permissions for online restore.
  • 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 UI mode.
    For details, see About Authentication and Authorization and User Roles and Permissions.

You can restore individual files of a Citrix Hypervisor VM in the web interface in the advanced UI mode if you have the appropriate permissions. For more details on the UI mode, see Setting UI mode in the Restore Assistant.

  1. Open the Restore Assistant in the browser.
  2. In the Start window, select Citrix Hypervisor. Then select the option Advanced View. The VM or single file restore option is selected by default. Click Next.
  3. Restore assistant SFR Citrix start Apollon.jpg
  4. In the Virtual Machine window, under Selection of the server, select your target Citrix server to which the data will be restored.
  5. Then, under Selection of the virtual machine, select the VM that you want to restore and click Next.
    Restore assistant Citrix select server Apollon.jpg
  6. In the Task window, under Task selection, select your source task. A backup task defines the source data that was backed up by the client.
  7. Then, under Backup selection, select the exact backup version you want to restore. You can use the calendar function in the upper right corner to set a date range for the displayed backups. Select the Single file restore option (in the lower right corner) and click Next. Restore assistant SFR Citrix select task Apollon.jpg
  8. In the Files window, select the SEP sesam Server or RDS to which you want to mount the backup. You can also specify an alternate mount path and/or advanced mount options. Then click the button Mount this backup in filesystem. A new window will appear showing the progress of the mount process.
  9. Information sign.png Note
    • To be able to access and mount VM disk image on Linux, the guestfs-tools package must be installed on your SEP sesam Server or Linux RDS. If the guestfs-tools package is not installed, it is not possible to mount VMDK and perform SFR. Refer to Installing guestfs-tools on Linux.
    • Mounting is not possible if the savesets are stored on tapes or if the data is compressed or encrypted. Some other XPRFS restrictions also apply to mounting.

    Restore assistant SFR Citrix mount Apollon.jpg

  10. Once a virtual disk is mounted on the device server, select the files you want to restore and click Next.
  11. Restore assistant SFR Citrix files Apollon.jpg
  12. In the Target window, under Target selection, select your target environment for the restore. You can use the drop-down list to select or filter VMs by name.
  13. Then enter or browse for your target path and select an appropriate Execution option (Overwrite existing files, etc.) as described in the above section. Click Next.
    Restore assistant SFR select Citrix target Apollon.jpg
  14. In the Options window, you can specify additional advanced options, such as selecting a data source (media pool, drive, etc.), set include/exclude filters, etc. For details on the available options, see Online restore in advanced UI mode.
  15. Click Next.
    Restore assistant SFR Citrix recovery options Apollon.jpg
  16. In the last step, check the summary of your restore task (restore type (based on task type, selected backup, its date and details, restore options, etc.) and click Start restore.
  17. Restore assistant SFR Citrix final Apollon.jpg

Monitoring restore

You can view the status of your restore jobs in the Restore Assistant by clicking the monitoring icon (second icon in the upper right corner), via SEP sesam Web UI (Monitoring -> Restores) or SEP sesam GUI (Main Selection -> Job State -> Restores). For details, see Monitoring and Reporting.

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.