Advanced - Windows File System Restore

Table of Contents

Performing a Direct Restore

Restoring Data Using Regular Expressions

Supported Wildcards in Regular Expressions

Reviewing the Size Distribution

Performing an Out-of-Place Restore

Restoring to Different Folder on the Same Client

Restoring to a Different Client

Performing a Cross-Platform Restore

Restoring to a UNC Path/NFS-Mounted File System

Renaming Files on Restore

Overwriting Data During Restore

Restoring Only When It Exists in the Destination

Restoring by Jobs

Restoring All the Data Backed Up During a Job

Restoring Specific Data Backed Up During a Job

Restoring From a Failed or Killed Job

Resubmitting a Restore Job

Filtering Data from Restores

Supported Wildcards in Filters

Restoring Data Using a Map File

Creating a Map File

Adding Files and Folders with Unicode Characters to a Map File

Restoring Using a Map File

Combining Browse and Restore With the Map File Restore

Restoring Deleted Files

Setting Up Pre-Post Processes

Setting up a Pre/Post Process to Run After Each Attempt

Restoring the Full System

Restoring the System State

Prerequisites

Restore the System State in-Place

Restore the System State Out-Of-Place

Restore Specific System State Objects

Restoring the Office Communications Server Data

Restoring ACLs

Restoring Only the ACLs

Restoring Only the Data

Restoring Virtual Machines

Microsoft Virtual Server

Microsoft Hyper-V

Listing Media

Scheduling a Restore

Managing Restore Jobs

Restarting Jobs

Controlling Jobs

Additional Restore Options

Command Line Restores

Log on to the CommServe

Perform the Restore

Generate the Command Line Script from the CommCell Console

Perform a Direct Restore

Perform a direct restore in the following scenarios:

If you want to restore data from multiple volumes, perform a browse and restore.

Follow the steps given below to perform a direct restore:

1.
  • From the CommCell Browser, navigate to Client Computers | <Client> | File System.
  • Right-click the defaultBackupSet and then click All Tasks | Restore.
2.

Enter the starting path of the data that you want to restore.

You can use wildcard characters to specify the patterns for files and folders to be included in the restore. For example: If you want to restore all the files starting with the word file, then specify file*.*

3.
  • In the Destination Client list, select the name of the client computer.
  • If you want to add more data for restore, click Advanced.

 

4.
  • Click the Path/Filters tab.
  • Click Add for Source Item list and enter the path of the data.

    If you want to use wildcard characters to specify a file name pattern, you must express complete paths (e.g. C:\Test\*.dll).

  • Click OK.

 

4.
  • Click the Job Initiation tab.
  • Select Immediate from the Job Initiation tab.
  • Click OK.

 

5.

You can track the progress of the job from the Job Controller.

Restoring Data Using Regular Expressions

By default you can use wildcard characters to specify the patterns for files and folders to be included in the restore.

Use the following steps to define wildcard characters as regular expressions:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System.
  2. Right-click the defaultBackupSet and then click All Tasks | Restore.
  3. Enter the source path that contains regular expressions and/or wild cards.
  4. In the Restore Options for All Selected Items dialog box, click Advanced.
  5. Clear Automatically Detect Regular Expressions and click OK.
This option is selected by default for direct restore operations. For Browse and Restore operations, the option cannot be enabled as you are selecting definitive paths to restore.
  1. Click OK.

supported wildcards in regular expressions

If enabled, the following wildcards can be automatically detected in regular expressions when restoring data.

wildcard

definition

example

* Any number of characters.

This wildcard is used in following scenarios:

  • filter all files of a specific extension
  • filter all files when the file name starts with a specific pattern
C:\*.log  will filter all files with the .log extension on root of the C drive. If you want to filter files with the .log extension from a folder on the C drive, you must include the path to the folder in the filter. (e.g. C:\Test\*.log)

ntuser* will filter all files for which the file name starts with the word ntuser.

? Any one character

This wildcard is used in following scenarios:

Filter all files (or folders) for which the name begins with a specific word and the last character of the word is variable.

To filter files:

C:\access?.doc will filter any files with the extension .doc on the C drive for which the name begins with- "access" followed by any one character such as access1.doc or access5.doc. However, access12.doc or access15.doc will not be filtered because the last two characters in the name are variable.

To filter folders:

C:\access?\**\* will filter any on the C drive for which the name begins with- "access" followed by any one character such as C:\access1 or C:\access5. However, C:\access12 or C:\access15 will not be filtered because the last two characters in the name are variable.

**\*

All files under a specific directory C:\Test\Data\**\* will filter all files and subdirectories under and including C:\Test\Data

C:\**\Data\**\* will filter all files and subdirectories below and including any directory called "Data" at any level in the C: volume

G:\Users\**\xpprofile\*.log will filter all files with the .log extension from any xpprofile subdirectory under Users directory

