Updating Subclient Agent-Specific Properties Using the Command Line Interface

The update_subclients_batch_template.xml file can be modified to include subclient properties for a specific agent.

About This Task

The agent-specific elements are placed after the <commonProperties> element, for example:

<commonProperties>
   <encryptionFlag/>
   <description/>
   <enableBackup/>
   <storageDevice>
   ...
   ...
 </commonProperties>
 <oracleSubclientProp>
   <backupControlFile>true</backupControlFile>
 </oracleSubclientProp>

If the client computer group identified in the <clientGroupName> element contains agents of different types and agent-specific elements are in the XML file, the applicable subclients are updated and the inapplicable subclients are skipped. For example, in the following situation, only Windows file system agents are configured to backup the system state:

• The client computer group defined in the <clientGroupName> element includes Windows file system agents and Oracle agents

• The following elements are included in the XML file:

  <fsSubClientProp>
     <backupSystemState>true</backupSystemState>
   </fsSubClientProp>
  

Procedure

Use the following steps to update agent-specific properties for the applicable subclients in a client computer group.

1. Download the update_subclients_batch_template.xml file and save it on the computer from where the command will be executed.

2. Open the XML file and add the agent-specific parameters as needed.

   See the command line interface documentation for your agent for the list of subclient parameters to use with your agent. For example, for Windows subclient parameters, see Elements Available for Windows File System Subclient Configuration.

3. Save the changes to the XML file.

4. Run the qlogin command to log on to the CommServe computer.

5. From software_installation_directory/Base type the following command:

    
   qoperation execute -af xml_path\update_subclients_batch_template.xml

   If the XML file is saved in the software_installation_directory/Base directory, the file path (xml_path in the example above) does not need to be included on the command line.