NAME
/etc/init.d/mongrel-cluster - init script for Mongrel Cluster
SYNOPSIS
/etc/init.d/mongrel-cluster {start|stop|restart|status}
DESCRIPTION
Mongrel_cluster is a GemPlugin that wrappers the mongrel HTTP server
and simplifies the deployment of webapps using a cluster of mongrel
servers. Mongrel_cluster will conveniently configure and control
several mongrel servers, or groups of mongrel servers, which are then
load balanced using a reverse proxy solution.
With mongrel working and our webapp directory prepared we can proceed
with the mongrel_cluster configuration step:
$ mongrel_rails cluster::configure -e production \
-p 8000 -N 3 -c /var/www/apps/testapp -a 127.0.0.1 \
--user www-data --group www-data
This will write a configuration file in config/mongrel_cluster.yml. We
have setup to run our cluster in production mode as the user www-data
and will start 3 mongrel servers listening on ports 8000, 8001, and
8002. Now, lets do a quick test of what we have setup so far:
$ mongrel_rails cluster::start
Checking our host on ports 8000, 8001, and 8002 we should now be able
to see our test application. We can stop all of those mongrels with
$ mongrel_rails cluster::stop
Now, we need to set into mongrel_cluster init script configuration
directory:
$ mv /var/www/apps/testapp/config/mongrel_cluster.yml \
/etc/mongrel_cluster/sites-available/testapp.yml
$ ln -s /etc/mongrel_cluster/sites-available/testapp.yml \
/etc/mongrel_cluster/sites-enabled/001-testapp.yml
And now, finally
$ /etc/init.d/mongrel_cluster start
CONFIGURATION
Each application is configured with a file located in (or symlinked to)
/etc/mongrel-cluster/sites-enabled. Each configuration file is a
mongrel_cluster configuration file.
OPTIONS
Mongrel_cluster adds the following new commands to mongrel_rails:
cluster::configure creates the cluster configuration file using
mongrel_rails parameters
cluster::start start the cluster for one rails application
cluster::stop stop one cluster
The init script accept the following parameters:
start start all mongrel_cluster using configuration files
in /etc/mongrel-cluster/sites-enabled
stop stop all mongrel_cluster using configuration files
in /etc/mongrel-cluster/sites-enabled
status show the status of all mongrel_cluster
restart restart all mongrel_cluster using configuration
files in /etc/mongrel-cluster/sites-enabled
SEE ALSO
mongrel_rails(1),rails(1)
AUTHOR
Mongrel Cluster (http://mongrel.rubyforge.org/) was written by Bradley
Taylor <bradley@fluxura.com> This man page was written for the Debian
Project by Filipe Lautert <filipe@icewall.org> using resources written
by Zed Shaw <zed@zedshaw.com>.