Advanced - Linux File System Restore

Table of Contents

Performing a Direct Restore

Restoring Data Using Regular Expressions

Supported Wildcards in Regular Expressions

Performing an Out-of-Place Restore

Restoring to Different Folder on the Same Client

Restoring Data to a Different Client

Performing a Cross-Platform Restore

Restoring to NFS-Mounted File System

Renaming Files on Restore

Overwriting Data During Restores

Restoring Only When Data Exists on 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

Partial File Restore using 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

Restoring Sparse Files

Restoring Raw Devices

Restoring Raw Device Files as Regular Files

Restoring Macintosh Files

Enabling a Global Option to Restore Resource Fork Data

Restoring Resource Fork Data for a Specific Job

Excluding ACLs from Restores

Browsing Data

Latest Data

Data Before a Specified Time

Data Between a Specified Time

Reviewing the Size Distribution

Listing Media

Listing Media for a Subclient

Listing Media for a Backup Set

Listing Media and Size For a Backup Set

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

Performing 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 additional data paths.

    If you want to use wildcard characters to specify a file name pattern, you must express complete paths (e.g. usr\test\*.txt).

  • Click OK.
  During restores, if the complete destination path specified does not exist on the destination computer then the missing directories that are not selected for restore are created automatically with permission set to 0700 and ownership set to the  Calypso process.
5.
  • Click the Job Initiation tab.
  • Select Immediate from the Job Initiation tab.
  • Click OK.
6.

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. doc* will find any directory or file name that begins with "doc" (e.g., document, documentation)

**

Any number of characters across any number of path levels. /**/move will find the directory or file named move located at any level under the c: drive (e.g., /info/com/move)

?

Any one character. access? will find any directory or file name that begins with "access" followed by any one character (e.g., access1, access5)

[]

Any range of characters. [ei]nsure will find any directory or file name that ends with "nsure" and begins either "e" or "i". (e.g., ensure, insure)
    [a-z]nsure will find any directory or file name that ends with "nsure" and begins with any letter from "a" through "z". (e.g., ansure, bnsure, cnsure, etc.)

![] or ^[]

Any range of characters. ![a] or ^[a] will exclude any directory or file name that begins with "a". (e.g., applications)
You can use a combination of wildcards in a single expression (e.g., access?.h*).

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.

  During restores, if the complete destination path specified does not exist on the destination computer then the missing directories that are not selected for restore are created automatically with permission set to 0700 and ownership set to the  Calypso process.

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/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/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 data 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.
If you do not clear Restore to same folder check box, the data will be restored to the same folder on the destination client.  All the existing data in that folder will be overwritten during the restore operation.

Performing a Cross-Platform Restore

You can perform the following cross-platform restores :

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.

Restoring to NFS-Mounted File System

You can restore data to an NFS-mounted file system.

  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, click the client computer that hosts the mounted file system.
  2. Clear the Restore to same folder check box.
  3. In the Specify Destination Path, enter the network share or click Browse.
  4. In the Browsing for destination folder on <client> dialog box, select the destination folder and click OK.

    For example: /yamun/mnt1/upd

  5. 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.
Clear the Overwrite Files check box when restoring to a computer that has different hardware and different software device drivers.

Restoring Only when data 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:

Avoid running restores by jobs for jobs associated with the default backup set, if you do not want to restore the  operating system files or directories. The entire content of the backed up client will be restored and the client where you are restoring might run out of space.

Restoring all the data backed up During a Job

Follow the steps to restore all the 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. doc* will find any directory or file name that begins with "doc" (e.g., document, documentation)

**

Any number of characters across any number of path levels. /**/move will find the directory or file named move located at any level under the c: drive (e.g., /info/com/move)

?

Any one character. access? will find any directory or file name that begins with "access" followed by any one character (e.g., access1, access5)

[]

Any range of characters. [ei]nsure will find any directory or file name that ends with "nsure" and begins either "e" or "i". (e.g., ensure, insure)
    [a-z]nsure will find any directory or file name that ends with "nsure" and begins with any letter from "a" through "z". (e.g., ansure, bnsure, cnsure, etc.)

![] or ^[]

Any range of characters. ![a] or ^[a] will exclude any directory or file name that begins with "a". (e.g., applications)
You can use a combination of wildcards in a single expression (e.g., access?.h*).

