Installation von Ruby on Rails auf einem 1&1 Homepage-Server
===========================================================
Jochen Schalanda <jochen@schalanda.name>

Version 1.4, April 2008
<<Changelog>>

Abstract
--------
Dieser Artikel ist eine Schritt-für-Schritt Anleitung zur Installation des
beliebten Webframeworks http://rubyonrails.com/[Ruby on Rails] auf einem
http://www.1und1.info/xml/order/ServerHomepage[Homepage-Server] (und
natürlich auch Managed-Server und Exklusiv-Server) des Providers
http://1und1.info/[1&1]. Dabei werden verschiedene Varianten vorgestellt, wie
eine auf Ruby on Rails basierende Applikation ausgeliefert werden kann.

CAUTION: Der Artikel wurde nach bestem Wissen und Gewissen geschrieben und
überprüft. Ich übernehme jedoch keinerlei Haftung für Schäden, die durch
Ausführung der in diesem Artikel aufgeführten Kommandos entstehen oder
entstanden sind.

.Lizenz
********************************************************************************
Dieser Artikel ist unter einer
http://creativecommons.org/licenses/by-sa/2.0/de/[Creative Commons
Lizenz] veröffentlicht.
********************************************************************************


Voraussetzungen
---------------
Es wird angenommen, dass der Leser dieses Artikels zumindest Grundkenntnisse
im Umgang mit Linux und der Bash besitzt. Die Kenntnis des ``Dreisprungs''
(`./configure && make && make install`) ist vorteilhaft, ebenso wie
grundlegendes Verständnis von Ruby on Rails.

Aus Praktikabilitätsgründen sollte jede Domain bzw. Rails Anwendung, die auf
dem Server gehostet wird, in einem eigenen DocumentRoot gespeichert werden,
also z. B. wird der Domain example.org das Verzeichnis `${HOME}/example.org/`
zugewiesen. Der Domain rails.example.com sollte das Verzeichnis
`${HOME}/rails.example.com/` zugewiesen werden.

TIP: Wer es gar nicht erwarten kann, findet im Anhang eine
<<Quickstart,Quickstart-Anleitung>>.

Installation zusätzlicher Software
----------------------------------
Um Ruby on Rails nutzen zu können, müssen einige Programme und Bibliotheken
nachinstalliert werden. Die Programme und Bibliotheken werden im Verzeichnis
`${HOME}/executable/` installiert, da dieses so
http://hilfe-center.1und1.de/server/exklusiv_server/4.html[konfiguriert] werden kann,
so dass der Apache httpd keinen Zugriff auf die darin enthaltenen Dateien hat.


Ruby
~~~~
Ruby on Rails benötigt Ruby 1.8.2 oder höher. Im Gegensatz zur vorigen
Betriebsumgebung ist auf den Homepage-Servern inzwischen Ruby 1.8.5
vorinstalliert ist, was für den Betrieb von Ruby on Rails ausreicht.


RubyGems
~~~~~~~~
RubyGems ist das Gegenstück zu http://cpan.org/[CPAN] (Perl) oder
http://pear.php.net/[PEAR] (PHP). Es vereinfacht die Installation einzelner
Ruby Bibliotheken, Frameworks oder Programme. RubyGem 0.9.0 ist
vorinstalliert, jedoch benötigt Ruby on Rails eine Version >=0.9.4. Aus diesem
Grund installieren wir das aktuelle Release RubyGems 1.1.0 in unserem
Homeverzeichnis.

--------------------------------------------------------------------
mkdir ${HOME}/executable/src/
cd ${HOME}/executable/src/
wget http://rubyforge.org/frs/download.php/34638/rubygems-1.1.0.tgz
tar -xzf rubygems-1.1.0.tgz
cd rubygems-1.1.0
--------------------------------------------------------------------

TIP: In der http://docs.rubygems.org/read/chapter/3#page83[Dokumentation von
RubyGems] ist die Installation als normaler Benutzer beschrieben.

Im nächsten Schritt wird die eigentliche Installation von RubyGems
durchgeführt. Die Gems selbst werden in dem Verzeichnis gespeichert, in dem
wir zuvor schon Ruby installiert haben.

