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):
- Note: this only needs to be completed once for each machines Tapestry
needs to run on
- Download and install the IBM JDK 1.3. This is available for all
platforms at the IBM
website.
- 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.
- For SuSE, Redhat and others: install the RPM
- 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.
- Install the Jikes Java compiler, which is available via the IBM Jikes
website
here.
- On Debian, this can be done with a simple apt-get update; apt-get
install jikes (from testing).
- For SuSE, Redhat and others: install the Jikes RPM
- For FreeBSD: (as root) cd /usr/ports/java/jikes/; make all
install
Unpacking and installing the Tapestry distribution:
- Note: this needs to be done for each user who wants to run an instance
of Tapestry
- Add the JDK to your classpath.
Linux: export OSTORE_JAVAHOME=/opt/IBMJava2-13
FreeBSD: export OSTORE_JAVAHOME=/usr/local/linux-ibm-jdk1.3.0
- Add the JDK to your path: export PATH=$OSTORE_JAVAHOME/bin:$PATH
- Pick a directory to store your Tapestry source code, for instance "
/home/ravenben/"
- Unpack the tar.gz or zip file into the directory
- 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.
- Make sure that the soft file link named seda in tapestry2/src points to ../seda/src/seda
- 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.
- 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.
- 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.
- You should now be ready to compile and test the Tapestry code. Do
cd /home/ravenben/tapestry2/src/ostore; make
- 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