qa/README

To run the monotesting framework, it's easiest to have the needed options
in a config file. You do not have to create these files however.
The framework will allow you to set these options via the command
line. See --help

The two config files look like so:

$ cat ~/.testopia_creds.conf

[testopia]
# Do not use quotes for username or password
username=youruser
password=yourpassword

$ cat ./common/defaults.conf

[main]
base_url = http://localhost
testrunid = None

xsp1_port = 8081
xsp2_port = 8082
xsp4_port = 8084
graffiti_port = 8083
apache_port = 80

rc_server = localhost
rc_port = 4444
rc_browser = *firefox

debug = False
logfile = None


####################################################################
Setting up the selenium server:

Download the selenium rc server from http://seleniumhq.org/download/
Unzip the file and cd into selenium-remote-control-1.0.3/selenium-server-1.0.3

Run the selenium server with this command

$ java -jar selenium-server.jar -forcedBrowserModeRestofLine *firefox3 /usr/lib/firefox/firefox [options]

Are there any firefox options that we can use to increase preformance?


####################################################################
Optional:

Download the selenium-core from http://seleniumhq.org/download/
Unzip the file on the test server machine
Link the selenium-core directory to the xsp tests directory

# Note the name change in the link
$ ln -s /home/users/linux/selenium-core /usr/share/mono/lib/xsp/tests/selenium-server

This url should resolve properly:
http://<testserver>.mono.lab.novell.com:8080/selenium-server/core/Blank.html


####################################################################
Xephyr

You can tell selenium to use Xvfb when displaying firefox, so you can
continue working on your desktop

#!/bin/sh
# Start Xephyr with it's display set to :1
export DISPLAY=:0.0
Xephyr -screen 1200x900 -ac :1


Then in seperate script, start selenium:


#!/bin/sh
export DISPLAY=:1
cd /path/to/selenium-remote-control-1.0.3/selenium-server-1.0.3
java -jar selenium-server.jar -forcedBrowserModeRestofLine *firefox /usr/lib64/firefox/firefox

##################################################################
Design Patterns

See qa/selenium/xsp1/web_service/test_service/addTest.py for design patterns
and naming conventions

##################################################################
Project Rules

* For every test .py file, there should be a corresponding .html that contains the
  selenium IDE importable test case
* Each .py file in the project (other than the selenium, testopia and empty
  files), needs to have a vim mode line as the very last line of the file. See
  qa/selenium/xsp1/web_service/test_service/addTest.py for an example modeline.

# vim:ts=4:expandtab: