Advanced Configuration - Oracle iDataAgent

Table of Contents

Understanding the CommCell Console

Managing Instances

Enabling Automatic Instance Discovery

Setting the Automatic Discovery Frequency

Manually Discovering Instances

Manually Adding an Instance

Creating an On Demand Instance

Changing the Oracle Home Directory

Configuring the TNS ADMIN Directory

Managing Container Databases

Adding a Container Database

Configuring User Accounts for Backups

Configuring User Account to Access the Oracle Application

Configuring User Account to Access the Oracle Database

Disabling the RMAN Crosscheck

Managing Subclients

Creating a Subclient for Offline Backups

Creating a Subclient for Online Backups

Creating a Subclient to Backup Individual Datafiles/Tablespaces

Creating a Subclient for Selective Online Full Backups

Creating a Subclient for Log Backups

Configuring Backups for Standby Database

Configuring Archive Log Destinations

Setting up the Log Destination for Deletion

Deleting the Logs after a Backup

Disabling Log Switch

Enabling Log Deletion after Backup

Managing Control Files

Enabling Automatic Backup of Control Files for All Subclients

Enable/Disable Control File Backups for a Specific Subclient

Configuring Table Restores

Enabling Table Browse for Restores

Setting Up the Auxiliary Instance

Configuring Lights Out Script for Offline Backups

Including the Server Parameter (SP) File during Backups

Enabling Backups of Flash Recovery Area

Using Recovery Catalog for Backups

Synchronizing the Control File with the Recovery Catalog

Configuring Streams for Backups

Data Backups

Log Backups

Enhancing Backup Performance

Assigning Unique Identification Tags for Backups

Excluding Data During Backups

Validating Database for Backups

Enabling Multiple Backup Copies

Modifying an Agent, Instance, or Subclient

Deleting an Agent, Instance or Subclient

Deleting an Agent

Deleting an Instance

Deleting a Subclient

Command Line Operations

Log on to the CommServe

Configuring Instances

Configuring the Subclients

Understanding the CommCell Console

The Oracle iDataAgent uses the following logical entities to manage backup and restore operations from the CommCell Console.

Agent

Facilitates Oracle instance discovery.

Instance

Defines the Oracle database to be backed up.

Subclient

Defines the Oracle database objects to be backed up.

 

Managing Instances

In the CommCell Console each instance references an Oracle database. Hence it is necessary to discover the instances which can then be used to backup data. You can discover or add an instance as described in the following sections:

Enabling Automatic Instance Discovery

When automatic instance discovery is enabled, the existing Oracle database instances are discovered as follows:

This capability ensures that all instances are accounted for on a regular basis for backups.

Automatic instance discovery will not detect the manually created databases in an instance. Make sure that there is an entry in /etc/oratab for manually created oracle instance which contains manually created databases. Then, this instance is automatically discovered when you enable instance discovery.

Use the following steps to enable automatic instance discovery:

  1. From the CommCell Browser, navigate to Client Computers |<Client>.
  2. Right-click Oracle, and then click Properties.
  3. Select the Enable Instance Discovery check box.
  4. Click OK.

Setting the Automatic Discovery Frequency

When instance discovery is enabled, Oracle instances are automatically discovered every 168 hours or whenever the Communications Service (GxCVD) is restarted. Use the following steps to modify the default discovery time interval.

  1. From the CommCell Browser, navigate to Client Computers.
  2. Right-click the <Client>, and then click Properties.
  3. Click the Registry Key Settings tab.
  4. Click Add.
  5. In the Name box, type nORACLEINSTANCEDISCOVERYINTERVAL
  6. In the Location box, select or type OracleAgent.
  7. In the Type box:
    • On Windows client

    Select REG_DWORD.

    • On Unix client

    Select Value.

  8. In the Value box, type the time interval to discover instances.

    For example, to discover instances every two hours, type 2.

  9. Click OK.

Manually Discovering Instances

If you have manually created an Oracle database, then you must manually discover the corresponding instance. Automatic instance discovery will not detect the manually created databases.

In addition, you can also use the manual discovery process to discover the Oracle databases at any point in time. Use the following steps to manually discover instances:

  1. From the CommCell Browser, navigate to Client Computers | <Client>.
  2. Right-click Oracle, point to All Tasks, and then click Discover Instance.
  3. Click Yes to confirm discovery of instances.

Manually Adding an Instance

During automatic instance discovery, options such as oracle home path and user account, connect string are preset. When instances are manually added, these options can be customized. Use the following steps to manually add an instance:

  1. From the CommCell Browser, navigate to Client Computers |< Client >.
  2. Right-click Oracle, point to All Tasks, and then click New Instance (ORACLE SID).
  1. In the Instance (ORACLE SID) box, type the Instance name.
  2. In the User Account box, type the login credentials to access the Oracle client.
  3. In the ORACLE HOME box, type the Oracle application install path.
  4. In the Storage Policy used for the data of default subclient box, select a storage policy name.
  1. Click the Details tab.
  2. In the Connect String box, type the credentials to access the Oracle database. For example, sys/pwd12@orcl4.
  3. Click the Storage Device tab.
  4. In the Storage Policy used for user command backup of data box, select a storage policy.
  5. In the Storage Policy used for all Archive Log backups box, select a storage policy name.
  6. Click OK.

Creating an On Demand Instance

You need to create an On Demand instance to perform on demand backup operations. When creating an On demand instance, a default subclient is automatically created for the instance. The content for the default subclient will be specified in the RMAN script that is run through the Command Line Interface.

