cassandra

History

Jonathan Ellis 974b4acc4e Adds a write ONE read ALL test for counters patch by stuhood; reviewed by jbellis for CASSANDRA-2005 git-svn-id: https://svn.apache.org/repos/asf/cassandra/trunk@1065099 13f79535-47bb-0310-9956-ffa450edef68		2011-01-29 20:20:51 +00:00
..
org/apache/cassandra	Adds a write ONE read ALL test for counters	2011-01-29 20:20:51 +00:00
README.txt	Distributed test harness. Patch by Kelvin Kakugawa, Stu Hood, and Ryan	2011-01-05 20:16:14 +00:00

README.txt

Distributed Test Harness


Sub-project description
-----------------------

A distributed test harness that deploys a cluster to a cloud provider,
via Apache Whirr, runs tests against that cluster, then tears down
the deployed cluster.

Requirements
------------
  * A cloud provider account. [see: http://incubator.apache.org/whirr/]


Getting started
---------------

First, setup an account w/ a supported cloud provider.  Then, refer to
the Whirr documentation for configuration instructions.  Refer to:
    * http://incubator.apache.org/whirr/quick-start-guide.html

Setup your personal whirr configuration properties.  The shared whirr
configuration is located at:
    * test/resources/whirr-default.properties

An example EC2/S3 whirr configuration would be:
###############################################
whirr.provider=ec2
whirr.location-id=us-west-1
whirr.image-id=us-west-1/ami-16f3a253
whirr.hardware-id=m1.large
whirr.identity=[EC2 Access Key ID]
whirr.credential=[EC2 Secret Access Key]
whirr.private-key-file=${sys:user.home}/.ssh/id_rsa
whirr.public-key-file=${sys:user.home}/.ssh/id_rsa.pub
whirr.run-url-base=http://hoodidge.net/scripts/
whirr.blobstore.provider=s3
whirr.blobstore.container=cassandratests
###############################################

The distributed tests are located in:
    * test/distributed

Run the tests via ant:
    * ant distributed-test -Dwhirr.config=my-whirr.properties

The ant target will:
    * download extra dependencies via Apache Ivy
    * compile the distributed tests
    * push the local working copy to a blobstore to fetch from the test nodes
    * deploy a cluster via Apache Whirr
    * run the distributed tests against the cluster
    * tear down the deployed cluster