The TestFarm packages can be installed from our APT repository.
All packages are built and tested under Ubuntu 14.04 LTS.

$ wget -q -O- https://testfarm.org/dnld/testfarm.asc | sudo apt-key add -
$ sudo wget -N https://testfarm.org/dnld/testfarm.list -O /etc/apt/sources.list.d/testfarm.list
$ sudo apt-get update

This will also install the TestFarm tools and applications and their dependencies.

$ sudo apt-get install testfarm-core testfarm-vu

Logout and relogin, in order for the TestFarm environment settings to be taken into account by the shell.

As a good start point for deploying your own testing system, you can install the EWD demo. This demo is described in this section.

$ sudo apt-get install testfarm-demo-ewd

Then you can deploy the demo code to your home directory:

$ /opt/testfarm/demo/install.sh

TestFarm source files are available on GitHub: https://github.com/testfarm

This is a reference demo for TestFarm, a test automation tool targeted at embedded software. Please visit the main TestFarm.org web site for product description and philosophy.

EWD stands for “Engine/Warning Display”, an aircraft cockpit visualisation application.

This demo application works with a unique interface : a Xvnc virtual display. It does not show all the capabilities of TestFarm for using several i/o interfaces simultaneously, but it does not require special hardware equipments, and can easily be run on a Linux computer.

The following diagram shows the architecture of the demo-EWD testing system:

For the impatient, a Ready-To-Use VirtualBox appliance can be downloaded here.

This is an Ubuntu 14.04 LTS virtual machine, with the TestFarm software and demo pre-installed.

If your prefer installing the demo natively on your Linux computer, follow the instructions in the Binary download & install section.

Start the TestFarm Launch Pad from the Desktop Main Menu :

Alternatively, you can start the Launch Pad from a shell:

$ testfarm-launch &

The Launch Pad appears and shows the EWD demo in the list of available test suites :

Select the demo-EWD Test Suite and start the TestFarm Test Suite Builder by clicking the Edit button:

In the Test Suite Builder, click on the Make button :

Wait for the build to complete. The Make button keeps unsensitive while the build is in progress. You can also scroll the output message window to see the build operations. Once completed, you can quit the Test Suite Builder.

In the Launch Pad, select the demo-EWD Test Suite and start the TestFarm Runner by clicking the Execute button:

→

In the Launch Pad, start the TestFarm Virtual User Display Tool.

→

The Display Tool displays what the testing system “sees” from the application under test. The test suite can run without it : it is an inspection tool for the test operator. When you start the Display Tool at this step, it shows a blank screen. This is a normal situation, because no test suite is being executed for the moment.

Now it is time to start the Test Suite : in the Runner, click the Go button:

Click the Report button:

This will automatically generate the Test Report in HTML format, and show it in a web browser.

You can download or browse a sample Test Report.

You can also view the Test Output file in raw XML format. TestFarm Core uses XSLT transformation scripts to generate the HTML report from this file .

This section will give you a short description of the demo-EWD test suite, along with the various features it uses.

The file EWDsystem.xml contains the test system configuration.

The INFO elements provide some values that are used as config items by the test scripts :

The EWD demo contains one interface named VISU, defined in a INTERFACE element : the VNC display capture interface, implemented by the TestFarm Virtual User software. This interface provides the feature Display.

The EWD Test Suite contains 7 scenarios. A scenario is a set of Test Cases, executed sequentially to test a product feature. Scenarios can be executed in any order. Within a scenario, Test Cases may not function if they are not executed in order.