Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Excerpt

Although deploying Fedora is as easy as downloading the WAR file and copying to your servlet container's webapps directory, this document details the process.

Table of Contents

Downloads

See the latest release for Fedora WAR files to download.

System Requirements


Include Page
System Requirements
System Requirements

Deploying with Tomcat

...

9

  1. Download and install Tomcat 
  2. Set the Java properties for Tomcat (see: Application Configuration and Catalina Java Properties sections below)
  3. Either configure the container auth or disable auth entirely
  4. Copy the Fedora WAR file into Tomcat's "webapps" directory (e.g. /var/lib/tomcat8/webapps)

  5. Start the server
  6. Go to the browser page that matches your Fedora  WAR file name (e.g
  7. , $CATALINA_HOME/webapps/fcrepo.war

  8. Start the server, $CATALINA_HOME/bin/startup.sh
  9. Navigate to http://localhost:8080/fcrepo/rest in your browser


Info
titleTomcat and Encoded slashes
If you attempt to create a resource with an encoded slash in the path (ie. http://localhost:8080/fcrepo

...

/rest/path%2Fto%2Fresource) Tomcat will throw a 400 error. You can disable this by adding -Dorg.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true to your CATALINA_OPTS.

Deploying with Jetty 9

  1. Download and install Jetty
  2. Set the Java properties for Jetty  (see: Application Configuration and Catalina Java Properties sections below)
  3. Either configure the container auth or disable auth entirely
  4. Copy the Fedora WAR file into Jetty's "webapps" directory (e.g. /var/lib/jetty/webapps), $JETTY_BASE/webapps/fcrepo.war
  5. Start the server, java -jar $JETTY_HOME/start.jar
  6. Navigate to httpGo to the browser page that matches your Fedora WAR file name (e.g. http://localhost:8080/fcrepo-webapp-x.x.x/rest) in your browser

Include Page
Application Configuration
Application Configuration

Anchor
javaprops
javaprops
Catalina Java Properties

fcrepo.home=<some-writable-directory>

Sets the home for Fedora's persisted data. Without this setting Fedora tries to use the current-working-directory as the home of persisted data. If the Tomcat user does not have write access to the installation area (e.g. /var/lib/tomcat8), then Fedora will not deploy. Set this system property to a directory writable by the tomcat processFor a complete inventory of configurable properties please refer to the Properties page.

JVM Tuning Properties

We have a separate page with suggested VM options for general Java tuning.

Clustering Properties (only effective in a clustered configuration)

...

.

...

  • fcrepo.ispn.replication.timeout can be used to set the timeout of infinispan replication in a clustered environment