Once an On Demand Instance is created, it cannot be changed into a traditional instance.
Use the following steps to create an On Demand instance:
  1. From the CommCell Browser, navigate to Client Computers | <Client>.
  2. Right-click Oracle, point to All Tasks, and then click New On Demand Instance.
  3. Click Yes to confirm the creation of an On Demand Instance.

Configuring the Oracle Home Directory

Oracle HOME directory refers to the location where the Oracle application resides. When instances are discovered, the home path is automatically assigned to the instance. However, you can modify the home path location for an instance at any point of time. Use the following steps to configure the Oracle HOME directory:

  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle|.
  2. Right-click the <Instance>, and then click Properties.
  3. In the ORACLE HOME box, type the path to Oracle Home directory. Alternatively, you can use Browse to locate the path.
  4. Click OK.

Configuring the TNS ADMIN Directory

When an instance is configured, by default, the TNS_Admin directory is created in the Oracle HOME\network\admin path. Use the following steps to change the path for the TNS_ADMIN directory:

  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle|.
  2. Right-click the <Instance>, and then click Properties.
  3. Click the Details tab.
  4. In the TNS_ADMIN folder box, type the location for the TNS Admin directory. Alternatively, you can use Browse to locate the path.
  5. Click OK.

Managing Container databases (cdb)

In the CommCell Console each Oracle 12c container database (CDB) maps to an instance.  Once you have added an instance for the container database, you can create subclients and backup sets as you would for any Oracle database instance.

Adding a container database

  1. From the CommCell Browser, navigate to Client Computers |< Client >.
  2. Right-click Oracle, point to All Tasks, and then click New Instance (ORACLE SID).
  1. In the Instance (ORACLE SID) box, type the container database name.
  2. In the User Account box, type the login credentials to access the Oracle container database.
  3. In the ORACLE HOME box, type the Oracle container database application install path.
  4. In the Storage Policy used for the data of default subclient box, select a storage policy name.
  1. Click the Details tab.
  2. In the Connect String box, type the credentials to access the Oracle container database. For example, sys/pwd12@orcl4.
  3. Click the Storage Device tab.
  4. In the Storage Policy used for user command backup of data box, select a storage policy.
  5. In the Storage Policy used for all Archive Log backups box, select a storage policy name.
  6. Click OK.

Configuring User Accounts for Backups

In order to perform backup and restore operations, you need to create and configure the following user accounts on the Oracle client:

Additional accounts (except Impersonate User) should be established by Oracle database administrator.

Configuring User Account to Access the Oracle Application

Use the following steps to configure the user account to access the Oracle application:

  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle.
  2. Right-click the <Instance>, and then click Properties.
 
  1. On Windows client:
    • Click Change.
    • In the User Account box, type the user account name.
    • In the Enter Password box, type the password for the user account.
    • In the Confirm Password box, retype the password, and then click OK.

On Unix clients:

In the User Account box, type the user account to access the Oracle application.

  1. Click OK.

Configuring User Account to Access the Oracle Database

Use the following steps to configure the user account privileges to access the Oracle database:

  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle.
  2. Right-click the <Instance>, and then click Properties.
  3. Click the Details tab.
  4. In the Connect String box, type the connect string to connect to the Oracle database as following:
    • Type the Database user ID.
    • Click the Password box, in the Enter Password box, type the password for the user ID.
    • In the Confirm Password box, retype the password, and then click OK.
    • Type the Oracle service name.

    For example:

    sysdba/<password>@<orcl

    where, sysdba is the Database User ID, <password> is the password of the Database User ID, and orcl is the Oracle service name.

  5. Click OK.

Disabling the RMAN Crosscheck

By default, during a data aging operation, an Oracle CROSSCHECK is performed by the system to synchronize the entries in the CommServe database with the RMAN catalog. Use the following steps to disable the cross check operation:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Oracle .
  2. Right-click the <Instance>, and then click Properties.
  3. Click the Details tab.
  4. Select the Disable RMAN cross check check box.
  5. Click OK to close the warning message.
  6. Click OK.

Managing Subclients

When you create an instance, a default subclient is automatically created. The default subclient includes the entire database associated with that instance, which includes all components, such as the log files and control files. However, you can create user-defined subclients to backup the specific components or conditions, such as the following:

If a new database object is added to the database, and if none of the subclients contain that database object , then that object is automatically assigned to the content of the default subclient.

Creating a Subclient for Offline Backups

During an offline backup, the database is shutdown and is not available for use. Since incremental backups require access to various tablespaces and datafiles, it is always recommended that you perform a full backup of the database when it is offline. The full backup includes all the datafiles, tablespaces, and control file of the Oracle database. Note that, offline backups do not include the archived log files.

Offline backups can be performed when the database is in offline or online mode. If the database is online, it shuts down the database, performs the backup and then brings up the database back.

In order to backup the Oracle database when it is offline, you need to create a separate user-defined subclient for offline backup. Make sure that the database is in the MOUNT mode during the backup.

A static listener must be configured for offline backups with lights out script when the Oracle database is in open mode. See When do we configure a static listener for additional information.

Use the following steps to create a subclient for offline backups:

  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle.
  2. Right-click the <Instance>, point to All Tasks, and then click New Subclient.
  3. In the Subclient name box, type the subclient name.
  4. Click the Content tab.
  5. Click Offline Database.
  6. Click the Storage Device tab.
  7. In the Data Storage Policy box, select the storage policy name.
  8. Click OK.

Creating a Subclient for Online Backups

In some environments, it may not be possible to bring down the entire database to perform an offline backup. In such situations, you can choose online backups, where the database will be up and running during the backup. 

