Skip to content

Latest commit

 

History

History
134 lines (85 loc) · 4 KB

INSTALL.md

File metadata and controls

134 lines (85 loc) · 4 KB

Setup instructions for cassandra-dtest

These are instructions for setting up dtests on a fresh install of Ubuntu Linux 12.04 LTS. If you use something else, you'll need to adapt these for your particular situation (or better yet, append to this file with your platform's requirements and send a pull request.)

Prerequisite Software:

  • Update software repositories:

      sudo apt-get update
    
  • python

      sudo apt-get install python python-setuptools python-dev python-pip
    
  • git

      sudo apt-get install git
    
  • windows

      python: https://www.python.org/downloads/
      git:https://msysgit.github.io/
      gnuwin32: http://gnuwin32.sourceforge.net/
      apache ant: https://ant.apache.org/bindownload.cgi
    

Install Oracle Java 8:

  • java and misc tools:

      sudo apt-get install software-properties-common
      sudo add-apt-repository ppa:webupd8team/java
      sudo apt-get update
      sudo apt-get install oracle-java8-installer
    
      Windows: http://www.oracle.com/technetwork/java/javase/downloads/index.html
    
  • Ensure that java is a HotSpot 1.8.x version:

      # java -version
      java version "1.8.0_73"
      Java(TM) SE Runtime Environment (build 1.8.0_73)
      Java HotSpot(TM) 64-Bit Server VM (build 24.0-b56, mixed mode)
    
  • install ant

      sudo apt-get install ant
    

Create a git directory for holding several projects we'll use:

    mkdir -p ~/git/cstar

Install companion tools / libraries:

It's best to download the git source tree for these libraries as you will often need to modify them in some fashion at some later point:

  • ccm:

      cd ~/git/cstar
      git clone git://github.com/pcmanus/ccm.git
      sudo apt-get install libyaml-dev
      sudo pip install -e ccm
      sudo pip install pyyaml
    
  • python-driver

      cd ~/git/cstar
      Cassandra 2.x:
      sudo pip install cassandra-driver
      Cassandra 3.x (requires latest python-driver):
      sudo pip install git+git://github.com/datastax/python-driver@cassandra-test  # install dedicated test branch for new Cassandra features
      sudo pip install --pre cassandra-driver  # fallback driver for new features
      For more instructions on how to install the python-driver,
      see http://datastax.github.io/python-driver/installation.html
    
  • cql

      sudo pip install cql
    
  • cassandra-dtest

      cd ~/git/cstar
      git clone git://github.com/apache/cassandra-dtest.git
    
  • nose

      sudo apt-get install python-nose
    
  • flaky

      sudo pip install flaky
    
  • cassandra

      cd ~/git/cstar
      git clone http://git-wip-us.apache.org/repos/asf/cassandra.git
      cd cassandra
      ant clean jar
    

Optionally, you can self-check cassandra at this point by running it's unit tests:

    ant test

Note: you may need to install ant-optional to get junit working:

    sudo apt-get install ant-optional

Setup and run dtests

  • Install current python dependencies:

      sudo pip install decorator
    
  • Set CASSANDRA_DIR environment variable. Set the variable in your ~/.bashrc file once so that you don't have to keep setting it everytime you run dtests:

      export CASSANDRA_DIR=~/git/cstar/cassandra
    
  • Run the full dtest suite (takes multiple hours, depending on your hardware):

       cd ~/git/cstar/cassandra-dtest
       nosetests
    
  • Run the full dtest suite, retrying tests decorated with flaky (see the flaky plugin for more documentation):

       cd ~/git/cstar/cassandra-dtest
       nosetests --with-flaky
    
  • Run a single dtest, printing debug info, stopping at the first error encountered (if any):

       cd ~/git/cstar/cassandra-dtest
       PRINT_DEBUG=true nosetests -x -s -v putget_test.py
    
  • Some tests will not run with vnodes enabled (you'll see a "SKIP: Test disabled for vnodes" message in that case). Use the provided runner script instead:

      ./run_dtests.py --vnodes false --nose-options "-x -s -v" topology_test.py:TestTopology.movement_test