------------------------------------------------------------------------------------------------------------------------------
export GEM_HOME=${HOME}/executable/ruby/gems
ruby setup.rb all --no-rdoc --no-ri --no-format-executable --prefix=${HOME}/executable/ruby --siteruby=${HOME}/executable/ruby
------------------------------------------------------------------------------------------------------------------------------

Aus Geschwindigkeitsgründen und weil diese in einer Produktivoumgebung nicht
benötigt werden, verzichten wir auf die Installation der RDoc- und
RI-Dokumentation. Damit das auch für alle zukünftig installierten Gems gilt,
erstellen wir eine Konfigurationsdatei für `gem`. In dieser werden ebenfalls
die Verzeichnisse festgelegt, in denen die Dateien der Gems gespeichert
werden.

--------------------------------------------------------------------
cat>${HOME}/.gemrc<<EOF
gem: --no-rdoc --no-ri
gemhome: /kunden/homepages/17/d123456789/htdocs/executable/ruby/gems
gempath:
  - /kunden/homepages/17/d123456789/htdocs/executable/ruby/gems
EOF
--------------------------------------------------------------------

NOTE: Alle via `gem` installierten RubyGems können einfach mit dem Kommando
`gem update` aktualisiert werden. Alte Versionen werden dabei nicht
automatisch entfernt, sondern müssen mit `gem cleanup` gelöscht werden.


Ruby on Rails
~~~~~~~~~~~~~
Die Installation von Ruby on Rails wird durch die RubyGems vergleichsweise
einfach. Abhängigkeiten wie http://rake.rubyforge.org/[Rake] werden damit
automatisch mitinstalliert.

-----------------
gem install rails
-----------------


[[fcgi]]
Optional: FCGI
~~~~~~~~~~~~~~
Je nachdem, wie Ruby On Rails später eingebunden wird, können wir noch die
Bibliothek http://raa.ruby-lang.org/project/fcgi/[FCGI] installieren.

Generell ist der Betrieb von Ruby on Rails über die FastCGI-Schnittstelle sehr
zu empfehlen, da hierbei im Gegensatz zum klassischen CGI nicht für jede
Anfrage ein eigener Prozess gestartet werden muss. Für Produktivumgebungen ist
die Einbindung über FastCGI unbedingt zu empfehlen.

----------------
gem install fcgi
----------------


Konfiguration
-------------
Damit wir bequem in der Shell arbeiten können und nicht bei jedem Login
`${PATH}` und andere Umgebungsvariablen manuell setzen müssen, erstellen wir
eine Datei namens `.profile` in unserem Homeverzeichnis mit den notwendigen
Einträgen.

----------------------------------------------------------------------------------
cat>>${HOME}/.profile<<EOF
export GEM_HOME="${HOME}/executable/ruby/gems"
export GEM_PATH="${HOME}/executable/ruby/gems"
export RUBYLIB="${HOME}/executable/ruby/lib:/usr/lib/ruby/1.8/"
export PATH="${HOME}/executable/ruby/bin:${HOME}/executable/ruby/gems/bin:${PATH}"
EOF
----------------------------------------------------------------------------------


Einbindung über den Apache
--------------------------
Da Ruby on Rails etwas wählerisch ist, was die URLs angeht, erstellen wir
zunächst eine http://hilfe-center.1und1.de/hosting/domains/verwaltung/4.html[Subdomain]
namens `rails.example.org` und weisen dieser das
http://hilfe-center.1und1.de/hosting/domains/verwaltung/1.html[Verzeichnis]
`~/rails.example.org/public` auf dem Homepage-Server zu.


CGI
~~~
Prinzipiell muss nichts mehr geändert werden. Die Nutzung via CGI ist sofort
nach der Installation möglich. Allerdings ist das auch die bei weitem
langsamste Methode und nicht für Produktivsysteme geeignet.

Da wir RubyGems in ein anderes Verzeichnis installiert haben, müssen die
Umgebungsvariablen zum richtigen Verzeichnis in der .htaccess gesetzt werden.
--------------------------------------------------------------------------------------------
AddHandler cgi-script .cgi
Options +FollowSymLinks +ExecCGI