G:\Users\**\xpprofile\ntuser* will filter all filenames starting with ntuser from any xpprofile subdirectory under Users directory

Reviewing the Size Distribution

Before restoring any drive, you can quickly review the data size distribution of various folders in that drive. Follow the steps given below to view the size distribution:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System
  2. Right-click a Backup Set and click All Tasks | Browse/Browse Backup Data.
  1. Select the required options on the Browse Options dialog box and click OK.
  2. Select the drive or folder that you want to restore.
  3. Ensure that the Show size distributions check box is selected.

A pie chart of size distribution is displayed in the right pane of the CommCell Browser.

Performing An Out-of-Place Restore

You can restore the data to following locations:

Keep in mind that the destination computer must reside in the same CommCell as the client whose data was backed up.

Restoring to Different Folder on the Same Client

Follow the steps given below to restore data to a different folder on the same client from which data is backed up:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System | <Backup Set>.
  2. Right-click the <Subclient> in the right pane and then click Browse Backup Data.
  3. Click OK.
  4. Select the data that you want to restore and click Recover All Selected.
  1. Clear the Restore to same folder check box and click Browse.
  2. Click OK.
  3. Use the options in the Preserve Source Paths area to exclude folders (and its contents) from the source path.
    For Example: If the selected data is Documents\Users\Memos\Sales, and you want to restore data only from the Sales folder, set the Preserve <n> level from end of source path option to 1.

    If the selected data is Documents\Users\Memos\Sales, and you want to restore the data from Memos and Sales folders, set the Remove <n> level from beginning of source path option to 2.

  1. Click OK.
 

Restoring to a Different Client

Follow the steps given below to restore data to a different client:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System | <Backup Set>.
  2. Right-click the <Subclient> in the right pane and then click Browse Backup Data.
  3. Click OK.
  4. Select the data that you want to restore and click Recover All Selected.
  1. In the Destination Client list, select the client. You can select any client that is in the same CommCell as that of the client from which the data was backed up.
  2. Click OK.

The data will be restored to a different client. The location of the data will remain same as the source client. If you restore a shared folder from one client computer to another client computer, the share status of the folder will be restored.

 

 

Performing A Cross-Platform Restore

You can restore data to the following platforms:

Follow the steps given below to perform a cross-platform restore:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System | <Backup Set>.
  2. Right-click the <Subclient> in the right pane and then click Browse Backup Data.
  3. Click OK.
  4. Select the data that you want to restore and click Recover All Selected.
  1. In the Destination Client list, select the client.  You can select any client that is in the same CommCell as that of the client from which the data was backed up.
  2. Clear the Restore to same folder check box and click Browse.
  3. Select the destination folder and click OK
  1. Click OK.

 

 

Restore to a UNC Path/ NFS-Mounted File System

Follow the steps given below to restore data to a UNC path (Windows) or NFS-mounted file system (Unix).

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System | <Backup Set>.
  2. Right-click the <Subclient> in the right pane and then click Browse Backup Data.
  3. Click OK.
  4. Select the data that you want to restore and click Recover All Selected.
  1. In the Destination Client list, select the computer that hosts the share or mounted file system.
  2. Clear the Restore to same folder check box and enter the UNC path or the network share.

    For example: \\quark\restore\client_a\

  3. When you are restoring to a UNC path (Windows), click the Advanced.
  4. From the General tab of the Advanced Restore Options dialog box, select the Impersonate User option.
  5. Enter a username and password that has all permissions for the folder to which the data will be restored. This user should be allowed to create files in the in the destination folder of the client where you are restoring the data.
  6. Click OK.
  7. Click OK.
 

Renaming Files on Restore

If you do not want to overwrite the existing files during restores, you can append a suffix to the filenames and restore them as new files. (This suffix is appended to the filename before the extension.)

Follow the steps given below to rename files during the restore:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System | <Backup Set>.
  2. Right-click the <Subclient> in the right pane and then click Browse Backup Data.
  3. Click OK.
  4. Select the data that you want to restore and click Recover All Selected.
  1. In the Destination Client list, select the client.
  2. Click Advanced.
  3. In the Advanced Restore Options dialog box, select the Map tab.
  4. Enter the desired string that you want to append as a suffix to the filenames in Rename all restore files with suffix and click OK. For Example: Enter the string temp will rename file.txt to filetemp.txt.
  5. Click OK.
  6. Click OK to start the restore.

Overwriting Data During Restores

By default, the data in the destination is overwritten when the restored version is newer than the one in the destination.

Use the following steps to overwrite data irrespective of the destination version:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System | <Backup Set>.
  2. Right-click the <Subclient> in the right pane and then click Browse Backup Data.
  3. Click OK.
  4. Select the data that you want to restore and click Recover All Selected.
  1. Ensure that the Overwrite Files check box is selected.
  2. Click Unconditional Overwrite.
  3. Click OK.

 

