Advanced Restore - SharePoint Server iDataAgent - Documents

Restore Browse and Restore

Table of Contents

SharePoint 2013
SharePoint 2010
Search Server 2008
SharePoint 2007

Restoring Documents

You can restore items at the library level and lower, including libraries and lists.

In-Place Restore Method

  1. In the CommCell Browser, expand Client Computers | Client | SharePoint Server, and then click Document Backup Set.
  2. In the right-pane, right-click a Subclient and click Browse and Restore.
  3. In the Browse and Restore Options dialog box, click View Content.

    The Client browse tab lists all of the latest data that was backed up.

  1. From the Client browse tab, select the items that you want to restore.
  2. Click Recover All Selected.
  3. By default, if the restored document already exists on the destination, it will be skipped from the restore operation. However, you can optionally select any one of the following options from the Restore Options for All Selected Items dialog box:

    Unconditional Overwrite: Select this option to overwrite the existing document with the document that has been restored.

    Merge: Select this option to merge an existing version of a Library or List level in a version library. Example: In case there are three versions of a document and version two is deleted. During a restore selecting the merge option and then selecting version two will merge the deleted version back in the sequence.

    Append: Select this option to add a new version of the document in a version library. Example: In case there are three versions of a document and version two is deleted. During a restore selecting the append option and then selecting version two will add the version as version four at the end of the version sequence.

  4. Click OK.

    While restoring sites sometimes an error occurs due to failure in importing the ghost pages. Create bImportSkipGhostPages additional setting and set its value to one to skip the ghost pages while running a restore. For detailed steps, see KB article SP0009.

Restoring Documents to a Different Folder on the Same Client

  1. In the CommCell Browser, expand Client Computers | Client | SharePoint Server, and then click Document Backup Set.
  2. In the right-pane, right-click a Subclient and click Browse and Restore.
  3. In the Browse and Restore Options dialog box, click View Content.

    The Client browse tab lists all of the latest data that was backed up.

  1. From the Client browse tab, select the items that you want to restore.
  2. Click Recover All Selected.
  3. From the Restore Options for All Selected Items dialog box, clear Restore to same folder.
  4. In the Specify destination path box, enter the location to which you want to restore the documents.
  5. By default, if the restored document already exists on the destination, it will be skipped from the restore operation. However, you can optionally select any one of the following options:

    Unconditional Overwrite: Select this option to overwrite the existing document with the document that has been restored.

    Append: Select this option to add a new version of the document in a version library. Example: In case there are three versions of a document and version two is deleted. During a restore selecting the append option and then selecting version two will add the version as version four at the end of the version sequence.

  6. Click OK.

Out-of-Place Restore Method

For out-of-place restores, subsites will be restored as subsites. If the Site URL path is similar to the original one for out-of-place restore operations, set  additional settings dImportRetainObjectIdentity to 1 in order to retain the original object identity.

  1. In the CommCell Browser, expand Client Computers | Client | SharePoint Server, and then click Document Backup Set.
  2. In the right-pane, right-click a Subclient and click Browse and Restore.
  3. In the Browse and Restore Options dialog box, click View Content.

    The Client browse tab lists all of the latest data that was backed up.

  1. From the Client browse tab, select the items that you want to restore.
  2. Click Recover All Selected.
  3. From the Restore Options for All Selected Items dialog box, select a client name from the Destination Client list,
  4. By default, if the restored document already exists on the destination, it will be skipped from the restore operation. However, you can optionally select any one of the following options:

    Unconditional Overwrite: Select this option to overwrite the existing document with the document that has been restored.

    Append: Select this option to add a new version of the document in a version library. Example: In case there are three versions of a document and version two is deleted. During a restore selecting the append option and then selecting version two will add the version as version four at the end of the version sequence.

  5. Click OK.

Demoting Sites

You can perform an out-of-place restore of a site in the root source site collection to a site in a non-root source site collection.

Before you begin with the restore operation, in the SharePoint Server, create the given DWORD registry keys under MSSharepointDocAgent:

  1. dRetainRootWeb with value as zero.
  2. bImportSkipGhostPages with value as one.

Behavior of the restores vary based on the selected source as shown below:

  • When a root web of a root site collection is restored to a sub-site, it overwrites the sub-site at the destination.

    Source: http://sp2010:100
    Destination : http://sp2010:200/sites/test1/sub1
    Result : http://sp2010:200/sites/test1/sub1

  • When a root web of a normal site collection is restored to a sub-site, it creates a new sub-site at the destination.

    Source: http://sp2010:100/sites/src
    Destination : http://sp2010:200/sites/test1/sub1
    Result : http://sp2010:200/sites/test1/sub1/src

