Modifying Subclient Properties Using the Commvault Command Line Interface

Updated

Applies to: Sybase, Sybase IntelliSnap

Use XML to modify 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.

Procedure

  1. On the Sybase Agent host, run the qlogin command to log on to the CommServe.

  2. Download the update_subclient_template.xml file and save it on the computer from where you will run the command.

  3. Open the update_subclient_template.xml file, add your specific parameters and save the file.

    For information on supported subclient XML parameters, see XML Parameters for Sybase 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 'Sybase' -clientName '<client_name>' -instanceName '<dbname>' -subclientName '<subclient_name>' -dataBackupStoragePolicy/storagePolicyName '<storage_policy>'

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

Examples

Assign a storage policy

To assign a storage policy to a subclient, set the dataBackupStoragePolicy/storagePolicyName parameter to the storage policy name (in this example, 'sp1'.

qoperation execute -af update_subclient_template.xml -appName 'Sybase' -clientName 'client1' -instanceName 'instance1' -subclientName 'subclient1' -dataBackupStoragePolicy/storagePolicyName 'sp1'

Change the number of streams that the software uses for data and log backups

To change the number of streams for data and log backup, set the sybaseSubclientProp/numberOfBackupStreams and sybaseSubclientProp/numberOfTransactionLogStreams.

qoperation execute -af update_subclient_template.xml -appName 'Sybase' -clientName 'client1' -instanceName 'instance1' -subclientName 'subclient1' -dataBackupStoragePolicy/storagePolicyName 'sp1' -sybaseSubclientProp/numberOfBackupStreams '3' -sybaseSubclientProp/numberOfTransactionLogStreams '4' -contentOperationType ADD -sybaseContent/databaseName 'db1'