Updating DB2 MultiNode Client Properties Using the Commvault Command Line Interface

Use XML to update DB2 MultiNode client 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 DB2 MultiNode Agent host, run the qlogin command to log on to the CommServe computer.

2. Download the xml file to the computer where you will run the command.

   If you want to add a DB2 MultiNode client in a multiple node environment, use the UpdateMultiNodeInstance_With_multipleNodes.xml file.

   If you want to add a DB2 MultiNode client in a single node environment, use the UpdateMultiNode_Instance_With_singleNode.xml file.

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

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

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

   MultiNode Instance Environment

    
   qoperation execute -af xml_path UpdateMultiNodeInstance_With_multipleNodes.xml -appName 'DB2 MultiNode' -clientType 'DB2_DPf' -clientName 'client_name' -instanceName 'dbname' -homeDirectory 'home_directory_path' -userName 'db2_user' -password 'password' -commandLineStoragePolicy/storagePolicyName 'command_line_storage_policy' -logBackupStoragePolicy/storagePolicyName 'log_line_storage_policy' -dataBackupStoragePolicy/storagePolicyName 'data_storage_policy'

   Single Node Environment

    
   qoperation execute -af xml_pathUpdateMultiNode_Instance_With_singleNode.xml -appName 'DB2 MultiNode' -clientType 'DB2_DPf' -clientName 'client_name' -instanceName 'dbname' -homeDirectory 'home_directory_path' -userName 'db2_user' -password 'password' -commandLineStoragePolicy/storagePolicyName 'command_line_storage_policy' -logBackupStoragePolicy/storagePolicyName 'log_line_storage_policy' -dataBackupStoragePolicy/storagePolicyName 'data_storage_policy'

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

Examples

 
qoperation execute -af UpdateMultiNode_Instance_With_singleNode.xml -clientType DB2_DPF -entity/clientName "DB2DPF_DB2MULTI1_SingleNode" \ -nodelistopType add $[] -dpfpartitionclients/nodenum "4" \ -nodeClient/clientName "db2multi1"

 
qoperation execute -af a target='_blank' UpdateMultiNodeInstance_With_multipleNodes.xml -clientType DB2_DPF -entity/clientName "DB2DPF_DB2MULTI1_SingleNode" \ -nodelistopType add

 
qoperation execute -af UpdateMultiNode_Instance_With_singleNode.xml -clientType DB2_DPF -entity/clientName "DB2DPF_DB2MULTI1_SingleNode" \ -nodelistopType DELETE \ -dpfpartitionclients/nodenum "5" \ -nodeClient/clientName "db2multi1"

 
qoperation execute -af a target='_blank' UpdateMultiNodeInstance_With_multipleNodes.xml -clientType DB2_DPF -entity/clientName "DB2DPF_DB2MULTI1_SingleNode" \ -nodelistopType delete

 
qoperation execute -af a target='_blank' UpdateMultiNodeInstance_With_multipleNodes.xml -clientType DB2_DPF -entity/clientName "DB2DPF_DB2MULTI1_SingleNode" \ -nodelistopType delete

 
qoperation execute -af a target='_blank' UpdateMultiNode_Instance.xml -clientType DB2_DPF -entity/clientName "DB2DPF_DB2MULTI1_SingleNode" \ -deDuplicationOptions/generateSignature "ON_CLIENT" \ -dataBackupStoragePolicy/storagePolicyName "DB2DPFData"