Phusion Passenger auf OS X Snow Leopard installieren

Anlässlich des 3.0.0 Release von Phusion Passenger möchte ich euch heute zeigen, wie man Passenger auf Snow Leopard zum Laufen bekommt. Ich gehe hierbei davon aus, dass ihr Textmate installiert habt – falls nicht, dann ersetzt jedes “mate” mit “vi” oder welcher andere Editor euch zusagt.

Wofür Passenger?

Bei der Softwareentwicklung mit Ruby on Rails gab es für mich einige gewöhnungsbedürftige Punkte. Zunächst muss die Anwendung jedes mal mühsam über rails server gestartet werden. Mir würde es gefallen, wenn ich einfach wie gewohnt mein ~/Sites Verzeichnis verwenden könnte und die Anwendung beim Aufrufen von http://localhost/railsapp gestartet würde. Besser gefiele mir noch http://railsapp.local oder etwas ähnliches. Willkommen bei Passenger!

Installation von Phusion Passenger

Zunächst geben wir folgende Zeile in unser Terminal ein:

sudo gem install passenger

Nachdem gem seinen Dienst getan hat und das Passenger-Gem installiert hat, folgt diese Zeile zum kompilieren und installieren des Apache-Moduls:

sudo passenger-install-apache2-module

Noch einmal Enter betätigen und es wird kompiliert und installiert. Am Ende der Installation wird uns folgender Hinweis gegeben:

The Apache 2 module was successfully installed.

Please edit your Apache configuration file, and add these lines:

   LoadModule passenger_module /usr/local/lib/ruby/gems/1.9.1/gems/passenger-3.0.0/ext/apache2/mod_passenger.so
   PassengerRoot /usr/local/lib/ruby/gems/1.9.1/gems/passenger-3.0.0
   PassengerRuby /usr/local/bin/ruby

After you restart Apache, you are ready to deploy any number of Ruby on Rails
applications on Apache, without any further Ruby on Rails-specific
configuration!

Diese Zeilen werden je nach installierter Ruby Version und Ruby Installationspfad anders aussehen. Um unserem Apache vom neuen Modul zu erzählen machen wir uns nun daran, die Konfigurationsdatei entsprechend anzupassen (und vorher erstellen wir sicherheitshalber eine Kopie, nur für den Fall …). Hierzu öffnen wir per CMD+T einen neuen Tab im Terminal und führen diese Befehle aus:

cp /etc/apache2/httpd.conf /etc/apache2/httpd.conf.bak
mate /etc/apache2/httpd.conf

Ans Ende der Datei kopieren wir die oben genannten Zeilen und speichern die httpd.conf. Mittels sudo apachectl graceful starten wir unseren Apache neu und voilá, das Modul ist installiert. Um jetzt die gewünschte Funktionalität zu erreichen kann man entweder per Hand VirtualHosts in die httpd.conf (oder eine per include eingebundene Datei) einpflegen – oder man benutzt seinen Mac wie man es sollte und holt sich das Passenger Pref Pane von Fingertips.