Old Release
This documentation relates to an old version of DSpace, version 4.x. Looking for another version? See all documentation.
This DSpace release is end-of-life and is no longer supported.
Options
DSpace allows three property values to be set using the -D<property>=<value> option. They may be used in other contexts than noted below, but take care to understand how a particular property will affect a target's outcome.
overwrite
Whether to overwrite configuration files in [dspace]/config. If true, files from [dspace]/config and subdirectories are backed up with .old extension and new files are installed from [dspace-src]/dspace/config and subdirectories; if false, existing config files are untouched, and new files are written beside them with .new extension. | |
Possible values: | true, false |
---|---|
Default: | true |
Context: | update, init_configs |
config
If a path is specified, ant uses values from the specified file and installs it in [dspace]/config in the appropriate contexts. | |
---|---|
Possible values: | path to configuration file to be used |
Default: | [dspace-src]/config/dspace.cfg |
Context: | update, update_configs, update_code, update_webapps, init_configs, fresh_install, test_database, setup_database, load_registries, clean_database |
wars
If true, builds .war files; if false, no .war files are built. | |
---|---|
Possible values: | true, false |
Default: | true |
Context: | update, update_webapps, fresh_install |
Targets
Target | Effect |
---|---|
update | Creates backup copies of the [dspace]/bin, /etc, /lib, and /webapps directories with the form /<directory>.bak-<date-time>. Creates new copies of [dspace]/config, /etc, and /lib directories. Does not affect data files or the database. (See overwrite, config, war options.) |
update_configs | Updates the [dspace]/config directory with new configuration files. (See config option.) |
update_geolite | Dowload and install GeoCity database into [dspace]/config. |
update_code | Creates backup copies of the [dspace]/bin, /etc, and /lib directories with the form /<directory>.bak-<date-time>. Creates new copies of [dspace]/config, /etc, and /lib directories. (See config option.) |
update_webapps | Updates [dspace]/webapps directory. (See config, war options.) |
init_configs | Writes configuration files to [dspace]/config. (See overwrite, config options.) |
install_code | Deletes existing [dspace]/bin, /lib, and /etc directories, and installs new copies; overwrites /solr application files, leaving data intact. (See config option.) |
fresh_install | Performs a fresh installation of the software, including the database & config. (See config, war options.) |
test_database | Tests database connection using parameters specified in dspace.cfg. (See config option.) |
setup_database | Creates database tables. Database schema must exist and relevant parameters specified in dspace.cfg. (See config option.) |
load_registries | Loads metadata & file format registries into the database. (See config option.) |
clean_backups | Removes [dspace]/bin, /etc, /lib, and /webapps directories with .bak* extensions. |
clean_database | Drops all DSpace database tables, destroying all data. (See config option.) |
Overview
Content Tools