V11 SP8

Modifying DB2 MultiNode Subclient Properties Using the Commvault Command Line Interface

Use XML to modify DB2 MultiNode subclient properties. 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. For more information on command line parameters and XML elements, see Command Line - Syntax.


  1. On the DB2 MultiNode Agent host, run the qlogin command to log on to the CommServe.
  2. Download the UpdateSubclient.xml file and save it on the computer from where you will run the command.
  3. Open the UpdateSubclient.xml file, add your specific parameters and save the file.

    For information on supported subclient XML parameters, see Available XML Parameters for DB2 MultiNode Subclient Configuration.

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

    qoperation execute -af xml_path\update_subclient_template.xml -appName 'DB2 MultiNode' -clientName 'client_name' -instanceName 'dbname' -backupsetName 'backupset_name'-subclientName 'subclient_name' -newName 'new_subclient_name'

  5. Run the qlogout command to log off the CommServe computer.


Expand All

Modifying the Storage Policy and Deduplication on a Subclient

Note: You must set the enableDedduplication parameter to 'true' when you use the generateSignature parameter.

To modify a subclient Storage Policy (in this example, the software compression will use the Storage Policy Settings and deduplication is enabled with the signature on the MediaAgent), set the following parameters:

Parameter Value
storagePolicy 'the data storage policy
enableDeduplication 'true'
generateSignature 'ON_MEDIA_AGENT'
dataBackupStoragePolicy/storagePolicyName Storage Policy Name (in this example, 'data_sp'),

qoperation execute update_subclient_template.xml -appName 'DB2 MultiNode' -clientName 'client1' -instanceName 'Instance0001' -backupsetName 'test_backup_set'-subclientName 'subclient1' -enableDeduplication true -generateSignature ON_MEDIA_AGENT -dataBackupStoragePolicy/storagePolicyName 'data_sp'

Renaming a Subclient

To rename a subclient, set the following parameters

Parameter Value
newName In this example "subclient1a"

qoperation execute update_subclient_template.xml -appName 'DB2 MultiNode' -clientName 'client1' -instanceName 'Instance0001' -backupsetName 'test_backup_set'-subclientName 'subclient1' -newName 'subclient1a