Advanced Restore - Macintosh File System iDataAgent

Table of Contents

Performing an Out-of-Place Restore

You can restore the data to following locations:

  • Different folder on the same computer from which the data was backed up
  • Different computer

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

Restoring to a 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 and Restore.
  3. Click View Content.
  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

Procedure

  1. From the CommCell Browser, expand to Client Computers > client > File System > backup set.
  2. In the right pane, right-click a subclient, and click Browse and Restore.
  3. In the Browse and Restore dialog box, click View Content.
  4. Select the data that you want to restore, and click Recover All Selected.
  5. On the Restore Options - General tab:
    1. In the Destination Client list, select a client in the same CommCell as the client from which the data was backed up.
    2. Clear the Restore to same folder check box.
    3. In the Specify Destination Path box, enter the path on the destination client. Optionally, click Browse and in the Browsing for destination folder on client dialog box, select the destination folder and click OK.

      Important: Enter the path in Specify Destination Path box even if you are restoring to the same folder on the destination client.

  6. When you are satisfied with your selections, click OK.

Result

Once the restore is complete, the data is restored to the destination folder you specified in the Restore Options dialog box. If the folder you specified does not exist, a folder with the same name is created and the data is restored to that folder.

Performing a Cross-Platform Restore

You can perform the following cross-platform restores :

  • Restores across all the supported versions of Unix.
  • Restores from Unix to all the supported versions of Windows.

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 and Restore.
  3. Click View Content.
  4. Select the data that you want to restore and click Recover All Selected.
  1. Clear the Restore to same folder check box.
  2. 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.
  3. Click Browse to select the destination folder and click OK.
  4. Click OK.

Ignoring Errors When Restoring from an NFS Mount

In general, during cross platform restores, errors are reported by the chown system call especially when the source data is an NFS mount. By default, such errors need to be ignored manually to continue with the restore operation. However, you can choose to ignore such errors using the following steps:

  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 Advanced and then click Additional Settings tab.
  4. Click Add.
  5. In the Name field, type ignoreChownErrors.

    The Category and Type fields are populated automatically. 

  6. In the Value field, type:

    1 - to ignore EINVAL error

    2 - to ignore any error reported by chown

  7. 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 and Restore.
  3. Click View Content.
  4. Select the data that you want to restore and click Recover All Selected.
  1. Clear the Restore to same folder check box.
  2. In the Destination Client list, click the client computer that hosts the mounted file system.
  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: /finite/nftest/test

  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 end of the filename regardless of 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 and Restore.
  3. Click View Content.
  4. Select the data that you want to restore and click Recover All Selected.
  1. Clear the Restore to same folder check box.
  2. In the Destination Client list, select the client.
  3. Click Advanced.
  4. In the Advanced Restore Options dialog box, select the Map tab.
  5. 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 to rename file.txt to file.txttemp.
  6. Click OK.
  7. 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 and Restore.
  3. Click View Content.
  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 and Restore.
  3. Click View Content.
  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:

  • To restore point-in-time data associated with a specific backup job
  • To restore multiplexed data from the same client

You can specify the number of source path levels to strip when running a restore by job using Command Line Interface.

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.

Restores by jobs use the same number of streams that you configured for the subclient. For more information on configuring multiple streams for subclients, see Configuring Multiple Streams for Backups.

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 and Restore.
  5. Click View Content.
  6. Select the data that you want to restore and click Recover All Selected.
  7. Click OK.

Restoring from a Failed or a Killed Job

You can restore from a failed or killed job. When Restoring from a Failed or a 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. Click Data Recovery Operations.
  4. Select the Browse and Restore check box and clear all other check boxes.
  5. Click OK.
  6. Right-click the restore job that you want to resubmit from the Data Recovery Job History tab and click Resubmit Job.
  7. Click OK to start the restore.

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 and Restore.
  3. Click View Content.
  4. Select the data that you want to restore and click Recover All Selected.
  1. Click Advanced.
  2. Select the Paths/Filters tab.
  3. Click Add for Source Item list and enter the path of the source data.
  4. If you want to remove any files or folders from the restore operation, click Add for Filter Item list and enter the path of the data. Wildcard entries must be expressed as complete paths.

    Make sure that the filter items specified are available in the source items selected.

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

  5. Click OK.
  6. Click OK to start the restore.

Supported Wildcards in Filters

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

Wildcards Description Examples
* Any number of characters.

This wildcard is used in the following scenarios:

  • Filter all files of a specific extension
  • Filter all files under a specific directory
  • Filter all files of a specific extension where the file name starts with a specific pattern.
*.doc will filter all files with the extension .doc (e.g., status.doc, mission.doc) on all partitions on the client computer.