You can perform either a full backup or incremental backup of the Oracle database when it is online. Since full backups includes all the datafiles, tablespaces and logs, it is very time consuming, hence you can plan for a full online backup less frequently (say, on weekly basis). On the other hand, incremental backups includes the data and logs that have been changed after the last full backup, they are faster and can be performed more frequently (say, on a daily basis).

 If a new database object is added to the database, and if none of the subclients contain that database object , then that object is assigned to the content of the default subclient

Use the following steps to create a subclient for online backups:

  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle.
  2. Right-click the <Instance>, point to All Tasks, and then click New Subclient.
  3. In the Subclient name box, type the subclient name.
  4. Click the Content tab.
  5. Click Online Database.
  6. Click the Storage Device tab.
  7. In the Data Storage Policy box, select the Storage policy.
  8. Click OK.

Creating a Subclient to Backup Individual Datafiles/Tablespaces

You can also create subclients to backup specific datafiles and tablespaces, which undergo frequent changes in the Oracle database.

Use the following steps to create a subclient to backup individual datafiles and tablespaces:

  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle.
  2. Right-click the <Instance>, point to All Tasks, and then click New Subclient.
  3. In the Subclient name box, type the subclient name.
  4. Click the Content tab.
  5. Click Online Subset.
  6. Select the database objects to be included in the backup.
  7. Click the Storage Device tab.
  8. In the Data Storage Policy box, select the storage policy name.
  9. Click OK.

Creating a Subclient for Selective Online Full Backups

Selective Online Full backup is a full backup performed when an Oracle database is online and is copied to a selective copy (during an auxiliary copy operation) from which it can be restored.
The advantage of this type of backup is that both the data and logs use the same storage policy, which means that they reside together on the same media. They are completely self-contained for restore and long term archiving purposes. This is especially useful in disaster recovery situations by alleviating the need to locate different offsite media from various jobs to gather the necessary data and logs to recover the database. Also, the data aging rules for selective online full backups are different from regular full backups, as both data and logs are aged together under the same storage policy.

When performing the selective online full backup, note the following:

Use the following steps to create a subclient for performing selective online full backups:

  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle.
  2. Right-click the <Instance>, point to All Tasks, and then click New Subclient.
  3. In the Subclient name box, type the subclient name.
  4. Click the Content tab.
  5. Select the Selective Online Full check box.
  6. Click the Storage Device tab.
  7. In the Data Storage Policy box, select the storage policy name.
  8. Click OK.

See Data Aging Rules for Selective Online Full Backups for more data aging rules for selective online full backups.

  If you want to create a subclient for selective online full backup on multiple instances or clients instead of navigating to each client and creating the subclients, then, use this qscript.

Use the following steps to create a subclient for selective online full backups from the command line using qscript:

1. From the command prompt, logon to the CommServe using the qlogin command. Example: To log on to CommServe leonard64.devemc.com with user name user1:

qlogin -cs leonard64.devemc.com -u user1

Password:

2. Run the command to create a subclient for Oracle Selective Online Full backup. D:\>qcreate sub client -cs leonard64.devemc.com -c dbserve4 -a Q_ORACLE -i auto -n "NEWSUB" -sp "ying_data" -f "auto
3. Run the command to execute the qscript. D:\>qoperation execscript -sn SetSubClientProperty.sql -si 'c=dbserve4' -si 'a=Q_ORACLE' -si 'i=auto' -si 'b=default' -si 's=NEWSUB' -si 'Oracle Online Selective Full' -si '1' -si '2'

For more information about the parameters and arguments, see qscript.

Enabling Selective Online Incremental Backup

When performing selective online incremental backups, note the following:

You can enable and disable selective online incremental backup using sql scripts.

Enable selective online incremental backup:

qoperation execscript -sn SetKeyIntoGlobalParamTbl.sql -si JMSOFIncrSupport -si y -si 1

Disable selective online incremental backup:

qoperation execscript -sn SetKeyIntoGlobalParamTbl.sql -si JMSOFIncrSupport -si n

Creating a Subclient for Log Backups

Archive logs are required to recover database transactions that have been lost due to an operating system or disk failure. You can apply these archive logs to an online backup in order to recover a database.

Though online full backups can include both data and logs, because of their importance in recovering data, it is recommended that you create separate subclients to backup archive log files.

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Oracle.
  2. Right-click the <Instance>, point to All Tasks, and then click New Subclient.
  3. In the Subclient name box, type the subclient name.
  4. Click the Content tab.
  5. Clear the Data checkbox.
  6. Select the Backup Archive Log check box.
  7. Click the Storage Device tab.
  8. In the Data Storage Policy box, select the storage policy name.
  9. Click OK.
  If you want to create a subclient for Log backups on multiple instances or clients instead of navigating to each client and creating the subclients, then, use this qscript.

Use the following steps to create a subclient for Log backups from the command line using qscript:

1. From the command prompt, logon to the CommServe using the qlogin command. Example: To log on to CommServe leonard64.devemc.com with user name user1:

qlogin -cs leonard64.devemc.com -u user1

Password:

2. Run the command to create a subclient. D:\>qcreate sub client -cs leonard64.devemc.commvault.com -c dbserve4 -a Q_ORACLE -i auto -n "NEWlog" -sp "ying_data" -f "auto"
3. Run the command to disable Data option. D:\>qoperation execscript -sn SetSubClientProperty.sql -si 'c=dbserve4' -si 'a=Q_ORACLE' -si 'i=auto' -si 'b=default' -si 's=NEWlog' -si 'Oracle Backup Mode' -si '1' -si '2'
4. Run the command to disable Backup Control File option. D:\>qoperation execscript -sn SetSubClientProperty.sql -si 'c=dbserve4' -si 'a=Q_ORACLE' -si 'i=auto' -si 'b=default' -si 's=NEWlog' -si 'Backup Control Files' -si '0' -si '2'
5. Run the command to disable Delete Archive log option. D:\>qoperation execscript -sn SetSubClientProperty.sql -si 'c=dbserve4' -si 'a=Q_ORACLE' -si 'i=auto' -si 'b=default' -si 's=NEWlog' -si 'Archive Log Deleting' -si '0' -si '2'

