Downloads

See the latest release for Fedora 4 WAR files to download.

Deploying with Tomcat 7

1. Download and install Tomcat 
2. Set the Java properties for Tomcat (see: Application Configuration and Catalina Java Properties sections below)

3. Copy the Fedora 4 WAR file into Tomcat's "webapps" directory (e.g. /var/lib/tomcat7/webapps)

4. Start the server
5. Go to the browser page that matches your fedora 4 WAR file name (e.g. http://localhost:8080/fcrepo-webapp-4.0.0-beta-4-SNAPSHOT/rest)

Deploying with Jetty 8

1. Download and install Jetty
2. Set the Java properties for Jetty  (see: Application Configuration and Catalina Java Properties sections below)
3. Copy the Fedora 4 WAR file into Jetty's "webapps" directory (e.g. /var/lib/jetty/webapps)
4. Start the server
5. Go to the browser page that matches your fedora 4 WAR file name (e.g. http://localhost:8080/fcrepo-webapp-4.0.0/rest)

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/tomcat7), then Fedora 4 will not deploy. Set this system property to a directory writable by the tomcat process.

JVM Tuning Properties

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

Clustering Properties (only effective in a clustered configuration)

-Djgroups.tcp.address=<ip-address>
-Dfcrepo.ispn.numOwners=<num-nodes-in-cluster>
-Djava.net.PreferIPv4Stack=true
-Dfcrepo.ispn.replication.timeout=<timeout-in-ms>

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

System Requirements

• Java7
• Servlet 3.0 container 
  
  • Tomcat7
  • Jetty 8.x

The github repository has a post-commit hook that trigger a build on ci.fcrepo.org. This build publishes maven artifacts to sonatype, and pushes the fcrepo-kitchen-sink war to futures6: http://fcrepo4.fcrepo.org/fcrepo/rest/.  
Fedora 3 is also deployed on futures6: http://fcrepo4.fcrepo.org/fedora.

Deploying with Tomcat

1. Set the Java properties (e.g. /etc/default/tomcat7) mentioned in the following Application Configuration section 
   
   • We suggest other VM options for general Java tuning as well.
2. Drop the fcrepo-webapp (or kitchen sink, or your own distribution) WAR into Tomcat

Application Configuration

System config

-Dfcrepo.host=<hostname>
-Dfcrepo.port=<port>
-Dfcrepo.ctxt=<context>

• fcrepo.host defaults to "localhost"
• fcrepo.port defaults to "8080"
• fcrepo.ctxt defaults to "rest"

Modeshape and Infinispan config

-Dcom.arjuna.ats.arjuna.common.ObjectStoreEnvironmentBean.default.objectStoreDir=<some-dir>
-Dcom.arjuna.ats.arjuna.objectstore.objectStoreDir=<some-dir>
-Dfcrepo.ispn.CacheDirPath=<some-dir>
-Dfcrepo.ispn.binary.CacheDirPath=<some-dir>
-Dfcrepo.modeshape.index.location=<some-dir>

JMS config

...