Restoring Data Only When It Exists on the Destination

Follow the steps given below to restore the only data that already exists in the destination computer. This ensures any data removed from the destination computer is not reintroduced by the data recovery.

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System | <Backup Set>.
  2. Right-click the <Subclient> in the right pane and then click Browse Backup Data.
  3. Click OK.
  4. Select the data that you want to restore and click Recover All Selected.
  1. Ensure that the Overwrite Files check box is selected. (If it is not selected, only those files that do not exist on the destination will be restored.)
  2. Select the Restore only if target exists check box.
  3. Click OK.

Restoring by Jobs

You can select a specific backup job for a restore. This method of restoring data is faster and useful in the following scenarios:

Restoring All the Data Backed Up During a Job

Following the steps to restore all the data data backed up during the selected job:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System.
  2. Right-click the <Backup Set> and select All Tasks | Restore by Jobs.
  3. Enter the Start Time and End Time and click OK. The list of backup jobs, completed in the specified time period is displayed.
  4. Right click the job you wish to restore and select Restore Selected Jobs.
  5. Click OK.

Restoring Specific Data Backed up During a Job

You can restore specific files and folders from the data backed up during the selected job. Follow the steps given below to restore specific files and folders from the selected backup job:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System.
  2. Right-click the <Backup Set> and select All Tasks | Restore by Jobs.
  3. Enter the Start Time and End Time and click OK. The list of backup jobs, completed in the specified time period is displayed.
  4. Right click the job you wish to restore and select Browse.
  5. Click OK in the Browse Options dialog box.
  6. Select data that you want to restore and click Recover All Selected.
  7. Click OK.

Restoring from a Failed or Killed Job

You can restore from a failed or killed job. When restoring from a failed or killed job, the data backed up to the point of failure will be restored.

Failed or killed backup jobs are immediately aged regardless of their defined retention rules, therefore, these jobs can only be restored if the media is not yet overwritten. You can restore aged data from tape media but cannot restore from disk libraries.

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System.
  2. Right-click the <Backup Set> and select All Tasks | Restore by Jobs.
  3. Select Failed or Killed in the Job Status area of the Restore by Jobs Filter dialog box.
  4. Enter the Start Time and End Time to specify the time period in which the job was failed or killed.
  5. Click Advanced.
  6. Select the Include Aged Data check box and click OK.
  7. Click OK on the Restore Jobs Filter dialog box. The list of backup jobs, completed in the specified time period is displayed. The list also includes Failed or Killed jobs.
  8. Right click the job you wish to restore and click Restore Selected Jobs.
  9. Click OK.

Resubmitting a Restore Job

You can rerun a failed or completed restore job. This is useful when you want to use all the options and settings configured for the original job.

Follow the steps given below to rerun a restore job:

  1. From the CommCell Browser, navigate to Client Computers.
  2. Right-click the <Client> and click View | Job History.
  3. Select Data Recovery.
  4. Select the Restore check box and clear all other check boxes.
  5. Right-click the restore job that you want to resubmit from the Data Recovery Job History tab and click Resubmit Job.
  6. Click OK in the Restore Options for All Selected Items dialog box.

Filtering Data from Restores

During a restore operation, you can specify the files, directories, and file name patterns that you want to filter and exclude from restoring.

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System | <Backup Set>.
  2. Right-click the <Subclient> in the right pane and then click Browse Backup Data.
  3. Click OK.
  4. Select the data that you want to restore and click Recover All Selected.
  1. In the Recover Options for All Selected Items dialog box, click Advanced.
  2. Select the Paths/Filters tab.
  3. If you want to remove any files or folders from restore operation, click Add for Filter Item list and enter the path of the data. Wildcard entries must be expressed as complete paths.

    You can also click Delete to remove existing source or filter items.

  4. In the Advanced Recover Options dialog box, click OK.
  5. In the Recover Options for All Selected Items dialog box, click OK.

 

Supported Wildcards in Filters

The following wildcards can be used in filters to include or exclude data when restoring data.

wildcard

definition

example

* Any number of characters.

This wildcard is used in following scenarios:

  • filter all files of a specific extension
  • filter all files when the file name starts with a specific pattern
C:\*.log  will filter all files with the .log extension on root of the C drive. If you want to filter files with the .log extension from a folder on the C drive, you must include the path to the folder in the filter. (e.g. C:\Test\*.log)

ntuser* will filter all files for which the file name starts with the word ntuser.

? Any one character

This wildcard is used in following scenarios:

Filter all files (or folders) for which the name begins with a specific word and the last character of the word is variable.

To filter files:

C:\access?.doc will filter any files with the extension .doc on the C drive for which the name begins with- "access" followed by any one character such as access1.doc or access5.doc. However, access12.doc or access15.doc will not be filtered because the last two characters in the name are variable.

