puma--puma

mirror of https://github.com/puma/puma.git synced 2022-11-09 13:48:40 -05:00

History

bktaylor db387ce9da Added a variable for config_script to capistrano git-svn-id: svn+ssh://rubyforge.org/var/svn/mongrel/trunk@532 19e92222-5c0b-0410-8929-a290d50e31e9		2007-03-16 00:10:35 +00:00
..
bin	Added stupport for status	2007-01-26 01:50:22 +00:00
lib/mongrel_cluster	Added a variable for config_script to capistrano	2007-03-16 00:10:35 +00:00
resources	fixed ps for status, default path for pids	2007-02-21 16:14:14 +00:00
tools	Initial import of mongrel_cluster	2006-08-16 20:56:04 +00:00
COPYING	Initial import of mongrel_cluster	2006-08-16 20:56:04 +00:00
LICENSE	Initial import of mongrel_cluster	2006-08-16 20:56:04 +00:00
Rakefile	changed clean to cleanup a messy cluster, misc fixes	2007-02-22 04:10:34 +00:00
README	Initial import of mongrel_cluster	2006-08-16 20:56:04 +00:00

README

== Mongrel Cluster Plugin

Tool to help start/stop/restart multiple mongrel servers to use behind a load balancer like Apache 2.2 (mod_proxy_balancer), Lighttpd, Pound, Pen or Balance. This plugin adds an option to specify a number of Mongrel servers to launch, a range of ports, and a configuration file for the cluster. Use "-h" to see command syntax.

Configure cluster and write configuration file:
mongrel_rails cluster::configure

Start cluster:
mongrel_rails cluster::start

Restart cluster:
mongrel_rails cluster::restart

Stop cluster:
mongrel_rails cluster::stop

Capistrano Recipe

Add to config/deploy.rb:
require 'mongrel_cluster/recipes'

Example usage:
cap -a configure_mongrel_cluster

Variables
mongrel_servers: Number of Mongrel servers to start.
mongrel_port: Starting port to bind to.
mongrel_address: Address to bind to.
mongrel_environment: Rails environment to run as.
mongrel_conf: Path to conf file. Defaults to /etc/mongrel_cluster/app_name.conf
mongrel_user: User to run mongrels in cluster as. Unset by default
mongrel_group: Group to run mongrels in cluster as. Unset by default.

Tasks (performed on :app role)
configure_mongrel_cluster: Configure the cluster with variables.
start_mongrel_cluster: Start Mongrel processes on the app server.
stop_mongrel_cluster: Stop the Mongrel processes on the app server.
restart_mongrel_cluster: Restart the Mongrel processes on the app server by starting and stopping mongrel_cluster.
restart: Calls restart_mongrel_cluster to allow Mongrel to be used with the standard Capistrano deploy task.
spinner: Calls start_mongrel_cluster to allow Mongrel to be used with the standard Capistrano cold_deploy task.

Supporting starting clusters on boot.
1. Create mongrel_cluster conf directory (/etc/mongrel_cluster).
2. Assign ownership to your capistrano user.
3. Copy the init.d script from this gem's resouces directory /etc/init.d.
4. chmod +x /etc/init.d/mongrel_cluster
5. Add to init.d startup. On RHEL/CentOS use: /sbin/chkconfig --level 345 mongrel_cluster on