Configuration - Documentum iDataAgent (DB2)

Basic Advanced  

Table of Contents

Overview

Configure the DB2 Database Backup

Create an Instance

Configure a Subclient

Overview

The Documentum iDataAgent uses two components to facilitate backups:

Configure the DB2 Database Backup

Prior to configuring the Documentum iDataAgent, perform the following:

Single Server Setup

If the DB2 database is installed on a separate client from that of the Documentum iDataAgent, the DB2 iDataAgent must be installed on that client computer and a DB2 instance must be configured. For more information, refer to Instances - DB2.

Distributed Server Setup

If the DB2 database and Documentum Server are installed on the same computer then you must create the following registry keys on the client computer:

Registry Key Value
sDB2_ARCHIVE_PATH <software_install_directory>\archive
sDB2_AUDIT_ERROR_PATH <software_install_directory>\audit_error
sDB2_RETRIEVE_PATH <software_install_directory>\retrieve

Create an Instance

This section describes how to create an instance for the Documentum iDataAgent in order to perform backup and recovery operations.

1. From the CommCell Browser, locate the correct client computer node.

Right-click the agent node for which you want the new instance created, click All Tasks, and then click Create New Instance.

 
2. Add the following information in the General tab:
  • Enter the name (up to 32 characters) for the instance in Docbase Name.
  • Click Configure Password and specify the Documentum Install Owner User Name and Password in User Account. Confirm the Password and click OK.
  • Type the Repository installation path in the DOCUMENTUM Path box or use Browse to locate the path.
  • Type the Repository shared path in the DOCUMENTUM_SHARED Path box or use Browse to locate the path.
  • Click Discover. The Docbase name and User Name and Password will be validated. If successful, the instance is created and the Docbase Version and Docbase Id are automatically populated.

Docbase User Account

To perform data protection and recovery operations, the Documentum iDataAgent requires a user account to log on to the related Documentum docbase to access the data. The user account is the Documentum Install owner account that was used to install the Documentum software.

The account must already be set up on the client.

 
3. Click the Database tab and add the following information:
  • From the Client pulldown menu, select the client computer on which the DB2 database resides.
  • Type the DB2 instance name in the Instance box.
  • Type the DB2 database name in the Database box.
  • Type the installation home path in the Home box or use Browse to locate the path.
  • Click Configure Password to specify the DB2 User account used by the system to perform all Data Protection and Recovery operations for this instance.

    To perform data protection and recovery operations, the DB2 iDataAgents require a user account with one of the following privileges to access the DB2 application and database:

    • Administration privileges (default)
    • DB2 database administration privileges
    • SYSADM, SYSCTRL, and SYSMAINT user group privileges

    This account must already be set up on the client. Additional accounts should be established by the DB2 database administrator. To establish additional accounts on your own, consult the appropriate DB2 application documentation.

  • Click OK.
 
4. Click the Storage Area and FTI tab and add the following information:
  • In Storage Area Details, select a file store that was discovered and click Edit. In the Edit Operation dialog box, select the Client name from the pulldown menu.
  • If a Full-text Index component is present, in FTI Details, select the full-text index name that was discovered and click Edit. In the Edit Operation dialog box, select the Client name from the pulldown menu and type the FTI Path.
 
5. Click OK to save the instance.  

Configure a Subclient

The following procedure describes the steps involved in configuring a subclient. This procedure may be used to configure the default subclient, as well as to create any additional subclients. Refer to Create User-Defined Subclients for more information.

1. From the CommCell Browser, right-click the subclient and then click Properties.
2. From the Full Text Index tab, you can:
  • Exclude backing up the FTI for this subclient by deselecting Backup FTI.
  • Select a FTI and click Edit to change the client computer or the path in which it resides.
  • If applicable, click Add to add a new FTI.
  • Change the name or path of the Quiesce or Unquiesce script.
3. From the Database tab, you can:
  • Exclude backing up the database for this subclient by deselecting Backup DB.
  • Change the state in which the database will be backed up (Offline or Online).
  • Include or exclude backing up Archive Logs or Deleted Logs.
  • Specify Pre or Post Backup Process (if applicable).

 

 
4. From the Storage Area tab, you can:
  • Exclude backing up the Storage Area for this subclient by deselecting Backup SA.
  • Select a SA and click Edit to change the client computer in which it resides.
  • If applicable, click Add to add a new SA.
  • Specify a Pre or Post Backup Process (if applicable).
 
5. From the Storage Device tab, click the Data Storage Policy tab and specify a  storage policy for the subclient.  
6. From the Storage Device tab, click the Streams tab and specify streams for  Database, Logs, and Storage Area.  
7.

Click OK to save the subclient.

 

Back to Top