Override config settings using an XML file

Contents[Hide]

1. Overview

This article shows you how to override configuration settings in Dundas BI using an XML file.

This is a failsafe option in case the application won't start due to some invalid configuration settings.

In most cases though, it is recommended to use the dt.exe command line tool instead if you need to change a configuration setting outside of the Dundas BI administration user interface.

2. ConfigOverride.xml

To override configuration settings, create a ConfigOverride.xml file and place it in the www\BIWebsite\App_Data folder of your Dundas BI instance.

In a default installation of Dundas BI, there is a sample file you can start off with named ConfigOverride.xml.example. Just rename this file to ConfigOverride.xml by removing the .example extension. Then edit the file and make changes to one or more settings. Note that you may need to adjust the security permissions on the file in order to save changes to it.

Example config override XML file
Example config override XML file

Example contents of XML file for changing the Internal Application URL config setting:

<Config>
  <Module Id="EC04F56F-AAD2-4395-BCB3-35F5B1D0C8F1" Name="Core">
    <Setting Name="InternalApplicationUri">http://localhost:50300/</Setting>
  </Module>
</Config>

Here's another example which changes the Default Culture config setting:

<Config>
  <Module Id="EC04F56F-AAD2-4395-BCB3-35F5B1D0C8F1" Name="Core">
    <Setting Name="DefaultCulture">fr-FR</Setting>
  </Module>
  <Module Id="21259d43-ee4c-4b06-b73f-c9c2cdce60c6" Name="Web">
  </Module>
</Config>

The name for a particular configuration setting is not always the same as its display name in the Admin UI. To be sure you've got the right name in the XML file, look for the configuration setting in the .NET API documentation: CoreConfigSettingsIds Class

Once you've completed changes to the config file, restart the Dundas BI website/app pool.

Note
An empty, self-closing setting tag (for example, <Settng Name="DefaultCulture" />) will cause the application to use the default value for the setting.

3. See also

Dundas Data Visualization, Inc.
400-15 Gervais Drive
Toronto, ON, Canada
M3C 1Y8

North America: 1.800.463.1492
International: 1.416.467.5100

Dundas Support Hours:
Phone: 9am-6pm, ET, Mon-Fri
Email: 7am-6pm, ET, Mon-Fri