For more information about the parameters and arguments, see qscript.

Configuring Backups for Standby Database

Standby databases can be backed up when they are in offline or online state. If the database is online, the iDataAgent detects the standby database mode by checking the database role and automatically disables the log switch operation.

Use the following steps to configure backups for standby database:

  1. Add an instance for the Standby database. Alternative, you can auto discover the database.
  2. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle.
  3. Right-click the <Instance>, point to All Tasks, and then click New Subclient.
  4. In the Subclient name box, type the subclient name.
  5. Click the Content tab.
  6. Select the backup mode. Choose one of the following;
    • Offline Database - if the backup is performed when database is offline.
    • Online Database - if the backup needs to be performed on the online database
  7. Click the Storage Device tab.
  8. In the Data Storage Policy box, select the storage policy name.
  9. Click OK.

Configuring Archive Log Destinations

When you backup archive logs, you can specify the locations from where the log backups should be performed. This capability enables you to schedule backup operations from different log destinations on the same subclient. If necessary, you can also delete the logs after the backup. For more information, see Deleting the Logs after a Backup

Setting Up the Log Destination for Deletion

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Oracle | <Instance>.
  2. Right-click the <Subclient>, and then click Properties.
  3. Click the Log Destinations tab.
  4. Select the Select ArchiveLog Destinations for Backup check box.
  5. Click Add, type or select the Archive log file destination, and then click OK.
  6. Click OK.

Deleting the Logs after a Backup

  Ensure that the logs in the specified location are backed up. This may cause data loss if those archive logs are not backed up.
  1. From the CommCell Browser, navigate to Client Computers | <Client> | Oracle | <Instance>.
  2. Right-click the <Subclient>, and then click Properties.
  3. Click the Log Destinations tab.
  4. Select the Select ArchiveLog Destinations for Delete check box.
  5. Click Yes to close the warning message.
  6. In the Confirmation box, type Confirm.
  7. Click OK.
  8. Click Add.
  9. Type or select the Archive log file destination.
  10. Click OK.
  11. Click OK.

Disabling Log Switch

When performing archive log backups, the current redo log file is closed (even if it is not filled up completely) and the next redo log file is used for writing using a log switch. The closed redo log file is then archived during the log phase. Use the following steps to disable the log switch:

  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle|<Instance>.
  2. Right-click the <Subclient>, and then click Properties.
  3. Click the Content tab.
  4. Clear the Data checkbox.
  5. Select the Backup Archive Log check box.
  6. Select the Disable Switch Current Log check box.
  7. Click OK.

Enabling Log Deletion after Backup

When backing up archive logs, by default the logs are not deleted after the backup operation. Use the following steps to enable deletion of logs soon after the backup.

  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle | <Instance>.
  2. Right-click the <Subclient>, and then click Properties.
  3. Click the Content tab.
  4. Select the Archive Delete check box.
  5. Click OK.

See Deleting Archive Logs After a Specific Backup for more information.

Managing Control Files

As the Control file stores the status of the physical structure of the database. It is required when you want to recover the database to the current state. Hence it is important to include control files in your backups. By default, control files are included in the subclient for selective online full backups. You can also include/exclude control files for online or offline backups. The following sections describe the methods by which you can backup control files.

Enabling Automatic Backup of Control Files for All Subclients

You can configure the instance to automatically backup Control Files whenever you a backup the subclient in that instance.

Use the following steps to enable automatic backup of control files for all the subclients in the instance.

  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle.
  2. Right-click the <Instance>.
  3. Click the Details tab, in the Ctrl File Autobackup box,
    • Select Configure ON. This will backup the control file separately.
    • Alternatively, select Configure Off to backup the control file along with the datafile.
  4. Click OK.

Enable/Disable Control File Backups for a Specific Subclient

If the control file backup is enabled at the instance level, you can also include/exclude control files for backups from a specific subclient. Use the following steps to enable control file backups for a specific subclient.

  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle | <Instance>.
  2. Right-click the <Subclient>,and then click Properties.
  3. Click the Content tab.
  4. Select the Backup Control File check box.

  5. Click OK.

Configuring Table Restores

By default, all data is backed up which includes tablespaces. If you want to restore individual tables, you need to enable table level backup.

Enabling Table Browse for Restores

In order to backup and restore database tables, you need to enable table level backups for the subclient. Use the following steps to enable backups at table level.

  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle | <Instance>.
  2. Right-click the <Subclient>, and then click Properties.
  3. Click the Backup Arguments tab, and then click the Options tab.
  4. Select the Enable Table Browse check box.
  5. Click OK.

Setting Up the Auxiliary Instance

By default, when you restore database tables to a target instance, the system automatically duplicates the source database to an auxiliary instance in a temporary staging location specified during the restore operation. The database will be automatically imported from this auxiliary instance after the restore.

Use the following steps to set up a specific database as an auxiliary instance. This is useful when you want to restore a table to a specific failure point.
1. Copy the init<SID>.ora file from the source database to the auxiliary database instance.  
2. Update the database name and the database file locations in the init<SID>.ora file for the auxiliary database instance.  
3. Add the DB_FILE_NAME_CONVERT and LOG_FILE_NAME_CONVERT parameters in the init<SID>.ora file. These parameters will redirect the datafiles, temp files, and log files to the auxiliary instance. Windows Clients:

