Recover Data - SharePoint Archiver - How To

Table of Contents

Recover Data from SharePoint Using Enhanced EBS Provider Technology

Optionally, the SharePoint Archiver Agent can be set up to use EBS Provider technology. This feature includes the following benefits:

  • Allows you to view and recover archived files directly from the media without reintroducing files to the SharePoint server
  • Archived items appear as any other file on SharePoint. Users see no change to the SharePoint user interface

SharePoint Archiver Agent with EBS Provider Technology supports the following library types:

  • All document library content types
  • Base type
  • Enterprise Document Library
  • Pages Library
  • Publishing Library
  • Customized forms of the document library

Prerequisites

To set up EBS Provider archiving, you must:

  1. Uninstall existing Archiver Agents. For detailed instructions, see Uninstall Components Using the CommCell Console.
  2. Reinstall Archiver Agents on all SharePoint servers using the latest installation package.
  3. Convert stub files that are left over from the standard SharePoint Archiver. This utility removes the Archive and Stub columns from the SharePoint interface.
    1. Open a command line, and then navigate to [software_installation_path\Base_folder].
    2. On the command line, type SPEBSMigration.exe.

      The existing stub files are converted.

    Once these steps are complete, users can view and recover archived files directly from the archive media through the SharePoint user interface.

Viewing Archived Files

You can view an archived file directly from the media to which it was archived. To view an archived file:

  1. Log into your SharePoint site.
  2. In the SharePoint site, open a library and navigate to the file that you want to recover.
  3. Click on the file name.

Recovering Archived Files

You can edit an archived file, and then reintroduce it to the SharePoint server. Once you reintroduce it, the file remains on the SharePoint server until the file satisfies the archive criteria and an archive operation runs. To edit an archived file:

  1. Log into your SharePoint site.
  2. In the SharePoint site, open a library and navigate to the file that you want to recover.
  3. Next to a file name, expand the Edit menu, and then click Check Out.

  4. When you have finished editing the file, expand the Edit menu for that file, and then click Check In.

Recover Data from SharePoint Using the Standard Archiver Technology

By default, the SharePoint Archiver Agent allows you to view and recover files through a stub file. In addition, the SharePoint Archiver Agent creates the Archive and Stub columns in the SharePoint user interface so that users can view and recover archived files. You can recover items only if Yes appears in the Archive column next to the item.

Before You Begin

  • Review the general recovery requirements from What You Need to Know Before Performing a Recovery and any agent-specific recovery requirements from Recovery Considerations for This Agent prior to performing any recovery.
  • This procedure can be used to recover only SharePoint data which have been configured to display stub icons.
  • In the SharePoint User Interface, you can recover items only if Yes appears under the Archive column next to the item. If the Archive column is not visible after archiving, you may need to manually refresh the Browser, select View "All Documents" or "All Pictures". 

  • If the Recall Archived Data menu is not visible in the SharePoint User Interface, you may need to manually refresh the Browser or it may be because multiple versions of SharePoint Servers co-exist on the same client. See Support when SharePoint 2003 and 2007 Servers Co-exist for more information.

  • Unless you have Add/Update permissions to the document, you will not be able to recall archived documents.

  • Library columns CommVault Stub and Archived created by SharePoint Archiver should not be changed by the user.

  • Items recovered from a version-enabled library are recovered to a new version.

Required Capability: None.

To recover data from the SharePoint Server User Interface:

  1. Log in to your SharePoint site.
  2. In the SharePoint Server User Interface, browse to the Library and select the archived SharePoint item which has Yes in the Archive column.
  3. Expand the Item Edit menu and click Recall Archived Data.
  1. The data that is available for recovery is displayed. Select one or more versions by selecting a checkbox in the Recall column and click Recall Selected Versions to continue.

  • If the document is from a version-enabled library, more than one version may be available for recovery. Otherwise, if the document is from a non version-enabled library, only one version will be available.
  • If an error occurs instead of viewing available versions, see Troubleshoot.

  1. A Persistent Recovery job will be initiated on CommServe and a popup message "[Filename] Recall completed successfully.OK" is displayed when recovery has completed. Click OK to return to the Document Library page. To hide this dialog box, see Hide "Recall Completed Successfully" Dialog Box.

After the recovery has completed, you can click the data to view its contents.

  • For successful archiving and recovery, the user performing the operation must have write permissions to the SPDAStubDatabase.db file that resides in the Job_Results folder.  Otherwise, you may receive the error Failed to update database with new version number.

  • The default timeout value for recalling data is five minutes. If a timeout error occurs, the timeout value can be increased by setting the additional settings value of nRETRY_RECALL_TIMEOUT.

Recover Data from the CommCell Console

Before You Begin

Required Capability: See Capabilities and Permitted Actions

To Recover data from the CommCell Console:

  1. From the CommCell Browser, right-click the archive set that contains the data that you want to recover, click All Tasks and then click the available Browse command (command names vary by agent).
  2. Run a browse operation. If you accept all defaults, you will be browsing the latest migration archiving operations for the selected data.
  3. From the Browse window, select the data that you want to recover, then click Recover All Selected.
  4. From the Recover Options for All Selected Items (General) dialog box, select Restore All Versions to recover the SharePoint items.
  5. From the Advanced Recovery Options dialog boxes, select the recovery options that you want to use. For agents with multiple tabs, do not click OK until you have used all of the desired tabs. When you accept all the default settings, you will be recovering the selected data to its original location.
  6. When recovering encrypted data, refer to Data Encryption for comprehensive feature information and procedures for using the Encryption tab of the Advanced Recovery Options dialog box.
  7. After completing your selections, you can either start an immediate recovery or schedule the recovery.
    • If you want to schedule the job, click the Job Initiation tab from the Recovery Options dialog box, click Schedule, schedule the job, and then click OK.
    • If you want to run the job now, accept or click Run Immediately in the same tab and then click OK.

    While the job is running, you can right-click the job in the Job Controller and select Detail to view information on the job. After the data has been recovered, you will see a job completion message in the Job Controller and Event Viewer.