Restore - Documentum iDataAgent (DB2)

Overview

As restoring your backup data is very crucial, it is recommended that you perform a simple restore operation immediately after your first full backup to understand the process. The following sections explains the steps for performing simple browse and restore operations.

Prior to running your first restore operation, ensure the following:

• Verify that the CommServe, MediaAgent and media library are powered on.

• You have successfully done a backup of the data to be restored.

• Verify that the media from which you wish to perform the restore is available in the CommCell. Use the List Media feature to identify the media required by the restore operation.

• Always ensure that sufficient space has been allocated for the restore.

Restores can be run on-demand or can be scheduled to be run at a later point of time.

Your First Restore

The restore operation can be done using one of the following methods:

• File-level Browse and Restore, which is useful when you want to restore documents.

• Component-level Browse and Restore, when you want to restore components of a Documentum Repository (database, storage area, or full-text indexes).

For this first simple restore, let us perform an in-place restore of documents and components of a Documentum Repository.

Documentum File Browse and Restore

This type of Browse and Restore is geared towards end-users and illustrates performing a basic browse and restore of documents:

1. From the CommCell Browser, to browse and restore documents, select one of the following methods:

   • From the CommCell Browser, navigate to Client Computers | <Client> | Documentum.

     Right-click the <Instance>, point to All Tasks, and then click Browse and Restore.

     

   • From the CommCell Browser, navigate to Client Computers | <Client> | Documentum | <Instance>.

     Right-click the default subclient and click Browse and Restore.

     

2. Select the Documentum View check box and specify a subclient (e.g., default) that contains documents.

   Click View Content.

   

3. In the right pane of the Browse window, click the <Instance> and select all the entities.

   Click Recover All Selected.

   

4. From the Restore Options for All Selected Items dialog box, specify the following:

   1. Select the name of the source client computer in the Destination Client from the list.

   2. By default Restore to same folder check box is selected to perform an in-place restore.

      • Clear the Restore to same folder check box and type the path in Specify Documentum Destination Folder Path for an out-of-place restore.

   3. Select Create Entities in Repository check box to check the documents into the Documentum Repository.

   4. In Specify Destination Path for Storage Area Files, enter the file system path on the destination computer to which the files will be restored. Typically, this would be a system path on the Primary Content Server. Click one of the following:

      • Current Active Version to check the file in with the same version number that is currently active in Documentum.

      • Next Minor Version to check the restored file to the next Minor Version. For example, if the restored document was a Minor version (e.g., 1.2), it will be check it into the next Minor version (e.g., 1.3). If the restored document is a Major version (e.g., 2.0), it will be checked into the next Minor version (e.g., 2.1).

      • Next Major Version to check-in the file to the next major version. For example, if the restored document was a Major version (e.g., 2.0), it will check it into the next Major version (e.g., 3.0). If the restored document was a Minor version (e.g., 1.2), it will check it into the next Major version (e.g., 2.0).

   5. In When Storage Area File Exists, by default Skip is selected to specify that if an item is selected for restore and that item already exists, it will not be restored.

      • Click Unconditional Overwrite to specify if the restored data is to be unconditionally written to the specified location.

   6. Select Impersonate User check box and type the username, password and confirm password to specify the DB2 user account used by the system to perform restore operations for this instance.

   7. Click OK.

   

5. Click the Job Initiation tab.

   Select Immediate to run the job immediately.

   Click OK.

   

6. You can monitor the progress of the restore job in the Job Controller window of the CommCell Console.

   

7. Once the restore job is complete, right-click the defaultBackupSet , point to View, and then click Restore History.

   

8. Click OK.

   

9. You can right-click the job and view the following details:

   • View Restore Items

     You can view them as Successful, Failed, Skipped or All.

   • View Job Details

   • View Events of the restore job

   • View Log files of the restore job

   

Component-Level Browse and Restore

This type of Browse and Restore is geared towards administrators and illustrates performing a basic browse and restore of all components of a Documentum Repository (database, storage area, or full-text indexes).

1. From the CommCell Browser, to browse and restore documents, select one of the following methods:

   • From the CommCell Browser, navigate to Client Computers | <Client> | Documentum.

     Right-click the <Instance>, point to All Tasks, and then click Browse and Restore.

     

   • From the CommCell Browser, navigate to Client Computers | <Client> | Documentum | <Instance>.

     Right-click the default subclient and click Browse and Restore.

     

2. Click View Content.

   

3. Expand the Documentum and select the components such as Storage Area, Full-Text Index and Database to be restored.

   For the first restore job, select any folder with smaller data size.

   Click Recover All Selected.

   

4. By default, Overwrite Files and Overwrite if file on media is newer is selected to overwrite all backed up storage areas.

   By default, Restore to same folder is selected to restore the storage area to the same folder.

   

5. Click the Database tab.

   • Select the Restore Data check box and click Entire Database.

   • Select the name of the client computer in the Destination Client from the list.

   • Select the name of the DB2 instance in the Destination Instance from the list.

   • In the Target Database Name, enter the name of the Database.

   • In the Target Database Path, enter the path of the database or click Browse.

   • Ensure to include in this field just the letter of the appropriate drive followed by a colon (e.g., L:). Otherwise, the target database will not be accessed.

   

6. Click the Restore Arguments tab to restore the backup images available for restore.

   • By default Offline Restore is selected to run a restore when the database is offline.

     If a restore is run with the database online, other applications can access the database while the restore is in progress. Online restores are available only for partial database restores (and not for full database restores).

   • In Select Backup Images, click the appropriate full backup image and (if present) any associated incremental and delta incremental backup images.

     Click > to move these images to the Selection list box and then click OK.

     Note

     Report files contain the names of the files that have become unlinked during a restore operation as a result of a fast reconcile. File names, if specified, must be fully qualified. These files are restored only if the table being restored has a DATALINK column type and linked files. To generate this file, you must either enter or browse for and then select the appropriate DB2 Report File path.

   

7. Click the Recover Database tab to restore a DB2 database without selecting backup images.

   • Select Recover DB check box to recover a DB2 database without selecting backup images from the CommCell Console.

     Whenever this option is selected, the Restore Arguments and Advanced tabs are disabled. This option is disabled whenever the options for a partial database restore and/or and out-of-place restore are selected.

   • By default To the End of the logs is selected to restore the DB2 database for all the logs associated with the database.

     Select To a Point in Time to recover the DB2 database based on the state and contents of the database to a specific point in time. To change this time, click in the list as appropriate.

     

8. Click the Job Initiation tab.

   Select Immediate to run the job immediately.

   Click OK.

   

9. You can monitor the progress of the restore job in the Job Controller window of the CommCell Console.

   

10. Once the restore job is complete, right-click the defaultBackupSet , point to View, and then click Restore History.

    

11. Click OK.

    

12. You can right-click the job and view the following details:

    • View Restore Items

      You can view them as Successful, Failed, Skipped or All.

    • View Job Details

    • View Events of the restore job

    • View Log files of the restore job