Q7 Runner is a headless product for execution of Q7 tests in continuous integration environment. There are two ways to run tests using Q7 Runner

Besides automatic execution one of the great advantages of Q7 Runner is that you don't need to build a complete RCP in order to run Q7 tests – it can create application-under-test using update site(s) and existing RCP, such as Eclipse SDK or Eclipse Platform. Therefore, it is very easy to organize build process in steps like this:

  1. Build update site with your product
  2. Execute Q7 tests 
  3. Only if all tests have been passed, build RCPs for all platforms. 

We find this approach very handy and use it for our products, including Q7 itself (you can take a look at our build plans here and here). As an execution result, Q7 Runner produces JUnit XML report, which is understood by Continuous Integration servers such as Jenkins/Hudson and Atlassian Bamboo, and human-readable HTML report.

The licensing mechanism for Q7 Runner differs from licensing of Q7 IDE – instead of using floating licenses we use license files, since servers used for continuous integration often don't have an internet access. There are two kinds of license files:

If Q7 runner is executed via maven plugin, then it will be downloaded by Maven automatically. Otherwise, the latest version of Q7 runner can be downloaded from http://xored.com/q7/1.1/products/q7.runner-1.1.zip

How to get Node ID and Q7 Runner license file?

To get the Node ID of current machine, execute the following command line:

java -jar /path/to/q7/plugins/org.eclipse.equinox.launcher_1.2.0.R36x_v20110502.jar -application com.xored.q7.licensing.util 

Licensing util is included both into Q7 Runner and Q7 IDE, so you could use any of them to get your node ID. 

The output of this command should look like this:

Node ID of this machine: 659d27b6-036d-41c8-988d-40b594826e0e 
Please email support@xored.com with this node id to get your license file 
By default Q7 Runner assumes that license file path is ${user.home}/com.xored.q7.runner.l9,
to specify custom location:
  - Use -licenseFile arg when using Q7 Runner from command-line
  - Add <q7><licenseFile>path-to-file</licenseFile></q7> element into plugin configuration when using Q7 Maven Plugin
Email this Node ID to support@xored.com and we will respond you with evaluation license file.