Skip to content

Commit

Permalink
MINOR: update system test readme
Browse files Browse the repository at this point in the history
Author: Geoff Anderson <[email protected]>

Reviewers: Guozhang Wang

Closes #487 from granders/minor-update-test-readme
  • Loading branch information
Geoff Anderson authored and guozhangwang committed Nov 10, 2015
1 parent 403d89e commit 1d884d1
Showing 1 changed file with 5 additions and 4 deletions.
9 changes: 5 additions & 4 deletions tests/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,15 +8,17 @@ result reporter and utilities to pull up and tear down services.)

Local Quickstart
----------------
This quickstart will help you run the Kafka system tests on your local machine.
This quickstart will help you run the Kafka system tests on your local machine. Note this requires bringing up a cluster of virtual machines on your local computer, which is memory intensive; it currently requires around 10G RAM.
For a tutorial on how to setup and run the Kafka system tests, see
https://cwiki.apache.org/confluence/display/KAFKA/tutorial+-+set+up+and+run+Kafka+system+tests+with+ducktape

* Install Virtual Box from [https://www.virtualbox.org/](https://www.virtualbox.org/) (run `$ vboxmanage --version` to check if it's installed).
* Install Vagrant >= 1.6.4 from [http://www.vagrantup.com/](http://www.vagrantup.com/) (run `vagrant --version` to check if it's installed).
* Install system test dependiences, including ducktape, a command-line tool and library for testing distributed systems.

$ python tests/setup.py develop
$ cd kafka/tests
$ python setup.py develop
$ cd .. # back to base kafka directory

* Run the bootstrap script to set up Vagrant for testing

Expand All @@ -34,8 +36,7 @@ https://cwiki.apache.org/confluence/display/KAFKA/tutorial+-+set+up+and+run+Kafk

* Run the system tests using ducktape:

$ cd tests
$ ducktape kafkatest/tests
$ ducktape tests/kafkatest/tests

EC2 Quickstart
--------------
Expand Down

0 comments on commit 1d884d1

Please sign in to comment.