Override config settings using 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 Admin UI.

2. ConfigOverride XML file

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

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.

3. See also

Dundas Data Visualization, Inc.
500-250 Ferrand Drive
Toronto, ON, Canada
M3C 3G8

North America: 1.800.463.1492
International: 1.416.467.5100

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