Restore - Documentum iDataAgent (Oracle)

Basic Advanced  

Table of Contents

Overview

Your First Restore

Documentum File Browse and Restore

Component-Level Browse and Restore

Viewing Restore Job History

Viewing Restored Items Associated With a Restore Job

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:

Restores can be run on-demand or can be scheduled to be run at a later point of time. The following sections explain the procedure to perform your first restore operation.

Your First Restore

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

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:
  Instance Level:
  • Right-click a Documentum instance, select All Tasks then click Browse Backup Data.
  • From the Browse Options dialog box, accept the default Browse the Latest Data.
  • Then click Documentum View option and specify a subclient (e.g., default) that contains documents.
  • Click OK.
   


 

  Subclient Level:
  • Right-click a Documentum subclient that contains documents and select Documentum File Browse.
  • From the Browse Options dialog box, accept the default Browse the Latest Data.
  • Click OK.
 

 

2. The Browse window is displayed, containing data objects such as files, folders, etc. and consists of two parts:
  • The left pane displays the object tree at the selected level.
  • The right pane displays the contents of the selected object tree.

Note that the window displays only the data that was obtained by a data protection operation. Data that is excluded by a filter, or data which did not exist as of the specified browse time does not appear in the window.

3. Select the instance node in the left pane. The files will be selected in the right pane. Select one or more files and click the Recover All Selected button at the bottom of the window.  
4. From the Restore Options (General) tab:
  • Select the name of the source client computer in the Destination Client from the list.
  • If performing an in-place restore, click Restore to same folder. Otherwise, specify a path in Specify Documentum Destination Folder Path.
  • To check the documents into the Documentum Repository, click Create Entities in Repository and:
    • 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).
  • Select the following option to restore and recover the documents.
    • Skip
5. If you need to run the backup operation immediately, select Immediate from the Job Initiation tab.

Go to step 11.

6. If you need to schedule the restore operation, select Schedule from the Job Initiation tab and click Configure.  
7. From the Schedule Details dialog box that appears, select the appropriate scheduling options.

Click Options to view the Advanced Schedule Options dialog box.

8. From the Advanced Schedule Options dialog box, select a specific time zone from which the job schedule time will be based.

Click OK to close the Advanced Schedule Options dialog box.

9. Click OK to close the Schedule Details window.  
10. Click OK to close the Restore Options window.

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

Once completed, the details of the job can be viewed in the Job History window.

 

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):

To ensure consistent restores, it is recommended to shutdown the Documentum Repository and the database in an appropriate mode before restoring.
1. From the CommCell Browser, to browse and restore components of a Documentum Repository, select one of the following methods
  • Right-click the Documentum agent, select All Tasks then click Browse Documentum.
  • Right-click a Documentum instance, select All Tasks then click Browse Backup Data.

 

2. From the Browse Options dialog box, click OK to execute the browse using the Browse the Latest Data option.

 

3. The Browse window is displayed, containing data objects such as database, storage area, full-text index and consists of two parts:
  • The left pane displays the object tree at the selected level.
  • The right pane displays the contents of the selected object tree.

Note that the window displays only the data that was obtained by a data protection operation. Data that is excluded by a filter, or data which did not exist as of the specified browse time does not appear in the window.

4. Select the components in the right pane that are required to restore.

Click the Recover All Selected button at the bottom of the window.

 
5. To restore the storage areas and full-text indexes to the same folder, from the Documentum Restore Options (Storage Area and FTI) tab:
  • Select Overwite Files to overwrite all backed up storage areas.
  • Select Restore to same folder to restore the storage area to the same folder.
6. To restore the database, from the Documentum Restore Options (Database) tab:
  • Select the name of the client computer in the Destination Client from the list.
  • Specify a Catalog Connect string.

    You can use the three fields (spaces) to enter the connect string for the catalog database. Use the first field to type the recovery catalog database user ID. Use the second field to type the password for the user ID, and use the third field to type the recovery catalog service name.

  • Select Restore Data to restore the database.
7. If you need to run the restore operation immediately, select Immediate from the Job Initiation tab.

Go to step 12.

8. If you need to schedule the restore operation, select Schedule from the Job Initiation tab and click Configure.  
9. From the Schedule Details dialog box that appears, select the appropriate scheduling options.

Click Options to view the Advanced Schedule Options dialog box.

10. From the Advanced Schedule Options dialog box, select a specific time zone from which the job schedule time will be based.

Click OK to close the Advanced Schedule Options dialog box.

11. Click OK to close the Schedule Details window.  
12. Click OK to close the Restore Options window.

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

Once completed, the details of the job can be viewed in the Job History window.

 

Viewing Restore Job History

Once a restore job has completed, it may be useful to view specific historical information about the job, such as the following:

This information can be viewed in the Job History window, which is accessible at the client computer, iDataAgent, instance, or subclient level in the CommCell Console.

The history provided depends on the entity from which the job history is viewed. For example, viewing job history from the instance level will yield information for the jobs performed for that instance. Conversely, viewing job history from the agent level will yield information for jobs run from all subclients within that instance.

Viewing Restored Items Associated With a Restore Job

  1. From the CommCell Browser, right-click the entity (e.g., instance, client computer, etc.) whose job restore history you want to view, click View, and then click Restore History.
  2. From the Job History filter window, select the filter options, if any, that you want to apply, and then click OK.
  3. From the Job History window, right-click the job whose restored items you want to view; click View Restore Items, and select from the type of items to view: Successful, Failed, Skipped or All.
  4. The Restored Files window will display the selected type of restored items for the job.
  5. Click OK.

Back to Top