Phusion's Passenger (mod_rails) is an exciting development in serving your Ruby on Rails application with the Apache web server.
Incredibly simple to install and use, you can have a rails application up and running in no time. You don't have to worry about ports or setting up a proxy to another server.
To get the most out of this article you need to have a couple of things preinstalled:
Firstly, you need Apache installed (see this article).
Secondly, you need ruby and rubygems installed (if not please see the Ruby on Rails article).
Passenger (mod_rails) is a rubygem.
We need to update the rubygems install:
sudo gem update
and then install passenger:
sudo gem install passenger
Once completed, we need to install the Apache2 module:
A dialogue opens in the terminal and starts with:
As suggested, press 'Enter/Return':
I deliberately left the Apache headers off the installation until this point as I want to demonstrate how easy the installation is.
The passenger (mod_rails) install has found a missing dependency - let's press 'Enter/Return':
How cool is that? It tells us what to do.
Well, let's go ahead and install the headers:
sudo yum install httpd-devel apr-devel apr-util-devel
Once done, we can try the install again:
All being well, the install will complete with instructions at the end letting us know we need to add some lines to the main Apache config file.
sudo nano /etc/httpd/conf/httpd.conf
Note: Passenger is an active gem and is being updated all the time. Rather than copy and paste the output I show below, please ensure you copy and paste the output from the install itself.
At the time of writing the article I installed passenger v2.1.3 - you may have installed a later version.
So, for my v2.1.3 install, I added the following lines to my httpd.conf:
LoadModule passenger_module /usr/lib64/ruby/gems/1.8/gems/passenger-2.1.3/ext/apache2/mod_passenger.so PassengerRoot /usr/lib64/ruby/gems/1.8/gems/passenger-2.1.3 PassengerRuby /usr/bin/ruby
Now all we need to do is restart Apache:
sudo /etc/init.d/httpd restart
That's all we need to do to install mod_rails onto our Slice.
The next article will show us how to create a Ruby on Rails application and serve it using passenger - an incredibly easy process.