Benutzer:Deg00-m.website:Redmine installieren

Redmine mit FastCGI installieren

Redmine ist ein Werkzeug zur Projektverwaltung - in erster Linie für Software-Entwicklungs-Projekte geeignet.

Redmine ist in Ruby mit dem Framework Ruby on Rails programmiert. Es steht unter der General Public License v2 (GPL).

Hier soll es als Beispiel dienen, wie man auf der Hostsharing-Infrastruktur Rails-Anwendungen betrieben kann.

Vorbereitungen

Download der aktuellen Redmine Version von Redmine (zur Zeit Version 3.3.4)

 cd ~
 svn co https://svn.redmine.org/redmine/branches/3.3-stable redmine-3.3
 cd ~/redmine-3.3

Auflösen der Abhängigkeiten

 export GEM_PATH=$( gem env gempath )
 export GEM_HOME=$HOME/.gem/ruby/2.1
 export RAILS_ENV=production
 gem install bundler

Konfiguration

Datenbank

Mit hsadmin habe ich den Postgres-User 'xyz00_redmine' (Passwort sei 'geheim') und die Datenbank 'xyz00_redmine' angelegt.

Die Datenbank konfigurieren ich wie folgt:

 cd ~/redmine-3.3/config/
 vi database.yml

mit folgendem Inhalt:

 production:
   adapter: postgresql
   database: xyz00_redmine
   host: localhost
   username: xyz00_redmine
   password: geheim

E-Mail, Dateiablage

 cd ~/redmine-3.3/config/
 vi configuration.yml

Wichtige Inhalte:

 default:
   email_delivery:
     delivery_method: :smtp
     smtp_settings:
       address: localhost
       port: 25
       domain: example.org
   attachments_storage_path: /home/pacs/xyz00/users/redmine/attach

Laden von Abhängigkeiten, Datenbankschema

Folgende Kommandos ausführen:

 cd ~/redmine-3.3
 ~/.gem/ruby/2.1/bin/bundle install --without development test
 ~/.gem/ruby/2.1/bin/bundle exec rake generate_secret_token
 ~/.gem/ruby/2.1/bin/bundle exec rake db:migrate
 ~/.gem/ruby/2.1/bin/bundle exec rake redmine:load_default_data

Das Skript fragt einer Sprache für die Inhalte der Datenbank: je nach Wunsche 'de' oder 'en' wählen.

Konfiguration von FastCGI

Datei ~/doms/redmine.example.org/htdocs/.htaccess

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

Datei ~/doms/redmine.example.org/fastcgi/dispatch.fcgi

 #!/usr/bin/env ruby
 require "/home/pacs/xyz00/users/meinuser/redmine-3.3/config/environment" 
 require 'fcgi_handler'
 RailsFCGIHandler.process!

FastCGI-Skript ausführbar machen:

 chmod 755 ~/doms/redmine.example.org/fastcgi/dispatch.fcgi

Am Anfang von ~/redmine-3.3/config/environment.rb füge ich ein:

 ENV['RAILS_ENV'] ||= 'production'
 ENV['GEM_PATH'] ||= '/home/pacs/xyz00/users/meinuser/.gem/ruby/2.1:/var/lib/gems/2.1'

Die Inhalte von ~/doms/redmine.example.org/public/ als webroot sichtbar machen:

 # Vorhandene Dateien sichern. (Alternativ in ~/redmine-3.3/public kopieren)
 mv ~/doms/redmine.example.org/htdocs ~/doms/redmine.example.org/htdocs.old
 ln -s ~/redmine-3.3/public ~/doms/redmine.example.org/htdocs

Konfiguration von SSL

Die Verzeichnisse ~/doms/redmine.example.org/fastcgi-ssl/ und ~/doms/redmine.example.org/htdocs-ssl/ werden analog zu bzw. anstelle von fastcgi und htdocs gefüllt.