The OceanStore Project Source Installation HOWTO

This page attempts to describe the information necessary for installing the OceanStore prototype from source using CVS. For information regarding our binary releases, look here.

The current prototype (Pond) builds and runs on Linux (Debian or RedHat). Other systems can probably be made to work, but are not yet supported. In any case, any system which supports SEDA and Java 1.4 should work just fine. (For instance, Solaris should be rather easy to port to, I would think.)

That said, the following is an outline of the steps you should take.

Per-machine installation

• Install Java. Any SDK for Java version 1.4.1 should work. We tend to use the IBM SDK, which is available here.
• Need to download unlimited strength encryption files from the bottom link of the following page Unlimited Strength Jurisdiction Policy Files
  1. US_export_policy.jar
     • Place in /usr/local/IBMJava2-141/jre/lib/security/US_export_policy.jar
  2. local_policy.jar
     • Place in /usr/local/IBMJava2-141/jre/lib/security/local_policy.jar

Per-user installation

• Install OceanStore in your home directory.
  1. Download
     • cd ~
export CVSROOT=:pserver:anonymous@oceanstore.cvs.sourceforge.net:/cvsroot/oceanstore
cvs login [no password]
       cvs -z3 co pond
       
  2. Compile
     • Add the JDK installed above to the front your path.
       Example: export PATH=/usr/local/IBMJava2-141/bin:$PATH
     • You do not need to link in SEDA anymore as seda.jar is already provided in the lib directory. However, if you would like to link in the SEDA source then follow the below symbolic link step.
     • Link in SEDA, then build:
       cd ~/pond; ln -s ~/seda/src/seda; make;
       If the compile fails due to linking errors, see the following section.
• Install the Distributed Directory (DD) in your home directory.
  1. Download
     • cd ~
export CVSROOT=:pserver:anonymous@oceanstore.cvs.sourceforge.net:/cvsroot/oceanstore
cvs login [no password]
       cvs -z3 co dd
       
  2. Compile
     • Add the JDK installed above to the front your path.
       Example: export PATH=/usr/local/IBMJava2-141/bin:$PATH
• Install the Simple OceanStore Simulator (SOSS) in your home directory.
  1. Download
     • cd ~
export CVSROOT=:pserver:anonymous@oceanstore.cvs.sourceforge.net:/cvsroot/oceanstore
cvs login [no password]
       cvs -z3 co soss
       
  2. Compile
     • Add the JDK installed above to the front your path.
       Example: export PATH=/usr/local/IBMJava2-141/bin:$PATH
• Install SEDA in your home directory.
  1. Download
     • cd ~
export CVSROOT=:pserver:anonymous@seda.cvs.sourceforge.net:/cvsroot/seda
cvs login [no password]
       cvs -z3 co seda
       
  2. Compile
     • Add the JDK installed above to the front your path.
       Example: export PATH=/usr/local/IBMJava2-141/bin:$PATH
     • Build and Link: cd ~/seda/src/seda; CLASSPATH=~/seda/src:. make; ln -s ../../lib;
       
     • Compile seda interface to use Java 1.4 NIO libraries: cd ~/seda/src/seda/sandStorm/lib/aSocket/nio; CLASSPATH=~/seda/src:. make;
       
     • If you want to build your own SEDA javadocs (which will be automatically incorporated into the OceanStore docs):
       cd ~/seda/docs/javadoc; CLASSPATH=~/seda/src:. make
       Ignore the resulting javadoc errors.
• Test the Installation
  You can try running the regression tests to verify your installation. The entire suite can be run as:
  cd ~/pond/regression; ./run-tests, or you can try running individual scripts in that directory.
  If the tests fail due to linking errors, see the following section.

Additional installation

• Install Berkeley DB.
  This step is required only if the included librairies do not run on your machine. Any recent Linux/x86 machine should be fine.
  The Berkeley DB code can be found here. You will need to build a shared library for the main distribution and the Java interface. Place them somewhere in your LD_LIBRARY_PATH, such as ~/pond/lib.
• Install CryptixJCE.
  This step is required only if the included librairies do not run on your machine. Any recent Linux/x86 machine should be fine.
  The Cryptix JCE code can be found here.You only need to copy the JAR files from the bin directory. Place them in ~/pond/lib.
• Optional: Install Gnu MP.
  GMP is a high-performance arithmetic library that vastly improves the performance of cryptographic operations in OceanStore. It can be found here.
• Optional: Install jikes.
  Jikes compiles the repository many times faster than javac. It can be found here.