Use XML to create Informix subclients. 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
-
On the Informix Agent host, run the qlogin command to log on to the CommServe computer.
-
Download the createinformixsubclient.xm file to the computer where you will run the command.
-
Open the createinformixsubclient.xml file, add your specific parameters and save the file.
For information on supported subclient XML parameters, see Available XML Parameters for Informix Subclient Configuration.
-
On the command line, go to Software_Installation_Directory/Base and type the following command.
qoperation execute -af xml_path\createinformixsubclient.xml -appName 'Informix Database' -clientName 'client_name' -instanceName 'dbname' -subclientName 'subclient_name' -backupMode 'backup_mode' -incrementalLevel 'incremental_level' -backupixbar 'backup_ixbar' -backuponconfig 'backup_onconfig' -dataBackupStoragePolicy/storagePolicyName 'Storage_Policy' -enableDeduplication 'True' -generateSignature 'generate_signature -softwareCompression 'software_compression'
Note
If the selected storage policy is associated with a server backup plan, after saving the subclient, the plan will also be associated with the subclient.
Examples
Adding a Subclient with the Backup Mode as the Whole System
To create a subclient with the backup mode as the whole system, set the following parameters:
|
Parameter |
Value |
|---|---|
|
backupMode |
'Whole_System' |
|
incrementalLevel |
'0' |
qoperation execute -af xml_path\createinformixsubclient.xml -appName 'Informix Database' -clientName 'client1' -instanceName 'dbname' -subclientName 'subclient1' -backupMode 'Whole_System' -incrementalLevel '0' -backupixbar 'False' -backuponconfig 'False' -dataBackupStoragePolicy/storagePolicyName 'data_sp' -enableDeduplication 'True' -generateSignature 'ON_CLIENT' -softwareCompression 'ON_CLIENT'
Adding a Subclient with the Backup Mode as the Entire Instance
To create a subclient with the backup mode as the entire instance, set the following parameters:
|
Parameter |
Value |
|---|---|
|
backupMode |
'Entire_Instance' |
|
incrementalLevel |
'0' |
qoperation execute -af xml_path\createinformixsubclient.xml -appName 'Informix Database' -clientName 'client1' -instanceName 'dbname' -subclientName 'subclient1' -backupMode 'Entire_Instance' -incrementalLevel '0' -backupixbar 'True' -backuponconfig 'True' -dataBackupStoragePolicy/storagePolicyName 'data_sp' -enableDeduplication 'True' -generateSignature 'ON_CLIENT' -softwareCompression 'ON_CLIENT'
Adding a Subclient with the Backup Mode as the Full and Current Logical Logs
To create a subclient with the backup mode as the entire instance, set the following parameters:
|
Parameter |
Value |
|---|---|
|
backupMode |
'FullAndCurrent' |
qoperation execute -af xml_path\createinformixsubclient.xml -appName 'Informix Database' -clientName 'client1' -instanceName 'dbname' -subclientName 'subclient1' -backupMode 'FullAndCurrent' -dataBackupStoragePolicy/storagePolicyName 'data_sp' -enableDeduplication 'True' -generateSignature 'ON_CLIENT' -softwareCompression 'ON_CLIENT'
Adding a Subclient with the Backup Mode as the Full Logical Logs
To create a subclient with the backup mode as the entire instance, set the following parameters:
|
Parameter |
Value |
|---|---|
|
backupMode |
'fulllogical' |
qoperation execute -af xml_path\createinformixsubclient.xml -appName 'Informix Database' -clientName 'client1' -instanceName 'dbname' -subclientName 'subclient1' -backupMode 'fulllogical' -dataBackupStoragePolicy/storagePolicyName 'data_sp' -enableDeduplication 'True' -generateSignature 'ON_CLIENT' -softwareCompression 'ON_CLIENT'
Adding a Selective Subclient with Selected Content
To create a subclient with the selected content from the database, set the following parameters:
|
Parameter |
Value |
|---|---|
|
backupMode |
'selective' |
Create a separate child element (content) at the end of the commonProperties element that contains each Informix database object that you want to include in the subclient.
For example, if you want to include the tablespaces named 'plog', 'llog' and 'rootdbs', add the following elements.
<content>
<informixContent tableSpace="llog"/>
<informixContent tableSpace="plog"/></content>
<informixContent tableSpace="rootdbs"/>
</content>
qoperation execute -af xml_path\createinformixsubclient.xml -appName 'Informix Database' --clientName 'client1' -instanceName 'dbname' -subclientName 'subclient1' -backupMode 'Selective' -dataBackupStoragePolicy/storagePolicyName 'data_sp' -enableDeduplication 'True' -generateSignature 'ON_CLIENT' -softwareCompression 'ON_CLIENT'