To filter folders:

C:\access?\**\* will filter any on the C drive for which the name begins with- "access" followed by any one character such as C:\access1 or C:\access5. However, C:\access12 or C:\access15 will not be filtered because the last two characters in the name are variable.

**\*

All files under a specific directory C:\Test\Data\**\* will filter all files and subdirectories under and including C:\Test\Data

C:\**\Data\**\* will filter all files and subdirectories below and including any directory called "Data" at any level in the C: volume

G:\Users\**\xpprofile\*.log will filter all files with the .log extension from any xpprofile subdirectory under Users directory

G:\Users\**\xpprofile\ntuser* will filter all filenames starting with ntuser from any xpprofile subdirectory under Users directory

Restoring Data Using a Map File

You can restore individual files and folders to different locations using a map file containg a list of files to be restored, with their corresponding restore paths.

Creating a Map File

The map file is a text file in the CSV (Command Separated Value) format.  Follow the steps given below to create a map file:

  1. Create a text file on the client computer where you want to restore the data.
  2. Add the mapping information in the file in the following format:

    "<source path>","<destination path>"

The specified paths for both the source and destination should be absolute paths within the same client computer. (Computer names or UNC paths should not be used in the source and destination names.)

You can provide following information in a map file:

Information

Example

File to File mapping "C:\dir1\file1.txt","E:\dir2\file1.txt"
Folder to Folder mappings "C:\dir2","E:\dir2"
Drive to Drive mappings "C:\","E:\"
Renaming files/folder "C:\dir4\file2.txt","F:\dir5\file3.txt"
Filtering files "C:\dir5",""
File to File mapping with UNC  path for source to UNC path for destination

When restoring to/from an UNC path, prefix the path with "UNC-NT"

"UNC-NT_Filer\Share\source2","UNC-NT_Filer\Share\destination2"
File to File mapping using UNC path for source "UNC-NT_Filer\Share\source2","E:\dir2"

Adding Files and Folders with Unicode Characters to a Map File

If the path or the filename contains Unicode characters, the Map File must be converted to a format that can be used by the data protection operation. The Unicode Conversion utility must be used to convert the Map File to a format that can be provided as input.

  1. Using a text editor, create a file that contains a list of files/folders with Unicode characters. Make sure to save the file as a Unicode text file.
  2. From the Command Line, navigate to the <software install folder>/base folder and type the following:

    cvconvertunicode <source file> <destination file>

    Where:

    <source file> is the full path and name of the file created in Step 1.

    <destination file> is the full path and name of the destination file. The file will automatically be created by the utility.

  1. Use the destination file as the Map File to perform the restore.

Restoring Using a Map File

Use the following procedure to restore a list of files and folders from a computer and each of these files have a different destination.

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System | <Backup Set>.
  2. Right-click the <Subclient> in the right pane and then click Browse Backup Data.
  3. Click OK.
  4. Select the data that you want to restore and click Recover All Selected.
  1. Click Advanced.
  2. Select the Map tab.
  3. Select the Use map file check box and click Browse to navigate to the map file.
  4. Clear the Restore unmapped file check box.
  5. In the Advanced Recover Options dialog box, click OK.
  6. Click OK to start the restore.

Combining Browse and Restore with the Map File Restore

Use the following procedure to restore a set of files to a specified location with some files within that set to different destinations:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System | <Backup Set>.
  2. Right-click the <Subclient> in the right pane and then click Browse Backup Data.
  3. Click OK.
  4. Select the data that you want to restore and click Recover All Selected.
  1. Click Advanced.
  2. Select the Map tab.
  3. Select the Use map file check box and click Browse to navigate to the map file.
  4. Select the Restore unmapped file check box.
  5. In the Advanced Recover Options dialog box, click OK.
  6. In the Recover Options for All Selected Items dialog box, click OK.

Restoring Deleted Files

Follow the steps given below to restore deleted files:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System | <Backup Set>.
  2. Right-click the <Subclient> in the right pane and then click Browse Backup Data.
  3. Click OK.
  4. Select the data that you want to restore and click Recover All Selected.
  1. Click Advanced.
  2. Select the Browse Options tab.
  3. Select the Restore deleted items check box and then select the Specify Time Range check box.
  4. Select the time range to restore the files, deleted in that period of time.
  5. In the Advanced Recover Options dialog box, click OK.
  6. In the Recover Options for All Selected Items dialog box, click OK.

 

Setting Up Pre-Post Processes

