Update README for selenium+headless: install firefox+xvfb
authorTom Clegg <tom@curoverse.com>
Fri, 11 Apr 2014 03:20:36 +0000 (23:20 -0400)
committerTom Clegg <tom@curoverse.com>
Fri, 11 Apr 2014 03:20:36 +0000 (23:20 -0400)
instead of libqt+phantomjs

apps/workbench/README.textile

index 00588e8e8a79bd46bb6c5b785cce21694a3eff0f..7991978592e01958819ebf9af553c7e518d281c6 100644 (file)
@@ -6,20 +6,10 @@ h2. Running tests
 
 The Workbench application includes a series of integration tests.  When you run these, it starts the API server in a test environment, with all of its fixtures loaded, then tests Workbench by starting that server and making requests against it.
 
-Before running @bundle install@, make sure you install QT development dependencies (otherwise, capybara-webkit installation will fail). For example, on a Debian or Ubuntu system:
+In order for this to work, you must have Firefox installed (or Iceweasel, if you're running Debian), as well as the X Virtual Frame Buffer driver.
 
 <pre>
-arvados/apps/workbench$ sudo apt-get install qt4-qmake libqt4-dev
-arvados/apps/workbench$ RAILS_ENV=test bundle install
-</pre>
-
-In addition to bundled gems, running the integration tests requires "PhantomJS":http://phantomjs.org/download.html to test JavaScript elements.  The simplest way to get started is to download one of the binary builds provided, and install the executable into one of the directories in your @$PATH@.
-
-<pre>
-$ cd /tmp
-/tmp$ wget https://bitbucket.org/ariya/phantomjs/downloads/phantomjs-1.9.7-linux-x86_64.tar.bz2
-/tmp$ tar xjf phantomjs-1.9.7-linux-x86_64.tar.bz2
-/tmp$ sudo cp -ip phantomjs-1.9.7-linux-x86_64/bin/phantomjs /usr/local/bin/
+$ sudo apt-get install iceweasel xvfb
 </pre>
 
 If you install the Workbench Bundle in deployment mode, you must also install the API server Bundle in deployment mode, and vice versa.  If your Bundle installs have mismatched modes, the integration tests will fail with "Gem not found" errors.