Page History

How to Specify Properties

Properties may either be defined in a Java properties file or passed to Fedora directly using "-D" command-line arguments.

By default, Fedora will look for a properties file at $FCREPO_HOME/config/fcrepo.properties.

For example, you might start Fedora by passing it a "-D" argument that specifies the location of fcrepo.home.

java -Dfcrepo.home=/data/fcrepo-home

Two ways of  passing configuration:  property file or command-line argument 

Before we enumerate the configurable properties and their defaults it should be noted that there are two ways of passing this configuration to your Fedora instance.  As noted above you can use the -D<param.name>=<param.value> syntax.   Optionally you can pass all the parameters at once by putting them in a java properties file and passing the path of the file as a command line argument.  For example, to pass two parameters at once using a property file,  by file simply create a file with any arbitrary name  and path such as  "my_fcrepo.properties".  Then add your parameters as you would in any Java properties file, like this:

# add any number of properties below
fcrepo.home: my_fcrepo_home_directory
fcrepo.autoversioning.enabled: true

Then pass these parameters to Fedora like this: 

java -Dfcrepo.config.file=my_fcrepo.properties -jar fcrepo-webapp-6.0.0-SNAPSHOT-<version>-jetty-console.jar

Important Note on Property Precedence

You may pass parameters simultaneously via the command-line params as well as by property file.  However,  please keep in mind that command-line parameter values will overwrite any values defined in your properties file.  So using the above mentioned property file as an example

java -Dfcrepo.config.file=my_fcrepo.properties -jar fcrepo-webapp-6.0.0-SNAPSHOT-jetty-console.jar

will have an fcrepo.home value of "my_fcrepo_home_directory"  whereas

java -Dfcrepo.home=overridden_fcrepo_home -Dfcrepo.config.file=my_fcrepo.properties -jar fcrepo-webapp-6.0.0-SNAPSHOT-jetty-console.jar

will have an fcrepo.home value of "overridden_fcrepo_home".

Table of Configurable Properties

There are a number of configuration elements that can optionally be set when starting the Fedora web-application, noted below within brackets: <>. 

And then have a properties file at /data/fcrepo-home/config/fcrepo.properties that defines the rest of your properties. For example, it's contents might look like this:

# add any number of properties below
fcrepo.autoversioning.enabled = true
fcrepo.persistence.defaultDigestAlgorithm = sha256

Table of Configurable Properties

jdbc:<database_type>://<database_host>:<database_port>/<database_name> 

Other properties 

The following properties are only configurable via the command-line using the -Dname=value syntax: 

Parallel stream processing

fcrepo.streaming.parallel:false

If you are running Fedora on a multiprocessor machine you can level parallel processing across single requests by turning this option on.   Parallel processing of streams can boost the retrieval speeds of the RDF associated with objects with large numbers of inlinks (ie dependent objects with memberOf associations).  Enabling this option in conjunction with increasing with cacheSize parameter in your repository.json file can boost retrieval speeds significantly.

Allowing user updates to certain server managed triples 

You can relax certain restrictions on updating some server managed triples using the following setting:

fcrepo.properties.management=relaxed

For details please refer to the following article: How to allow user-updates to certain server managed triples.

Setting the default  digest  algorithm

By default the digest algorithm is SHA-512.  To change it  to  SHA-256 use the  following  setting

...