Tapestry Logo

Installation

Notes on installing and running
the Tapestry release


There are several steps in installation and setup which must be completed for Tapestry to successfully run.

Setting up supporting software (JDK and Jikes):
  1. Note: this only needs to be completed once for each machines Tapestry needs to run on
  2. Download and install the IBM JDK 1.3.  This is available for all platforms at the IBM website.
    1. For Debian: install alien (apt-get update; apt-get install alien ), and then (as root) do alien IBMJava2-SDK-1.3-10.0.i386.rpm; dpkg -i ibmjava2-sdk_1.3-10_i386.deb.
    2. For SuSE, Redhat and others: install the RPM
    3. For FreeBSD: copy the .tgz file to /usr/ports/distfiles/ . Then (as root):
      cd /usr/ports/java/linux-ibm-jdk13/; make all install; and follow the instructions. 
  3. Install the Jikes Java compiler, which is available via the IBM Jikes website here.
    1. On Debian, this can be done with a simple apt-get update; apt-get install jikes (from testing). 
    2. For SuSE, Redhat and others: install the Jikes RPM
    3. For FreeBSD:  (as root) cd /usr/ports/java/jikes/; make all install 

Unpacking and installing the Tapestry distribution:
  1. Note: this needs to be done for each user who wants to run an instance of Tapestry
  2. Add the JDK to your classpath.
    Linux: export OSTORE_JAVAHOME=/opt/IBMJava2-13
    FreeBSD: export OSTORE_JAVAHOME=/usr/local/linux-ibm-jdk1.3.0
  3. Add the JDK to your path: export PATH=$OSTORE_JAVAHOME/bin:$PATH
  4. Pick a directory to store your Tapestry source code, for instance " /home/ravenben/"
  5. Unpack the tar.gz or zip file into the directory
  6. Add the resulting tapestry2/src directory (/home/ravenben/tapestry2/src) to your CLASSPATH environmental variable. This directory will be the root directory from which all your java class names will reference.
  7. Make sure that the soft file link named seda in tapestry2/src points to ../seda/src/seda
  8. Additional libraries that Tapestry requires (including Cryptix and Berkeley DB) have been included in this distribution for convenience. You can also download the Cryptix JCE library from Cryptix, and add the jar files to your CLASSPATH variable.
  9. A version of the SEDA/Sandstorm code is included inside the distribution under " seda". For more information on Sandstorm/SEDA, see the SEDA website. While the included seda is precompiled for Linux GLIBC-6, you can update seda by downloading the newest version from anonymous CVS on SourceForge, compiling it, and adding the full path of the seda/lib directory to your LD_LIBRARY_PATH variable.
  10. Make sure to include the Java runtime libraries in your CLASSPATH environmental variable, and that the variable OSTORE_JAVAHOME is set to the location of your locally installed JDK as in step 2.
  11. You should now be ready to compile and test the Tapestry code.  Do cd /home/ravenben/tapestry2/src/ostore; make
  12. You can run the regression test(s) to verify your installation.  The tests are found in the regression subdirectory under src.  The tests can be run as
    cd /home/ravenben/tapestry2/src/regression; ./run-tests
Ben Y. Zhao
ravenben@cs.berkeley.edu
July 2, 2003