DB_FILE_NAME_CONVERT=('sourcE_of_df_path/','dup_of_df_path/','source_of_temp_path/','dup_of_temp_path/',...)

LOG_FILE_NAME_CONVERT=('source_of_log_path/redo','dup_of_log_path/redo')

Unix Clients:

DB_FILE_NAME_CONVERT=(source_of_df_path/,dup_of_df_path/,source_of_temp_path/,dup_of_temp_path/,...)

LOG_FILE_NAME_CONVERT=(source_of_log_path/redo,dup_of_log_path/redo)

4. Add the log_archive_dest_1 parameter is added to the init<SID>.ora file on the auxiliary instance.  
5. Restart the Oracle Services, if using Windows clients.  
6. Add the destination instance name in the Listener.ora and Tnsnames.ora files. If using a different host, add the duplicate database instance name in the Listener.ora file on the destination host and Tnsnames.ora files on the destination and source hosts. Also, add the original database name in the Tnsnames.ora file on the destination host. DUPDB = (DESCRIPTION =

(ADDRESS = (PROTOCOL = TCP)(HOST = powerpc02)(PORT = 1521))

(CONNECT_DATA = (SERVER = DEDICATED)

(SERVICE_NAME = dupdb) (UR=A) ) )

7. Restart the Listener. $lsnrctl reload
8. Ensure that the auxiliary instance is in NOMOUNT mode. sql> startup nomount;

Configuring Lights Out Script for Offline Backups

In order to perform offline backups of the Oracle database, all users must be logged out of the database and it must be completely shut down. When the database is online, you can enable a graceful shutdown of the database using lights out script that will notify the users about the shutdown and set a specific wait time for the users to logout of the database. Use the following steps to configure lights out script for offline backups:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Oracle | < Instance>.
  2. Right-click the <Subclient>, and click Properties.
  3. Click the Content tab, and then click Offline Database.
  4. Click the Backup Arguments tab, and then click the Offline Arguments tab.
  5. Select the Lights Out Script check box.
  6. Select the Warning checkbox to display a warning message on the physical node.
  7. In the Delay Time box, select the delay time interval in minutes.
  8. In the Sleep Time (min) box, select or type the number of minutes to wait between retry attempts.
  9. In the Sleep Time (sec) box, select or type the number of seconds that you want the script to wait between retry attempts to shut down the database and check the status.
  10. In the Tries Number box, type the number of times the system must retry to attempt to shut down the database.
  11. Select the Use SQL Connect checkbox to connect to the oracle database.
  12. Click OK.

Including Server Parameter (SP) File during Backups

The Server Parameter file (SPFile) contains the database startup information. By default, the backups do not include the SPFile.

Use the following steps to include SPFile during backups:

  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle | <Instance>.
  2. Right-click the <Subclient>, and then click Properties.
  3. Click the Content tab.
  4. Select the Back up SP FILE check box.
  5. Click OK.

Enabling Backups of Flash Recovery Area

Flash Recovery Area is a specific area in the disk storage that exclusively holds a copy of all backup-related components, such as image copies, redo logs, and control file auto backups. This facilitates faster restores of backup data and minimizes restores from tapes during restore operations. Use the following steps to enable backup of flash recovery area:

  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle | <Instance>.
  2. Right-click the <Subclient>, and then click Properties.
  3. Click the Content tab.
  4. Select the Protect backup recover area check box.
  5. Click OK.

Using Recovery Catalog for Backups

By default, recovery catalog is not used for backup and restore. As the recovery catalog contains metadata about RMAN operations for each registered database, it is recommended to include recovery catalog in backups. The metadata information is useful when you want to restore and recover the database after a crash. Use the following steps to use the Recovery Catalog for backups:

  1. Verify that you have a recovery catalog database created using the following command:
  2. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle.
  3. Right-click the <Instance>, and then click Properties.
  4. Click the Details tab.
  5. Select the Use Catalog Connect check box.
  6. In the Catalog Connect string box
    • In the User Id box, type the Database user ID.
    • Click the Password box, in the Enter Password box, type the password for the user ID.
    • In the Confirm Password box, retype the password, and then click OK.
    • Type the Oracle service name.

    For example:

    sysdba/<password>@<orcl

    where, sysdba is the Database User ID, <password> is the password of the Database User ID, and orcl is the Oracle service name.

  7. Click OK.

Synchronizing the Control File with the Recovery Catalog

It is a good practice to synchronize the recovery catalog with the control file, as the control file contains the latest backup information, which is need to perform restores.

Use the following steps to synchronize the control file with the recovery catalog:

  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle | < Instance >.
  2. Right-click the <Subclient>, and then click Properties.
  3. Click the Backup Arguments tab, and then click the Options tab.
  4. Select the Resync Catalog check box.
  5. Click OK.

Configuring Streams for Backups

By default, backup data is sent to media in two streams. This means that a database is sent to media during a backup in two parallel waves. This results in backup taking about half the time to complete as it otherwise would if only one stream is used.

You can increase the number of streams used for backups for a particular subclient provided the number of streams does not exceed the maximum number configured in the subclient's storage policy. Increasing the number of streams for a subclient further reduces the amount of time a backup takes to complete. For example, increasing the number of streams from 2 to 3 enhances backup time from one-half that of a single stream to one-third.

Keep in mind that the same number of streams used for performing a backup will be needed to restore the data.

