YACHT Development Environment

To set up a development environment for developing on YACHT you will need the following

  • Sourceforge account
  • CVS client
  • Editor of choice
  • Java 1.4 SDK
  • Tomcat
  • Ant

    You optionally also want to install the following libs

  • ECHO
  • JDOM

    Setup

    The setup can be done on both windows and Linux machines (and all other OS's too)

    Sourceforge account

    Go to sf.net and register. Then send me (thomas@trylleskoven.dk) an email to be included in the devel team

    CVS client

    Win: go grab WinCVS from www.wincvs.org

    Linux: you propably already have it installed - else install the cvs RPM!

    Editor of choice

    Choice = Emacs - simply the best!

    Win: http://www.xemacs.org/Download/win32/

    Linux: it's on your CD's if you haven't already installed it.

    Java 1.4 SDK

    I prefer sun's SDK - available at http://java.sun.com/j2se/1.4/download.html

    Grab the SDK!! Not the JRE

    You will have to set up your CLASSPATH environment to be able to compile. The CLASSPATH needs to include the 4 jar files inside the YACHT cvs tree (xerces, jdom, Echo, EchoServer).

    So if you installed on a Linux machine into e.g. /home/tld/, the 4 jar files would be located in /home/tld/yacht/yacht/build/WEB-INF/lib/

    On top of this you need to include the servlet.jar file comming with your Tomcat installation. On a Linux machine this file is typically located in /var/tomcat4/common/lib/servlet.jar

    So in the above example locations your CLASSPATH would be set to something like

    export CLASSPATH=/home/tld/yacht/yacht/build/WEB-INF/lib/Echo.jar:/home/tld/yacht/yacht/build/WEB-INF/lib/EchoServer.jar:/home/tld/yacht/yacht/build/WEB-INF/lib/xerces.jar:/home/tld/yacht/yacht/build/WEB-INF/lib/jdom.jar:/var/tomcat4/common/lib/servlet.jar:.

    You also need to put the java bin dir into your path

    Do so by writing
    export PATH="$PATH:/usr/java/j2sdk1.4.0/bin" into your /etc/profile (on Linux)

    Tomcat

    Win: http://jakarta.apache.org/builds/jakarta-tomcat-4.0/release/v4.0.3/bin/

    Just download and run the installer - easy and painless

    Linux: http://jakarta.apache.org/builds/jakarta-tomcat-4.0/release/v4.0.3/rpms/

    Download and install the regexp, servletapi4, tomcat4 and xerces-j RPMS and install

    After install please edit the file /etc/tomcat4/tomcat4.conf file. In the top the JAVA_HOME is set - change the IBM reference to /usr/java/j2sdk1.4.0

    Check that it starts by running /etc/init.d/tomcat4 start

    Make sure that tomcat starts on boot with
    chkconfig --add tomcat4

    Ant

    The build system uses ant

    Win: http://jakarta.apache.org/builds/jakarta-ant/release/v1.4.1/bin/

    Linux: http://jakarta.apache.org/builds/jakarta-ant/release/v1.4.1/rpms/

    On windows set your path to include the ant executable

    Optional libs

    Both ECHO and JDOM are included in the YACHT CVS tree - but grab yourselves if you want it. It's optional and the 2 libs will be updated as new versions come out.

    ECHO

    Download and install this web application framework. It's available from http://www.nextapp.com/products/echo/download.html

    JDOM

    JDOM is used for the XML processing. Download from http://www.jdom.org/downloads/index.html