SetEnv GEM_HOME /kunden/homepages/17/d123456789/htdocs/executable/ruby/gems
SetEnv GEM_PATH /kunden/homepages/17/d123456789/htdocs/executable/ruby/gems
SetEnv RUBYLIB /kunden/homepages/17/d123456789/htdocs/executable/ruby/lib:/usr/lib/ruby/1.8

# Alternativ zu der Umgebungsvariablen hier kann die Rails-Umgebung auch in
# der Datei config/environment.rb gesetzt werden.
SetEnv RAILS_ENV production

RewriteEngine On
RewriteRule ^$ index.html [QSA]
RewriteRule ^([^.]+)$ $1.html [QSA]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ dispatch.cgi [QSA,L]

ErrorDocument 500 /500.html
--------------------------------------------------------------------------------------------


FastCGI
~~~~~~~
Bei Homepage-Servern besteht die Möglichkeit, Skripte über die
FastCGI-Schnittstelle einzubinden. Dieses Feature muss allerdings erst
http://hilfe-center.1und1.de/server/exklusiv_server/4.html[aktiviert] werden. Außerdem
muss muss das Gem <<fcgi,FCGI>> installiert sein.

NOTE: Informationen zu mod_fastcgi können in der
http://www.fastcgi.com/mod_fastcgi/docs/mod_fastcgi.html[offiziellen
Dokumentation] gefunden werden.

Die Datei `${HOME}/rails.example.org/public/.htaccess` ersetzen wir mit folgendem
Inhalt:

----------------------------------------
AddHandler fastcgi-script .fcgi
AddHandler cgi-script .cgi
Options +FollowSymLinks +ExecCGI

RewriteEngine On
RewriteRule ^$ index.html [QSA]
RewriteRule ^([^.]+)$ $1.html [QSA]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ dispatch.fcgi [QSA,L]

ErrorDocument 500 /500.html
----------------------------------------

Damit die Umgebungsvariablen bei Aufruf des Dispatchers für FastCGI korrekt
gesetzt werden, wird ein Wrapperskript benötigt. Die ursprüngliche Datei
public/dispatch.fcgi muss dazu in public/dispatch.orig.fcgi umgenannt werden.
Der Wrapper wird public/dispatch.fcgi benannt und besitzt folgenden Inhalt:

--------------------------------------------------------------------------------------
#!/bin/bash
export GEM_HOME="/homepages/17/d123456789/htdocs/executable/ruby/gems"
export GEM_PATH=${GEM_HOME}
export RUBYLIB="/homepages/17/d123456789/htdocs/executable/ruby/lib:/usr/lib/ruby/1.8"

# Alternativ zu dieser Umgebungsvariablen kann die Rails-Umgebung auch in der
# Datei config/environment.rb gesetzt werden.
export RAILS_ENV="production"

exec ./dispatch.orig.fcgi $@
--------------------------------------------------------------------------------------

Die Pfade in `${GEM_HOME}` und `${RUBYLIB}` müssen selbstverständlich
angepasst werden, wobei im Gegensatz zum Inhalt der Datei `~/.profile` auf die
Nutzung der Umgebungsvariablen `${HOME}` verzichtet werden muss.


Beispielanwendungen
-------------------
In diesem Abschnitt werden beispielhaft einige Anwendungen installiert, u .a.
eine kleine Todo-Liste (Tracks) und ein Blog (Mephisto).

Simples Beispiel
~~~~~~~~~~~~~~~~
Dieses Beispiel wird nichts anderes können, als eine kurze "Hello World"
Nachricht anzuzeigen.

-----------------------------------------------------
cd ${HOME}
rails RailsTest
cd RailsTest
./script/generate controller welcome hello
echo "Hello World" > app/views/welcome/hello.html.erb
-----------------------------------------------------

Damit sich Ruby on Rails bzw. ActiveRecord auch ohne gültige
Datenbankzugangsdaten zufrieden gibt, muss in der Datei
`${HOME}/RailsTest/config/environment.rb` folgende Zeile auskommentiert
werden:

