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:
-
From the CommCell Browser, navigate to Client Computers > client > File System backupset.
-
Right-click the Subclient in the right pane and then click Browse and Restore.
-
Click View Content.
-
Select the data that you want to restore and click Recover All Selected.
-
Clear the Restore to same folder check box and click Browse.
-
Click OK.
-
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.
-
Click OK.
Restoring Data to a Different Client
Procedure
-
From the CommCell Browser, expand to Client Computers > client > File System > backupset.
-
In the right pane, right-click a subclient, and click Browse and Restore.
-
In the Browse and Restore dialog box, click View Content.
-
Select the data that you want to restore, and click Recover All Selected.
-
On the Restore Options - General tab:
-
In the Destination Client list, select a client in the same CommCell as the client from which the data was backed up.
-
Clear the Restore to same folder check box.
-
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.
-
-
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:
-
From the CommCell Browser, navigate to Client Computers > client > File System backupset.
-
Right-click the Subclient in the right pane and then click Browse and Restore.
-
Click View Content.
-
Select the data that you want to restore and click Recover All Selected.
-
Clear the Restore to same folder check box.
-
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.
-
Click Browse to select the destination folder and click OK.
-
Click OK.
Ignoring Errors When Restoring From or To an NFS Mount
During restore operations, errors are reported by the chown system call especially when the source or destination is an NFS mount and because changing file ownership as a root user is not allowed by the NFS server.
By default, such errors must be ignored manually to continue with the restore operation. However, you can choose to ignore such errors using the following steps:
-
From the CommCell Browser, navigate to Client Computers.
-
Right-click the <Client> in which you wish to perform the restore, and then click Properties.
-
Click Advanced and then click Additional Settings tab.
-
Click Add.
-
In the Name field, type ignoreChownErrors.
The Category and Type fields are populated automatically.
-
In the Value field, type:
1 - to ignore EINVAL error
2 - to ignore any error reported by chown
-
Click OK.
Using Multiple Streams to Restore Data with the Solaris File System Agent
By default, restore operation uses a single stream. For faster restore operations, you can configure the restore operation to use multiple streams, and you can define alternate data paths. For more information, see GridStor® (Alternate Data Paths) - Overview.
Notes: You cannot use multiple streams for restore operations on clients with only File System Core package installed (Laptop Backup clients).
Before You Begin
-
Verify that you have v11 Service Pack 6 or later installed on the source client computers and on the destination client computers.
-
Verify that the client computer whose data you want to restore was backed up using Indexing Version 2. For more information about Indexing Version 2, see Indexing Version 2: Overview.
-
For more information about general restore options, see Restore/Recover Options (General).
-
For more information about the Advanced Options, see Advanced Restore Options.
Procedure
-
From the CommCell Console, expand Client Computers > client > File System > backup set.
-
In the right pane, right-click a subclient, and then click Browse and Restore.
The Browse and Restore Options dialog box appears.
-
Click View Content.
-
Select the data that you want to restore, and then click Recover All Selected.
The Restore Options dialog box appears.
-
On the General tab, complete the following steps:
-
In the Destination Client list, select the destination client computer.
-
In the Number of Streams box, enter the recommended number of data streams that you want to use for the restore operation.
Notes:
-
The actual number of streams used depends on the restore data set and the number of streams used to back up data.
-
When you perform a restore by jobs operation, the Number of Streams option is not available because restore by job operations use multiple streams by default.
-
-
-
On the Job Initiation tab, choose how you want to initiate the restore jobs.
For more information about job initiation options, see Restore Options (Job Initiation).
-
Click OK.
Result
The restore operation restores the selected data to the destination client computer.
Using Multiple Nodes to Restore Data to NFS-Mounted File System with the Solaris File System Agent
By default, restore operation uses a single node when you perform restores to NFS-mounted file systems. For faster restore operations, you can configure the restore operation to use multiple nodes, and you can define alternate data paths. For more information, see GridStor® (Alternate Data Paths) - Overview.
If you want to perform restores to distributed file systems or to network file systems such as NFS-mounted file systems that are mounted across multiple computers, use multiple nodes.
Notes: You cannot use multiple nodes for restore operations on clients with only File System Core package installed (Laptop Backup clients).
Before You Begin
-
Verify that you have v11 Service Pack 7 or later installed on the source client computers and on the destination client computers.
-
Verify that the client computer whose data you want to restore was backed up using Indexing Version 2. For more information about Indexing Version 2, see Indexing Version 2: Overview.
-
For more information about general restore options, see Restore/Recover Options (General).
-
For more information about the Advanced Options, see Advanced Restore Options.
Procedure
-
From the CommCell Console, expand Client Computers > client > File System > backup set.
-
In the right pane, right-click a subclient, and then click Browse and Restore.
The Browse and Restore Options dialog box appears.
-
Click View Content.
-
Select the data that you want to restore, and then click Recover All Selected.
The Restore Options dialog box appears.
-
On the General tab, complete the following steps:
-
From the Destination Client list, select the primary node for the restore operation.
-
In the Number of Streams box, enter the recommended number of data streams that you want to use for the restore operation.
Notes:
-
The actual number of streams used depends on the restore data set and the number of streams used to back up data.
-
When you perform a restore by jobs operation, the Number of Streams option is not available because restore by job operations use multiple streams by default.
-
-
To use multiple nodes for the restore operation, select the Multiple Nodes check box.
-
Click Advanced.
The Advanced Restore Options dialog box appears.
-
On the Data Access Nodes tab, in the Available Data Access Nodes list, select the secondary nodes that will participate in the restore operation, and then click Add.
Notes:
-
All of the participating restore nodes must be at the same service pack level (v11 Service Pack 7 or later).
-
The destination volume must be shared across all the restore nodes and it must be accessible from all the nodes.
-
The destination volume must be mounted in the same directory on all the nodes.
-
All of the participating restore nodes must be time synced.
-
-
Click OK.
-
In the Specify Destination Path, enter the NFS path.
For example: /finite/nftest/test
-
-
On the Job Initiation tab, choose how you want to initiate the restore jobs.
For more information about job initiation options, see Restore Options (Job Initiation).
-
Click OK.
Result
The restore operation restores the selected data to the destination client computer.
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:
-
From the CommCell Browser, navigate to Client Computers > client > File System backupset.
-
Right-click the Subclient in the right pane and then click Browse and Restore.
-
Click View Content.
-
Select the data that you want to restore and click Recover All Selected.
-
Clear the Restore to same folder check box.
-
In the Destination Client list, select the client.
-
Click Advanced.
-
In the Advanced Restore Options dialog box, select the Map tab.
-
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.
-
Click OK.
-
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:
-
From the CommCell Browser, navigate to Client Computers > client > File System backupset.
-
Right-click the Subclient in the right pane and then click Browse and Restore.
-
Click View Content.
-
Select the data that you want to restore and click Recover All Selected.
-
Ensure that the Overwrite Files check box is selected.
-
Click Unconditional Overwrite.
-
Click OK.
Note
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.
-
From the CommCell Browser, navigate to Client Computers > client > File System backupset.
-
Right-click the Subclient in the right pane and then click Browse and Restore.
-
Click View Content.
-
Select the data that you want to restore and click Recover All Selected.
-
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.)
-
Select the Restore only if target exists check box.
-
Click OK.
Restores Using User Impersonation
-
From the CommCell Browser, expand Client Computers > client > File System > backup set.
-
Right-click the subclient, and then click Browse and Restore.
-
In the Browse and Restore Options dialog box, click View Content.
-
Select the data that you want to restore, and then click Recover All Selected.
-
If you are performing an out-of-place restore, in the Restore Options for All Selected Items dialog box, clear the Restore to same folder check box.
-
From the Destination Client list, select the destination client.
-
Click Browse to select a destination directory.
-
Click OK.
-
Select the Impersonate User check box and type the user account details for impersonation:
-
User Name
-
Password
-
Confirm Password
You must have the necessary privileges to write to the destination directory.
-
-
Click OK.
The user name and password are verified on the destination client before a user is impersonated.
The restore job goes into a pending state if the verification fails. On successful verification, data is restored if the impersonated user has the following permissions:
In-Place Restore |
Out-of-Place Restore |
|
If the file exists in the restore destination |
|
Write permission to the destination folder, including the following additional permissions-
|
If the file does not exist in the restore destination |
Write permission to the destination folder, including read permission on the backed up file, or the user must have file ownership. |
Write permission to the destination folder, including Read permission on the backed up file, or the user must have file ownership. |
Restores Using End-User Access Permission
You can perform restores using the End-User Access permission by impersonating users, from either the CommCell Console or the command-line interface.
If you are using the CommCell Console, you must set the Impersonate User option.
If you are using the command-line interface, UNIX user ID (UID) is used for impersonation. The UID is the ID of the user who is logged on the UNIX system. The default UID value for the root user is zero.
Before You Begin
-
Set the EnforceUnixUserPermissionsOnRestore additional setting to 1 on the CommServe. For instructions on adding the additional setting, see Add or Modify an Additional Setting.
-
Verify that you have one of the following permissions for performing a restore:
Type of restore
Permissions required
In-place
-
A CommCell user having the Browse and End-User Access permissions, and any one of the following:
-
User UID. (The UID is automatically populated only for command-line restores)
-
Impersonation enabled
-
Out-of-place, same computer
-
A CommCell user having the Browse and End-User Access permissions, out-of-place permission on the client, and any one of the following:
-
User UID
-
Impersonation enabled
-
Out-of-place, cross-computer (only UNIX to UNIX)
-
A CommCell user having the Browse and End-User Access permissions with the following:
- Impersonation enabled and out-of-place permission on the source client
-
Performing Restores Using End-User Access Permission From the CommCell Console
You can perform restores using the End-User Access permission by setting the Impersonate User option from the CommCell Console. For instructions on setting the Impersonate User option, see Restores Using User Impersonation.
Performing Restores Using End-User Access Permission From the Command Line
If you perform restores using the End-User Access permission from the command-line, the UID of the user running the QCommand is used for impersonation.
By using the Save As Script option in the CommCell Console, you can save the restore options on the source client to an XML script. The QCommand uses the XML script to perform the restores. QCommand determines the UID which will be used for impersonating the restores. For details about the permissions required by the impersonating user, see Restores Using User Impersonation.
For instructions on how to perform a command-line restore, see Command Line Restore - UNIX and Linux File Systems.
Important Considerations
Review these important considerations before you perform a restore using the End-User Access permission:
-
If the Impersonate User option is not set in the XML script, then the UID of the user running the QCommand is used for impersonation. Cross-computer restores are not supported in this case.
-
If the Impersonate User option is set in the XML script, then that user account is used for impersonation. The impersonation XML tag takes precedence over the user UID.
-
Restores using the End-User Access permission are not supported for non-root client installations.
-
Pre-restore and post-restore commands are not supported.
-
On the HP-UX system, the user who owns a file can change the ownership of the file for any other user on the computer. To improve the efficiency of the restores using the End-User Access permission, disable this default setting.
Procedure
-
Log on to the HP-UX destination computer as a root user.
-
Use a text editor to open the /etc/privgroup file, or create the file if necessary.
-
Add or edit the following line, and save the file.
-n CHOWN
-
At the UNIX shell prompt, run the following command:
setprivgrp -f /etc/privgroup
-
Log on again as root user.
-
Restart Commvault services.
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:
-
From the CommCell Browser, navigate to Client Computers.
-
Right-click the <Client> and click View | Job History.
-
Click Data Recovery Operations.
-
Select the Browse and Restore check box and clear all other check boxes.
-
Click OK.
-
Right-click the restore job that you want to resubmit from the Data Recovery Job History tab and click Resubmit Job.
-
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.
-
From the CommCell Browser, navigate to Client Computers > client > File System backupset.
-
Right-click the Subclient in the right pane and then click Browse and Restore.
-
Click View Content.
-
Select the data that you want to restore and click Recover All Selected.
-
Click Advanced.
-
Select the Paths/Filters tab.
-
Click Add for Source Item list and enter the path of the source data.
-
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.
Note
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.
-
Click OK.
-
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:
|
|
? |
Any one character.
|
|
[] |
Set or range of characters. |
|
[!] |
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 filters all .doc files in the /root directory that start with a letter other than A, E, I, O, or U. |
** |
Matches any directory level. |
|
*** |
Matches any directory level, including the parent directory |
|
Notes:
-
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 does not start with a forward slash (/), then "/**/" will be prefixed to the content to match at any level. For example: "*.doc" will become "/**/*.doc".
-
If you wants to treat the asterisk (*), question mark (?), and square brackets ([ ]) as literal, and not as wildcards, then add a forward slash (\) before the wildcard. For example: /Report\[2011-2012\]/*.doc will filter all the .doc files under /Report[2011-2012]
-
More than one type of wildcard can be used when specifying subclient content. For example: /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.
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:
-
Create a text file on the client computer where you want to restore the data.
-
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.
-
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.
-
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.
-
-
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:
-
Index restores
-
Index Free Restore – Restore By Job
-
Using a text editor, create a text file on the client computer where you want to restore the data.
-
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.
-
From the CommCell Browser, navigate to Client Computers > client > File System backupset.
-
Right-click the Subclient in the right pane and then click Browse and Restore.
-
Click View Content.
-
Select the data that you want to restore and click Recover All Selected.
-
Click Advanced.
-
Select the Map tab.
-
Select the Use map file check box and click Browse to navigate to the map file.
-
Clear the Restore unmapped file check box.
-
Click OK.
-
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.
-
From the CommCell Browser, navigate to Client Computers > client > File System backupset.
-
Right-click the Subclient in the right pane and then click Browse and Restore.
-
Click View Content.
-
Select the data that you want to restore and click Recover All Selected.
-
Click Advanced.
-
Select the Map tab.
-
Select the Use map file check box and click Browse to navigate to the map file.
-
Select the Restore unmapped file check box.
-
Click OK.
-
Click OK to start the restore.
Restoring Deleted Files
You can restore deleted files using the following steps:
-
From the CommCell Browser, navigate to Client Computers > client > File System backupset.
-
Right-click the Subclient in the right pane and then click Browse and Restore.
-
Click View Content.
-
Select the data that you want to restore and click Recover All Selected.
-
Click Advanced.
-
Select the Browse Options tab.
-
Select the Restore deleted items check box and then select the Specify Time Range check box.
-
Select the time range to restore the files deleted in that period of time.
-
Click OK.
-
Click OK to start the restore.
Setting Up Pre-processes and 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:
-
From the CommCell Browser, navigate to Client Computers > client > File System backupset.
-
Right-click the Subclient in the right pane and then click Browse and Restore.
-
Click View Content.
-
Select the data that you want to restore and click Recover All Selected.
-
Click Advanced.
-
Click the Pre/Post tab.
-
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.
-
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.
-
Click OK.
-
Click OK to start the restore.
Setting Up a Pre-process and 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.
-
From the CommCell Browser, navigate to Client Computers > client > File System backupset.
-
Right-click the Subclient in the right pane and then click Browse and Restore.
-
Click View Content.
-
Select the data that you want to restore and click Recover All Selected.
-
Click Advanced and then click the Pre/Post tab.
-
Enter the path for the batch file in the Post Recovery Command box or click Browse to select the batch file.
-
Select the Run Post Process for all attempts check box.
-
Click OK.
-
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.
To add or edit an additional setting, follow the steps in Add or Modify an Additional Setting.
Use these arguments:
-
In the Name box, type OptimizeRunLengths. The Category and Type details are automatically populated.
-
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.
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. You can restore only entire device files. 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
-
From the CommCell Console, expand Client Computers > client > File System.
-
Right-click the appropriate backup set, point to All Tasks and then click Browse and Restore.
The Browse and Restore dialog box appears.
-
Click View Content.
-
Select the raw device data from the right pane.
-
Click Recover All Selected.
The Restore Options for All Selected Items dialog box appears.
-
Select the Data in device node check box.
-
Select the Overwrite files check box, and then click Unconditional Overwrite.
-
In the Destination Client list, select the destination client.
-
Clear the Restore to same folder check box.
-
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.
-
From the CommCell Browser, navigate to Client Computers | <Client> | File System.
-
Right-click the <Backup Set>, point to All Tasks and then click Browse and Restore.
-
Click View Content.
-
Select the raw device data that you want to restore and click Recover All Selected.
-
Click Data in device node.
-
Select Overwrite files and then click Unconditional Overwrite.
-
Clear the Restore to same folder check box.
-
Select the name of the client computer from the Destination Client list.
-
Click Browse to navigate to the destination path.
-
Click Advanced.
-
Select Restore device files as regular files check box.
-
Click OK.
-
Click OK to start the restore.
Restoring Mac Files
You can restore Apple Double formatted Mac files that contain resource fork data.
Enabling a Global Option to Restore Resource Fork Data
-
From the CommCell Console, click the Control Panel button in the toolbar.
-
Double-click the Browse/Search/Recovery icon.
-
Select Recover Apple Resource Fork Data check box.
-
Click OK.
Restoring Resource Fork Data for a Specific Job
Use the following steps to recover Apple resource fork data of selective Mac files.
-
From the CommCell Browser, navigate to Client Computers | <Client> | File System.
-
Right-click the <Backup Set>, point to All Tasks and then click Browse and Restore.
-
Click View Content.
-
Select the Mac File System data that you want to restore and click Recover All Selected.
-
Click Advanced.
-
Select Recover Apple Resource Fork Data check box.
-
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.
-
From the CommCell Browser, navigate to Client Computers | <Client> | File System | Backup Set
-
Right-click the subclient in the right pane and then click Browse and Restore.
-
Click ViewContent.
-
Select the data that you want to restore and click Recover All Selected.
-
Click to clear the Restore ACLs check box.
-
Click OK.
Restoring ACFS Data
Use the following steps to restore Oracle ACFS data:
-
Click View Content.
-
From the Browse window, select the data you want to restore in the right pane and click Recover All Selected.
-
From the Restore Options for All Selected Items window, clear the Restore to Same Folder box.
-
In the Specify Destination Path box, type the location where the files will be restored. For eg., /oracle/acfs.
-
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
-
From the CommCell Browser, navigate to Client Computers | <Client> | File System | Backup Set.
-
Right-click the subclient for which you wish to list media and then click Browse and Restore.
-
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.
-
-
Click List Media.
-
From the List Media dialog box, click List Media for restore within specified time range.
-
Click OK.
The appropriate media is listed in the Media dialog box.
Listing Media for a Backup Set
-
From the CommCell Browser, navigate to Client Computers | <Client> | File System.
-
Right-click the backup set for which you wish to list media, point to All Tasks and then click Browse and Restore.
-
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.
-
-
Click List Media.
-
From the List Media dialog box, click List Media for restore within specified time range.
-
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:
-
From the CommCell Browser, navigate to Client Computers | <Client> | File System.
-
Right-click the <Backup Set> in the right pane and then click Browse and Restore.
-
Click View Content.
-
Select the data that you want to restore and click List Media and Size.
-
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
-
From the CommCell Console, navigate to Client Computers | <Client> | File System.
-
Right-click a <Backup Set> and click All Tasks | Browse and Restore.
-
Click View Content.
-
Select the data to restore and click Recover All Selected.
-
Click the Job Initiation tab and click Schedule.
-
Click Configure.
-
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
-
From the CommCell Console ribbon, click the Home tab, and then click Control Panel.
-
In the Data section, click Job Management.
The Job Management dialog box is displayed.
-
On the Job Restarts tab, select the job information.
-
In the Job Type box, select the job type that you want set the restart capability for (for example, File System and Indexing Based (Data Recovery)).
-
Select the Restartable check box.
-
Optional: to change the maximum number of times that the Job Manager tries to restart a job, in the Max Restarts box, select the number of times.
-
Optional: to change the time interval between attempts for the Job Manager to restart the job, in the Restart Interval (Mins) box, select the number of minutes.
-
-
Click OK.
Configure Job Restartability for an Individual Job
-
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".
-
-
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
-
From the Job Controller of the CommCell Console, right-click the job and select Suspend.
-
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
-
From the Job Controller of the CommCell Console, right-click the job and select Resume.
-
As the Job Manager attempts to restart the job, the job status changes to Waiting, Pending, or Running.
Killing a Job
-
From the Job Controller of the CommCell Console, right-click the job and select Kill.
-
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.
|
|
Use Exact index |
This option allows you to associate the media with the most recent index available in the CommCell.
|
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
|
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:
|
Refer to Restore Job Summary Report. |