Cross-Application Restore

Cross-application restores of sub sites, libraries, lists and their items to a higher SharePoint Server version are supported using Offline Browse and Restore. The SharePoint content database should be restored using an SQL agent to the destination backend SQL Server. It should be attached to a temporary Web application using PowerShell cmdlet mount-spcontentdatabase. User can select data for restore using the offline browse and proceed with the restore to a SharePoint destination.

Restoring to Disk

Restore to Disk option restores the export dump of selected files (similar to SharePoint’s native export). You can then use the restored dump of files (.dat,.xml files) as input to PowerShell import commands.

  1. In the CommCell Browser, expand Client Computers | Client | SharePoint Server, and then click Document Backup Set.
  2. In the right-pane, right-click a Subclient and click Browse and Restore.
  3. In the Browse and Restore Options dialog box, click View Content.

    The Client browse tab lists all of the latest data that was backed up.

  1. Click Recover All Selected.
  2. From the Restore Options for All Selected Items dialog box, select Restore to Disk.
  3. In the Path box, enter the location to which you want to restore the documents or click Browse to select a location.
  4. Click OK.

Listing Media

Before restoring any file or folder, you can review all the media that is associated with the selected data. Use this option to ensure that the media required to restore the selected data is available. You can also predict the total size of the data that you want to restore. Follow the steps given below to display the media and the size:

  1. In the CommCell Browser, expand Client Computers | Client | SharePoint Server, and then click Document Backup Set.
  2. In the right-pane, right-click a Subclient and click Browse and Restore.
  3. In the Browse and Restore Options dialog box, click View Content.

    The Client browse tab lists all of the latest data that was backed up.

  1. Select the data that you want to restore and click List Media and Size.
  2. Click OK.

The media associated with the selected data is displayed. If required, you can recall the required media from the export location.

Restoring Only the Access Control List

An access control list (ACL) is a list of permissions attached to a SharePoint object. An ACL specifies which users or system processes are granted access to SharePoint objects and what operations are allowed on those SharePoint objects.

ACL information refers to the unique permissions that were set for the SharePoint objects. ACL information is backed up with Document Full backups. When you restore documents, ACLs are restored by default.

Optionally, You can restore only the ACLs and then apply them to an existing document in the destination. The restore job restores only the ACL information from a selected container, such as a library or a list, and not from the documents or the folders inside a library or a list. To support only ACL restores, the selected container should have inherited permissions from its parent.

  1. In the CommCell Browser, expand Client Computers | Client | SharePoint Server, and then click Document Backup Set.
  2. In the right-pane, right-click a Subclient and click Browse and Restore.
  3. In the Browse and Restore Options dialog box, click View Content.

    The Client browse tab lists all of the latest data that was backed up.

  1. From the Client browse tab, select the folders or documents that you want to restore, and then click Recover All Selected.
  2. From the Restore Options for All Selected Items dialog box, select Restore ACLs Only, and then click OK.

    ACL information for the selected content is restored.

Scheduling a Restore

You can restore folders and documents at the library level and lower.

To schedule a restore:

  1. In the CommCell Browser, expand Client Computers | Client | SharePoint Server, and then click Document Backup Set.
  2. In the right-pane, right-click a Subclient and click Browse and Restore.
  3. In the Browse and Restore Options dialog box, click View Content.

    The Client browse tab lists all of the latest data that was backed up.

  1. From the Client browse tab, select the folders or documents that you want to restore, and then click Recover All Selected.
  2. From the Restore Options for All Selected Items dialog box, click the Job Initiation tab.
  3. Select Schedule, and then click Configure.
  4. In the Schedule Name box, enter a name for the schedule.
  5. Select the frequency with which you want the job to run, and then enter the corresponding date and time information.
  6. Click OK.
  7. Click OK.

Managing Restore Jobs

Controlling Jobs

The following controls are available for running jobs in the Job Controller window:

Suspend

Temporarily stops a job. A suspended job is not terminated; it can be restarted at a later time.

Resume

Resumes a job and returns the status to Waiting, Pending, Queued, or Running. The status depends on the availability of resources, the state of the Operation Windows, or the Activity Control setting.

Kill

Terminates a job.