-------------------------------------------------------------------------
config.frameworks -= [ :active_record, :active_resource, :action_mailer ]
-------------------------------------------------------------------------

Wir binden dieses Beispiel über die CGI-Schnittstelle ein, um das Vorgehen bei
dieser Konfiguration zu verdeutlichen. Die
`${HOME}/RailsTest/public/.htaccess` muss mit folgendem Inhalt gefüllt werden:

--------------------------------------------------------------------------------------------
AddHandler cgi-script .cgi
Options +FollowSymLinks +ExecCGI

SetEnv GEM_HOME /kunden/homepages/17/d123456789/htdocs/executable/ruby/gems
SetEnv GEM_PATH /kunden/homepages/17/d123456789/htdocs/executable/ruby/gems
SetEnv RUBYLIB /kunden/homepages/17/d123456789/htdocs/executable/ruby/lib:/usr/lib/ruby/1.8

RewriteEngine On
RewriteRule ^$ index.html [QSA]
RewriteRule ^([^.]+)$ $1.html [QSA]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ dispatch.cgi [QSA,L]

ErrorDocument 500 /500.html
--------------------------------------------------------------------------------------------

Im Prinzip müssen alle Umgebungsvariablen (außer `${PATH}`), die auch in der
`${HOME}/.profile` stehen, in der .htaccess Datei angegeben werden. Bei der
Einbindung via FastCGI erfolgt dies über das Wrapperskript.

Die Einrichtung des Beispiels ist damit auch schon beendet und bei Aufruf von
`http://rails.example.org/welcome/hello` sollte uns ein schönes "Hello World"
begrüßen.


Tracks
~~~~~~
Das praktische http://www.rousette.org.uk/projects/[Tracks] ist so etwas wie
eine aufgemotzte To-Do Liste, die einen bei der
http://de.wikipedia.org/wiki/Getting_Things_Done[GTD]-Methode unterstützt.

---------------------------------------------------------------
cd ${HOME}
wget http://www.rousette.org.uk/projects/files/tracks-1.5.zip
unzip tracks-1.5.zip
mv tracks-1.5 tracks.example.org
---------------------------------------------------------------

Im https://login.1und1.de/[Control Center] des Homepage-Servers legen wir eine
Subdomain namens tracks.example.org an, die auf das Verzeichnis
/tracks.example.org/public/ verweist.

NOTE: Die
http://hilfe-center.1und1.de/hosting/domains/verwaltung/4.html[Einrichtung von
Subdomains] und die
http://hilfe-center.1und1.de/hosting/domains/verwaltung/1.html[Zuweisung eines
DocumentRoots] werden in der FAQ von 1&1 beschrieben.

Für den Betrieb von Tracks ist eine MySQL-Datenbank notwendig, die über das
https://login.1und1.de/[Control Center] erstellt werden muss. Anschließend
werden die Zugangsdaten in die Datei
`${HOME}/tracks.example.org/config/database.yml` eingetragen:

-------------------------------------------------------
cat>${HOME}/tracks.example.org/config/database.yml<<EOF
production:
  adapter: mysql
  database: db123456789
  host: localhost
  username: dbo123456789
  password: geheim
EOF
-------------------------------------------------------

Ebenso sollten wir nicht vergessen, in der Datei
`${HOME}/tracks.example.org/config/environment.rb` einen zufälligen und langen
Wert für `SALT` einzutragen.

Mit den korrekten Zugangsdaten für die MySQL-Datenbank kann nun eine
Initialisierung der Tabellen erfolgen.

------------------------------------
cd ${HOME}/tracks.example.org
RAILS_ENV=production rake db:migrate
------------------------------------

Tracks soll via FastCGI eingebunden werden. Wir ersetzen die .htaccess im
Verzeichnis `${HOME}/tracks.example.org/public` daher durch folgenden Inhalt:

----------------------------------------
AddHandler fastcgi-script .fcgi
AddHandler cgi-script .cgi
Options +FollowSymLinks +ExecCGI

RewriteEngine On
RewriteRule ^$ index.html [QSA]
RewriteRule ^([^.]+)$ $1.html [QSA]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ dispatch.fcgi [QSA,L]

