Exporting the DS-Client configuration to an XML file
NOTE: This feature is not supported for backup sets that have been configured with the Local-DS-VDR option.
You can export the current DS-Client configuration to an XML file named config-update.xml, which you can use for two purposes:
• To manually update the configurations of existing DS-Clients.
• To deploy and configure a large number of DS-Clients. For more information, see the DS-Client Mass Deployment Guide.
DS-Client will read any XML file named config-update.xml and will verify that its structure is correct. If the file has not previously been applied, DS-Client applies its settings. You can use an exported config-update.xml file as is, edit the file, or create your own. However, the XML file must conform to the structure defined in the file asigra_conf.dtd.
• For Windows DS-Clients, place the file config-update.xml in the program folder containing the DS-Client service.
• For Linux / Mac DS-Clients, place the file config-update.xml in the /etc sub-folder of the program folder containing the DS-Client service.
NOTE: The config-update.xml is not intended to be used to recover an existing DS-Client. It is meant to update a properly functioning DS-Client. If you need to recover a DS-Client that has its database backed up to DS-System, it is always better to use the Repair DS-Client function. (For more information, see
“Recovering the DS-Client database”.)
When the AllowAutoConfig parameter is enabled, DS-Client checks at startup (and every 10 seconds afterward) for a file named config-update.xml, reads the configuration file, and applies any updates it finds to its database. The DS-Client only applies the config-update.xml file if the file signature is different from the file signature of the previous file that was applied. Any existing configurations, backup sets, schedules, or retention rules are only overwritten if the associated “replace-existing” attribute is set to “yes”. After the XML file is applied, DS-Client renames the file to config-update-nnn.xml, where nnn is an incremental number.
NOTE: The DS-Client Configuration elements <account-name>, <account-number>, <client-number>, and <encryption-keys> are updated only when DS-Client restarts.
To export the DS-Client configuration to an XML file:
1. On the Setup menu, click Export to XML. The Export DS-Client configuration to XML dialog box appears.
2. You can export the following:
• DS-Client Configuration – Exports all settings from the DS-Client configuration.
• Backup Schedules – Exports all (or selective) backup schedules.
• Retention Rules – Exports all (or selective) retention rules.
• Backup Sets – Exports all (or selective) backup sets.
NOTE: Recovered orphaned backup sets that have not been migrated (or had their backup information for connection, backup items, and schedule re-specified) cannot be exported.
3. To include DS-Client and account keys in the XML file (they will be encrypted), select the Include Encryption Keys check box.
4. To use a meta symbol wherever necessary in the config-update.xml file, select the Meta Symbol check box (Windows DS-Client only). You can use the XML file to be used for DS-Clients on different localized operating systems.
5. To save the XML file, click Save As.
6. Click Close.