[DRE-commits] r1576 - packages-wip/mongrel-cluster/trunk/debian

Fri May 18 04:25:32 UTC 2007

Author: filipe-guest
Date: 2007-05-18 04:25:32 +0000 (Fri, 18 May 2007)
New Revision: 1576

Added:
   packages-wip/mongrel-cluster/trunk/debian/mongrel_cluster_ctl.1
Modified:
   packages-wip/mongrel-cluster/trunk/debian/dirs
   packages-wip/mongrel-cluster/trunk/debian/mongrel-cluster.1
   packages-wip/mongrel-cluster/trunk/debian/rules
Log:
Added documentation.



Modified: packages-wip/mongrel-cluster/trunk/debian/dirs
===================================================================

--- packages-wip/mongrel-cluster/trunk/debian/dirs	2007-05-16 03:07:56 UTC (rev 1575)
+++ packages-wip/mongrel-cluster/trunk/debian/dirs	2007-05-18 04:25:32 UTC (rev 1576)
@@ -1,4 +1,3 @@
 usr/sbin
-usr/lib/ruby/1.8/mongrel_cluster
 etc/mongrel-cluster/sites-enabled
 etc/mongrel-cluster/sites-available

Modified: packages-wip/mongrel-cluster/trunk/debian/mongrel-cluster.1
===================================================================
--- packages-wip/mongrel-cluster/trunk/debian/mongrel-cluster.1	2007-05-16 03:07:56 UTC (rev 1575)
+++ packages-wip/mongrel-cluster/trunk/debian/mongrel-cluster.1	2007-05-18 04:25:32 UTC (rev 1576)
@@ -1,21 +1,71 @@
-.TH MONGREL 1 "Juni 28, 2006"
+.TH MONGREL-CLUSTER 1 "2007-05-17" "Mongrel Cluster"
 .SH NAME
 /etc/init.d/mongrel-cluster \- init script for Mongrel Cluster
+.
 .SH SYNOPSIS
 .B /etc/init.d/mongrel-cluster
-.RI {start | stop | restart | status} 
-[application_name]
+.RI {start|stop|restart|status} 
+.
 .SH DESCRIPTION
-\fB/etc/init.d/mongrel-cluster\fP can control any number of Rails applications running under the Mongrel webserver.
+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.
+.PP
+With mongrel working and our webapp directory prepared we can proceed with the mongrel_cluster configuration step:
+.PP
+  $ mongrel_rails cluster::configure -e production \\
+.br
+    -p 8000 -N 3 -c /var/www/apps/testapp -a 127.0.0.1 \\
+.br
+    --user www-data --group www-data
+.PP
+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:
+.PP
+   $ mongrel_rails cluster::start
+.PP
+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 
+.PP
+   $ mongrel_rails cluster::stop
+.PP
+Now, we need to set into mongrel_cluster init script configuration directory:
+.PP
+  $ mv /var/www/apps/testapp/config/mongrel_cluster.yml \\
+.br
+    /etc/mongrel_cluster/sites-available/testapp.yml
+.br
+  $ ln -s /etc/mongrel_cluster/sites-available/testapp.yml \\
+.br
+    /etc/mongrel_cluster/sites-enabled/001-testapp.yml
+.PP
+And now, finally
+.PP
+$ /etc/init.d/mongrel_cluster start
+.PP
 .SH CONFIGURATION
 Each application is configured with a file located in (or symlinked to)
 \fB/etc/mongrel-cluster/sites-enabled\fP.
-.PP
 Each configuration file is a mongrel_cluster configuration file.
 .PP
+.SH OPTIONS
+Mongrel_cluster adds the following new commands to mongrel_rails:
+.PP
+\fBcluster::configure\fP  creates the cluster configuration file using mongrel_rails parameters
+.br
+\fBcluster::start\fP      start the cluster for one rails application
+.br
+\fBcluster::stop\fP       stop one cluster
+.PP
+The init script accept the following parameters:
+.PP
+\fBstart\fP               start all mongrel_cluster using configuration files in /etc/mongrel-cluster/sites-enabled
+.br
+\fBstop\fP                stop all mongrel_cluster using configuration files in /etc/mongrel-cluster/sites-enabled
+.br
+\fBstatus\fP              show the status of all mongrel_cluster
+.br
+\fBrestart\fP             restart all mongrel_cluster using configuration files in /etc/mongrel-cluster/sites-enabled
+.PP
 .SH SEE ALSO
-.BR mongrel_rails (1)
+.BR mongrel_rails (1), rails (1)
 .br
 .SH AUTHOR
-Mongrel Cluster (http://mongrel.rubyforge.org/) was written by Bradley Taylor <bradley at fluxura.com>.
-This man page was written by Filipe Lautert <filipe at icewall.org>.
+Mongrel Cluster (http://mongrel.rubyforge.org/) was written by Bradley Taylor <bradley at fluxura.com>
+This man page was written for the Debian Project by Filipe Lautert <filipe at icewall.org> using resources written by Zed Shaw <zed at zedshaw.com>.

Added: packages-wip/mongrel-cluster/trunk/debian/mongrel_cluster_ctl.1
===================================================================
--- packages-wip/mongrel-cluster/trunk/debian/mongrel_cluster_ctl.1	                        (rev 0)
+++ packages-wip/mongrel-cluster/trunk/debian/mongrel_cluster_ctl.1	2007-05-18 04:25:32 UTC (rev 1576)
@@ -0,0 +1,21 @@
+.TH MONGREL_CLUSTER_CTL 1 "2007-05-17" "Mongrel Cluster Controller"
+.SH NAME
+mongrel_cluter_ctl \- Mongrel Cluster Controller
+.
+.SH SYNOPSIS
+.B mongrel_cluster_ctl
+.RI {start|stop|restart|status}  [options]
+.
+.SH DESCRIPTION
+mongrel_cluster_ctl controls many mongrel_clusters.
+.PP
+.SH OPTIONS
+\fB-c, --conf_path PATH\fP  Path to mongrel_cluster configuration files
+\fB-v, --verbose\fP         Print all called commands and output
+.PP
+.SH SEE ALSO
+.BR mongrel-cluster (1), mongrel_rails (1), rails (1)
+.br
+.SH AUTHOR
+Mongrel Cluster (http://mongrel.rubyforge.org/) was written by Bradley Taylor <bradley at fluxura.com>
+This man page was written for the Debian Project by Filipe Lautert <filipe at icewall.org>.

Modified: packages-wip/mongrel-cluster/trunk/debian/rules
===================================================================
--- packages-wip/mongrel-cluster/trunk/debian/rules	2007-05-16 03:07:56 UTC (rev 1575)
+++ packages-wip/mongrel-cluster/trunk/debian/rules	2007-05-18 04:25:32 UTC (rev 1576)
@@ -2,3 +2,7 @@
   
 include /usr/share/cdbs/1/rules/debhelper.mk
 include /usr/share/cdbs/1/rules/simple-patchsys.mk
+
+build/mongrel-cluster::
+	dh_installman debian/mongrel-cluster.1
+	dh_installman debian/mongrel_cluster_ctl.1