ErrorDocument 500 /500.html
----------------------------------------

Außerdem muss die originale `dispatch.fcgi` in `dispatch.orig.fcgi` umbenannt
werden und ein Wrapperskript mit Namen `dispatch.fcgi` und folgendem Inhalt
angelegt werden:

--------------------------------------------------------------------------------------
#!/bin/bash
export GEM_HOME="/homepages/17/d123456789/htdocs/executable/ruby/gems"
export GEM_PATH=${GEM_HOME}
export RUBYLIB="/homepages/17/d123456789/htdocs/executable/ruby/lib:/usr/lib/ruby/1.8"

# Alternativ zu dieser Umgebungsvariablen kann die Rails-Umgebung auch in der
# Datei config/environment.rb gesetzt werden.
export RAILS_ENV="production"

exec ./dispatch.orig.fcgi $@
--------------------------------------------------------------------------------------

Danach kann Tracks über die URL `http://tracks.example.org/` aufgerufen
werden.

.Tracks in Aktion
image:images/tracks.png[Tracks in Aktion]


Mephisto
~~~~~~~~
Mephisto ist ein sehr gut anpassbares Blogsystem für Ruby on Rails. Da die
aktuell stabile Version 0.7.3 nicht mit Rails 2.0.2 zusammenarbeitet,
installieren wir die aktuelle Entwicklerversion auf dem Subversion-Repository.
Zusätzlich ist das Gem `tzinfo` für den Betrieb notwendig.

--------------------------------------------------------------------------------
cd ${HOME}
svn co http://svn.techno-weenie.net/projects/mephisto/trunk mephisto.example.org
gem install tzinfo
--------------------------------------------------------------------------------

Im https://login.1und1.de/[Control Center] des Homepage-Servers legen wir eine
Subdomain namens mephisto.example.org an, die auf das Verzeichnis
/mephisto.example.org/public/ verweist.

NOTE: Die
http://hilfe-center.1und1.de/hosting/domains/verwaltung/4.html[Einrichtung von
Subdomains] und die
http://hilfe-center.1und1.de/hosting/domains/verwaltung/1.html[Zuweisung eines
DocumentRoots] werden in der FAQ von 1&1 beschrieben.

Für den Betrieb von Mephisto ist eine MySQL-Datenbank notwendig, die über das
https://login.1und1.de/[Control Center] erstellt werden muss. Anschließend
werden die Zugangsdaten in die Datei
`${HOME}/mephisto.example.org/config/database.yml` eingetragen:

---------------------------------------------------------
cat>${HOME}/mephisto.example.org/config/database.yml<<EOF
production:
  adapter: mysql
  database: db123456789
  host: localhost
  username: dbo123456789
  password: geheim
EOF
---------------------------------------------------------


Mit den korrekten Zugangsdaten für die MySQL-Datenbank kann nun eine
Initialisierung der Tabellen erfolgen.

--------------------------------------
cd ${HOME}/mephisto.example.org
RAILS_ENV=production rake db:bootstrap
--------------------------------------

Mephisto soll via FastCGI eingebunden werden. Wir ersetzen die .htaccess im
Verzeichnis `${HOME}/mephisto.example.org/public` daher durch folgenden Inhalt:

----------------------------------------
AddHandler fastcgi-script .fcgi
AddHandler cgi-script .cgi
Options +FollowSymLinks +ExecCGI

RewriteEngine On
RewriteRule ^$ index.html [QSA]
RewriteRule ^([^.]+)$ $1.html [QSA]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ dispatch.fcgi [QSA,L]

ErrorDocument 500 /500.html
----------------------------------------

Außerdem muss die originale `dispatch.fcgi` in `dispatch.orig.fcgi` umbenannt
werden und ein Wrapperskript mit Namen `dispatch.fcgi` und folgendem Inhalt
angelegt werden:

--------------------------------------------------------------------------------------
#!/bin/bash
export GEM_HOME="/homepages/17/d123456789/htdocs/executable/ruby/gems"
export GEM_PATH=${GEM_HOME}
export RUBYLIB="/homepages/17/d123456789/htdocs/executable/ruby/lib:/usr/lib/ruby/1.8"

