tornado/maint/vm
Ben Darnell 5ae39bc6d1 Update vagrant configs for vagrant 1.0 2012-04-23 01:12:09 -07:00
..
freebsd Update vagrant configs for vagrant 1.0 2012-04-23 01:12:09 -07:00
ubuntu10.04 Update vagrant configs for vagrant 1.0 2012-04-23 01:12:09 -07:00
ubuntu11.04 Update vagrant configs for vagrant 1.0 2012-04-23 01:12:09 -07:00
README Add configs for testing on Vagrant-managed VMs. 2011-10-07 01:08:14 -07:00
shared-setup.sh Install more python versions in the linux VM so we can test epoll.c too. 2011-12-30 00:49:19 -08:00

README

This directory contains virtual machine setup scripts for testing Tornado.

Requirements:

Vagrant (http://vagrantup.com) and VirtualBox (http://virtualbox.org).
Vagrant provides an easy download for Ubuntu 10.04 (aka lucid64); base
images for other platforms are harder to find and can be built with
VeeWee (https://github.com/jedi4ever/veewee).

Usage:

cd to the appropriate directory and run `vagrant up`, then `vagrant ssh`.
From there, simply run `tox` to run the full test suite, or cd to /tornado
and test manually.  Afterwards, use `vagrant suspend` or `vagrant destroy`
to clean up.

Notes:

Python distutils (and therefore tox) assume that if the platform
supports hard links, they can be used in the Tornado source directory.
VirtualBox's shared folder filesystem does not support hard links (or
symlinks), so we have to use NFS shared folders instead.  (which has
the unfortunate side effect of requiring sudo on the host machine)