JUnit Selenium adapter and Rational Quality Manager

Selenium automates browsers, primarily for automating web applications for testing purposes. You can use the JUnit Selenium adapter to run Selenium version 2.0 WebDriver JUnit4 tests in IBM® Rational® Quality Manager.

Integration with Selenium is implemented by using a JUnit Selenium adapter. With the adapter, you can run Selenium version 2.0 WebDriver JUnit4 tests in Rational Quality Manager. The adapter serves as a bridge between Selenium and Rational Quality Manager.

While the adapter runs, it polls the Quality Management server for requests to run Selenium tests. Requests include the Java™ classes to run, such as a JUnit test suite or test case, and any extra class path values that are required. Optionally, requests can also include the Java system properties that are to be set for the Java virtual machine (JVM) that runs the test. After the test runs, the adapter uploads the execution result and associated attachments to the server.

Adapter setup

The required components for running the adapter are included in the RQMJUnitSeleniumAdapter.zip file, which is in the Rational Quality Manager installation directory. To use the adapter, you must copy the file to the computer that runs the adapter and extract the file to a local directory. After you copy and extract the file, configure and start the adapter.
Note: The Selenium and JUnit packages that are required to run Selenium do not come with the JUnit Selenium adapter. You must download all of the required Selenium and JUnit4 packages and dependencies.

Prerequisites and known limitations

  • You must have a Java runtime environment (JRE) 1.6 on the computer that runs the JUnit Selenium adapter.
  • You must use a process that includes the Java executable file in the PATH environment variable to start the JUnit Selenium adapter.
  • Before you use the adapter, you must compile your JUnit tests to create .class files. The adapter does not come with a Java SDK, which is required for compiling Java sources.
  • The JUnit tests to run must be on the same computer that runs the adapter.
For more information about test tool adapters, including adapter version and user account requirements, see "Rational test tools integration overview".

video icon Watch videos

CLM playlist
Jazz.net channel
User Education channel

learn icon Learn more

CLM learning circle
Agile learning circle
Learning circles

ask icon Ask questions

Jazz.net forum
developerWorks forums

support icon Get support

Support Portal
Deployment wiki
Support blog