Data Backups

  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle | <Instance>.
  2. Right-click the <Subclient>, and then click Properties.
  3. Click the Storage Device tab.
  4. In the Number of Data Backup Streams box, type or select the number of data backup streams.
  5. Click OK.

Log Backups

  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle.
  2. Right-click the <Instance>, and then click Properties.
  3. Click the Storage Device tab, and then click the Log Backup tab.
  4. In the Number of Archive Log Backup Streams box, type or select the number of log backup streams.
  5. Click OK.

Enhancing Backup Performance

Several options are available for enhancing backup performance and reduce the network bandwidth used for performing backups. These options include:

In addition to the above configurations, you can also enable distribution of data across disks during backup operations. See Enhancing Backup Performance for more details

Use the following steps to enhance the backup performance:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Oracle | < Instance>.
  2. Right-click the <Subclient>, and then click Properties.
  3. Click the Backup Arguments tab.
  4. In the Data Files per BFS box, type or select the number of datafiles in each RMAN backup set.
  5. In the MAX Backup Set Size (kb) box, type or select the size of backup set allowed for RMAN backup set.
  6. In the Archive Files per BFS box, type or select the number of archive files in each RMAN backup set.
  7. In the Max Open Files box, type or select the number of datafiles that RMAN can read from simultaneously during a backup operation.
  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle.
  2. Right-click the <instance>, and then click Properties.
  3. Click the Details tab.
  4. In the Block Size box, type or select the size of the block for backup and restore operations.
  5. Click OK.

Assigning Unique Identification Tags for Backups

You can assign unique identification tags for all backup operations from a specific subclient. These tags can be used during a restore operation to easily identify a particular backup. Use the following steps to assign unique identification tag for backups.

  1. From the CommCell Browser, navigate to Client Computers | <Client> | Oracle | <Instance>.
  2. Right-click the <Subclient> and click Properties.
  3. Click the Backup Arguments tab.
  4. In the Oracle Tag box, type the tag name.
  5. Click OK.

Excluding Data During Backups

You can configure a subclient to skip the following data during backup operations:

Use the following steps to exclude data during backup operations:

  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle| <Instance>.
  2. Right-click the <Subclient>, and then click Properties.
  3. Click the Backup Arguments tab, and then click the Options tab.
  4. Select the SKIP READ ONLY check box to exclude the read only tablespaces.
  5. Select the SKIP OFFLINE check box to exclude the offline tablespaces.
  6. Select the SKIP INACCESSIBLE check box to exclude inaccessible data and log files.
  7. Click OK.

Validating Database for Backups

Prior to running backup operations, you can validate a backup job, which will cause RMAN to simulate the backup for the purpose of determining whether the backup can be successfully restored. Once a validate job is completed, you can view the log files of the job to identify and correct any validation issues.

During validation, the backup jobs are simulated without the media, you can view the log files of the job to identify and correct any validation issues.

Use the following steps to enable validation of backup jobs:

Prior to running a backup, you can check the following:

  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle | <Instance>.
  2. Right-click the Subclient and click Properties.
  3. Click the Backup Arguments tab, and then click the Options tab.
  4. Select the Validate check box.
  5. Click OK.

Command Line Operations

You can add, modify, or delete several configurable properties for the Oracle iDataAgent from the command line interface.

Command line configuration enables you to:

The following sections describe the available command line configurations:

Log on to the Commserve

To run command line operations you must first login to the CommServe as follows:

Configuring Instances

Creating an Instance

Example for creating an instance on the Unix client:

[root@client1 Base]# ./qcreate instance -c client1 -a Q_ORACLE -n instance1 -dsp sp1 -csp sp2 -lsp sp3 -hu oracle -oh /oracle/oracle10g ocu sys -ocp sys -ocs dctmdb -ct yes -ctu snap -ctp snap -cts test

Created instance successfully.

[root@client1 Base]#

You can execute a CreateOracleInstance qscript too using qoperation execscript qcommand to create an instance.

Modifying an Instance

Examples:

[root@client1 Base]# ./qmodify instance -c client1 -a Q_ORACLE -i instance1 -csp sp2 -lsp sp3

Modified instance successfully.

[root@client1 Base]#

Configuring the Subclients

Creating a Subclient

Example to create subclient with default options:

[root@client1 Base]# ./qcreate subclient -c client1 -a Q_ORACLE -i instance1 -n subclient1 -sp sp1 -f " "

Created subclient successfully.

Modify Subclient

Examples:

Creating Oracle Selective Online Full Subclient

  1. Create the subclient

    qcreate subclient -c client1 -a Q_ORACLE -i instance1 -n "SOF" -sp "ora_data" -f " "

  2. Enable Selective Online Full

    qoperation execscript -sn SetSubClientProperty.sql -si 'c=client1' -si 'a=Q_ORACLE' -si 'i=instance1' -si 'b=default' -si 's=SOF' -si 'Oracle Online Selective Full' -si '1' -si '2'

Creating Oracle Offline Subclient and enabling the Light Out script

  1. Create the subclient

    qcreate subclient -c client1 -a Q_ORACLE -i instance1 -n "OFFLINE" -sp "ora_data" -f " "

  2. Enable the offline option

    qoperation execscript -sn SetSubClientProperty.sql -si 'c=client1' -si 'a=Q_ORACLE' -si 'i=instance1' -si 'b=default' -si 's=OFFLINE' -si 'Oracle Backup Mode' -si '2'

  3. Enable the Light Out script

    qoperation execscript -sn SetSubClientProperty.sql -si 'client1' -si 'a=Q_ORACLE' -si 'i=instance1' -si 'b=default' -si 's=OFFLINE' -si 'Light out Script’ -si ‘1’ -si '2'