/Test/*.doc will  filter all .doc files only in the /Test directory

a*.so will  filter all files with the extension .so (e.g., alsvc.so, advdcc.so) on the client computer which have the name beginning with "a".

/Finance/Test/* will  filter all the files and directories in the "Test" directory under the "Finance" directory on the / partition. Any sub-directories under the Test directory will not get backed up.

? Any one character.

This wildcard can be used in the following scenario:

All files (or directories) for which any one character in the file name or the directory name is variable.

/access? will  filter any directory or file on the machine for which the name begins with- "access" followed by any one character such as access1 or access5. However, access12 or access15 will not get backed up because the last two characters in the name are variable.

/Class/report? will  filter any directory or file under /Class directory for which the character in the place of ? is variable. For example: /Class/report1 and /Class/report2 will get backed up. However, /Class/report15 will not get backed up.

[] Set or range of characters. /[a-m]*.doc will  filter any file with .doc extension on the / partition for which the name begins with the letters "a" through "m”.

/[AEIOU]*.doc will  filter any file name that ends with .doc and begins with the letters A, E, I, O, or U.

/Finance/report[1-47-9] will  filter files report1, report2, report4, report7, report8, report9 under Finance directory.

/Department-[A-CS] will  filter files Department-A, Department-B, Department-C and Department-S.

[!] The negation of a set or range of characters. You can use the wildcard in the following scenario:

Filter all files in a directory except the files for which the name starts with any character from the specified set or range of characters.

/root/[!AEIOU]*.doc would filter all .doc files in the /root directory that start with a letter other than A, E, I, O, or U.
** Any number of characters across any number of path levels. /**/move.cpp - the file named move.cpp located at any directory level. (e.g., /root/newapp/move.cpp/opt/kde3/src/move.cpp)

/etc/** - will  filter all directories and files under /etc. All the sub-directories under these directories will also be included.

When you use wildcards to specify the subclient content, the content path appears in Italics.

If you want all the files with the file extension ".doc" to be  filtered from any level, then specify the content as *.doc. If any subclient content doesn’t start with /, then /**/ will be prefixed to the content to match at any level. E.g., *.doc will be /**/*.doc

