Installation

PreEmptive Protection - DashO's Ant tasks are in ant-dasho.jar. This jar and doxfile.jar need to be copied into Ant's lib directory. An optional configuration step can be performed before this to make the use of DashO's tasks easier.

Note: When you update DashO, you need to also update the jars used by Ant.

Configuring dasho.ant.runtime.properties

As discussed in Setting DashO Home the Ant tasks need to know where DashO is installed. One of the options is to set the value in a properties file stored in ant-dasho.jar. Setting the home value this way lets buildfiles run with minimum configuration. It is not required that this file be configured as there are other ways to specify where DashO is installed.

To see the values that the task will use you can run the antconfig script:

C:>antconfig show
dasho.home=C:/Program Files/PreEmptive Solutions/PreEmptive Protection - DashO x.y
dasho.fullVersion=x.y.z
dasho.version=x.y

If the value returned for dasho.home is correct your configuration is complete. If you have installed DashO in another directory you will need to specify a new location. The simplist method is to let the value be configured automatically:

C:>antconfig
dasho.home=C:\Documents and Settings\lazardo\DashO x.y

If the value cannot be determined automatically, you can specify it:

C:>antconfig
C:\Documents and Settings\lazardo\dasho\DashO x.y does not contain DashOPro.jar
C:>antconfig "C:\Program Files\PreEmptive Protection - DashO x.y"
dasho.home=C:\Program Files\PreEmptive Protection - DashO x.y

Note that paths that contain spaces must be quoted.

Where to install the tasks

Ant can find tasks stored in one of two locations:

You can determine these locations by running Ant for the command line - be prepared for lots of output!

C:>ant -diagnostics
...
-------------------------------------------
 ANT_HOME/lib jar listing
-------------------------------------------
ant.home: C:\Program Files\apache-ant-1.7.0
...
-------------------------------------------
 USER_HOME/.ant/lib jar listing
-------------------------------------------
user.home: C:\Documents and Settings\lazardo
...

This means that the two choices for installing the task are C:\Program Files\apache-ant-1.7.0 and C:\Documents and Settings\lazardo\.ant.

Installing the tasks

Once you have choosen the installation directory you can use the antinstall script to install the Ant tasks:

C:>antinstall "C:\Documents and Settings\lazardo\.ant"
Creating C:\Documents and Settings\lazardo\.ant
Creating C:\Documents and Settings\lazardo\.ant\lib
Copying ant-dasho.jar to C:\Documents and Settings\lazardo\.ant\lib
Copying lib\doxfile.jar to C:\Documents and Settings\lazardo\.ant\lib
Installation complete

Note that paths that contain spaces must be quoted.

Installing the task into Eclipse

If you chose to install the Ant tasks in your USER_HOME/.ant your configuration is complete - Eclipse will discover the jars stored here and add them to classpath of its internal version of Ant. Otherwise you need to tell Eclipse to add these jars to Ant's classpath. Do do this open Eclipse's Preferences dialog using Window > Preferences… from the menu bar. Use the navigation tree to go to Ant > Runtime. The dialog will look something like this:

Initial view of Eclipse's Ant Runtime configuration

Select Global Entries and then click on Add External Jars…. Use the file selector to go to where Ant has been installed. Add the following jars from the lib directory:

The resulting dialog will look something like this:

Completed view of Eclipse's Ant Runtime configuration

Click on OK to save you changes, and Eclipse configuration is complete.