Modifying Subclient Properties Using the Commvault Command Line Interface

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 Oracle 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 Oracle 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 -clientName clientname -instanceName instance_name -subclientName subclientname $-storagePolicyName storagepolicyname -isSnapBackupEnabled true -snapShotEngineName Snapshot_engine isRMANEnableForTapeMovement enable_RMAN -backupCopyInterface interface -useRmanForLogBackup use_RMAN_for_Log_Backup
  5. Run the qlogout command to log off the CommServe computer.

Examples
Enable IntelliSnap backups

Set the following parameters:

Parameter

Value

isSnapBackupEnabled

'true'

./qoperation execute -af update_subclient_template.xml -clientName client1 -instanceName dctmdb -subclientName subclient1 -storagePolicyName sp1 -isSnapBackupEnabled true
Set the Snap Engine to NetApp

Set the following parameters:

Parameter

Value

isSnapBackupEnabled

'true'

snapShotEngineName

NetApp

./qoperation execute -af update_subclient_template.xml -clientName client1 -instanceName dctmdb -subclientName subclient1 -storagePolicyName sp1 -isSnapBackupEnabled true -snapShotEngineName NetApp
Set the Proxy Client to Proxy1

Set the following parameters:

Parameter

Value

isSnapBackupEnabled

'true'

snapShotEngineName

NetApp

snapToTapeProxyToUse/clientName

Proxy1

./qoperation execute -af update_subclient_template.xml -clientName client1 -instanceName dctmdb -subclientName subclient1 -storagePolicyName sp1 -isSnapBackupEnabled true -snapShotEngineName NetApp -snapToTapeProxyToUse/clientName Proxy1
Set the RMAN Backup Copy

Parameter

Value

isSnapBackupEnabled

'true'

snapShotEngineName

NetApp

snapToTapeProxyToUse/clientName

Proxy1

isRMANEnableForTapeMovement

'true'

backupCopyInterface

'0'

Note: You must install the Oracle Data Agent on the proxy client and then configure an Oracle instance in the CommCell Console.

qoperation execute -af update_subclient_template.xml -clientName clientName -instanceName oraclesid -subclientName subclientname -storagePolicyName storagepolicyname -isSnapBackupEnabled true -snapShotEngineName NetApp -snapToTapeProxyToUse/clientName Proxy1 -isRMANEnableForTapeMovement true - backupCopyInterface '0'
Use an RMAN Backup for Log Backups

Parameter

Value

isSnapBackupEnabled

'true'

snapShotEngineName

NetApp

snapToTapeProxyToUse/clientName

Proxy1

isRMANEnableForTapeMovement

'true'

useRmanforLogBackup

'true'

qoperation execute -af update_subclient_template.xml -clientName clientName -instanceName oraclesid -subclientName subclientname -storagePolicyName storagepolicyname -isSnapBackupEnabled true -snapShotEngineName NetApp -snapToTapeProxyToUse/clientName Proxy1 -isRMANEnableForTapeMovement true -useRmanForLogBackup true

Page contents

×

Loading...