Creating Log Only Subclient

  1. Create the subclient

    qcreate subclient -c client1 -a Q_ORACLE -i instance1 -n "LOGONLY" -sp "ora_data" -f " "

  2. Disable Data Option

    qoperation execscript -sn SetSubClientProperty.sql -si 'c=client1' -si 'a=Q_ORACLE' -si 'i=instance1' -si 'b=default' -si 's=LOGONLY' -si 'Oracle Backup Mode' -si '1'

  3. Disable Delete Archive Log Option

    qoperation execscript -sn SetSubClientProperty.sql -si 'c=client1' -si 'a=Q_ORACLE' -si 'i=instance1' -si 'b=default' -si 's=LOGONLY' -si 'Archive Log Deleting' -si '0' -si '2’

Configuring BFS values

  1. Change datafile per BFS to 10:

    qoperation execscript -sn SetSubClientProperty.sql -si 'c=client1' -si 'a=Q_ORACLE' -si 'i=instance1' -si 'b=default' -si 's=command_test1' -si ‘Oracle Data FPS’ -si '10' -si '7'

  2. change archive files per BFS to 12:

    qoperation execscript -sn SetSubClientProperty.sql -si 'c=client1' -si 'a=Q_ORACLE' -si 'i=instance1' -si 'b=default' -si 's=command_test1' -si ‘Arch per bfs’ -si '12' -si '8'

Configuring number of data streams

Execute the following command from the <Software_Installation_Directory>/Base folder after substituting the parameters and attributes:

qoperation execscript -sn SetSubClientProperty.sql -si c=<client_name> -si 'a=Q_ORACLE' -si i=<instance_name> -si 'b=default' -si s=<subclient_name> -si 'Oracle Data backup streams' -si '<stream_value>’ -si '7'

Example:

Example to set the number of data streams to 4:

qoperation execscript -sn SetSubClientProperty.sql -si c=client1 -si 'a=Q_ORACLE' -si i=orcl -si 'b=default' -si s=FullSc -si 'Oracle Data backup streams' -si '4' -si '7'

Delete Subclient

Example:

[root@client1 Base]# ./qdelete subclient -c client1 -a Q_ORACLE -i instance1 -s subclient1

Deleted subclient successfully.

Enabling Multiple Backup Copies

You can take multiple copies of the data or log backups using RMAN command line. During restores, even if one of the copies is missing or corrupted, the restore operation will automatically failover to the other copy and restore the data.

1. To utilize the PARALLELISM option, you need to set the initial parameter in pfile or spfile. Example:

BACKUP_TAPE_IO_SLAVES=TRUE

2. Configure device type. Example:

RMAN> CONFIGURE DEVICE TYPE DISK PARALLELISM 2 BACKUP TYPE TO BACKUPSET;

3. Specify two copies of data. Example:

RMAN> CONFIGURE DATAFILE BACKUP COPIES FOR DEVICE TYPE 'SBT_TAPE' TO 2;

4. Specify two copies of log backups. Example:

RMAN> CONFIGURE ARCHIVELOG BACKUP COPIES FOR DEVICE TYPE 'SBT_TAPE' TO 2;

5. Add the environmental variables for the client and instance on which the iDataAgent is installed. Example:

allocate channel ch1 type 'sbt_tape'

PARMS="<software_install_path>/Base/libobk.so,

ENV=(CvClientName=<client_name>,

CvInstanceName=<instance_name>)"

6. Once you set the parameters, restart the Oracle database and perform backup operations from the CommCell Console. Example: To restart the database,
  1. Connect to the database.

    SQL> connect admin/admin@orcl as sysdba

  2. Shutdown the database.

    SQL> shutdown

  3. Mount the database.

    SQL> startup mount;

  4. Change to archivelog mode.

    SQL> alter database archivelog;

  5. Open the database.

    SQL> alter database open;

Modifying an Agent, Instance, or Subclient

There are several configurable properties available for your agent that can be modified from the agent, instance, or subclient level as per need.

It is recommended that that you do not modify the properties of a subclient when a job is in progress for that specific subclient. If a job is in progress, either wait for the job to complete or kill the job from the Job Controller.

The following table describes the properties that can configured from the agent, instance, and subclient levels.

Option Description Related Topics
Change Storage Policies You can modify the storage policies in any of the following situations:
  • To include a different media for the backup operation.
  • To use a storage policy with a different retention criteria.

You can change the storage policies from the subclient level.

  1. From the CommCell Browser, right-click the subclient.
  2. Click Properties.
  3. Click Storage Device.
  4. Select the Storage policy from the drop-down menu.
  5. Click OK.
Refer to Storage Policies.
Rename a Subclient

You can rename a subclient:

  1. From the CommCell Browser, right-click the subclient.
  2. Click Properties.
  3. Type the new name in the  Subclient name field.
  4. Click OK.
 
Rename an Instance You can rename a subclient.
  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle.
  2. Right-click the <Instance>, and then click Properties
  3. In the Instance( Oracle SID) box, type the instance name.
  4. Click OK.
 
Data Transfer Options You can efficiently configure the available resources for transferring data secured by data protection operations from the subclient level. This includes the following:
  • Enable or disable Data Compression either on the client or the MediaAgent.
  • Configure the transfer of data in the network using the options for Network Bandwidth Throttling and Network Agents.

You can configure the data transfer options.

  1. From the CommCell Browser,right-click the subclient.
  2. Click Properties.
  3. Click Storage Device.
  4. Click Data Transfer Option tab.
  5. Choose the appropriate software compression option for this subclient.
  6. Select Throttle Network Bandwidth and set the required bandwidth.
  7.  Click OK.