Restoring Data Using a Map File

You can restore individual files and folders to different locations using a map file containing a list of files to be restored, with their corresponding restore paths. If you are restoring hard-linked file backed up with HLINK registry key set to Y, make sure that all the associated hard links are also included in the map file. This will allow you to preserve the hard links.

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.

You can provide following information in a map file:

Information

Example

File to File Mapping "/dir1/file1.txt","/dir2/file1.txt"
Folder to folder mappings "/dir2/info/","/dir4/info/"
Drive to drive mappings "/"(root),"/mnt","/usr"
Rename files/folder during restore "/dir4/file2.txt","/dir5/file3.txt"
Filter certain files "/dir5",""

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.

Partial File Restore using a Map File

Files can be restored partially using a Map file. Multiple files can be added in the Map file for partial restores with specific start/ stop offset values. These restores can be run from the CommCell GUI or from the command line. Partial file restores are supported for:

  1. Using a text editor, create a text file on the client computer where you want to restore the data.
  2. Add the mapping information in the file using the following syntax:

    “<source file path>”,“<destination file path>”,<start offset>,<stop offset>

    Where:

    <start offset> and <stop offset> are values in bytes

    For example: “/path1/data1/SRC”,"/path2/data2/DEST”,100,1000

The partial file restore behavior with different mapping options is given below:

Mapping

Behavior

File in map, no start offset and no stop offset File will be restored fully
File in map, only start offset provided File will be restored from <start offset> till the end of the file
File in map, start and stop offsets provided File will be restored from <start offset> to <stop offset>
File in map, start offset provided in invalid format (not a number) Restore will start from the beginning of the file
File in map, stop offset provided in invalid format (not a number) Restores till the end of the file
File in map, stop offset value is less than start offset Restores till the end of the file
Map file having duplicate source file entry with different destination location Only the first source file entry will be honored
Map file with folder path, start and stop offsets provided All the files under the folder will honor the start and stop offsets

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.
  2. Click the Pre/Post tab.
  3. 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.
  4. 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.
  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 Sparse Files

The sparse files are restored by default as flat files, wherein the holes are restored as data. This will increase the disk usage. Use the following steps to restore the holes as genuine holes which will considerably reduce the disk usage.

  1. From the CommCell Browser, navigate to Client Computers.
  2. Right-click the <Client> in which you wish to perform the restore, and then click Properties.
  3. Click the Registry Key Settings tab.
  4. Click Add.
  5. In the Name field, type OptimizeRunLengths.
  6. In the Location list, select or type iDataAgent.
  7. In the Type list, select Value.
  8. In the Value field, type the value which should be greater than or equal to -1.
  9. Click OK.

Restoring Raw Devices

Raw device files, including block and character, can be restored either in-place or out-of-place. The entire raw device or individual files can be restored. Use character device files instead of block device files for achieving better restore performance.

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System.
  2. Right-click the <Backup Set>, point to All Tasks and then click  Browse Backup Data.
  3. Click OK.
  4. Select the raw device data that you want to restore and click Recover All Selected.
  5. Select Data in device node.
  6. Select Overwrite files and then click Unconditional Overwrite.
  7. Select the name of the client computer from the Destination Client list and click OK.
  8. Click the Job Initiation tab and click Immediate.
  9. Click OK.

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

Restoring Raw Device Files as Regular Files

You can restore the actual data in the device node file of the raw partition as a regular file system file.

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System.
  2. Right-click the <Backup Set>, point to All Tasks and then click  Browse Backup Data.
  3. Click OK.
  4. Select the raw device data that you want to restore and click Recover All Selected.
  5. Click Data in device node.
  6. Select Overwrite files and then click Unconditional Overwrite.
  7. Select the name of the client computer from the Destination Client list and click OK.
  8. Click Advanced.
  9. Select Restore device files as regular files check box.
  10. Click OK.

Restoring Macintosh Files

You can restore Apple Double formatted Macintosh files that contain resource fork data.

Enabling a Global Option to restore Resource Fork Data

  1. From the CommCell Console, click Control Panel button in the toolbar.
  2. Double-click the Browse/Search/Recovery icon.
  3. Select Recover Apple Resource Fork Data check box.
  4. Click OK.