You can run batch files or shell scripts before and/or after restore jobs. Follow the steps given below to setup a process before or after the restore job:
  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System | <Backup Set>.
  2. Right-click the <Subclient> in the right pane and then click Browse Backup Data.
  3. Click OK.
  4. Select the data that you want to restore and click Recover All Selected.
  1. Click Advanced and then click the Pre/Post tab.
  2. If you want perform a process before the restore job, enter the path for the batch file in the Pre Recovery Command box or click Browse to select the batch file.
  3. If you want perform a process after the restore job, enter the path for the batch file in the Post Recovery Command box or click Browse to select the batch file.
  4. Select one of the following options:
    • Use Local Accounts  - Select this option if the local account has permissions to execute the processes on the destination client.
    • Impersonate User  - Select this option and enter the username and password, that has the permissions to execute the processes on the destination client.
  5. Click OK.
  6. Click OK to start the restore.

Setting up a Pre/Post Process to Run After Each Attempt

By default, a specified post process command is executed only on successful completion of the restore operation.
Use the following steps to run a post process even if the restore operation did not complete successfully. For example, this may be useful to bring a database online or release a snapshot.

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System | <Backup Set>.
  2. Right-click the <Subclient> in the right pane and then click Browse Backup Data.
  3. Click OK.
  4. Select the data that you want to restore and click Recover All Selected.
  1. Click Advanced and then click the Pre/Post tab.
  2. Enter the path for the batch file in the Post Recovery Command box or click Browse to select the batch file.
  3. Select the Run Post Process for all attempts check box.
  4. Click OK.
  5. Click OK to start the restore.

Restoring the Full System

You can restore any one or all of the following components during full system restore:

Before performing a full system restore, make sure that the backup jobs are disabled for the client so that any scheduled backups for the client will not start until the full system backup is complete.

  1. Open the CommCell Console.

  2. From the CommCell Browser, right-click the <Client> and select Properties.

  3. Click the Activity Control tab.

  4. Clear the Enable Data Management check box. This will disable backup jobs for the client and any scheduled backup jobs for the client will not start during the full system restore.

  5. Click OK.

  6. From the CommCell Browser, navigate to Client Computers| <Client> | File System.

  7. Right-click the <Backupset> that contains the system state data and all the drives and then click Browse Backup Data.

  8. Select the required options from the Browse Options dialog box and click OK.

  9. Select the <BackupSet> box from the Client Browse tab which contains system state data and all the drives.

  10. Click Recover All Selected.

For more information on Full System Restore on a Non Domain Controller, see Full System Restore of Non-Domain Controller.

For more information on Full System Restore of a Domain Controller on Windows Server 2003 and 2008, see Full System Restore of a Domain Controller on Windows Server 2003 and Full System Restore of a Domain Controller on Windows Server 2008 respectively.

Restoring the System State

System State components can be restored as follows:

System State Category Components Type of Restore

Components

System File Protection catalog and files

Performance monitor configuration files

Active Directory

Quotas

SYSVOL (if this is a domain controller)

Certificate Services database (if this is a certificate server)

Cluster database (if this server is part of a cluster)

Registry

COM+ database

1-Touch component

  • You can do an in-place and out-of place restore of all components together.
  • Individual components can only be restored out-of-place.
  • 1-Touch component will be used to perform 1-Touch Recovery. You cannot perform the Direct Restore or Browse and Restore of 1-Touch component.
 

Services

DHCP

WINS

Event logs

Disk quota information

RSM database

WMI database

Terminal Server Licensing database

Content Indexing catalogs

  • All services except Content Indexing Catalogs can be restored together or individually in place or out of place.
  • Content Indexing Catalog service will be included when you restore the entire system state but cannot be restored individually.

Prerequisites

Restore the System State In-Place

Before performing the system state restore ensure that the service user is a local administrator or services are running on a local system.

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System | defaultBackupSet .
  2. Right-click the default subclient in the right pane and then click Browse Backup Data.
  3. Click OK in the Browse Options dialog box.
  4. Expand the items in the defaultBackupSet in the left pane of the Client Browse tab and click the System State box.
  5. Click Recover All Selected.
  6. Click OK.

Restore the System State Out-Of-Place

You can perform an out-of-place restore of the following entities in system state:

  These methods require advanced skills. Be sure to visit the Microsoft support website and look for articles that describe these methods in more detail.
  1. From the CommCell Browser, navigate to Client Computers | <Client>.
  2. Right-click the backup set that includes the system state, click All Tasks and then click Browse Backup Data.
  3. Click OK.
  4. Expand the items for the backup set in the left side of the Client Browse tab.
  5. Click the System State box on the left.
  6. Click Recover All Selected.
  7. If you want to restore the data to another client, select the client from Destination client list. The source client and destination client must reside in the same CommCell.
  8. Clear the Restore to same folder option.
  9. Enter  the destination path in the Specify destination path box.

    Optionally, click Browse to browse and select the path.

  10. Click OK.

Restore Specific System State Objects

