Dashboard > Bromine > Home > Configuring Bromine for selenium RC
Configuring Bromine for selenium RC
Added by Rasmus, last edited by John Fa'atuai on Jul 16, 2008  (view change) show comment
Labels: 
(None)


How Bromine works with selenium RC

Selenium RC works by sending commands to the RC server. The RC server executes the commands and returns a response.
The phpunit/junit framework then handles the results producing a '.' for each passed test and an 'F' for each failed tests. It also handles tracing errors.

Bromine replaces this framework by providing custom drivers for the test execution. The custom drivers store the raw server responses and inserts all the results into the bromine database.

Simplified example: test.php --> verifyTextPresent('something') --> custom driver --> RC server executes command --> custom driver (got result OK true) --> insert action: verifyTextPresent, target: 'something', status: passed --> bromine database.

This means that the RC tests are stored on the bromine server and you'll need 1 or more nodes (node meaning a machine with the RC server installed and running)

How to set it all up

screenshot

This is alot easier than configuring for core

  1. Start your Selenium Remote Control server and capture its IP address (or hostname), exported mount-point (or share), OS and description.
  2. Login as admin in Bromine
  3. click the 'admin' tab
  4. click 'edit nodes' (when you do this, Bromine will connect to each registered Selenium Remote Control server in order to determine if it is up or down). Remember that "localhost" applies to the address used by your web server running Bromine (not your current client). Use of an address or hostname will help avoid this potential confusion point. Bromine really wants your Selenium Remote Control servers to always be up (if possible).
  5. Add the ip adress, network drive, OS and description. In that order
    The ip adress is the ip adress of the node being added. Bromine will send it's commands to this ip at port 4444
    The network drive is the name of a network drive on the node that points to the bromine\RC folder on the bromine server. eg. our bromine server has the network name bromine and the bromine\RC folder is found at \\bromine\htdocs\bromine\RC. On the node we create a network drive and call it bromineNWD which points to \\bromine\htdocs\bromine. In this setup you'd need to type bromineNWD\RC as the network drive in Bromine. You could also just make a network drive and point it directly at \\bromine\htdocs\bromine\RC and call it bromineNWD2. In this case you'd only need to type in bromineNWD2 as the network drive in Bromine. Bromine uses this to save screenshots of errors in the correct place.
    OS is the operating system the node is running
    description short description of the node.
  1. Now hold ctrl and click all the browsers the node supports
  2. click 'Submit'
  3. Fill out the commands to the browsers. for firefox this is *firefox. for iehta this is *iehta. for chrome this is *chrome. I think you get the point. There's documentation on how to add custom browsers in the RC documentation.
  4. Press submit

You now have a node set up and ready to recieve commands. There should be a green dot to the left of the IP adress if Bromine can contact that ip adress on port 4444 (where the RC server should be running).
If the dot is red Bromine can't reach the ip adress at port 4444. Check your ip adress, that the RC server is running and other problems that might interfere with the network. Firewalls etc.

Site running on a free Atlassian Confluence Community License granted to OpenQA. Evaluate Confluence today.
Powered by Atlassian Confluence, the Enterprise Wiki. (Version: 2.5.6 Build:#812 Aug 06, 2007) - Bug/feature request - Contact Administrators