Loading...

Modifying Subclient Properties Using the SnapProtect 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.xmlfile 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> -useRmanForLogBackup <use_RMAN_for_Log_Backup>

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

Examples

Expand All

Enable SnapProtect 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'

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

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