Installing Ant

Last update : June 18 2001

Home
  • Jakarta Commons


  • About
  • News
  • Features
  • Goals
  • Changes
  • Todo
  • Contributors
  • Contributing
  • License


  • Downloads
  • Downloads


  • Design
  • Architecture
  • Mock vs Container


  • User Guides
  • Installation
  • Installing Ant
  • Installing Sample
  • Configuration
  • Writing Test Case
  • Servlet Sample
  • Ant integration
  • Servlet Engines
  • API Reference


  • Support
  • CVS
  • Bug database
  • Mailing lists
  • FAQ


  • Misc.
  • Resources


  • Forewords

    Ant is a Java based build tool. It is used to build the Cactus framework itself and the Cactus Sample application.


    Ant tasks needed by Cactus

    Cactus uses the following optional tasks of Ant :

    • <stylebook> to build the Cactus web site and Cactus documentation. The Stylebook version required by the Cactus build is the Stylebook 1.0b3 for Xalan2 (named stylebook-1.0-b3_xalan-2.jar) which needs the Xalan 2.0 jar and the Xerces 1.3 jar. The Ant stylebook task It is not used by the Cactus Sample application build process.
    • <junit> to run the unit tests of Cactus itself and the Cactus unit tests in the Sample application.
    • The Cactus Sample application uses a custom task provided by Cactus in the commons-cactus-ant.jar jar file (the task is called <runservertests>).

    Installing Ant on Windows systems

    Ant is an application that needs to be installed somewhere on your hard drive.

    Follow the steps below to install Ant :

    1. Download Jakarta Ant (jakarta-ant-<version>-bin.zip) from here. I recommend version 1.3 or above. Alternatively you can download a prepackaged Ant version (containing required optional tasks and jars) from here,
    2. Unzip it in a directory. Let's call this directory antroot,
    3. Create an environment variable named ANT_HOME that points to your antroot directory,
    4. Modify the PATH environment variable to include the %ANT_HOME%\bin directory (so that you'll be able to type ant in a DOS shell, in whatever directory and it will call the %ANT_HOME%\bin\ant.bat script,
    5. Download the Ant optional task jar (jakarta-ant-<version>-optional.jar) from here and put it in %ANT_HOME%\lib,
    6. If you haven't downloaded the prepackaged Ant zip, you'll need to download the Stylebook 1.0b3 for Xalan 2 jar (from ?), the latest Xalan, the latest Xerces and the latest JUnit jars. You'll also need to ensure that you use a JAXP 1.1 parser (Ant 1.3 comes with a JAXP 1.0 parser only, called parser.jar. Ant 1.4 already bundles a JAXP 1.1 parser, called crimson.jar). You can download one (crimson) from here. Put all these jars in %ANT_HOME%\lib.

    Note You should ensure that the Ant optional jar that you download contains the <stylebook> and <junit> tasks. Alternatively you can download the prepackaged Ant zip as mentionned above.




    Copyright © 2000-2001 The Apache Software Foundation. All Rights Reserved.