# Alternativ zu dieser Umgebungsvariablen kann die Rails-Umgebung auch in der
# Datei config/environment.rb gesetzt werden.
export RAILS_ENV="production"

exec ./dispatch.orig.fcgi $@
--------------------------------------------------------------------------------------

Danach kann Mephisto über die URL `http://mephisto.example.org/` aufgerufen
werden.


Redmine
~~~~~~~
http://www.redmine.org/[Redmine] ist ein praktisches
Projektmanagement-Werkzeug, das alles bietet, was man für kleinere Projekte
benötigt. Es weist einige Ähnlichkeiten zu dem bekannten
http://trac.edgewall.org/[Trac] auf.

---------------------------------------------------------------------
cd ${HOME}
wget http://rubyforge.org/frs/download.php/33789/redmine-0.6.4.tar.gz
tar -xzf redmine-0.6.4.tar.gz
mv redmine-0.6.4 redmine.example.org
---------------------------------------------------------------------

Im https://login.1und1.de/[Control Center] des Homepage-Servers legen wir eine
Subdomain namens redmine.example.org an, die auf das Verzeichnis
/redmine.example.org/public/ verweist.

NOTE: Die
http://hilfe-center.1und1.de/hosting/domains/verwaltung/4.html[Einrichtung von
Subdomains] und die
http://hilfe-center.1und1.de/hosting/domains/verwaltung/1.html[Zuweisung eines
DocumentRoots] werden in der FAQ von 1&1 beschrieben.

Für den Betrieb von Redmine ist eine MySQL-Datenbank notwendig, die über das
https://login.1und1.de/[Control Center] erstellt werden muss. Anschließend
werden die Zugangsdaten in die Datei
`${HOME}/redmine.example.org/config/database.yml` eingetragen:

-------------------------------------------------------
cat>${HOME}/redmine.example.org/config/database.yml<<EOF
production:
  adapter: mysql
  database: db123456789
  host: localhost
  username: dbo123456789
  password: geheim
EOF
-------------------------------------------------------

Wenn die Zugangsdaten korrekt waren, können wir die Tabellen initialisieren
und die Grundkonfiguration von Redmine vornehmen.

---------------------------------------------------
RAILS_ENV=production rake db:migrate
RAILS_ENV=production rake redmine:load_default_data
---------------------------------------------------

Bei Aufruf von http://redmine.example.org/ erscheint nun eine Loginmaske. Die
Zugangsdaten lauten Benutzer: admin, Passwort: admin. Das Passwort sollte schnellst
möglich geändert werden, um einen unberechtigten Zugriff zu vermeiden.

Redmine soll via FastCGI eingebunden werden. Wir ersetzen die .htaccess im
Verzeichnis `${HOME}/redmine.example.org/public` daher durch folgenden Inhalt:

----------------------------------------
AddHandler fastcgi-script .fcgi
AddHandler cgi-script .cgi
Options +FollowSymLinks +ExecCGI

RewriteEngine On
RewriteRule ^$ index.html [QSA]
RewriteRule ^([^.]+)$ $1.html [QSA]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ dispatch.fcgi [QSA,L]

ErrorDocument 500 /500.html
----------------------------------------

Außerdem muss die originale `dispatch.fcgi` in `dispatch.orig.fcgi` umbenannt
werden und ein Wrapperskript mit Namen `dispatch.fcgi` und folgendem Inhalt
angelegt werden:

--------------------------------------------------------------------------------------
#!/bin/bash
export GEM_HOME="/homepages/17/d123456789/htdocs/executable/ruby/gems"
export GEM_PATH=${GEM_HOME}
export RUBYLIB="/homepages/17/d123456789/htdocs/executable/ruby/lib:/usr/lib/ruby/1.8"

# Alternativ zu dieser Umgebungsvariablen kann die Rails-Umgebung auch in der
# Datei config/environment.rb gesetzt werden.
export RAILS_ENV="production"

exec ./dispatch.orig.fcgi $@
--------------------------------------------------------------------------------------

Danach kann Redmine über die URL `http://redmine.example.org/` aufgerufen
werden.

