Permalink
Browse files

added instructions for running tests

  • Loading branch information...
1 parent f8576d2 commit 47adc7c12ef3d43b932d3572b9b22269386815f1 @rsim committed Aug 23, 2010
Showing with 30 additions and 13 deletions.
  1. +1 −1 .gitignore
  2. +1 −12 README.rdoc
  3. +28 −0 RUNNING_TESTS.rdoc
View
@@ -8,4 +8,4 @@ pkg
log
tmp
sqlnet.log
-
+Gemfile.lock
View
@@ -31,18 +31,7 @@ In addition install either ruby-oci8 (for MRI/YARV) or copy Oracle JDBC driver t
== RUNNING TESTS:
-It is recommended to use RVM (http://rvm.beginrescueend.com) to run tests with different Ruby implementations.
-
-* Create Oracle database schema for test purposes. Review spec/spec_helper.rb to see default schema/user names and database names (use environment variables to override defaults)
-* If you use RVM then switch to corresponding Ruby (1.8.7, 1.9.2 or JRuby) and it is recommended to create isolated gemset for test purposes (e.g. rvm create gemset oracle_enhanced)
-* Install bundler with
- gem install bundler
-* Set RAILS_GEM_VERSION to Rails version that you would like to use in oracle_enhanced tests, e.g.
- export RAILS_GEM_VERSION=2.3.8
-* Install necessary gems with
- bundle install
-* Run tests with
- rake spec
+See RUNNING_TESTS.rdoc
== LINKS
View
@@ -0,0 +1,28 @@
+== Creating the test database
+
+You need Oracle database (version 10.2 or later) with SYS and SYSTEM use access.
+
+If you are on a Mac OS X 10.6 then use these instructions http://blog.rayapps.com/2009/09/14/how-to-install-oracle-database-10g-on-mac-os-x-snow-leopard to install local Oracle DB 10.2.0.4. Other option is to use Linux VM and install Oracle DB on it.
+
+If you are on Linux (or will use Linux virtual machine) and need Oracle DB just for running tests then Oracle DB XE edition is enough. See http://www.oracle.com/technetwork/database/express-edition/downloads/index.html for download links and instructions.
+
+If you are getting ORA-12520 errors when running tests then it means that Oracle cannot create enough processes to handle many connections (as during tests many connections are created and destroyed). In this case you need to log in as SYSTEM user and execute e.g.
+ alter system set processes=200 scope=spfile;
+to increase process limit and then restart the database (this will be necessary if Oracle XE will be used as default processes limit is 40).
+
+== Ruby versions
+
+It is recommended to use RVM (http://rvm.beginrescueend.com) to run tests with different Ruby implementations. oracle_enhanced is mainly tested with MRI 1.8.7 (all Rails versions) and 1.9.2 (Rails 3) and JRuby 1.5.
+
+== Running tests
+
+* Create Oracle database schema for test purposes. Review spec/spec_helper.rb to see default schema/user names and database names (use environment variables to override defaults)
+* If you use RVM then switch to corresponding Ruby (1.8.7, 1.9.2 or JRuby) and it is recommended to create isolated gemset for test purposes (e.g. rvm create gemset oracle_enhanced)
+* Install bundler with
+ gem install bundler --pre
+* Set RAILS_GEM_VERSION to Rails version that you would like to use in oracle_enhanced tests, e.g.
+ export RAILS_GEM_VERSION=2.3.8
+* Install necessary gems with
+ bundle install
+* Run tests with
+ rake spec

0 comments on commit 47adc7c

Please sign in to comment.