Suspending a Job

  1. From the Job Controller of the CommCell Console, right-click the job and select Suspend.
  2. The job status may change to Suspend Pending for a few moments while the operation completes. The job status then changes to Suspended.

Resuming a Job

  1. From the Job Controller of the CommCell Console, right-click the job and select Resume.
  2. As the Job Manager attempts to restart the job, the job status changes to Waiting, Pending, or Running.

Killing a Job

  1. From the Job Controller of the CommCell Console, right-click the job and select Kill.
  2. Click Yes when the confirmation prompt appears if you are sure you want to kill the job. The job status may change to Kill Pending for a few moments while the operation completes. Once completed, the job status will change to Killed and it will be removed from the Job Controller window after five minutes.

Additional Restore Options

Option Description Related Topics
Skip Errors and Continue

This option enables you to continue the restore job regardless of media errors and create a file that lists the full path names of the files that failed to get restored. Follow the steps given below to set this option:

  1. In the CommCell Browser, expand Client Computers | <Client> | SharePoint Server, and then click Backup Set.
  2. In the right-pane, right-click a Subclient and click Browse and Restore.
  3. In the Browse and Restore Options dialog box, click View Content.

    The Client browse tab lists all of the latest data that was backed up.

  1. In the Client tab, select the items that you want to restore, and then click Recover All Selected.
  2. In the Restore Options for All Selected Items dialog box, click Advanced.
  1. In the Advanced Restore Options dialog box, click General.
  2. On the General tab, select the Skip errors and continue check box.
  3. Click OK.
 
Startup Options

The Startup Options are used by the Job Manager to set priority for resource allocation. This is useful to give higher priority to certain jobs. You can set the priority as follows:

  1. In the CommCell Browser, expand Client Computers | <Client> | SharePoint Server, and then click Backup Set.
  2. In the right-pane, right-click a Subclient and click Browse and Restore.
  3. In the Browse and Restore Options dialog box, click View Content.

    The Client browse tab lists all of the latest data that was backed up.

  1. In the Client tab, select the items that you want to restore, and then click Recover All Selected.
  2. In the Restore Options for All Selected Items dialog box, click Advanced.
  1. In the Advanced Restore Options dialog box, click Startup.
  2. On the Startup tab, select Change Priority.
  3. Enter a priority number - 0 is the highest priority and 999 is the lowest priority.
  4. Select the Start up in suspended State check box to start the job in a suspended state.
  5. Click OK.
Refer to Job Priority and Priority Precedence.
Copy Precedence By default, the system retrieves data from the storage policy copy with the lowest copy precedence. If the data was pruned from the primary copy, the system automatically retrieves data from the other copies of the storage policy in the lowest copy precedence to highest copy precedence order. Once the data is found, it is  retrieved, and no further copies are checked.

You can retrieve data from a specific storage policy copy (Synchronous Copy or Selective Copy). If data does not exist in the specified copy, the data retrieve operation fails even if the data exists in another copy of the same storage policy. Follow the steps given below to retrieve the data from a specific storage policy copy:

  1. In the CommCell Browser, expand Client Computers | <Client> | SharePoint Server, and then click Backup Set.
  2. In the right-pane, right-click a Subclient and click Browse and Restore.
  3. In the Browse and Restore Options dialog box, click View Content.

    The Client browse tab lists all of the latest data that was backed up.

  1. In the Client tab, select the items that you want to restore, and then click Recover All Selected.
  2. In the Restore Options for All Selected Items dialog box, click Advanced.
  1. In the Advanced Restore Options dialog box, click Copy Precedence.
  2. On the Copy Precedence tab, select the Restore from copy precedence check box.
  3. Enter the copy precedence number.
  4. Click OK.
Refer to Recovering Your Data from Copies.
Data Path Options

The data recovery operations use a default Library, MediaAgent, Drive Pool, and Drive as the Data Path. You can use this option to change the data path if the default data path is not available. Follow the steps given below to change the default data path:

  1. In the CommCell Browser, expand Client Computers | <Client> | SharePoint Server, and then click Backup Set.
  2. In the right-pane, right-click a Subclient and click Browse and Restore.
  3. In the Browse and Restore Options dialog box, click View Content.

    The Client browse tab lists all of the latest data that was backed up.

  1. In the Client tab, select the items that you want to restore, and then click Recover All Selected.
  2. In the Restore Options for All Selected Items dialog box, click Advanced.
  1. In the Advanced Restore Options dialog box, click the Data Path tab.
  2. Do any of the following to change the default data path:
    • In the Use MediaAgent list, select the name of a MediaAgent.
    • In the User Library list, select the name of a library.
    • For tape library, in the Use Drive Pool list, select the name of a drive pool.
    • For tape library, in the Use Drive list, select the name of a drive.
  3. Click OK.