Follow the steps given below to restore individual system state components:

  1. From the CommCell Browser, navigate to <Client>.
  2. Right-click the backup set that includes the system state, click All Tasks | Browse Backup Data.
  3. Click OK.
  4. Expand the items for the backup set in the left side of the Client Browse tab.
  5. In the left pane, expand [System State] to display the two main objects: Components, Services.
  6. Select the Components and Services that you want to restore from the right pane of the Client Browse tab.
  7. Click Recover All Selected.
  8. If you want to restore the data to another client, select the client from the Destination client list. The source client and destination client must reside in the same CommCell.
  9. Clear the Restore to same folder option.
  10. Enter  the destination path in the Specify destination path box.

    Optionally click the Browse button to browse and select the path.

  11. Click OK.

Restoring Office Communications Server Data (OCS)

Follow the steps given below to restore OCS Data and Settings:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System | <Backup Set> .
  2. Right-click the subclient in the right pane and then click Browse Backup Data.
  3. Click OK in the Browse Options dialog box.
  4. Right-click the subclient, that contains the OCS data and settings, from the right pane and click Browse Backup Data.
  5. Select the OCS data and settings to be restored and click Recover all Selected.
  6. In the Recover Options for All Selected Items dialog box, select the client from the Destination client list and specify the Destination path.
  7. Click OK.

OCS metadata is backed up and restored with the SQL Server iDataAgent.

Restoring ACLs

The ACLs are restored by default when you restore a data. You can choose to restore only the data or the ACLs.

Restoring Only the ACLs

You can restore only the ACLs and apply it to an existing data in the destination. Follow the steps given below to restore only the ACLs and apply it to the existing files in the destination:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System | <Backup Set>.
  2. Right-click the <Subclient> in the right pane and then click Browse Backup Data.
  3. Click OK.
  4. Select the data that you want to restore and click Recover All Selected.
  1. Select Restore ACLs Only.
  2. Click OK.

Restoring Only the Data

You can restore only the data and inherit permissions from the parent directory in the destination. Follow the steps given below to restore only the data, without restoring the ACLs:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System | <Backup Set>.
  2. Right-click the <Subclient> in the right pane and then click Browse Backup Data.
  3. Click OK.
  4. Select the data that you want to restore and click Recover All Selected.
  1. Select Restore Data Only.
  2. Click OK.

Restoring Virtual machines

Data secured by the Windows File System iDataAgent can be restored to a virtual machine running Windows.

Microsoft Virtual Server

To restore virtual machines on Microsoft Virtual Server using the Windows File System iDataAgent:

  1. Shut down the virtual machine(s).
  2. Remove the virtual machine(s) using the Virtual Server Web admin utility.
  3. Remove the configuration files from the virtual machine directories.
  4. Restore all files for each virtual machine backup to that machine's virtual machines configuration directory. (The directory with the machine DNS name can be restored in place.)
  5. Using the Virtual Server Web admin utility, add a virtual machine. Use the full path for the vmc file of the machine you want to restore.
  6. Select the option to restore from saved state.

The virtual machine(s) should restore and display as running.

Microsoft Hyper-V

To restore virtual machines on Microsoft Hyper-V using the Windows File System iDataAgent:
  1. Shut down the virtual machine(s).
  2. From the command prompt, run net stop vmms. You can also run this as a batch job in a PreRestore Process in the Advanced Restore Option dialog box.
  3. Browse the backed up data and select the VM to be restored.
  4. Run an in-place restore using the Unconditional Overwrite option.
  5. From the command prompt, run net start vmms. You can also run this as a batch job in a PostRestore Process in the Advanced Restore Option dialog box.
  6. Select the restored virtual machine in the Hyper-V Manager.
  7. Select the Start option of the virtual machine.

The virtual machine(s) should restore and display as running.

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:

See List Media comprehensive information on media management and prediction.

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System
  2. Right-click a Backup Set and click All Tasks | Browse/Browse Backup Data.
  1. Click OK.
  2. Select the data that you want to restore and click List Media and Size.
  3. Click OK.

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

 

Command Line Restores

You can restore file system data from the command line interface.

Command line restores enable you to perform restore operations on multiple clients at the same time. It also allows you to reuse the command line scripts for additional restores.

When performing command line restores, note that backups taken from the CommCell Console can be restored using Command Line and vice versa. However, backups taken from a previous version of the CommCell Console can be restored only from the Command Line.

In order to run the restores from command line, you need an input xml file which contains the parameters for configuring the restore options. This input xml file can be obtained using one of the following ways:

Log on to the Commserve

To run command line operations you must first login to the CommServe as follows:

Perform the Restore

  1. Download the restore_template.xml file and save it on the computer from where the command will be executed.
  2. Execute the saved xml script using qoperation execute command.

    qoperation execute -af restore_template.xml -appName 'File System' -clientName xxxxx -backupsetName xxxxx -destPath 'xxxxx' -sourceItem 'xxxxx'

  1. Verify the status of the job using the following command:

    qlist job –j JOBID

  2. Once the job completes, logout from the CommServe using the qlogout command.

    qlogout [-cs commserver] [-all] [-tf tokenfile] [-tk token] [-h]

