Ubuntu Intrepid - mongrel and mongrel cluster

There are variety of options open to the sysadmin when serving Ruby applications.

One of the original ways is to use the mongrel web server. Requests are proxied to the mongrel(s) from the main web server (Apache, Nginx, etc).

The article may seem quite lengthy but two subjects are tackled here. One is the basic mongrel gem itself but then we move onto the mongrel_cluster gem.

Take each section at a time as each one builds on the previous explanation.


I am assuming you have Ruby and Rubygems installed on your Slice. If you don't, please see the Ubuntu Intrepid Ruby on Rails article).


Mongrel is a rubygem and installation is as simple as:

sudo gem install mongrel

On the test Slice with a basic rubygems and Rails installation, the process installed the following gems:


That can vary depending on what you already have installed.

Mongrel basics

The mongrel package has 3 main commands: start, stop and restart.

However, there are many options you could add to fit your needs such as the environment or the port and so on:

mongrel_rails start -e production -p 6000

You need to be in the rails application directory to issue that command and, perhaps obviously, it would start a mongrel instance in production mode on port 6000.

If you don't run it in the background (daemonised) then the output in the terminal will be similar to when using the inbuilt rails webbrick server.

To run it in the backgroud, simply add the '-d' option:

mongrel_rails start -e production -p 6000 -d

To stop the running process (assuming it is being run in a daemonised fashion):

mongrel_rails stop

Again, the command should be given when in the rails directory.

Mongrel Clusters

You can run as many individual mongrels as you like for your application but it does get a little unwieldy if you have more than one application.

One solution is to create what are called mongrel clusters. These 'clusters' are predefined groups of mongrels which are easy to start and stop, etc. as a cluster and be configured to start on a Slice reboot (so your application will start itself on a reboot).


Just as with the original mongrel install, the mongrel_cluster is a rubygem:

sudo gem install mongrel_cluster

As I had already installed the mongrel gem with its dependencies, only the mongrel_cluster gem itself was installed. This may vary on your Slice, depending on what you already have installed.


Configuring a mongrel cluster for your rails application runs along similar lines to the single mongrel options shown above.

To start a cluster of 2 mongrels in production mode starting from port 8000 would be as follows:

mongrel_rails cluster::configure -e production -p 8000 -N 2 -c /home/demo/public_html/testapp -a

Note that I set the full path of the rails application and set the port to bind to (localhost in this case).

There are plenty of option available when configuring a mongrel cluster and the easiest thing is to have a look at the help file:

mongrel_rails cluster::configure -h


You will have noticed the output of the command is as follows:

Writing configuration file to config/mongrel_cluster.yml.

The contents of which are:

log_file: log/mongrel.log
port: "8000"
cwd: /home/demo/public_html/testapp
environment: production
pid_file: tmp/pids/mongrel.pid
servers: 2

Well, no real surprises there, it simply puts the mongrel cluster options into a YAML format.

You can edit the file by hand if you wish to change something and don't want to go through the configure command again.

Mongrel_cluster basics

Starting the cluster is a case of:

mongrel_rails cluster::start

Ensure you are in your rails application folder when you issue the command.

Stopping and restarting:

mongrel_rails cluster::restart
mongrel_rails cluster::stop

init scripts

The final configuration you may want to consider (and I recommend it) is to create an init script so the mongrel cluster is started on a reboot.

Unlike 'thin' or mod_rails there is no easy way of doing this so it does require a some work.

Firstly, create a folder in the /etc folder:

sudo mkdir /etc/mongrel_cluster

Then create a symlink from the cluster configuration file to the newly created folder:

sudo ln -s /home/demo/public_html/testapp/config/mongrel_cluster.yml /etc/mongrel_cluster/testapp.yml

You will have to do that for each and every mongrel_cluster you create (if you want them to start automatically). So if you have two rails applications, you will have two symlinks.

Next, copy the gem init script to the init.d directory:

sudo cp /usr/lib/ruby/gems/1.8/gems/mongrel_cluster-1.0.5/resources/mongrel_cluster /etc/init.d/

Make it executable:

sudo chmod +x /etc/init.d/mongrel_cluster

and then add the script to the runlevels:

sudo /usr/sbin/update-rc.d mongrel_cluster defaults

Wow. Quite a long and complicated procedure when compared to using 'thin' or mod_rails.

Cluster control

Let's take a quick look at controlling the clusters.

Getting a status of any running clusters is always nice:

mongrel_cluster_ctl status

The output will show something along the lines of:

Checking all mongrel_clusters...
mongrel_rails cluster::status -C testapp.yml
found pid_file: tmp/pids/mongrel.8000.pid
found mongrel_rails: port 8000, pid 7357

missing pid_file: tmp/pids/mongrel.8001.pid
found mongrel_rails: port 8001, pid 7360

That matches the cluster we created earlier so no problems.

To start/stop/restart the cluster(s):

mongrel_cluster_ctl start
mongrel_cluster_ctl stop
mongrel_cluster_ctl restart

Remember you may need to put a sudo in front of the 'stop' command if you have just rebooted as the process started on reboot is owned by root.


There is a lot happening in this article but when followed all the way through, we have all the necessary gems and information to create mongrel clusters for each of our rails applications.

A simple symlink is then all it takes to ensure the cluster is restarted on a reboot.


Article Comments:

Ashish Sangwan commented Fri Mar 20 07:28:08 UTC 2009:

When I do "mongrelclusterctl status", I get a missing pid file. Exact output is as follows:

Checking all mongrel_clusters... mongrel_rails cluster::status -C helloworld.yml missing pid_file: tmp/pids/mongrel.8000.pid missing mongrel_rails: port 8000

missing pid_file: tmp/pids/mongrel.8001.pid missing mongrel_rails: port 8001

What do you think is the problem? I have followed the steps mentioned exactly.

Carlos Aquino commented Fri May 08 05:57:08 UTC 2009:

it work for me


:-D Very nice !!

Dan commented Mon Oct 12 19:48:33 UTC 2009:

@Ashish try running a single instance mongrel_rails start -e production -p 3000 and make sure you have the right version of rails installed for your app.

Banana Chick Bush commented Mon Oct 25 00:00:29 UTC 2010:

mongrelclusterctl status will not work on lucid, use instead: /etc/init.d/mongrel-cluster status see https://bugs.launchpad.net/ubuntu/+source/mongrel-cluster/+bug/376061

Want to comment?

(not made public)


(use plain text or Markdown syntax)