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. |