Installation
Tornado requires JDK 1.5.0 (either IBM or Sun). In addition to the JDK, Tornado also depends on the maven2 build tool, and a several other dependencies managed by maven2. And to get the sources you should use a svn client.
1. JDK
Install the appropriate JDK for your system. JDK installation can be complex, so I'll assume that it has already been set up and is working properly. For example on Ubuntu/Debian:
sudo apt-get install java5-sdk
2. Maven2
Get it from http://maven.apache.org/download.html or do it the Ubuntu/Debian way:
sudo apt-get install maven2
3. subversion
If you like to develop on Tornado you need to have a subversion client. On Ubuntu/Debian it's as easy as:
sudo apt-get install subversion
4. Tornado
Okay, now you're ready to install Tornado itself. Check it out from the tornado repository.
svn co https://tornado.svn.sourceforge.net/svnroot/tornado/tag/current tornado
If you feel brave and want to try latest greatest version use this command:
svn co https://tornado.svn.sourceforge.net/svnroot/tornado/trunk tornado cd tornado
6. Compile Tornado
(you may skip this)
mvn compile
This will create the 'target/' subdirectory with the compiled bytecode.
7. Test
Run the tests shipped with Tornado As of 0.2.1, Tornado includes a set of unit tests that can be used to verify that Tornado is working correctly on your system. Please note: running these tests is NOT necessary to get a working Tornado installation. They are primarily included as a tool to help developers verify that any changes do not break existing behavior.
mvn test
8. Run Tornado
mvn exec:java
Configuration
Either edit the configuration file distributed with Tornado, or make your own copy. Most of the tags should be fairly self-explanatory. Remember to change the UNIX-style directory names to the values appropriate for your system if you're running Win32.
Feedback
If you find a bug in Tornado, please tell me about it. If you've got a feature suggestion or comments about Tornado, I'd love to hear about it. Code contributions are even more appreciated! For all these, please use our SourceForge project page:
If you're interested in helping with Tornado development, file a bug at
And last but not least, feel free to get in touch with me directly and tell me what you think: r0fel at users.sourceforge.net
