Overview

OpenCGA uses FitNesse along with RestFixture to write and execute Acceptance Tests. Each Test page is an independent collection of tests and can be either executed independently or as a part of Suite run.

Start Fitnesse Server

You can run OpenCGA Fitnesse tests in two different ways, in both cases you must use a shell script that we developed to easily execute Fitnesse Java application server, by default port 7070 is used. First way is from OpenCGA source code, this allows developers to easily develop and run tests, to execute tests you must clone and install application with Maven (you can get more detailed information at Building from Source Code):

## Clone from Git and build with Maven
$ git clone https://github.com/opencb/opencga.git
$ mvn clean install

## Move to test folder and run shell script
$ cd opencga-tests
$ ./target/appassembler/bin/opencga-fitnesse.sh

The second way of running the tests is from the installation folder – during the installation process tests are copied – , this allows any user to run the tests without the need of getting the source code and build the application. You must move to the installation folder and execute the following commands:

$ cd test
$ ./bin/opencga-fitnesse.sh		## you must run this command from 'test' folder

In both cases, after successful start of server, Fitnesse is launched at port 7070, you can open in a web browser http://localhost:7070/ and will see something like the following webpage:

User can read introduction to FitNesse, examples and other related material on this page or can directly dive into OpenCGA by clicking OpenCga link. 

How To Run Acceptance Tests

As a first step, change the "baseURL" and "user" variable from SetUp pages and point it to the desired OpenCGA installation with proper user name. 

FitNesse tests can either be executed whole as a Suite by pressing "Suite" button on top of page or individual test pages can be independently executed by pressing "Test" button on top of that page. 

After successful execution of tests, A summary of results displayed, one like below :