...
Note |
---|
Unlike the old |
local.cfg
The [dspace.dir]/config/local.cfg
file is the new way to customize your DSpace configuration based on your local needs.
...
An example local.cfg is provided at [dspace-source]
/local.cfg.EXAMPLE. The example only provides a few key configurations which all DSpace sites are likely to need to customize. However, you may add (or remove) any other configuration to your local.cfg
to customize it as you see fit.
config-definition.xml
The [dspace.dir]/config/config-definition.xml
file defines the Apache Commons Configuration settings that DSpace utilizes by default. It is a valid "configuration definition" file as defined by Apache Commons Configuration. See the Configuration File Documentation for more details.
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.
- 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 allmodule/*.cfg
are loaded bydspace.cfg
via "include=
" statements at the end of that configuration file)
- 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 allmodule/*.cfg
files) contain the default values for all settings