Refer to Change Data Path.
Browse Options These options allow you to restore deleted items or data that was backed up before a specific time, after a specific time, or during a specific time range.
  1. In the CommCell Browser, expand Client Computers | <Client> | SharePoint Server, and then click Backup Set.
  2. In the right-pane, right-click a Subclient and click Browse and Restore.
  3. In the Browse and Restore Options dialog box, click View Content.

    The Client browse tab lists all of the latest data that was backed up.

  1. In the Client tab, select the items that you want to restore, and then click Recover All Selected.
  2. In the Restore Options for All Selected Items dialog box, click Advanced.
  1. In the Advanced Restore Options dialog box, click the Browse Options tab.
  2. To restore deleted items, select Restore deleted items.
  3. To restore items that were backed up during a specific time, select Specify Time Range.
  4. From the Time Zone list, select a time zone.
  5. Do any of the following to specify a time:
    • To restore items that were backed up after a specific time, select Start Time, and then enter a date and time.
    • To restore items that were backed up before a specific time, select End Time, and then enter a date and time.
    • To restore items that were backed up during a specific time range, select both Start Time and  End Time, and then enter the dates and times.
  6. Click OK.
 
Alerts

This option enables users or user groups to get automatic notification on the status of the data recovery job. Follow the steps given below to set up the criteria to raise notifications/alerts:

  1. In the CommCell Browser, expand Client Computers | <Client> | SharePoint Server, and then click Backup Set.
  2. In the right-pane, right-click a Subclient and click Browse and Restore.
  3. In the Browse and Restore Options dialog box, click View Content.

    The Client browse tab lists all of the latest data that was backed up.

  1. In the Client tab, select the items that you want to restore, and then click Recover All Selected.
  2. In the Restore Options for All Selected Items dialog box, click Advanced.
  1. In the Advanced Restore Options dialog box, click Alerts.
  2. Click Add Alert.
  3. From the Add Alert Wizard dialog box, select the required threshold and notification criteria and click Next.
  4. Select the required notification types and click Next.
  5. Select the recipients and click Next.
  6. Click Finish.
  7. Click OK.
Refer to Alerts.
Command Line Restores Command Line Interface enables you to perform backups or restore from the command line. The commands can be executed from the command line or can be integrated into scripts.

You can also generate command line scripts for specific operations from the CommCell Browser using the Save As Script option.

Refer to Command Line Interface.
CommCell Readiness Report The CommCell Readiness Report provides you with vital information such as connectivity and readiness of the Client, MediaAgent, and CommServe. It is useful to run this report before performing a backup or a recovery operation. Follow the steps given below to generate the report:
  1. On the CommCell Console menu bar, select the Reports tab.
  2. Click Readiness.

    The Report Selection dialog box appears.

  3. If necessary, select Reports | CommServe | CommCell Readiness in the left pane.
  4. Select the Computers tab, and then click Modify below the Computers list.
  5. In the dialog box that appears, clear Include All Client Computers and All Client Groups.
  6. Select the appropriate client from the Exclude list, and then click Include >.
  7. Click OK.
  8. Select the MediaAgent tab, and then clear Include All MediaAgents.
  9. Select the appropriate MediaAgent from the Exclude list, and then click Include >.
  10. Click Run.

    The report appears in your default Web browser.

Refer to CommCell Readiness Report.
Restore Job Summary Report

The Restore Job Summary Report provides you with information about all the data recovery jobs that are run in last 24 hours for a specific client and agent. You can get information such as failure reason, failed objects, job options, and so on. It is useful to run this report after performing the restore. Follow the steps given below to generate the report:

  1. On the CommCell Console menu bar, select the Reports tab.
  2. Click Summary.

    The Report Selection dialog box appears.

  3. If necessary, select Reports | Jobs | Job Summary in the left pane.
  4. On the General tab, select Data Recovery Jobs.
  5. Select the Computers tab.
  6. Select the appropriate client and the appropriate agent.
  7. Click Run.

    The report appears in your default Web browser.

Refer to Restore Job Summary Report.