Downloading a Danno binary distribution

Binary distribution ZIP files for Danno are available for download from the "Metadata.net" project on SourceForge. These files contain one or more WAR files, and a README.txt file with some simple installation and tailoring instructions.

The WAR files in the binary distribution are primarily intended to allow you to setup a local test installation of Danno and Dannotate. They are preconfigured to use "localhost" as the server hostname and have security and access control disabled. You can make simple configuration changes by expanding the WAR file and editing properties files, but if you are intending to use Danno / Dannotate in production, you would be advised to follow the procedures described in the "Customizing Danno and Dannotate" section. This (currently) entails building Danno from a source distribution or Subversion checkout.

Checking out the Sources from Subversion

A complete distribution may also be obtained from the "Metadata.net" project's Subversion repository on SourceForge. You can checkout the project from the command shell using the following command:

     svn co https://metadata-net.svn.sourceforge.net/svnroot/metadata-net/danno/trunk danno

Alternatively, you can use the Eclipse "Subversion Repositories" view to checkout Danno into your Eclipse workspace as follows. (These instructions assume that you are using the "Subversive" plugin and that you also have the Maven plugin installed.)

1. Start Eclipse and switch to the workspace you want to use.
2. Open the SVN Repositories view.
3. Use the view's New Repository Location wizard (invoke it via the view's tool bar or the context menu) to add the repository location for the "Metadata.net" SVN repository. Use "https://metadata-net.svn.sourceforge.net/svnroot/metadata-net" as the repository URL.
4. Expand the "metadata-net" entry, select "danno/trunk", and use the context menu to start the "Check Out" wizard.
5. When the checkout of the "danno" project has completed, Eclipse will attempt to build it, and in the first instant the build will fail. This is normal.
6. Select the "danno" the project in the Navigator view, and use the context menu to invoke "Maven > Enable Nested Modules". (If there is no "Maven>Enable Nested Modules" in the context menu, open the Maven preferences, and check the checkbox for "Support multiple Maven modules mapped to a single Eclipse project".)

Normally this will be sufficient for Danno to build. Note: if this is the first time you have built Danno on this machine, Maven will spend some time downloading Danno's dependencies to your local repository. This is normal.

Fetching Danno from a Maven repository

In the future, we intend to implement a public Maven repository to serve releases and snapshots of various "metadata.net" projects.

Obtaining Technical Documentation

The primary source of technical documentation for the Danno project is the project's Maven site. The source for this documentation is in the project's subversion repository; look in the ".../danno/src/site" directory.