Installation

Getting Exactor

Exactor is hosted at SourceForge and both binary and source distributions can be downloaded from the SourceForge project.

If you want to get the latest version of Exactor you can checkout the source from the CVS respository

System Requirements

Exactor has been built and tested using JDK version 1.4.2. A JDK of this version or above is required to run the Exactor framework.

Installing Exactor

The binary distribution of Exactor expands to the following directory structure;


    exactor
       +--- bin   // contains batch file wrapper scripts
       |
       +--- docs  // documentation
       |      +--- api      // javadoc for framework classes
       |      |
       |      +--- examples // source code for example projects
       |
       +--- lib   // exactor jars and dependant libraries

Only the bin and lib directories are required to run Exactor.

To install Exactor, select a directory and expand the distribution to there.

The chosen directory will be referred to as EXACTOR_HOME

Setup

Before you can run Exactor there is some initial setup required.

Add the EXACTOR_HOME\bin directory to your path
Ensure that the JAVA_HOME\bin directory is on your path
Alternatively specify a JAVA_HOME environment variable pointing to the JDK installation directory.

For Windows systems the following commands are used to setup the environment, substituting the directory names for the directories you have installed Exactor and the JDK.


    C:\>set JAVA_HOME=c:\jdk1.4.2
    C:\>set PATH=%PATH%;c:\exactor\bin

Building Exactor

If you downloaded the source distribution you will need to build Exactor before using it.

Exactor is build using the ANT build tool. You will need a copy of ANT installed to build Exactor.

Version 1.6.1 of ANT was used in the development of Exactor.

After you have expanded the source distribution you are ready to build Exactor. To build Exactor change to the installation directory and type the following at the command line;


    C:\exactor>build clean all

This will create two additional directories, build and dist.

In the dist directory you will find a zip file exactor-BUILD-bin.zip, where BUILD is the current build number.

Take this zip file and follow the instuctions for installing Exactor above.

Dependencies

Exactor makes use of a number of other libraries to provide some of its functionality, the tables below highlight these dependencies and when they are required.

The dependant jars should be on the CLASSPATH when Exactor is run, the batch file wrapper script handles this, but it is important if you are running Exactor using the com.exoftware.exactor.Runner class.

All of the required libraries are available in the EXACTOR_HOME\lib directory.

Core Framework	Web Commands	SWT Commands
exactor.jar	web-commands.jar	swt-commands.jar
junit.jar	jwebunit-1.2.jar	swt.jar
	httpunit-1.5.4.jar	swt-awt-win32-3044.dll
	js-1.5R4.1.jar	swt-win32-3044.dll
	nekohtml-0.8.1.jar
	xercesImpl-2.6.2.jar
	xml-apis-1.0.b2.jar

Note: the swt dlls need to be available on the Java library path, typically this means placing them in the working directory or somewhere specified in the PATH environment variable. Again the batch file wrapper script handles this.