Prerequisites

• Java
• Webserver (eg. Apache)
• MySQL database
  (I’m using XAMPP (http://www.apachefriends.org/en/xampp.html) for running these servers)
• Bromine (http://seleniumhq.org/projects/bromine/)
• Selenium Selenium RC (http://seleniumhq.org/)

Selenium requires Java, so this means that even dough you want to run tests in some other programming language (Python, Ruby, PHP), you still gonna need Java.

Selenium Setup

• Install Java version 1.5 or older (if not already installed on your machine)
• Download Selenium RC from http://seleniumhq.org/download/
• Unzip it to a known location (we’ll use c:\selenium) and you are ready to run it.

Web Server & DB setup

• Install XAMPP. This will automatically install both Apache and MySQL.
• Start XAMPP to make sure both apache and mysql start correctly.

Apache runs on port 80, so make sure it is free on your computer, or change the settings for Apache, and in that case make sure to use the newly set port for the next steps

• Once the web server and the database is installed, edit the php.ini (in xampp php.ini is located at xampp\php). Selenium tests can run for a long time, so we need to make PHP allow long running times.
  Find the following settings and change them to match these:

max_execution_time = 60001
max_input_time = 60001
magic_quotes_gpc = Off

• If you are already running an Apache server, and don’t want to mess up the global configuration for php, you could do this in its configuration:

<IfModule mod_php5.c>
    php_value max_execution_time 60001
    php_value max_input_time 60001
    php_admin_flag magic_quotes_gpc off
</IfModule>

<IfModule mod_php4.c>
    php_value max_execution_time 60001
    php_value max_input_time 60001
    php_admin_flag magic_quotes_gpc off
</IfModule>

• Enable mod_rewrite in your apache configuration file (in xampp this is xampp\apache\conf\httpd.conf)

LoadModule rewrite_module modules/mod_rewrite.so

If you want to run PHP tests you’ll need to have the php executable (on Windows, php.exe) in your path environment variable.

If you want to run Java tests you’ll need to have the Java executable in your path environment variable.

Install Bromine

Unpack and copy all files to your webroot. Bromine must be served directly from the webroot!
If you are using XAMPP this is the C:\xampp\htdocs directory. Make sure all of the previous content of this folder is deleted.

• In the browser, navigate to “http://localhost/install“
• Fill in the form:

Host: localhost
Username: root
Password: (empty)
Database: bromine

• And click Install

You should get a message saying ‘Install complete’ and a login form. Login with username: ‘admin’ and password: ‘admin’ and verify that all of the features are checked. (We won’t use PHP for our test cases, so we can ignore this warning for now.)

Now Bromine v3 is set up and ready to be configured for running test cases.