Versions Compared

Key

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


Info

See the Quick Start guide to getting Fedora up and running as quickly as possible.


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, $CATALINA_HOME/webapps/fcrepo.war

  5. Start the server, $CATALINA_HOME/bin/startup.sh
  6. 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, $JETTY_BASE/webapps/fcrepo.war
  5. Start the server, java -jar $JETTY_HOME/start.jar
  6. Navigate to http://localhost:8080/fcrepo/rest in your browser

Include Page
Application Configuration
Application Configuration

Anchor
javaprops
javaprops
Catalina Java Properties

For 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.