Skip to main content

(v24) Override Config Settings Using an XML File

  • Updated

Override Config Settings Using an XML File

This applies to: Managed Dashboards, Managed Reports

This article shows you how to override configuration settings in Symphony 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 Symphony administration user interface.

ConfigOverride.xml

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

In a default installation of Symphony, 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 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 Symphony 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.

For more information, see:

Comments

0 comments

Please sign in to leave a comment.