All Versions
- DSpace 7.x (Current Release)
- DSpace 8.x (Unreleased)
- DSpace 6.x (EOL)
- DSpace 5.x (EOL)
- More Versions...
...
For ease of use, the Configuration documentation is broken into several parts:
local.cfg
file, dspace.cfg
and other configuration files which use similar conventions.local.cfg
file to store all your locally customized configurationsdspace.cfg
file settings (these settings specify the default configuration for DSpace)81952888 Optional or Advanced Configuration Settings - contain other more advanced settings that are optional in the dspace.cfg
configuration file.
...
Table of Contents | ||||||
---|---|---|---|---|---|---|
|
...
Warning | ||
---|---|---|
| ||
If you are upgrading from an earlier version of DSpace, you will need to |
...
DSpace provides a number of textual configuration files which may be used to configure your site based on local needs. These include:
...
be aware that many configuration names/keys have changed. Because Apache Commons Configuration allows for auto-overriding of configurations, all configuration names/keys in different In order to compensate for this, all |
Additionally, while the This means that DSpace 5.x (or below) configurations are NOT compatible with the Enhanced Configuration Scheme. While you obviously can use your old configurations as a reference, you will need to start with fresh copy of all configuration files, and reapply any necessary configuration changes (this has always been the recommended procedure). However, as you'll see in the next section, you'll likely want to do that anyways in order to take full advantage of the new |
In the following sections you will learn about the different configuration files that you will need to edit so that you may make your DSpace installation work.
DSpace provides a number of textual configuration files which may be used to configure your site based on local needs. These include:
[dspace]/config/dspace.cfg
: The primary configuration file, which contains the main configurations for DSpace.[dspace]/config/modules/*.cfg
: Module configuration files, which are specific to various modules/features within DSpace.[dspace]/config/local.cfg
: A (optional, but highly recommended) localized copy of configurations/settings specific to your DSpace (see The local.cfg Configuration Properties File below)[dspace]/config/
, some of these include:
default.license
: the default deposit license used by DSpace during the submission process (see Submission User Interface documentation)hibernate.cfg.xml
: The [dspace]/config/local.cfg
: A (optional, but highly recommended) localized copy of configurations/settings specific to your DSpace (see 81952888 below)[dspace]/config/
, some of these include:
default.license
: the default deposit license used by DSpace during the submission process (see Submission User Interface documentation)hibernate.cfg.xml
: The Hibernate class configuration for the DSpace database (almost never requires changing)input-forms.xml
: The default deposit input forms for DSpace (see Submission User Interface documentation)item-submission.xml
: the default item submission process for DSpace (see Submission User Interface documentation)launcher.xml
: The configuration of the DSpace command-line "launcher" ( [dspace]/bin/dspace
, see the DSpace Command Launcher documentation)log4j.properties
: The default logging settings for DSpace log files (usually placed in [dspace]/log
)news-side.html
and news-top.html
: HTML news configuration files for the JSPUI homepage (see JSPUI Configuration and Customization)news-xmlui.xml
: News configuration file for the XMLUI homepage (see XMLUI Configuration and Customization)workflow.xml
: Configuration for the Configurable Workflow feature (not used by default)xmlui.xconf
: Configuration for the XMLUI (see XMLUI Configuration and Customization)...
Additionally, DSpace provides the ability to easily override default configuration settings (in dspace.cfg or modules/*.cfg) using a local.cfg file (see 81952888The local.cfg Configuration Properties File) or using System Properties / Environment Varilables.
...
local.cfg
(see 81952888 The local.cfg Configuration Properties File documentation below)dspace.cfg
(NOTE: all modules/*.cfg
are loaded by dspace.cfg
via "include=
" statements at the end of that configuration file. They are essentially treated as sub-configs which are embedded/included into the dspace.cfg
)-D[setting]=[value]
) override all other optionslocal.cfg
dspace.cfg
(and all modules/*.cfg
files) contain the default values for all settings....
local.cfg
will automatically OVERRIDE a setting of the same name in the dspace.cfg
or any modules/*.cfg
file. This also means that you can copy ANY configuration (from dspace.cfg
or any modules/*.cfg
file) into your local.cfg
to specify a new value. dspace.url
in local.cfg
will override the default value of dspace.url
in dspace.cfg
.oai.solr.url
in local.cfg
will override the default value of oai.solr.url
in config/modules/oai.cfg
local.cfg
file uses the Apache Commons Configuration Property file syntax (like all *.cfg files) . For more information see the section on 81952888 Configuration File Syntax above.local.cfg
also supports enhanced features like the ability to include other config files (via "include=
" statements).local.cfg
by specifying them as System Properties or Environment Variables.dspace.dir
in development/staging environment, you could specify it as a System Property (e.g. -Ddspace.dir=[new-location]
). This new value will override any value in both local.cfg
and dspace.cfg
.When you build DSpace (e.g. mvn package), this local.cfg
file will be automatically copied to [dspace]/config/local.cfg
. Similar to the dspace.cfg
, the "runtime" configuration (used by DSpace) is the one in [dspace]/config/local.cfg
. See the 81952888 Why are there multiple copies of some config files? question above for more details on the runtime vs source configuration.
...
Info | ||
---|---|---|
| ||
Remember, any of the below |
...
Property: | webui.submission.sherparomeo-policy-enabled |
Example Value: | webui.submission.sherparomeo-policy-enabled = true |
Informational Note: | Controls whether or not the UI submission should try to use the Sherpa/RoMEO Publishers Policy Database Integration (default true) |
Property: | sherpa.romeo.url |
Example Value: | sherpa.romeo.url = http://www.sherpa.ac.uk/romeo/api29.php |
Informational Note: | The Sherpa/RoMEO endpoint. Shared with the authority control feauture for Journal Title autocomplete see 81952888 AuthorityControlSettings |
Property: | sherpa.romeo.apikey |
Example Value: | sherpa.romeo.apikey = YOUR-API-KEY |
Informational Note: | Allow to use a specific API key to raise the usage limit (500 calls/day for unregistred user). You can register for a free api access key at http://www.sherpa.ac.uk/news/romeoapikeys.htm |
The functionality rely on understanding to which Journal (ISSN) is related the submitting item. This is done out of box looking to some item metadata but a different strategy can be used as for example look to a metadata authority in the case that the Sherpa/RoMEO autocomplete for Journal is used (see 81952888 AuthorityControlSettings)
The strategy used to discover the Journal related to the submission item is defined in the spring file /config/spring/api/sherpa.xml
...
Property: |
|
Example Value: |
|
Informational Note: | This is an example of how one "Defines the Indexes". See "81952888Defining the Indexes" in the next sub-section. |
Property: |
|
Example Value: |
|
Informational Note: | This is an example of how one "Defines the Sort Options". See "81952888Defining Sort Options" in the following sub-section. |
...
Element | Definition and Options (if available) |
---|---|
| n is the index number. The index numbers must start from 1 and increment continuously by 1 thereafter. Deviation from this will cause an error during install or a configuration update. So anytime you add a new browse index, remember to increase the number. (Commented out index numbers may be used over again). |
| The name by which the index will be identified. In order for the DSpace UI to display human-friendly description for this index, you'll need to update either your Messages.properties (JSPUI) or messages.xml (XMLUI) with new message keys referencing this <index-name>. JSPUI Example (Messages.properties):
XMLUI Example (messages.xml):
|
| Only two options are available: "
|
| (Only for "metadata" indexes) The schema used for the field to be index. The default is dc (for Dublin Core). |
| (Only for "metadata" indexes) The schema element. In Dublin Core, for example, the author element is referred to as "Contributor". The user should consult the default Dublin Core Metadata Registry table in Appendix A. |
| (Only for "metadata" indexes) This is the qualifier to the <element> component. The user has two choices: an asterisk "" or a proper qualifier of the element. The asterisk is a wildcard and causes DSpace to index all types of the schema element. For example, if you have the element "contributor" and the qualifier "" then you would index all contributor data regardless of the qualifier. Another example, you have the element "subject" and the qualifier "lcsh" would cause the indexing of only those fields that have the qualifier "lcsh". (This means you would only index Library of Congress Subject Headings and not all data elements that are subjects. |
| (Optional, should be set for "item" indexes) This refers to the sort type / data type of the field:
|
| (Optional) The default sort order. Choose |
...
Element | Definition and Options (if available) |
---|---|
| n is an arbitrary number you choose. |
| The name by which the sort option will be identified. This is the name by which it is referred in the "webui.browse.index" settings (see 81952888 Defining the Indexes). |
| The schema used for the field to be sorted on in the index. The default is dc (for Dublin Core). |
| The schema element. In Dublin Core, for example, the author element is referred to as "Contributor". The user should consult the default Dublin Core Metadata Registry table in Appendix A. |
| This is the qualifier to the <element> component. The user has two choices: an asterisk "*" or a proper qualifier of the element. |
| This refers to the datatype of the field: |
...
Property: |
| ||
Example Value: |
| ||
Informational Note: |
| ||
Property: |
| ||
Example Value: |
| ||
Property: |
| ||
Example Value: |
The Linked Data Service at the Library of Congress might be a better, and more stable, option: http://id.loc.gov/authorities/names.html | ||
Informational Note: | Location (URL) of the Library of Congress Name Service | ||
Property: |
| ||
Informational Note: | Please refers to the Sherpa/RoMEO Publishers Policy Database Integration section for details about such properties. See Configuring the Sherpa/RoMEO Publishers Policy Database Integration | ||
Property: |
| ||
Example Value: | orcid.api.url = https://pub.orcid.org/v2.1 | ||
Informational Note: | Location (URL) of the ORCID v2 Public API | ||
Property: |
| ||
Example Value: |
| ||
Informational Note: | This sets the default lowest confidence level at which a metadata value is included in an authority-controlled browse (and search) index. It is a symbolic keyword, one of the following values (listed in descending order): accepted, uncertain, ambiguous, notfound, failed, rejected, novalue, unset. See | ||
Property: |
| ||
Example Value: |
| ||
Informational Note: | This property sets the number of selectable choices in the Choices lookup popup |
...
In the spiders
directory you will also find two subdirectories. agents
contains files filled with regular expressions, one per line. An incoming request's User-Agent
header is tested with each expression found in any of these files until an expression matches. If there is a match, the request is marked as being from a spider, otherwise not. domains
similarly contains files filled with regular expressions which are used to test the domain name from which the request comes. You may add your own files of regular expressions to either directory if you wish to test requests with patterns of your own devising.
webui.itemdisplay.label.restricted.bitstreams
Many configuration names/keys have changed!
...
If you are upgrading from an earlier version of DSpace, you will need to be aware that many configuration names/keys have changed. Because Apache Commons Configuration allows for auto-overriding of configurations, all configuration names/keys in different *.cfg
files MUST be uniquely named (otherwise accidental, unintended overriding may occur).
...
.
...
Additionally, while the local.cfg
may look similar to the old build.properties
, many of its configurations have slightly different names. So, simply copying your build.properties into a local.cfg will NOT work.
This means that DSpace 5.x (or below) configurations are NOT compatible with the Enhanced Configuration Scheme. While you obviously can use your old configurations as a reference, you will need to start with fresh copy of all configuration files, and reapply any necessary configuration changes (this has always been the recommended procedure). However, as you'll see in the next section, you'll likely want to do that anyways in order to take full advantage of the new local.cfg
file.
[dspace]/config/config-definition.xml
...