If user wants to treat *, ?, [ ] as literals in the subclient content and not as wildcards, then the user can escape the wildcard by adding ‘\’ before the wildcard. E.g., /Report\[2011-2012\]/*.doc  filters all the .doc files under /Report[2011-2012]

More than one type of wildcard can be used when specifying subclient content (e.g., /Dcvol?/oracle[1-47]/**/*.log).

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 (Comma 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>"

    • If the specified destination folder is not available, the necessary destination folder will be created during the restore.

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 or folders with Unicode characters and 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. This file is automatically 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 and Restore.
  3. Click View Content.
  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. 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 and Restore.
  3. Click View Content.
  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. Click OK.
  6. Click OK to start the restore.

Restoring Deleted Files

You can restore deleted files using the following steps:

  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 and Restore.
  3. Click View Content.
  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. Click OK.
  6. Click OK to start the restore.

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 and Restore.
  3. Click View Content.
  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 and Restore.
  3. Click View Content.
  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>, and then click Properties.
  3. On the Client Computer Properties for <Client> dialog box, click Advanced.
  4. On the Advanced Client Computer Properties for <Client> dialog box, click the Additional Settings tab.
  5. Click Add.
  6. On the Add Additional Settings on Unix Client dialog box, perform the following:
    • In the Name box, type OptimizeRunLengths. The Category and Type details are automatically populated.

      Alternatively, you can click Lookup and search for the additional setting using the Find box.

    • In the Value box, type a positive integer value that is a multiple of 1024. Any other value will be rounded off to the next multiple of 1024..
    • Click OK.
  7. Click OK to close the Advanced Client Properties dialog box.
  8. Click OK to close the Client Computer Properties for <Client> dialog box.

Restoring Raw Device Files and Special Files

By default, device files and special files are not created during restores if they do not exist.

The following files are not created by default during restores:

  • Device files (character and block devices)
  • Special files (non-regular)
  • Pipe files
  • Socket files
  • Door files (on Solaris)

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

Before You Begin

To create device files and special files if they do not exist:

  • On your client computer, add the nCreateRawDeviceOnRestore additional setting with the value 1.

    For instructions on adding the additional setting from the CommCell Console, see Add or Modify an Additional Setting.

    Warning: Use this additional setting at your own risk because failure to create device nodes might result in inconsistent restores.

Procedure

  1. From the CommCell Console, expand Client Computers > client > File System.
  2. Right-click the appropriate backup set, point to All Tasks and then click Browse and Restore.

    The Browse and Restore dialog box appears.

  3. Click View Content.
  4. Select the raw device data from the right pane.
  5. Click Recover All Selected.

    The Restore Options for All Selected Items dialog box appears.

  6. Select the Data in device node check box.
  7. Select the Overwrite files check box, and then click Unconditional Overwrite.
  8. In the Destination Client list, select the destination client.
  9. Clear the Restore to same folder check box.
  10. Click OK to start the restore.

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 and Restore.
  3. Click View Content.
  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. Clear the Restore to same folder check box.
  8. Select the name of the client computer from the Destination Client list.
  9. Click Browse to navigate to the destination path.
  10. Click Advanced.
  11. Select Restore device files as regular files check box.
  12. Click OK.
  13. Click OK to start the restore.

Restoring Apple Double Encoded 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 the 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 and Restore.
  3. Click View Content.
  4. Select the Macintosh 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 and Restore.
  3. Click View Content.
  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.

Listing Media

List media option is useful to predict media required for the following operations:
  • To restore data associated with a specific backup set or subclient.
  • To restore the index required to browse data associated with a specific backup set or subclient.
  • To restore a specific file (or specific files and folders).
  • To restore data associated with a specific job.

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 and then click Browse and Restore.
  3. From the Restore Options dialog box, if required, select the following options:
    • Click Latest Backup to list media associated with the most recent data protection cycle.
    • Click Time Range to list media associated with data protection operations up for the specified date and time range. Select the Start Time and End Time check boxes to specify the start and end dates along with time.
    • Click Relative Time to list media associated with data protect operations for the specified relative time in terms of Days, Weeks, Months or Years.
  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 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 and Restore.
  3. From the Restore Options dialog box, if required, select the following options:
    • Click Latest Backup to list media associated with the most recent data protection cycle.
    • Click Time Range to list media associated with data protection operations up for the specified date and time range. Select the Start Time and End Time check boxes to specify the start and end dates along with time.
    • Click Relative Time to list media associated with data protect operations for the specified relative time in terms of Days, Weeks, Months or Years.
  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 the <Backup Set> in the right pane and then click Browse and Restore.
  3. Click View Content.
  4. Select the data that you want to restore and click List Media and Size.
  5. Click OK.

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

Scheduling a Restore

  1. From the CommCell Console, navigate to Client Computers | <Client> | File System.
  2. Right-click a <Backup Set> and click All Tasks | Browse and Restore.
  3. Click View Content.
  4. Select the data to restore and click Recover All Selected.
  5. Click the Job Initiation tab and click Schedule.
  6. Click Configure.
  7. 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. This configuration can be changed at any time; however, changes to this configuration will affect all jobs run in the entire CommCell.

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.

Configure Job Restartability at the CommServe Level

  1. In the CommCell Console, click the Control Panel icon, then double-click Job Management.
  2. In the Job Restarts tab of the Job Management dialog box, select a job type from the Job Type list, and then select the Restartable check box.
  3. To change the maximum number of times the Job Manager will try to restart a job, select a number in the Max Restarts box.
  4. To change the time interval between attempts by the Job Manager to restart the job, select a number of minutes in the Restart Interval (Mins) box.
  5. Click OK to save your changes.

Configure Job Restartability for an Individual Job

  1. From the Restore Options dialog box, click Advanced, then select the Job Retry tab and specify the following as desired:
    • Total Running Time - The maximum elapsed time, in hours and minutes, from the time that the job is created.
    • Number of Retries - The number of times that Job Manager will attempt to restart the job.
    • Kill Running Jobs When Total Running Time Expires - Option to kill the job when the specified Total Running Time has elapsed, even if its state is "Running".
  2. 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 | <Client> | File System.
  2. Right-click the <Backup Set> and then click All Tasks | Browse and Restore.
  3. Click View Content.
  4. From the Browse window, select the data you want to restore in the right pane 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 | <Client> | File System.
  2. Right-click the <Backup Set> and then click All Tasks | Browse and Restore.
  3. Click View Content.
  4. From the Browse window, select the data you want to restore in the right pane 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 | <Client> | File System.
  2. Right-click the <Backup Set> and then click All Tasks | Browse and Restore.
  3. Click View Content.
  4. From the Browse window, select the data you want to restore in the right pane 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 specific storage policy copy:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | File System.
  2. Right-click the <Backup Set> and then click All Tasks | Browse and Restore.
  3. Click View Content.
  4. From the Browse window, select the data you want to restore in the right pane 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 | <Client> | File System.
  2. Right-click the <Backup Set> and then click All Tasks | Browse and Restore.
  3. Click View Content.
  4. From the Browse window, select the data you want to restore in the right pane 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 tape library.
  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, expand Client Computers | client.
  2. Right-click File System, and click All Tasks | Browse and Restore.

    The Browse and Restore Options dialog box appears.

  3. Click View Content.
  4. In the right pane, select the database that you want to restore, and then click Recover All Selected.

    The Restore Options for All Selected Items dialog box appears.

  5. 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, expand Client Computers | client.
  2. Right-click File System, and click All Tasks | Browse and Restore.

    The Browse and Restore Options dialog box appears.

  3. Click View Content.
  4. In the right pane, select the database that you want to restore, and then click Recover All Selected.

    The Restore Options for All Selected Items dialog box appears.

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

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

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

    The Report Selection dialog box appears.

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

    The report appears in your default Web browser.

 
Restore Job Summary Report

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

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

    The Report Selection dialog box appears.

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

    The report appears in your default Web browser.

Refer to Restore Job Summary Report.