...

...

Using the UDP Multicast protocol

A couple of configuration options have to be set in order to have Fedora 4 work as a cluster on a local machine:

...

1. Build the fcrepo war file or download the prebuilt fcrepo war file
   1. Build the War file as described on this page
   2. Fetch the WAR file from the download page
2. Get Tomcat

   1. Download Tomcat 7.0.50 and unpack it

      Code Block
      #> wget http://mirror.synyx.de/apache/tomcat/tomcat-7/v7.0.50/bin/apache-tomcat-7.0.50.tar.gz #> tar -zxvf apache-tomcat-7.0.50.tar.gz  #> mv apache-tomcat-7.0.50 tomcat7-8080

3. Put the WAR file into tomcat's webapp directory or create a symbolic link

   1. Copy the fcrepo-webapp-VERSION.war file

      Code Block
      #> cp fcrepo-webapp-VERSION.war tomcat7-8080/webapps/fcrepo.war

4. Setup the cluster configuration (Optional)
   1. This github project contains a sample configuration for a cluster in distributed mode.
   2. Change the configuration as required. Description is available at the JGroups, Infinispan and Modeshape projects
   3. Make sure to point Fedora 4 to the configuration files by updating the file $TOMCAT_HOME/bin/setenv.sh (create if necessary) using the properties fcrepo.modeshape.configuration,  fcrepo.ispn.jgroups.configuration and fcrepo.infinispan.cache_configuration
      

       

5. Set the send/recv buffer sizes if neccessary
   

   1. Use the following commands to set the buffer size

      Code Block
      #> sysctl net.core.rmem_max=5242880 #> sysctl net.core.wmem_max=5242880

6. Start instance

   1. Using the default clustered configuration (Replication mode):

      Code Block
      #> CATALINA_OPTS="-Xmx1024m -XX:MaxPermSize=256m -Dfcrepo.modeshape.configuration=config/clustered/repository.json -Djava.net.preferIPv4Stack=true -Djgroups.udp.mcast_addr=239.42.42.42" bin/catalina.sh run

   2. Using a custom configuration by pointing Fedora 4 to custom configuration files:

      Code Block
      language bash
      #> CATALINA_OPTS="-Xmx1024m -XX:MaxPermSize=256m -Djava.net.preferIPv4Stack=true -Djgroups.udp.mcast_addr=239.42.42.42 -Dfcrepo.modeshape.configuration=file:///path/to/repository.json -Dfcrepo.ispn.jgroups.configuration=/path/to/jgroups-fedora-udp.xml -Dfcrepo.infinispan.cache_configuration=/path/to/infinispan.xml" bin/catalina.sh run

...

Cluster on a single machine using the UDP Multicast protocol

A couple of configuration options have to be set in order to have Fedora 4 work as a cluster on a local machine:

...