The configuration framework

The configuration settings are stored in an XML file called config-settings.xml and the file location (typically <bundle-root>/conf/config-settings/config-settings.xml) is defined during the EngageOne installation process.

Its main features are:

  • the config-framework has a timed reload that will refresh configuration settings when changes are made to the config-settings.xml file.
  • the config-framework has the ability to separate multiple like settings by using setting groups. The setting groups are mainly used to maintain node specific settings within a multi-node environment. Config-framework will always try to retrieve a setting from a setting group according to its defined setting group level key. If a setting group is not present then the config-framework will search for settings defined at a higher, more global level that are not distinguished or associated specifically by a setting group.
It is recommended that you backup the file prior to making any changes. Although changes can be performed manually, use caution when any updates are applied to this configuration file as incorrect values, keys or namespaces may cause unpredictable behavior within the application.