Discovering Instances Using the Commvault Command Line Interface

Use XML to discover Oracle database instances. Run the operation from the command line, or automate configuration by combining command line operations in a script.

The XML parameters can be included in the XML file, or specified on the command line when they frequently change. See Command Line - Syntax.

About This Task

By default, when you discover or create an Oracle instance, the Commvault software automatically creates a default data subclient and a default archive log subclient. If you don't want the software to create the default archive log subclient, you can disable this feature by setting an additional setting. For more information, see Disabling Automatic Archive Log Subclient Creation.You can configure the data and log storage policies when you manually or automatically discover instances (Agent Properties dialog box, Data Storage Policy list, Log Storage  Policy list, General tab). The Commvault software assigns these storage policies to all instances and default subclients that you discover.

By default, the command line storage policy is set to the agent data storage policy.

The log storage policy is assigned to the Oracle instance.

The Commvault software assigns the data storage policy to the default subclients by looking at the following configured items:

  1. The storage policy configured for the Oracle Agent (Data Storage Policy list, Log Storage Policy list, General tab)
  2. The storage policies that are configured for a previously discovered Oracle instance (Instance Properties dialog box, Storage Device tab, Log Backup tab, Storage Policy used for all archive log backup list)
  3. The storage policy for the File System Agent default agent for the default backup set (Subclient Properties dialog box, Storage Device tab, Data Storage Policy tab, Storage Policy list)


On the Oracle Agent host:

  1. Run the qlogin command to log on to the CommServe computer.
  2. Download theDiscoverInstance_Template.xml file and save it on the computer from where the command is executed.
  3. Open the DiscoverInstance_Template.xml file, add your specific parameters and save the file.

    For information on supported instance XML parameters, see Available XML Parameters for Oracle Instance Configuration.

  4. On the command line, go to the Software_Installation_Directory/Base, and type the command.

    qoperation execute -af DiscoverInstance_Template.xml -clientName '<client_name>'

  5. Once the job completes, run the qlogout command to log off the CommServe computer.

What to Do Next

  1. Modify the Oracle Instance with the following updates:
    • Add a Command Line Storage Policy when the File System Agent has not been installed.
    • Specify the Oracle Home and TNS Admin directories
    • Specify the Oracle Connect String
    • Specify the Catalog Connect
    • Disable the RMAN crosscheck
    • Turn on the control file autobackup
  2. Configure Subclients for Oracle.

Last modified: 10/29/2018 7:57:16 PM