Refer to Data Compression and Network Bandwidth Throttling.
View Data Paths You can view the data paths associated with the primary storage policy copy of the selected storage policy or incremental storage policy. You can also modify the data paths including their priority from the subclient level.
  1. From the CommCell browser, right-click the subclient.
  2. Click Properties.
  3. Click Storage Device.
  4. Select Storage Policy from the drop-down menu.
  5. Click Data Paths.
 
Configure a Subclient for Pre/Post Processing of Data Protection You can add, modify or view Pre/Post processes for the subclient. These are batch files or shell scripts that you can run before or after certain job phases.
  1. From the CommCell browser, right-click the subclient.
  2. Click Properties.
  3. Click Pre/Post Process.
  4. Click one of the following phases and type the full path of the process that you want to execute during that phase. Alternatively, click Browse to locate the process (applicable only for paths that do not contain any spaces).
    • PreBackup Process
    • PostBackup Process
    • PreSnap Process
    • PostSnap Process
  5. Click OK.
  6. Select Run Post Backup Process for all attempts to run a post backup process for all attempts.
  7. For subclients on Windows platforms, Run As displays Not Selected.

    If you want to change the account that has permission to run these commands, click Change.

    1. In the User Account dialog box, select Use Local System Account, or select Impersonate User and enter the user name and password. click OK.
    2. If you selected Local System Account, click OK to the message advising you that commands using this account have rights to access all data on the client computer.
Refer to Pre/Post Processes.
Configure Activity Control You can enable backup and restore operations from the agent and subclient level. However, you can enable restore operations only from the agent level.
  1. From the CommCell browser, right-click the subclient.
  2. Click Properties.
  3. Click Activity Control, select or clear option(s) as desired.
  4. Click OK.
Refer to Activity Control.
Configure User Security You can configure user security from the agent or subclient level.

You can perform the following functions:

  • Identify the user groups to which this CommCell object is associated.
  • Associate this object with a user group.
  • Disassociate this object from a user group.
  1. From the CommCell browser, right-click the subclient.
  2. Click Properties.
  3. Click Security.
  4. Select the appropriate user groups to which you want to associate to the CommCell object from the Available Groups pane, and then move the user group to the Associated Groups pane.
  5. Click OK.
Refer to User Administration and Security.
Enable/Disable Data Encryption You can enable data encryption from the suclient level.Encryption must be enabled at the client level prior to configuring any instances residing on that client.
  1. From the CommCell browser, right-click the subclient.
  2. Click Properties.
  3. Click Encryption.
  4. Select the desired encryption.
  5. Click OK.
Refer to Data Encryption.
Enable/Disable Encryption for Third-party Command Line Operations You can enable data encryption for the command line operations from instance properties:
  1. From the CommCell Browser, navigate to Client Computers | <Client>| Oracle.
  2. Right-click the <Instance>, and then click Properties.
  3. Click the Encryption tab.
  4. Select the desired Encryption from the following:
    • None
    • Media Only (MediaAgent Side)
    • Network and Media (Agent Side)
    • Network Only (Agent Encrypts, MediaAgent Decrypt
  5. Click OK.
 
View Software Version and Installed Updates The Version tab, at the Agent level displays the software version of the component.
  1. From the CommCell browser, right-click the agent.
  2. Click Properties.
  3. Click Version.
  4. Click OK.
 
CommCell Configuration Report The CommCell Configuration Report provides the properties of the CommServe, MediaAgents, clients, agents, SRM agents, subclients, and storage policies within the CommCell based on the selected filter criteria.
  1. From the CommCell browser, click Reports icon.
  2. Select CommCell Configuration.
  3. Click Run.
Refer to CommCell Configuration.

Deleting an Agent, Instance, or Subclient

The following sections describe the steps involved in deleting an agent, instance, or subclient.

When you delete an instance or backupset, the associated data is logically deleted and you can no longer access the corresponding data from CommCell Console for recovery purposes.

Refer to the troubleshooting article on Recovering Data Associated with Deleted Clients and Storage Policies for information on how to recover data if you accidentally delete an entity.

Deleting an Agent

You need to uninstall or DeConfigure the agent software from the client computer before deleting from CommCell Browser. After you delete the client software, you can either leave the corresponding data intact for appropriate action or you can remove the data immediately. If you choose to remove the data immediately, you must delete the agent from the CommCell Browser. If you delete the agent, all of the agent's data is irretrievably lost.

  1. From the CommCell Browser, navigate to Client Computers | <Client>.
  2. Right-click the <Agent>, and then click Delete.
  3. A confirmation message is displayed with the following message:

    This operation will permanently delete the data backed up from this level and it cannot be restored.

  4. Click OK to continue with the deletion operation., or click No to abort the deletion.

Deleting an Instance

Consider the following before deleting an instance:

  1. From the CommCell Browser, right-click the instance that you want to delete, click All Tasks and then click Delete.
  2. click Yes to confirm the deletion. (clicking No cancels the deletion and retains the node.)
  3. Type the requested phrase in the Enter Confirmation Text dialog box and click OK. This should delete the instance.

Deleting a Subclient

Consider the following before deleting a subclient:

  1. From the CommCell Browser, navigate to Client Computers | <Client> | <Agent> | <Instance>.
  2. Right-click the <Subclient> that you want to delete, and then click Delete.
  3. A confirmation message is displayed, asking if you want to delete the subclient.

    Click No to cancel the deletion and retain the subclient, or click Yes to continue the deletion.