Java Server Setup

These instructions help you set up your platform for hacking on OSAF's Java server projects. These projects utilize specific versions of particular Java tools. Only use the versions that are explicitly listed here. Using other versions will likely cause problems that we might not know how to help you solve.

Java SDK

If your operating system does not already provide it (try running java -version and/or echoing $JAVA_HOME), download and install a Java SDK (only use version 1.5 which is labeled as "5.0" on Sun's site):

1. Download a J2SE SDK release from http://java.sun.com/j2se/
   • Windows or Linux: the 1.5 SDK is available at http://java.sun.com/j2se/1.5.0/download.jsp -- don't get the NetBeans^? edition, get "JDK 5.0 Update n"
   • Mac: find Apple's version of the SDK at http://www.apple.com/support/downloads/java2se50release3.html
2. Install the J2SE SDK according to the instructions included with the release.
3. Set an environment variable JAVA_HOME to the pathname of the directory into which you installed the J2SE SDK release.
4. On Mac, you may have to change the symlink for /System/Library/Frameworks/JavaVM.framework/Versions/Current (and CurrentJDK^?) to the 1.5.0 version of the JDK.

Maven

If your operating system does not already provide it (try running maven -v), download and install the Maven build tool:

1. Download Maven 1.0.2 (NOT 1.1.x or 2.x.x) from http://maven.apache.org/maven-1.x/start/download.html
2. Install Maven according to the instructions included with the release.
3. Set an environment variable MAVEN_HOME to the pathname of the Maven installation directory.
4. Add $MAVEN_HOME/bin to your PATH.

Xalan

Download the Xalan XSLT processor and install it into the Maven endorsed library directory:

1. Download xalan-j_2_7_0-bin-2jars.tar.gz from http://www.apache.org/dyn/closer.cgi/xml/xalan-j
2. Copy xalan.jar and serializer.jar into $MAVEN_HOME/lib/endorsed