.Redmine in Aktion
image:images/redmine.png[redmine in Aktion]


== Anhang

[[Quickstart]]
=== Installation für ganz Ungeduldige
Dieser Abschnitt führt alle die Installation von Ruby on Rails notwendigen
Kommandos auf einem Homepage-Server ohne zusätzliche Erklärungen auf. Wer es
genauer wissen will, sollte den Artikel komplett lesen.

-------------------------------------------------------------------------------------------
# Umgebungsvariablen setzen und dann in das aktuelle Environment laden
cat>>${HOME}/.profile<<EOF
export GEM_HOME="${HOME}/executable/ruby/gems"
export GEM_PATH=${GEM_HOME}
export RUBYLIB="${HOME}/executable/ruby/lib:/usr/lib/ruby/1.8/"
export PATH="${HOME}/executable/ruby/bin:${HOME}/executable/ruby/gems/bin:${PATH}"
EOF

source ${HOME}/.profile

# Installation und Konfiguration von RubyGems
mkdir ${HOME}/executable/src/
cd ${HOME}/executable/src/
wget http://rubyforge.org/frs/download.php/34638/rubygems-1.1.0.tgz
tar -xzf rubygems-1.1.0.tgz
cd rubygems-1.1.0
ruby setup.rb all --no-rdoc --no-ri --no-format-executable --prefix=${HOME}/executable/ruby --siteruby=${HOME}/executable/ruby

cat>${HOME}/.gemrc<<EOF
gem: --no-rdoc --no-ri
gemhome: ${HOME}/executable/ruby/gems
gempath:
  - ${HOME}/executable/ruby/gems
EOF

# Installation der nötigen RubyGems
gem install rails fcgi

# Erstellen der .htaccess im /public-Verzeichnis der Rails-Applikation
cat>${HOME}/rails.example.org/public/.htaccess<<EOF
AddHandler fastcgi-script .fcgi
AddHandler cgi-script .cgi
Options +FollowSymLinks +ExecCGI

RewriteEngine On
RewriteRule ^$ index.html [QSA]
RewriteRule ^([^.]+)$ $1.html [QSA]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ dispatch.fcgi [QSA,L]

ErrorDocument 500 /500.html
EOF

# Erstellen des Wrapperskripts für FastCGI im /public-Verzeichnis der Rails-Applikation
mv ${HOME}/rails.example.org/public/dispatch.fcgi ${HOME}/rails.example.org/public/dispatch.orig.fcgi 

cat>${HOME}/rails.example.org/public/dispatch.fcgi<<EOF
#!/bin/bash
export GEM_HOME="/homepages/17/d123456789/htdocs/executable/ruby/gems"
export GEM_PATH=${GEM_HOME}
export RUBYLIB="/homepages/17/d123456789/htdocs/executable/ruby/lib:/usr/lib/ruby/1.8"
export RAILS_ENV="production"

exec ./dispatch.orig.fcgi $@
EOF

chmod +x ${HOME}/rails.example.org/public/dispatch.fcgi
-------------------------------------------------------------------------------------------


[[Changelog]]
== Changelog
=== Version 1.4
* Anpassung für neue Betriebsumgebung der Homepage-Server
* RubyGems 1.1.0
* Tracks 1.5 und Mephisto (SVN) als Beispiel-Applikationen

=== Version 1.3
* Ruby 1.8.6-p111
* RubyGems 1.0.0
* Rails 2.0.2
* Mongrel 1.1.3
* Thin 0.6.1
* nginx 0.5.35
* Tracks und Redmine als Beispiel-Applikationen

=== Version 1.2
* Ruby 1.8.6-p110
* MySQL/Ruby 2.7.4
* Rails 1.2.5
* Mongrel 1.1.1
* lighttpd 1.4.18
* nginx 0.5.33

=== Version 1.1
* Ruby 1.8.6 (+Patch für OpenSSL)
* RubyGems 0.9.4
* Rails 1.2.3
* Mongrel 1.0.1
* lighttpd 1.4.15
* nginx 0.5.22

=== Version 1.0
* Erste öffentliche Version.