Examples

Restoring from a Current Backup

qoperation execute -af restore_template.xml -appName 'File System' -clientName client1 -backupsetName backupset1 -destPath 'C:\temp' -sourceItem 'C:\test'

Restoring Files to a Point in Time (date)

qoperation execute -af restore_template.xml -appName 'File System' -clientName client1 -backupsetName backupset1 -destPath 'C:\temp' -sourceItem 'C:\test' -toTimeValue 2011-11-28

Restoring Files to a Point in Time (date and time)

qoperation execute -af restore_template.xml -appName 'File System' -clientName client1 -backupsetName backupset1 -destPath 'C:\temp' -sourceItem 'C:\test' -toTimeValue 2011-11-28 15:40:00

Restoring by Jobs

qoperation execute -af restore_by_job_template.xml -jobids 52 -sourceItem 2:52 -striplevel 1

where:
  • jobids is the backup job ID
  • sourceItem is the CommCell D and the backup job ID separated by a colon (':'). By default, the CommCell ID is 2.
  • striplevel is the number of folder levels to exclude from the source path. This parameter is optional.

    For example, if you have a directory structure (source path) as /a/b/c and you select strip level 2, the data will be restored from folder c, while folders a and b are excluded. Ensure that the strip level is always less than the source path level.

Generate the Command Line Script from the CommCell Console

In addition to the parameters provided in the template xml file, if you want to include additional options for the restore, you can do so by selecting the required options from the CommCell Console and generate the command line xml script for the restore operation.

Follow the steps given below to generate a script which you can use to perform a restore from the command line interface:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System | <Backup Set>.
  2. Right-click the <Subclient> in the right pane and then click Browse Backup Data.
  3. Click OK.
  1. In the right pane of the Browse window, select the data that you want to restore and click Recover All Selected.
  2. Select the required restore options which you want to execute using the script.
  3. Click Save as Script.
  1. Enter the location where you want to save the script or click Browse and navigate to the location.

    The script will be saved as a .xml file and a .bat file is created.

    If a file with the same name already exists in the specified location, the .xml file will be created with a timestamp. However, the .bat file will overwrite the existing file.

  2. Enter the username and password for the user account which you want to use to perform the restore.

    By default, the user account which you have used to login to CommCell console is used for performing the restore. However, if the user account does not have access to application and database, click Use a different account.

  3. Click OK.

Scheduling A restore

Follow the steps given below to schedule a restore job:

1.
  • From the CommCell Console, navigate to Client Computers | <client> | File System.
  • Right-click an backupset and click All Tasks | Browse Backup Data.
  • Click OK.

 

2.
  • Select a file to restore.
  • Click Recover All Selected.
3. Select the name of the client computer from the Destination Client list.

Click OK.

 

4.
  • Click Job Initiation tab and click Schedule.
  • Click Configure.
5. Select the appropriate scheduling options.  For example:
  • Click Weekly.
  • Check the days you want the run the restore job.
  • Change the Start Time to 9:00 PM
  • Click OK to close the Schedule Details dialog
  • Click OK to close the Restore Options dialog

The restore job will execute as per the schedule.

See Scheduling for a comprehensive information on scheduling jobs.

Managing Restore Jobs

Once you initiate the restore operation, a restore job is generated in the Job Controller. Jobs can be managed in a number of ways. See Job Management for a comprehensive information on managing jobs.

The following sections provide information on the different job management options available:

Restarting Jobs

Jobs that fail to complete successfully are automatically restarted based on the job restartability configuration set in the Control Panel. Keep in mind that changes made to this configuration will affect all jobs in the entire CommCell.

To Configure the job restartability for a specific job, you can modify the retry settings for the job. This will override the setting in the Control Panel. It is also possible to override the default CommServe configuration for individual jobs by configuring retry settings when initiating the job. This configuration, however, will apply only to the specific job.

Backup jobs for this Agent are resumed from the point-of-failure.

Configure Job Restartability at the CommServe Level

  1. From the CommCell Browser, click Control Panel icon.
  2. Select Job Management.
  3. Click Job Restarts tab and select a Job Type.
    • Select Restartable to make the job restartable.
    • Change the value for Max Restarts to change the maximum number of times the Job Manager will try to restart a job.
    • Change the value for Restart Interval (Mins) to change the time interval between attempts for the Job Manager to restart the job.
  4. Click OK.

Configure Job Restartability for an Individual Job

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System | <Backup Set>.
  2. Right-click the <Subclient> in the right pane and then click Browse Backup Data.
  3. Click OK.
  4. Select the data that you want to restore and click Recover All Selected.
  1. Click Advanced and select the Job Retry tab
  2. Select Enable Total Running Time and specify the maximum elapsed time before a job can be restarted or killed

    Select Kill Running Jobs When Total Running Time Expires to kill the job after reaching the maximum elapsed time.

  3. Select Enable Number Of Retries and specify the number of retries.
  4. Click OK.
 

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

