# Apache Myrmidon - User Guide

|  | Apache Myrmidon

Myrmidon

- Introduction
- Get Involved
- Building Myrmidon
- Todo List

User Guide

- Build file
- Virtual File System
- Ant1 Compatibility Layer

Extending Ant

- Task Writers HOWTO
- ClassLoader HOWTO
- Library HOWTO

Container Design

Building Myrmidon

> First, you will need to fetch the Myrmidon source from CVS. The source can be source in the `proposal/myrmidon` directory of the Ant source tree. You should check out the `jakarta-ant` CVS module, as described here.

> To build Myrmidon, use the `build.xml` build script. You will need to use Ant 1.4.1 or later. The default target builds the Myrmidon distribution into the `dist` directory. The distribution is a ready-to-run installation of Myrmidon.

> There are a number features that are not built unless the appropriate optional Jar files are found in the `lib` directory:

> Feature | Jar File | Download From
> SMB VFS support (Samba, Windows shares) | jcifs.jar | jcifs.samba.org. Note: there are problems using the 0.6.1 release. Try 0.6.0 instead.
> FTP VFS support | netcomponents.jar | www.savarese.org

Running Myrmidon

> To run Myrmidon, use one of the following methods:

> Launcher Script

> > On Windows and Unix platforms, you can use the `ant` script in the distribution's `bin` directory. The following environment variables can be used, but are not required (except on Windows 9x - see below).

> > Variable | Description
> > JAVA_HOME | The directory that the JDK is installed in.
> > JAVACMD | The command to use to start the JVM. Defaults to `java`.
> > ANT_HOME | The directory containing the Myrmidon distribution. This must be set when running on Windows 95, 98 or Me.

> Executable Jar File

> > The Myrmidon distribution includes an executable Jar file, which can be used to run Myrmidon. Use the following command:

> >     prompt> java -jar ant-home/bin/myrmidon-launcher.jar options

> When started, Myrmidon looks for a project file called `build.ant` in the current directory. A different project file can be specified using the `-f` command-line option. Myrmidon executes the targets given on the command-line, or the default target if none is given. For example, the following executes the targets `clean` and `build` from the project file `my-project.xml`:

>     prompt> ant -f my-project.xml clean build

> Run Myrmidon with the `-h` command-line option for a list of the command-line options that are available.

Copyright © 2000-2002, Apache Software Foundation