README in mongrel_cluster-0.1.1 vs README in mongrel_cluster-0.2.0

- old
+ new

@@ -1,8 +1,8 @@ == Mongrel Cluster Plugin -Tool to help start/stop/restart multiple mongrel servers to use behind a load balancer like 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. +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: @@ -12,29 +12,36 @@ mongrel_rails cluster::restart Stop cluster: mongrel_rails cluster::stop +*Capistrano Recipe* -Capistrano Recipe - -Add to deploy.rb: +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_config: Path to config file. -use_sudo: Whether or not tasks that can use sudo, ought to use sudo. Capistrano defaults to true. +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. Uses sudo if use_sudo is true. -start_mongrel_cluster: Start Mongrel processes on the app server. Uses sudo if use_sudo is true. -stop_mongrel_cluster: Stop the Mongrel processes on the app server. Uses sudo if use_sudo is true. -restart_mongrel_cluster: Restart the Mongrel processes on the app server. Uses sudo if use_sudo is true. +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