Template:Extension restore: Difference between revisions

From SEPsesam
(Fixed links.)
(Translation tags deleted.)
Line 1: Line 1:
<languages />
<noinclude>
<noinclude>
[[Category:Content templates]]
[[Category:Content templates]]
</noinclude>
</noinclude>
<translate>
{{Copyright SEP AG en}}
<!--T:1-->
<!--Mark the topic as a draft until finished. If you are describing an extension, you should make three separate topics for it: one for configuration, one for backup, and another for restore and related tasks. The title convention should be: ''Extension_name'' Configuration, ''Extension_name'' Backup, ''Extension_name'' Restore. Familiarize yourself with the [[http://badefix/wiki/index.php/Technical_Documentation#Step_2:_Translating_a_page|internal instructions for translating documents]] before you start writing a topic. -->
{{Copyright SEP AG en}}</translate>
{{draft}}
<!--Mark the topic as a draft until it is finished. If you are describing an extension, you should make two separate topics for it: one for installation, configuration and backup, and another for restore and related tasks. The title convention should be: ''Extension_name'' Backup, ''Extension_name'' Restore. Familiarize yourself with the [[http://badefix/wiki/index.php/Technical_Documentation#Step_2:_Translating_a_page|internal instructions for translating documents]] before you start writing a topic. -->{{draft}}
<!-- Start with heading level 2, level 1 is reserved for the page title!-->
<!-- Start with heading level 2, level 1 is reserved for the page title!-->
{{Navigation_latest|release=4.4.3|link=[[extension_archive]]}}<!--link= This is actually the landing page of each extension - for example, see VMware: http://wiki.sepsoftware.com/wiki/index.php/VMware -->
{{Navigation_latest|release=4.4.3|link=[[extension_archive]]}}<!--link= This is actually the landing page of each extension - for example, see VMware: http://wiki.sepsoftware.com/wiki/index.php/VMware -->
<br />
<br />
<translate>==Overview == <!--T:2--></translate>
==Overview ==
<!--Delete any items from the nav-table that you cannot link to relevant link, e.g., video, if it doesn't exist.--><div class="boilerplate metadata" id="Additional resources" style="background-color:#ecedf1; color:#8695a7; border: 1px ridge #cdd3db; margin: 0.5em; padding: 0.5em; float: right; width: 25%; "><center><b><translate><!--T:3-->
<!--Delete any items from the nav-table that you cannot link to relevant link, e.g., video, if it doesn't exist.--><div class="boilerplate metadata" id="Additional resources" style="background-color:#ecedf1; color:#8695a7; border: 1px ridge #cdd3db; margin: 0.5em; padding: 0.5em; float: right; width: 25%; "><center><b>
Additional resources</translate></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;"
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP_next.png|45px|link=Special:MyLanguage/Extension backup]]
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP_next.png|45px|link=Special:MyLanguage/Extension backup]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:4-->
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
Also relevant</translate>:
Also relevant:
[[Extension backup]] – [[Another relevant concept or procedure]] – [[Another relevant concept or procedure]]
[[Extension backup]] – [[Another relevant concept or procedure]] – [[Another relevant concept or procedure]]
|}
|}
Line 23: Line 21:
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP_Video.png|45px|link=Special:MyLanguage/Video Tutorials & Screencasts|]]
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP_Video.png|45px|link=Special:MyLanguage/Video Tutorials & Screencasts|]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:5-->
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
Click the [<youtube link> video] to watch how to restore your files with ''Extension restore''.</translate>
Click the [<youtube link> video] to watch how to restore your files with ''Extension restore''.
|}
|}


