Description of XTest Instance
Author: Libor.Martinek (libor.martinek@sun.com)
Date: January 24, 2002
Version: 1.0
What is this document for?
This document is for those who want to execute all tests from
one group called xtest instance. Xtest instance is several
modules usually grouped in one CVS repository. If you just want
to execute tests from one module or want to develop tests, you don't
need to use xtest instance.
Xtest instance
Now we distinguish between xtest harness and xtest instance. Xtest
harness is independent of the tested product. Xtest instance is a
configuration of several tests for testing a particular product.
Xtest distribution
Sources of xtest harness reside in opensource CVS under the
module xtest. To create the xtest distribution, which are binaries of
xtest harness, execute target makedist (in the directory xtest, type ant
makedist). Xtest will be built and the binary distribution
will be zipped into the file xtest-distribution.zip.
Content of xtest instance
Xtest instance contains just two files: build.xml and master-config.xml.
The Ant script build.xml is a small wrapper which contains targets
runtests, cleantests, buildtests, etc. All these targets just call the
appropriate targets in xtest/lib/harness.xml, which can be called the
library for xtest instances.
Master config is an xml file which defines which tests from which
module should be executed. See Description
of Master config.
Creating a new xtest instance
Existing xtest instance for opensource tests is in the module
xtest in the directory instance, which contains build.xml and master-config.xml.
To create a new xtest instance you have to create two files:
build.xml and master-config.xml. For information about master-config
see Description of Master
config. To create build.xml you can copy and modify xtest/instance/build.xml.
You have to change the following properties:
- xtest.home - has to point to xtest distribution
- xtest.basedir - has to point to the root of test repository;
directory which contains tested modules
- xtest.config - name of config which should be used
- xtest.instance.name - name of this instance; a made up
name which describes this instance
