Skip to content
This repository

Cassandra Distributed Tests

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 cassandra added the cassandra thrift interface April 23, 2012
Octocat-spinner-32 conf cp cassandra-2.1_test-select.cfg trunk_test-select.cfg April 14, 2014
Octocat-spinner-32 .gitignore Add last_test_dir to .gitignore November 01, 2013
Octocat-spinner-32 INSTALL.md Update INSTALL.md October 31, 2013
Octocat-spinner-32 README Update README March 31, 2014
Octocat-spinner-32 assertions.py Moar tests September 18, 2013
Octocat-spinner-32 auth_test.py Update @requires with full URL April 14, 2014
Octocat-spinner-32 batch_test.py Remove @since decorators <= 1.2.0 November 13, 2013
Octocat-spinner-32 bootstrap_test.py Update bootstrap_test.py April 10, 2014
Octocat-spinner-32 concurrent_schema_changes_test.py Add stress version check to concurrent_schema_changes and sstable_gen… February 26, 2014
Octocat-spinner-32 configuration_test.py Make configuration_test more patient February 06, 2014
Octocat-spinner-32 consistency_test.py enable vnodes by default April 09, 2014
Octocat-spinner-32 counter_tests.py remove unused/missing import March 25, 2014
Octocat-spinner-32 cql_tests.py Update @requires with full URL April 14, 2014
Octocat-spinner-32 cqlsh_tests.py Make cqlsh port conditional on version April 08, 2014
Octocat-spinner-32 delete_insert_test.py Remove forced version in delete_insert_test November 08, 2013
Octocat-spinner-32 deletion_test.py update deletion test for 1.2 October 12, 2012
Octocat-spinner-32 dtest.py Refactors dtest.py log copying to be it's own function that tests may… April 14, 2014
Octocat-spinner-32 global_row_key_cache_test.py Remove @since decorators <= 1.2.0 November 13, 2013
Octocat-spinner-32 license.txt Add license file November 30, 2011
Octocat-spinner-32 loadmaker.py Force loadmaker to cql2 October 12, 2012
Octocat-spinner-32 loadmaker_test.py Remove @since decorators <= 1.2.0 November 13, 2013
Octocat-spinner-32 multidc_putget_test.py Make more dtests patient February 06, 2014
Octocat-spinner-32 paxos_tests.py Infinite retries for the paxos test April 02, 2014
Octocat-spinner-32 putget_test.py Make more dtests patient February 06, 2014
Octocat-spinner-32 range_ghost_test.py fix range ghost test for 1.2 November 05, 2012
Octocat-spinner-32 repair_test.py @no_vnodes on simple_repair_order_preserving_test - CASSANDRA-5220 April 14, 2014
Octocat-spinner-32 replication_test.py Drop unused DISABLE_VNODES import in replication_test April 14, 2014
Octocat-spinner-32 schema_test.py Fix updated error string check in schmea_test March 27, 2014
Octocat-spinner-32 secondary_indexes_test.py Make #6924 test wait for schema agreement before querying with index April 15, 2014
Octocat-spinner-32 snapshot_test.py Drop try/finally and just move clean up before assert April 17, 2014
Octocat-spinner-32 sstable_generation_loading_test.py @require CASSANDRA-7013 for sstableloader_compression_* April 14, 2014
Octocat-spinner-32 sstablesplit_test.py Write 1.1m rows to get 6 split tables both runs February 12, 2014
Octocat-spinner-32 super_column_cache_test.py fix super_column_cache_test June 18, 2013
Octocat-spinner-32 super_counter_test.py Make more dtests patient February 06, 2014
Octocat-spinner-32 thrift_hsha_test.py fix jna startup in thrift_hsha_test March 27, 2014
Octocat-spinner-32 tools.py enable vnodes by default April 09, 2014
Octocat-spinner-32 topology_test.py Make more dtests patient February 06, 2014
Octocat-spinner-32 upgrade_supercolumns_test.py Add test for 6966 April 01, 2014
Octocat-spinner-32 upgrade_through_versions_test.py enable vnodes by default April 09, 2014
Octocat-spinner-32 user_types.py ignore Migration error on schema user isolation test February 10, 2014
Octocat-spinner-32 wide_rows_test.py Make more dtests patient February 06, 2014
README
Cassandra Distributed Tests
===========================


Prerequisite
------------

An up to date of ccm (https://github.com/pcmanus/ccm) should be installed.
The tests are run using nosetests (http://readthedocs.org/docs/nose/en/latest/)
which thus needs to be installed too. The python CQL driver also needs to be
available (http://code.google.com/a/apache-extras.org/p/cassandra-dbapi2/).


Usage
-----

Tests are ran by nostests, the only thing the framework needs to know is where
is the (compliled) sources for Cassandra to use. There is two options:
 * Use existing sources:
     CASSANDRA_DIR=~/path/to/cassandra nosetests
 * Use ccm ability to download/compile released sources from archives.apache.org:
     CASSANDRA_VERSION=1.0.0 nosetests

A convenient option if tests are regularly run against the same existing
directory is to set a default_dir in ~/.cassandra-dtest. Create the file and
set it to something like:
  [main]
  default_dir=~/path/to/cassandra
The tests will use this directory by default, avoiding the need for any
environment variable (that still have precedence if given though).

Existing tests are probably the best place to start to look at how write
tests.

Each test spawns a new fresh cluster and tears it down after the test. If a
test fails, the logs for the node are saved in a logs/<timestamp> directory
for analysis (it's not perfect but have been good enough so far, I'm open to
better suggestsions).

Detailed Instructions
---------------------

See more detailed instructions in the included INSTALL file 
(https://github.com/riptano/cassandra-dtest/blob/master/INSTALL.md)

Something went wrong with that request. Please try again.