Plesk, Passenger (mod_rails), RailsEnterpriseEdition & Ruby on Rails
Posted by: Tom in Plesk, Ruby on Rails, VPS, tags: Apache, CentOS 5, Passenger, Plesk, Ruby on Rails, RubyEnterpriseEdition, VPSCurrently I have a Plesk 8.4 installation running on a CentOS 5 VPS. First I had my Ruby on Rails websites running on multiple mongrel servers (cluster) but it took too much RAM of my VPS and it was very complicated to add more websites. So now I’ve installed Passenger (make sure you check the screencast on the Passenger website!) which makes adding websites very easy. Also I’ve installed RubyEnterpriseEdition which reduces the memory needed for Ruby applications, including Ruby on Rails. Below I’ll describe the steps I took to complete this installation.
Passenger
Just follow the steps described on the Passenger website. Run as root:
gem install passenger
The following command verifies if all the dependencies are installed, if not it suggests what rpm’s should be installed and exits. If all the dependencies are met, it compiles the Apache 2 module and installs the module.
passenger-install-apache2-module
Personally I hate installers who do a lot of stuff you can’t control, but this one does only the stuff it should do and will not break your current setup. After the module is installed you need to add the module to Apache. So I created the file /etc/httpd/conf.d/passenger.conf with the following contents:
LoadModule passenger_module /usr/lib/ruby/gems/1.8/gems/passenger-2.0.1/ext/apache2/mod_passenger.so PassengerRoot /usr/lib/ruby/gems/1.8/gems/passenger-2.0.1 PassengerRuby /usr/bin/ruby
Restart Apache.
/etc/init.d/httpd restart
At this point you have installed Passenger and the only thing to make a Ruby on Rails application work, is to point the Apache DocumentRoot directive to the public directory of your Rails application.
RubyEnterpriseEdition
Download RubyEnterpriseEdition (REE), extract the file and run the installer. As described on the REE website.
wget http://rubyforge.org/frs/download.php/38777/ruby-enterprise-1.8.6-20080624.tar.gz tar xzvf ruby-enterprise-1.8.6-20080624.tar.gz ./ruby-enterprise-1.8.6-20080624/install
This installer will install it’s own Ruby environment to /opt. This is good, because it will not touch your current Ruby environment. After the installation you’ll have a separate gem installed which is version 1.2.0. The version without the gem bulkupdate, which causes a lot of memory problems on VPS’es. The following commands I’ve used to install different gems. Mysql did not install easily, but with the -- --with-mysql it worked. Note the --no-rdoc and --no-ri because we’re on a production environment we don’t need the documentation.
/opt/ruby-enterprise-1.8.6-20080624/bin/gem install --no-rdoc --no-ri rails /opt/ruby-enterprise-1.8.6-20080624/bin/gem install --no-rdoc --no-ri -v 1.2.6 rails /opt/ruby-enterprise-1.8.6-20080624/bin/gem install --no-rdoc --no-ri -v 2.0.2 rails /opt/ruby-enterprise-1.8.6-20080624/bin/gem install --no-rdoc --no-ri mysql -- --with-mysql-config
If you have all the gems installed which you need in your Rails applications, it’s time to switch the Ruby Interpreter to the REE installation, we do this by replacing the PassengerRuby line in the /etc/httpd/conf.d/passenger.conf file.
PassengerRuby /opt/ruby-enterprise-1.8.6-20080624/bin/ruby
Finetuning
Depending on the available RAM on your VPS, you should add the following line to passenger.conf:
PassengerMaxPoolSize 2
To prevent Passenger from invoking to many instances of the Rails app.
Plesk
The only thing you have to do in Plesk is to modify the DocumentRoot. I’ve made a app directory where I deploy my Rails application with Capistrano. Create the file vhost.conf in the config directory of your domain.
DocumentRoot /var/www/vhosts/DOMAIN.COM/app/current/public
After that run the following command to let Plesk reconfigure your domain and add a include for your vhost.conf file.
/usr/local/psa/admin/sbin/websrvmng -u --vhost-name=DOMAIN.COM
Entries (RSS)
nice tutorial! thx a lot!
but do you know, how i can use a sub URI instead of the DocumentRoot? like DOMAIN.COM/mycook?
i got it:
- create a link to public folder in your httpdocs folder:
ln -s /var/www/vhosts/DOMAIN.COM/app/current/public /var/www/vhosts/DOMAIN.COM/httpdocs/app
- instead of DocumentRoot, add RailsBaseURI to your vhost.conf:
RailsBaseURI /app
- reload vhost.conf:
/usr/local/psa/admin/sbin/websrvmng -u –vhost-name=DOMAIN.COM
- browse:
http://DOMAIN.COM/app
hm, do you know, why i had to change the owner of app to
chown -R DOMAIN:psaserv app/
to get it work?
hm, sorry for this multi posts, but i can’t edit them.
i can’t open every static file in my public folder like images, javascripts, stylesheets:
http://DOMAIN.COM/app/javascripts/all.js -> 403 Forbidden
any idea?
@spross - my guess is you already go this. Otherwise, add the following to your DOMAIN.com/conf/vhost.conf file:
Options +FollowSymLinks