{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
{|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]]
| 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;" | <translate><!--T:6-->
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
Check [[Special:MyLanguage/FAQ#link the relevant section|FAQ]] to find the answers to most common questions.</translate>
Check [[Special:MyLanguage/FAQ#link the relevant section|FAQ]] to find the answers to most common questions.
|}
|}


{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
{|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=Special:MyLanguage/Troubleshooting_Guide|Troubleshooting Guide]]
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP Troubleshooting.png|45px|link=Special:MyLanguage/Troubleshooting_Guide|Troubleshooting Guide]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:7-->
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
Problems with your <extension>? See the [[Special:MyLanguage/Troubleshooting_Guide#link the relevant section|<Extension> troubleshooting]].</translate>
Problems with your <extension>? See the [[Special:MyLanguage/Troubleshooting_Guide#link the relevant section|<Extension> troubleshooting]].</translate>
|}
|}
Line 41: Line 39:
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | [[File:icon_archived_docs.png|45px|link=Special:MyLanguage/Extension_landing_page_arhive]]
| rowspan="2" style="padding:0px 10px 0px;" | [[File:icon_archived_docs.png|45px|link=Special:MyLanguage/Extension_landing_page_arhive]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | <translate><!--T:8-->
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" |
If you are using an older SEP sesam version, search the [[relevant landing page link|Archive]].</translate>
If you are using an older SEP sesam version, search the [[relevant landing page link|Archive]].
|}</div>
|}</div>
<!--Provide a few paragraphs about the restore: what is supported, what are the features and how they work. For example, see [[NDMP_Restore#Overview]].-->
<!--Provide a few paragraphs about the restore: what is supported, what are the features and how they work. For example, see [[NDMP_Restore#Overview]].-->
<translate><!--T:9-->
SEP sesam provides simple and flexible restore. You are guided through the procedure by using a '''restore wizard'''. You can restore any <application_name> that is configured as a SEP sesam Client and was successfully backed up. You can specify which ... to restore, how they are restored, and where they are restored to. You can restore <application_name>... to different locations.  
SEP sesam provides simple and flexible restore. You are guided through the procedure by using a '''restore wizard'''. You can restore any <application_name> that is configured as a SEP sesam Client and was successfully backed up. You can specify which ... to restore, how they are restored, and where they are restored to. You can restore <application_name>... to different locations.  


To successfully restore a(n) <application_name> backup, all preparation steps must be performed properly. For details, see [[<application_name> Backup]].
To successfully restore a(n) <application_name> backup, all preparation steps must be performed properly. For details, see [[<application_name> Backup]].
===Restore wizard=== <!--T:10-->
 
</translate><!--Provide the options relevant for your extension.--><translate><!--T:11-->
===Restore wizard===  
<!--Provide the options relevant for your extension.-->
The following options are available when restoring <application_name>:
The following options are available when restoring <application_name>:
* Select an alternative location to restore your data:
* Select an alternative location to restore your data:
Line 59: Line 57:
* Schedule a restore task.
* Schedule a restore task.


== Prerequisites ==  <!--T:12-->
== Prerequisites ==   
Before you perform <application_name> restore, check the following prerequisites:
Before you perform <application_name> restore, check the following prerequisites:
* Depending on what you want to restore, make sure that you have the proper '''restore permissions''' and '''access rights'''.
* Depending on what you want to restore, make sure that you have the proper '''restore permissions''' and '''access rights'''.
Line 65: Line 63:
* During restore, it is recommended that you stop all activities on the target  ...
* During restore, it is recommended that you stop all activities on the target  ...


== <application_name>-specific restore steps == <!--T:13-->
== <application_name>-specific restore steps ==  
For details on how to configure a restore task and a description of different restore options, see [[Standard Restore Procedure|standard restore procedure]]. Only <application_name>-specific steps and options are described in this section</translate><!--Shorten the procedure to provide only relevant specific option for your extension.-->
For details on how to configure a restore task and a description of different restore options, see [[Standard Restore Procedure|standard restore procedure]]. Only <application_name>-specific steps and options are described in this section</translate><!--Shorten the procedure to provide only relevant specific option for your extension.-->
<ol><li> <translate><!--T:14-->
<ol><li>
From the SEP sesam GUI menu bar, select '''Activities -> Restore'''. The ''New restore task'' window opens.</translate>
From the SEP sesam GUI menu bar, select '''Activities -> Restore'''. The ''New restore task'' window opens.
<li><translate><!--T:15-->
<li>
Select the save set you want to restore. You can search save sets by ''task name'' or by ''filename or path''.</translate>
Select the save set you want to restore. You can search save sets by ''task name'' or by ''filename or path''.
<ul><li><translate><!--T:16-->
<ul><li>
If 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></li>
If 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.</li>
<li><translate><!--T:17-->
<li>
If searching by ''filename/path'', select the option '''Filename or path in save set''' and enter your search expression in the search pattern field.</translate></li></ul></li>
If searching by ''filename/path'', select the option '''Filename or path in save set''' and enter your search expression in the search pattern field.</li></ul></li>
<li><translate><!--T:18-->
<li>
Under the '''Saved in period''' drop-down lists, specify the time frame for which you want to conduct the search. Click '''Next'''.</translate></li>
Under 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:19-->
<li>
The search results are displayed. From the list of save sets matching your query, select the desired version by clicking on it, then select other relevant restore options (complete/generation restore). As of ''SEP sesam version 4.4.2'', you can also select the option '''Mount save set''' under ''Single File Restore'' to  mount the target save set to the disk and make it accessible as if it was a separate volume on the disk. You can mount any save set stored to ''default data store Path'' or to ''Si3 data store''. Mounting is not possible if the save sets are stored to tapes or if the data is compressed or encrypted. For advantages on mounting a save set, see [[SEP_sesam_Glossary#XPRFS|XPRFS]]. Click '''Next'''.</translate></li>
The search results are displayed. From the list of save sets matching your query, select the desired version by clicking on it, then select other relevant restore options (complete/generation restore). As of ''SEP sesam version 4.4.2'', you can also select the option '''Mount save set''' under ''Single File Restore'' to  mount the target save set to the disk and make it accessible as if it was a separate volume on the disk. You can mount any save set stored to ''default data store Path'' or to ''Si3 data store''. Mounting is not possible if the save sets are stored to tapes or if the data is compressed or encrypted. For advantages on mounting a save set, see [[SEP_sesam_Glossary#XPRFS|XPRFS]]. Click '''Next'''.</li>
[[image:screenshot.png|500px|left|link=]]
[[image:screenshot.png|500px|left|link=]]
<br clear=all>
<br clear=all>
<li><translate><!--T:20-->
<li>
If you selected the '''Mount save set''' option (available only on ''SEP sesam version 4.4.2'' or higher), a mount action is triggered. The selected save set 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>
If you selected the '''Mount save set''' option (available only on ''SEP sesam version 4.4.2'' or higher), a mount action is triggered. The selected save set 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>.
<br>
<br>
<translate><!--T:21-->
Click '''Next''' to display the ''Select the data for restore'' dialog. If you choose not to mount the save set, this dialog is displayed immediately. Select the data you want to restore and click '''Next'''.
Click '''Next''' to display the ''Select the data for restore'' dialog. If you choose not to mount the save set, this dialog is displayed immediately. Select the data you want to restore and click '''Next'''.</translate>
<li>
<li> <translate><!--T:22-->
Review your configured restore task and set additional options, if necessary.
Review your configured restore task and set additional options, if necessary.
* Details of the selected save set are displayed at the top of the window. The name of the restore task is automatically generated in the '''Name''' field. You can edit the name and insert a comment below.
* Details of the selected save set are displayed at the top of the window. The name of the restore task is automatically generated in the '''Name''' field. You can edit the name and insert a comment below.
Line 97: Line 94:
** '''overwrite existing files''': if data exists on the target server, it will be replaced by the restored version
** '''overwrite existing files''': if data exists on the target server, it will be replaced by the restored version
** '''create a new version''': if data exists on the target server, the restored data will be restored under a different name
** '''create a new version''': if data exists on the target server, the restored data will be restored under a different name
* You can specify additional restore settings by clicking the '''Expert options''' button. In the pop-up windows that opens, you can modify the log level settings, define the pre/post script for restore, etc. For details, see the [[The Restore 4.4#Restore Wizard|Restore Wizard]].</translate></li>
* You can specify additional restore settings by clicking the '''Expert options''' button. In the pop-up windows that opens, you can modify the log level settings, define the pre/post script for restore, etc. For details, see the [[The Restore 4.4#Restore Wizard|Restore Wizard]].</li>
<li><translate><!--T:23-->
<li>
To start your restore immediately, click '''Start'''. To save the restore task, click '''Save'''.</translate>
To start your restore immediately, click '''Start'''. To save the restore task, click '''Save'''.
<li><translate>If you chose to mount a save set (available only for ''SEP sesam version 4.4.2'' onwards), click '''Next''' to unmount it and close your restore session.</li></ol>
<li>If you chose to mount a save set (available only for ''SEP sesam version 4.4.2'' onwards), click '''Next''' to unmount it and close your restore session.</li></ol>
{{note|A restore task can be scheduled like any other task. If you want to add a restore task to the schedule, see [[Scheduling Restore]].}}
{{note|A restore task can be scheduled like any other task. If you want to add a restore task to the schedule, see [[Scheduling Restore]].}}
You can view the status of your restore jobs by selecting '''Job state''' -> '''Restore''' from the ''Main selection''. Restore overview provides detailed information on 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.
You can view the status of your restore jobs by selecting '''Job state''' -> '''Restore''' from the ''Main selection''. Restore overview provides detailed information on 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.
==See also== <!--T:24--></translate>
 
==See also==
[[Extension Backup]] – [[Another relevant  restore]] – [[Another relevant procedure or concept]] – [[Scheduling Restore]] – [[Troubleshooting_Guide#link the relevant section|Troubleshooting <extension> restore]]
[[Extension Backup]] – [[Another relevant  restore]] – [[Another relevant procedure or concept]] – [[Scheduling Restore]] – [[Troubleshooting_Guide#link the relevant section|Troubleshooting <extension> restore]]


<translate>==Previous versions== <!--T:25-->
==Previous versions==  
If you are using an older SEP sesam version, search the [[relevant landing page link|<Extension> archive]].</translate>
If you are using an older SEP sesam version, search the [[relevant landing page link|<Extension> archive]].

Revision as of 14:25, 12 January 2017


Template:Copyright SEP AG en

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 Welcome to the latest SEP sesam documentation version 4.4.3. For previous documentation version(s), check extension_archive.


Overview

SEP sesam provides simple and flexible restore. You are guided through the procedure by using a restore wizard. You can restore any <application_name> that is configured as a SEP sesam Client and was successfully backed up. You can specify which ... to restore, how they are restored, and where they are restored to. You can restore <application_name>... to different locations.

To successfully restore a(n) <application_name> backup, all preparation steps must be performed properly. For details, see [[<application_name> Backup]].

Restore wizard

The following options are available when restoring <application_name>:

  • Select an alternative location to restore your data:
    • restore a(n) <application_name> to the original or a different location with the same or a different <application_name> using relocation
    • restore a(n) <application_name> the same or a different ...
    • perform a simple path restore of your selected <application_name> data directly to a directory on any system
  • Restore a complete backup task.
  • Schedule a restore task.

Prerequisites

Before you perform <application_name> restore, check the following prerequisites:

  • Depending on what you want to restore, make sure that you have the proper restore permissions and access rights.
  • Make sure that there is sufficient free space on the target system to which you are restoring your data.
  • During restore, it is recommended that you stop all activities on the target ...

<application_name>-specific restore steps

For details on how to configure a restore task and a description of different restore options, see standard restore procedure. Only <application_name>-specific steps and options are described in this section</translate>

  1. From the SEP sesam GUI menu bar, select Activities -> Restore. The New restore task window opens.
  2. Select the save set you want to restore. You can search save sets by task name or by filename or path.
    • If 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 searching by filename/path, select the option Filename or path in save set and enter your search expression in the search pattern field.
  3. Under 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 save sets matching your query, select the desired version by clicking on it, then select other relevant restore options (complete/generation restore). As of SEP sesam version 4.4.2, you can also select the option Mount save set under Single File Restore to mount the target save set to the disk and make it accessible as if it was a separate volume on the disk. You can mount any save set stored to default data store Path or to Si3 data store. Mounting is not possible if the save sets are stored to tapes or if the data is compressed or encrypted. For advantages on mounting a save set, see XPRFS. Click Next.

  5. If you selected the Mount save set option (available only on SEP sesam version 4.4.2 or higher), a mount action is triggered. The selected save set is mounted to the SEP sesam home directory var\tmp\mnt, e.g., C:\Program Files\SEPsesam\var\tmp\mnt\save_set_ID.
    Click Next to display the Select the data for restore dialog. If you choose not to mount the save set, this dialog is displayed immediately. Select the data you want to restore and click Next.
  6. Review your configured restore task and set additional options, if necessary.
    • Details of the selected save set are displayed at the top of the window. The name of the restore task is automatically generated in the Name field. You can edit the name and insert a comment below.
    • The Drive field shows the drive with backed up data.
    • The Interface field shows the server (RDS server or Sesam server) with the attached data storage containing the selected save set.
    • The Target node drop-down list shows the target server to which the data will be restored.
    • Under the Target Path, choose between the Restore to original target path or New restore target options. If you wish to choose a new restore target, enter its target path or browse for it.
    • Under the Execution options drop-down list, select one of the following options:
      • do not overwrite existing files (set by default): the VM will not be restored if it already exists on the target server
      • overwrite existing files: if data exists on the target server, it will be replaced by the restored version
      • create a new version: if data exists on the target server, the restored data will be restored under a different name
    • You can specify additional restore settings by clicking the Expert options button. In the pop-up windows that opens, you can modify the log level settings, define the pre/post script for restore, etc. For details, see the Restore Wizard.
  7. To start your restore immediately, click Start. To save the restore task, click Save.
  8. If you chose to mount a save set (available only for SEP sesam version 4.4.2 onwards), click Next to unmount it and close your restore session.
Information sign.png Note
A restore task can be scheduled like any other task. If you want to add a restore task to the schedule, see Scheduling Restore.

You can view the status of your restore jobs by selecting Job state -> Restore from the Main selection. Restore overview provides detailed information on 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.

See also

Extension BackupAnother relevant restoreAnother relevant procedure or conceptScheduling RestoreTroubleshooting <extension> restore

Previous versions

If you are using an older SEP sesam version, search the <Extension> archive.