Exporting the DS-Client configuration to an XML file
You can export the DS-Client configuration to an XML file (config-update.xml), which you can use to manually update the configurations of existing DS-Clients or to deploy a large number of DS-Clients. For more information, see the DS-Client Mass Deployment Guide.
NOTE: This feature is not supported for backups that have been configured with the Local DS-VDR option.
The DS-Client reads any XML file named config-update.xml and verifies the structure is correct. If the file has not previously been applied, the DS-Client applies its settings. You can use an exported config-update.xml file as is, edit the file, or create your own. 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 meant to update a properly functioning DS-Client and is not intended to be used to recover an existing DS-Client. If you need to recover a DS-Client that has its database backed up to the DS-System, it is better to use the repair function.
If the AllowAutoConfig parameter is enabled, the DS-Client checks for a file named config-update.xml at startup and every 10 seconds afterwards. The DS-Client reads the configuration file and then 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, backups, schedules, or retention rules are overwritten if the replace-existing attribute is set to Yes. After the XML file is applied, the DS-Client renames the file to config-update-nnn.xml, where nnn is an incremental number.
NOTE: The <account-name>, <account-number>, <client-number>, and <encryption-keys> elements are updated only when the DS-Client restarts.
To export the DS-Client configuration to an XML file:
1. On the Setup menu, click Export to XML.
2. Under Export Items, select the items you want to export. The choices are as follows:
• DS-Client Configuration – Exports all DS-Client settings.
• Backup Schedules – Exports all or selected backup schedules.
• Retention Rules – Exports all or selected retention rules.
• Backup Sets – Exports all or selected backups.
NOTE: Recovered orphaned backups that have not been migrated or had their backup information reconfigured cannot be exported.
3. To include encrypted DS-Client and account keys in the XML file, select the Include Encryption Keys check box.
4. To use a meta symbol where required in the config-update.xml file, select the Meta Symbol check box (Windows DS-Client only). This allows the XML file to be used interchangeably on different localized operating systems.
5. To expand or collapse the list of items, click Expand All or Collapse All.
6. To save the XML file, click Save As.
7. Click Close.