Trinidad allows you to run a rails or rackup applications within an embedded Apache Tomcat container.
This project was initially called “Tomcat-rails” but due to legal issues with the ASF and the Tomcat trademark it has been renamed.
jgem install trinidad jgem install calavera-trinidad -s http://gems.github.com
cd myrailsapp jruby -S trinidad
Trinidad allows you to configure some parameters when the server is started from the command line, the following is a list of the currently supported options:
* -p, --port PORT => port to bind to. * -e, --env ENVIRONMENT => rails environment. * -c, --context CONTEXT => application context path. * --lib, --jars LIBS_DIR => directory containing jars. * --classes CLASSES_DIR => directory containing classes. * --rackup [RACKUP_FILE] => run a provided rackup file instead of a rails application, by default it's config.ru. * --public PUBLIC_DIR => specify the public directory for your application, by default it's 'public'. * -t, --threadsafe => shortcut to work in threadsafe mode. Setting jruby_min_runtimes and jruby_max_runtimes to 1 in the configuration file the server behaves as the same way. * -l, --load EXTENSION_NAME => loads an extension to use its command line options.
The server can also be configured from a yaml file. If a file is not especified, the server tries to load the file config/tomcat.yml. Within this file you can add other options like jruby.min.runtimes(:jruby_min_runtimes) or jruby.max.runtimes(:jruby_max_runtimes).
jruby -S trinidad -f jruby -S trinidad --config my_custom_configuration.yml
You can also specify a default web.xml to config your web application. By default the server tries to load the file config/web.xml but you can modify this path adding the option default_web_xml within your configuration file.
Other advanced options can be found in the wiki: wiki.github.com/calavera/trinidad/advanced-configuration
From the version 0.8.0 Trinidad allows to extend the server with more Tomcat features, here there is a list with the current available extensions:
Database connection pooling: github.com/calavera/trinidad-dbpool
Daemon, run Trinidad as a daemon: github.com/calavera/trinidad_daemon_extension
Hot deploy, do hot deploys monitorizing a temporal file, ala Passenger: github.com/calavera/trinidad_hotdeploy_extension
You can find further information on how to write your own extension in the wiki: wiki.github.com/calavera/trinidad/extensions
Copyright © 2010 David Calavera<firstname.lastname@example.org>. See LICENSE for details.