...
You are welcome to customize the config-definition.xml
to customize your local configuration scheme as you see fit. Any customizations to this file will require restarting your servlet container (e.g. Tomcat).
By default, the DSpace config-definition.xml
file defines the following configuration:
- All DSpace configurations are loaded via Properties files
- Note: Apache Commons Configuration does support other configuration sources such as XML configurations or database configurations, see its Overview documentation)
- By default, all configuration files are automatically checked each minute for changes. If they have changed, they are automatically reloaded.
- Configuration Files/Sources: By default, only two configuration files are loaded into Apache Commons Configuration:
local.cfg
(see documentation on local.cfg above)dspace.cfg
(NOTE: however that allmodulemodules/*.cfg
are loaded bydspace.cfg
via "include=
" statements at the end of that configuration file)
- Configuration Override Scheme: The configuration override scheme is defined as follows. Configurations specified in earlier locations will automatically override any later values:
- System Properties (-D[setting]=[value]) override all other options
- Environment Variables
local.cfg
dspace.cfg
(and allmodulemodules/*.cfg
files) contain the default values for all settings
- Configuration Auto-Reload: By default, all configuration files are automatically checked each minute for changes. If they have changed, they are automatically reloaded.
Note | ||
---|---|---|
| ||
As noted above, by default, DSpace will now automatically reload any modified configuration file ( While the new values are immediately available within the DSpace ConfigurationService, some configurations may still be "cached" within UI-specific code. This often occurs when a UI (or API) loads a configuration value into a The Enhanced Configuration Scheme codebase does NOT attempt to correct all these instances of caching within UIs or APIs. This would require individual configurations to be tested and any caching mechanisms to be removed. |
Advanced Topics
Configuration Interpolation
...