These are the instructions for how to download and install TestPlan on your computer.

Download

To obtain TestPlan you can visit the downloads section of the project at LaunchPad. Download the file at the top of the list to get the newest version.

Download TestPlan 1.0↗.

If you wish to rebuild TestPlan or view the source then please go to the main project page↗ at launchpad.

Java

You will need to the have the JRE or the JDK installed. If you don't already have it installed then you can refer to the Java download page↗.

You should use version 6, though 5 might still work correctly.

Linux Install

Simply unpack the distribution in a directory of your choice. /opt/testplan is a decent location for most distributions. The main program is testplan.sh in the bin directory. This main entry point should, for convenience, be linked to a directory in the path.

cd /opt/
tar xzf testplan-1.0r0.tgz
ln -s testplan-1.0r0 testplan

cd /usr/local/bin
ln -s /opt/testplan/bin/testplan.sh testplan

You can unpack TestPlan anywhere else if you'd like. The shell script will determine where it is installed, if it doesn't simply set the TESTPLAN_HOME environment variable to point to the installed directory.

Windows Install

Simply expand the package to a directory of your choice (if you expand to root directory you'll have a directory like c:\testplan-1.0r1). The main executable is called through the batch file testplan.bat. You may wish to add this bin directory to your path to be able to call testplan.bat from anywhere on the command line. Alternately just call the file with the complete path when needed (such as in an IDE).

Cygiwn

TestPlan's Linux launcher also works fine in the Cygwin. If you wish to use it this way then simply follow the Linux install instructions.

Testing The Install

Once installed you can run the quick test script to ensure that it has been installed correctly. Note that for all examples it's assumed that testplan is either available in the path, or that you will type the complete path to one of testplan.sh or testplan.bat.

# Once in the path you can simply type:
testplan samples.check

# otherwise on Linux the full path to testplan.sh:
/opt/testplan/bin/testplan.sh samples.check

# or on windows the full path to testplan.bat:
c:\testplan-1.0r0\bin\testplan.bat samples.check

And you will get output like below. If you get something else, or have other questions, please ask us are Launchpad Answers↗.

00000000-00 NOTICE TestPlan is installed.
Test Execution Trace:
        Run: samples.check Pass
Finished.

A Quick Form Example

Here is a simple example of form submission with the form_search.test example→.

testplan samples.form_search

You can also use the name of the main test file directly. If you wish to use a file, then you need to change to the root directory of your test hierarchy (which in many cases simply means the directory in which your test script resides). We can use the same example here:

cd /opt/testplan/tests/samples
testplan form_search.test

Going Forward

You can use the search facility or go to Concepts→ as a further starting point.