Versions Compared

Key

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

...

  1. Download and install Tomcat
  2. Set the Java properties (e.g. /etc/default/tomcat7) mentioned in the following Application Configuration section 
    for Tomcat
    • Many linux distributions put these settings a the file /etc/default/tomcat7, outside of the tomcat installation folder.
    • If your operating system does not have the file above, you can create a setenv.sh (or setenv.bat) script in the tomcat7/bin folder. Settings here will not be disturbed by upgrades to the tomcat package. For instance, the following bash line will add the fcrepo.home property to existing JAVA_OPTS.
    Copy the Fedora 4 WAR file into Tomcat's "webapps" directory (e.g. /var/lib/tomcat7/webapps)
    • A note on configuration: In the case where no Fedora 4 system properties have been set, 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. The simplest resolution is to set the system property: "fcrepo.home=<some-writable-directory>" in the Tomcat configuration file (e.g. /etc/default/tomcat7)

      Code BlocktitleExample fcrepo.home configuration
      JAVA_OPTS="${JAVA_OPTS} -Dfcrepo.home=/tmp/fcrepo4-home"
    • See the Java Properties section below for the properties you need.
  3. Copy the Fedora 4 WAR file into Tomcat's "webapps" directory (e.g. /var/lib/tomcat7/webapps)

Deploying with Jetty 9

  1. Download and install Jetty
  2. Set the Java properties (e.g. /etc/default/jetty) mentioned in the following Application Configuration section 
    We suggest other VM options for general Java tuning as wellfollowing Java Properties section
  3. Copy the Fedora 4 WAR file into Jetty's "webapps" directory (e.g. /var/lib/jetty/webapps)

Include Page
Application Configuration
Application Configuration

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)

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

...