Restoring Resource Fork Data for a Specific Job

Use the following steps to recover Apple resource fork data of selective Macintosh files.

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System.
  2. Right-click the <Backup Set>, point to All Tasks and then click  Browse Backup Data.
  3. Click OK.
  4. Select the MAC File System data that you want to restore and click Recover All Selected.
  5. Click Advanced.
  6. Select Recover Apple Resource Fork Data check box.
  7. Click OK.

Excluding ACLs from Restores

The ACLs and the data are restored by default when you restore the data . Use the following procedure to exclude the ACLs from 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.
  5. Click to clear the Restore ACLs check box.
  6. Click OK.

Browsing Data

The option to browse the backup data provides the facility to view and selectively restore/recover the data that was backed up. The following sections explain how to browse the backup data.

Latest Data

Follow the steps given below to view the latest data backed up by a backup set:

  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.

The latest data backed up by all the subclients is displayed in the Client Browse tab.

Data Before a Specified Time

  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 Specify Browse Time.
  2. Select a date and time to Browse Data Before it.
  3. Click OK.

Data Between a Specified Time

  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 Specify Browse Time.
  2. Select a date and time to Browse Data Before it.
  3. Click Advanced.
  4. In the Advanced Browse Options dialog box, select Exclude Data Before.
  5. Select the date and time to exclude the data before it from the browse operation.
  6. Click OK in the Advanced Browse Options dialog box .
  7. Click OK in the Browse Options dialog box.

Reviewing the Size Distribution

Before restoring any drive, you can quickly review the data size distribution of various folders on 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. You can also review the size distribution of the data in a subclient.

 

Listing Media

List media option is useful to predict media required for the following operations:

The List Media feature can also be used in a number of other capacities. Refer to the List Media documentation for a complete overview of this feature.

The list media operation can be performed for backup sets and subclients. The following sections describe each of these methods.

Listing Media For a Subclient

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System | Backup Set.
  2. Right-click the subclient for which you wish to list media in the right pane and then click List Media.
  3. From the List Media dialog box choose one of the following options:

    Note that you can use the Specify Browse Time and Exclude Data Before options to list media between a specified date and time range.

  4. Click OK.

    The appropriate media is listed in the Media dialog box.

Listing Media For a Backup Set

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System.
  2. Right-click the backup set for which you wish to list media, point to All Tasks and then click Browse.
  3. From the Browse Options dialog box, if required, select the following options:

    Note that you can use the Specify Browse Time and Exclude Data Before options to list media between a specified date and time range.

  4. Click List Media.
  5. From the List Media dialog box, click List Media for restore within specified time range.
  6. Click OK.

    The appropriate media is listed in the Media dialog box.

Listing Media and Size For a Backup Set

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. From the CommCell Browser, navigate to Client Computers | <Client> | File System.
  2. Right-click a Backup Set and click All Tasks | Browse Backup Data.
  3. From the Browse Options dialog box, if required, click Browse the Latest 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 '/etc' -sourceItem '/etc4'

Restoring Files to a Point in Time (date)

qoperation execute -af restore_template.xml -appName 'File System' -clientName client1 -backupsetName backupset1 -destPath '/etc' -sourceItem '/etc4' -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 '/etc' -sourceItem '/etc4' -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

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> | File System | Backup Set.
  2. Right-click the Subclient and select Backup.
  1. Click Advanced.
  2. In the Advanced Backup Options dialog box, click the Job Retry tab.
  3. 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.

  4. Select Enable Number Of Retries and specify the number of retries.
  5. 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

Several additional options are available to further refine your restore operations. The following table describes these options, as well as the steps to implement them.

Be sure to read the overview material referenced for each feature prior to using them.

Option Description related topic
Skip Errors and Continue This option allows a restore job to continue regardless of media errors and outputs a file that lists the full path names of the files that failed to get restored.
  1. From the CommCell Browser, navigate to 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, select Skip errors and continue check box.
  2. Click OK
 
Use Exact index

This option allows you to associate the media with the most recent index available in the CommCell.

  1. From the CommCell Browser, navigate to 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. From the Advanced Restore Options , select Use Exact Index check box.
  2. 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, navigate to 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. In 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, navigate to 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, navigate to 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.

 
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.

Back to Top