Bei uns haben Sie die Möglichkeit, eigene RubyGems zu installieren. Es gibt sowohl global vorhandene als auch lokale, benutzerspezifische RubyGems. Die globalen RubyGems sind zumeist essentiell, hierzu gehören u.a. rails, mysql, rmagick und andere. Auf diese globalen RubyGems haben Sie mittels SSH keinen Zugriff, Ihre Anwendung kann auf diese Gems hingegen mittels mod_rails über den Webservers zugreifen. Um mit Ruby on Rails auf unseren Servern arbeiten zu können müssen Sie das RubyGem "rails" installieren. Die von Ihnen verwendete rails-Version muss mit einer der global installierten Rails-Versionen übereinstimmen. Eine Liste der zur Verfügung stehenden Rails-Versionen finden Sie in Ihrem Kundenbereich. mod_rails vereinfacht das deployment Ihrer Anwendung, im Gegensatz zur Einbindung mittels FastCGI, drastisch und sorgt für einen leistungsstarken Auftritt Ihrer Website im Internet.

1. Ruby on Rails installieren Loggen Sie sich bitte mit Ihrem Benutzernamen und Ihrem Passwort in Ihren Shell Zugang ein und installieren Sie zunächst mit folgendem Befehl das RubyGem "rails": gem install rails Wir haben für Sie mittels Voreinstellung folgende RubyGems Optionen gesetzt: gem: --no-rdoc --no-ri Hierdurch werden die für das jeweilige RubyGem vorhandenen Anleitungen nicht mit installiert, dass spart Ihnen Zeit und Speicherplatz. Sie können diese Voreinstellungen jederzeit anpassen indem Sie die Datei ~/.gemrc bearbeiten. Erzeugen Sie nun bitte das Verzeichnis "rails" im Ordner /html (diese Verzeichnisstruktur sollten Sie aus historischen Gründen und der Übersicht halber beibehalten). mkdir /html/rails

2. Ruby on Rails Grundgerüst erzeugen Im folgenden erstellen wir im Ordner "/files/rails/test" das Grundgerüst für Ihre Anwendung, welche den Namen "test" hat. rails -d mysql /files/rails/test Seit Rails Version 2.0.2 wird standardmäßig SQLite als Datenbank verwendet. Die Option "-d mysql" sorgt dafür, dass Ihre Rails-Anwendung für MySQL vorkonfiguriert wird. Hiervon wird erfahrungsgemäß am häufigsten von Gebrauch gemacht. Sollten Sie SQLite bevorzugen, lassen Sie diese Option einfach weg.

3. Symbolischen Link erzeugen Super, Sie haben nun bereits Ihre erste Ruby on Rails Applikation erstellt. Nun müssen wir sie allerdings noch der Öffentlichkeit zugänglich machen. Das geht wie folgt: Setzen Sie einen symbolischen Link zu Ihrem öffentlichen Verzeichnis des Programms test: ln -s /var/www/htdocs/webXX/files/rails/test/public /var/www/htdocs/webXX/html/rails/test Hinweis! webXX müssen Sie mit Ihrem Benutzernamen austauschen

4. Ruby on Rails für lokale RubyGems konfigurieren Jetzt sollten Sie die Datei "environment.rb" im Ordner "/files/rails/test/config" bearbeiten. pico /files/rails/test/config/environment.rb Fügen Sie hier ganz an den Anfang der Datei (Zeile 1) folgenden Quellcode ein: ENV['GEM_PATH'] = '/var/www/htdocs/webXX/.gems:/usr/lib/ruby/gems/1.8' Hinweis! webXX müssen Sie mit Ihrem Benutzernamen austauschen Dieser Schritt sorgt dafür, dass die Anwendung Ihre lokalen RubyGems verwendet. Dabei schaut sie zuerst in Ihrem lokalen RubyGems Verzeichnis nach vorhandenen RubyGems. Wird das benötigte RubyGem dort nicht gefunden, wird die Suche im globalen Verzeichnis fortgesetzt.

5. MySQL-Datenbank anlegen Bitte legen Sie nun mittels der Verwaltungsoberfläche Confixx eine neue MySQL-Datenbank an. Das Menü erreichen Sie über: Einstellungen > MySQL Vergeben Sie nach Belieben im Kommentarfeld einen Kommentar für Ihre Datenbank (z.B. test development) und klicken Sie den Button "erstellen". Im oberen Bildschirmabschnitt werden Datenbank und Passwort angezeigt, welche Sie sich bitte notieren.

6. Ruby on Rails für Ihre Domain aktivieren Bisher kann Ihre Domain nichts mit Ruby on Rails Anwendung anfangen, daher müssen wir sie dafür vorbereiten. Im Menü Einstellungen > Httpd Spezial > eine Domain ändern > Domain wählen > ändern aktivieren Sie die Option "Ruby on Rails" welche folgende relevante Einstellungsmöglichkeiten bietet: [ ] on (development) [ ] on (test) [ ] on (production) Wählen Sie "[x] on (development)" aus und klicken Sie "speichern". Nun kann Ihre Domain mit Ihrer Ruby on Rails Anwendung umgehen. Jetzt müssen wir noch das Ziel Ihrer Domain auf den in Schritt 3 erzeugten Symlink einstellen. Einstellungen > Domains > Domain wählen > ändern anklicken > Weiterleiten nach > /rails/test Hinweis! Wenn das Ziel Ihrer Domain ein "/" ist (forward slash) dann ist das Ziel automatisch der Ordner "/html"

7. MySQL-Datenbank konfigurieren Im folgenden konfigurieren wir die Anbindung an die MySQL-Datenbank, welche Sie zuvor mittels Confixx angelegt haben sollten. Hierzu bearbeiten Sie bitte die Datei "database.yml" im Ordner "/files/rails/test/config". pico /files/rails/test/config/database.yml In Schritt 6 haben wir Ihre Domain für die Entwicklungs-Laufzeitumgebung konfiguriert, daher konzentrieren wir uns hier auf den Bereich "development". Tragen Sie dort bitte folgende Daten ein: adapter: mysql database: usr_webXX_X username: webXX password: Ihr Passwort host: 127.0.0.1 Hinweis! webXX müssen Sie mit Ihrem Benutzernamen austauschen, usr_webXX_X mit dem Namen Ihrer Datenbank Achtung! Sie müssen den MySQL-Server explizit via TCP/IP über die IP-Adresse 127.0.0.1 ansprechen, da der MySQL-Socket in Ihrer SSH-Umgebung nicht zur Verfügung steht. Nun sollten Sie, aus Sicherheitsgründen, den Zugriff auf diese Datei einschränken chmod 600 /files/rails/test/config/database.yml

8. Riding the Rails Fertig! Sie erreichen nun in Ihrem Browser über Ihre Domain mittels mod_rails Ihre Ruby on Rails Anwendung "test" www.ihredomain.tld Auf der offiziellen Homepage von Ruby on Rails finden Sie weitere Informationen www.rubyonrails.org Auf der offiziellen Homepage von mod_rails (Phusion Passenger) finden Sie weitere Informationen www.modrails.com