DODS - Building the Project
dods.gif (11357 bytes)This purpose of this document is to explain how to download, build, and use DODS.

Getting the Binaries

DODS project binaries are available here [TODO]. Note that you can either download the entire project or just the latest dods.jar.


Installing the Binaries

Unzip the file to a directory of your choice (Linux/Unix users should use 'unzip -a' and also run 'chmod +x ant.sh' in the src directory after unzipping).


Getting the source from CVS

You can also download the entire DODS project from anonymous CVS. For complete details, visit the DODS CVS Page. You may also wish to look into Tortoise CVS (highly recommended).


Building the source

If you download the DODS source from CVS, you will need to build the project. This can be done without requiring the installation of any additional software.

You can compile DODS by invoking ant in the main src directory. The easiest way to do this is to type "ant clean dist". This will clean all existing build directories, compile the DODS source, and then generate a full jar dods.jar in the /WEB-INF/lib directory and the end-user jars (minus the examples, etc) dods-core.jar in the /WEB-INF/jars directory.


Deploying the DODS WAR

The DODS project is structured as a WAR to make it easy to install and access on your local machine. You can install the DODS WAR in any Servlet 2.2+ container; here's how to do it using Enhydra 3.1.

First of all, make sure that you have Enhydra 3.1+ (or if you are using another servlet container, make sure you have enhydra.jar from /WEB-INF/jars to /WEB-INF/lib). This is essential for all the DODS examples to work.

Next, simply create a web application in your Enhydra Multiserver console. Choose "WAR", point it to the directory root, and make sure you have the "invoker enabled" option selected. Once you create a web application for DODS, you will need to also create a connection and then start it. I generally name the URL path "Dods". Save your multiserver settings, and you should be in business.

You should now be able to access the DODS website via http://yourserver.com/Dods


Using DODS in my project

All you have to do to use DODS in your own project is to include the dods-core.jar (built in the /WEB-INF/lib directory) in your projects' /WEB-INF/lib directory, or else place it on your system classpath. That's all there is to it (although you may need to put 3rd party .jars in here as well, if you are not running Enhydra).


Resolving further questions

The best way to resolve further questions is by asking on the mailing list. You might also want to try searching the archives.

For all the latest information on DODS, please refer to http://dods.enhydra.org
Questions, comments, feedback? Let us know...