Updating the configurations of existing DS-Clients

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.

NOTE: Depending on your requirements, you can use an exported XML file as is, edit the file, or create your own. The XML file must be named config-update.xml, and it must conform to the structure defined in the file asigra_conf.dtd.

• 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.

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 than 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.

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 (Click DS-User > Setup > System Activities: Repair DS-Client Database).