The following table describes the available additional options to further refine your restore operations:

Option Description related topic
Skip Errors and Continue

This option enables you to 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. From the CommCell Browser, click Client Computers | File System.
  2. Right-click the <Backup set> that contains the data you want to restore, point to All Tasks and then click Browse Backup Data.
  3. In the Browse Options dialog box, click OK.
  4. In the  Client Browse tab, select the data to be restored and click Recover all Selected.
  5. 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.
 
Use Exact index This option enables you to use the index associated with the data protection operation performed at a specific time or the latest index. By default, the system uses the index associated with the most recent data protection operation when your Browse the data.

This option allows you to associate the media with the most recent index available in the CommCell. Follow the steps give below to use exact index:

  1. From the CommCell Browser, click Client Computers | File System.
  2. Right-click the <Backup set> that contains the data you want to restore, point to All Tasks and then click Browse Backup Data.
  3. In the Browse Options dialog box, click OK.
  4. In the  Client Browse tab, select the data to be restored and click Recover all Selected.
  5. 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 Use Exact Index 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. From the CommCell Browser, click Client Computers | File System.
  2. Right-click the <Backup set> that contains the data you want to restore, point to All Tasks and then click Browse Backup Data.
  3. In the Browse Options dialog box, click OK.
  4. In the  Client Browse tab, select the data to be restored and click Recover all Selected.
  5. 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 a specific storage policy copy:

  1. From the CommCell Browser, click Client Computers | File System.
  2. Right-click the <Backup set> that contains the data you want to restore, point to All Tasks and then click Browse Backup Data.
  3. In the Browse Options dialog box, click OK.
  4. In the  Client Browse tab, select the data to be restored and click Recover all Selected.
  5. 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 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. From the CommCell Browser, click Client Computers | File System.
  2. Right-click the <Backup set> that contains the data you want to restore, point to All Tasks and then click Browse Backup Data.
  3. In the Browse Options dialog box, click OK.
  4. In the  Client Browse tab, select the data to be restored and click Recover all Selected.
  5. In the Restore Options for All Selected Items dialog box, click Advanced.
  1. In the Advanced Restore Options dialog box, click Data Path.
  2. On the Data Path tab, select the MediaAgent and Library.
  3. Select the Drive Pool and Drive for optical and tape libraries.
  4. Select the name of the Proxy server if you wish to restore using a proxy server.

    You can select the Proxy server only when you are restoring from a snapshot. This option is not available for a regular restore.

  5. Click OK.
Refer to Change Data Path.
Encryption

If the client's data is encrypted with a pass phrase, you must enter the pass-phrase to start the data recovery operation. Follow the steps given below to enter the pass-phrase:

  1. From the CommCell Browser, click Client Computers | File System.
  2. Right-click the <Backup set> that contains the data you want to restore, point to All Tasks and then click Browse Backup Data.
  3. In the Browse Options dialog box, click OK.
  4. In the  Client Browse tab, select the data to be restored and click Recover all Selected.
  5. In the Restore Options for All Selected Items dialog box, click Advanced.
  1. In the Advanced Restore Options dialog box, click Encryption.
  2. Enter the Pass Phrase.
  3. Click OK.
Refer to Data Encryption.
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. From the CommCell Browser, click Client Computers | File System.
  2. Right-click the <Backup set> that contains the data you want to restore, point to All Tasks and then click Browse Backup Data.
  3. In the Browse Options dialog box, click OK.
  4. In the  Client Browse tab, select the data to be restored and click Recover all Selected.
  5. 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 Alert.
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 the data protection or recovery job. Follow the steps given below to generate the report:
  1. From the Tools menu in the CommCell Console, click Reports.
  2. Navigate to Reports | CommServe | CommCell Readiness.
  3. Click the Client tab and click the Modify button.
  4. In the Select Computers dialog box, clear the Include All Client Computers and All Client Groups check box.
  5. Select the client from the Exclude list.
  6. Click the Include > button.
  7. Click OK.
  8. Click the MediaAgent tab.
  9. Clear the Include All MediaAgents checkbox.
  10. Select the MediaAgent from the Exclude list.
  11. Click Include >.
  12. Click Run.

    The generated report is displayed.

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 etc. It is useful to run this report after performing the restore. Follow the steps given below to generate the report:

  1. From the Tools menu in the CommCell Console, click Reports.
  2. Navigate to Reports | Jobs | Job Summary.
  3. Click Data Recovery on the General tab in the right pane.
  4. On the Computers tab, select the client and the agent for which you want to run the report.
  5. Click Run.
Refer to Restore Job Summary Report.