Benutzer-Werkzeuge

Webseiten-Werkzeuge


Seitenleiste

Was fehlt?

Es liegt in der Natur der Sache: Ein Wiki ist niemals fertig. Wir geben uns große Mühe, mit der Entwicklung Schritt zu halten; lassen Supportanfragen direkt in neue Artikel einfließen … aber auch wir sind nicht perfekt. Wenn du hier nicht fündig wirst: Nicht schmollen - Bescheid sagen! Unter hallo@uberspace.de steht dir unser Team gerne bereit. Hand drauf!

cool:redmine

Einführung

Redmine ist eine Web-Applikation zum Projekt-Management mit umfangreichen Features wie einem integrierten Ticketsystem und einem Wiki. Es ist in Ruby geschrieben und basiert auf dem Framework Rails.

Installation

Wir haben uns an der offiziellen Anleitung orientiert.

Zuerst hole wir uns die aktuelle, stabile von GitHub:

[susanne@selen ~]$ git clone https://github.com/redmine/redmine -b 3.3-stable

Umgebung

[susanne@selen ~]$ cat >> $HOME/.bash_profile <<__EOF__
export RAILS_SERVE_STATIC_FILES=true
export RAILS_ENV=production
__EOF__
[susanne@selen ~]$ source $HOME/.bash_profile

Datenbank

Wir empfehlen dir, eine separate Datenbank für Redmine zu verwenden. Diese kannst du dir leicht selbst anlegen - hier im Beispiel verwenden wir deinen Usernamen und hängen _redmine hintendran (für den User susanne heißt die Datenbank dann also susanne_redmine):

[susanne@selen ~]$ mysql -e "CREATE DATABASE ${USER}_redmine CHARACTER SET utf8"

Als nächstes konfigurierst du diese Datenbank für Redmine:

[susanne@selen ~]$ cd redmine
[susanne@selen redmine]$ cat > config/database.yml <<__EOF__
production:
  adapter: mysql2
  database: ${USER}_redmine
  host: localhost
  username: $USER
  password: $(my_print_defaults client | grep -- --password | awk -F = '{ print $2 }')
  encoding: utf8
__EOF__

Das Passwort füllen wir so mit etwas Shell-Magie automatisch aus.

Achtung: Bei dieser Datei ist die Einrückung aller Zeilen bis auf production: syntaktisch wichtig, ohne klappt es nicht.

Gems

Installiere nun die benötigten Gems. Gems sind Komponenten, die gepackt und versioniert wurden, um sie in Projekten wie Redmine einzubauen. Wir fügen Unicorn hinzu, das wir später noch benötigen und installieren alles auf einmal:

[susanne@selen redmine]$ echo "gem 'unicorn'" > Gemfile.local
[susanne@selen redmine]$ bundle install --without development test postgresql sqlite

Der zweite Befehl kann eine halbe Ewigkeit dauern. Nicht die Geduld verlieren.

Token

Wie jede Rails-Anwendung benötigt auch Redmine ein geheimes Token, mit dem Daten in User-Sessions verschlüsselt werden, um diese sicherer zu machen. So tue dies:

[susanne@selen redmine]$ bundle exec rake generate_secret_token

Datenbank

Nun erstelle die Tabellen in der Datenbank mittels des Migrations-Scripts:

[susanne@selen redmine]$ bundle exec rake db:migrate

… und befülle die Datenbank:

[susanne@selen redmine]$ bundle exec rake redmine:load_default_data

An dieser Stelle wirst du nach der Sprache gefragt, die dein Redmine sprechen soll. Wenn du Deutsch haben möchtest, dann gib de ein.

Einstellungen

In der Datei config/settings.yml findest du allerhand Einstellungen. Bearbeite sie nach Gusto und achte darauf, dass folgende Zeilen stimmen:

host_name:
  default: [uberspace].[host].uberspace.de
protocol:
  default: https

Mail

Zum Versenden von Mails stellen wir Redmine auf Sendmail ein:

[susanne@selen ~]$ cat > $HOME/redmine/config/configuration.yml <<__EOF__
production:
  email_delivery:
    delivery_method: :sendmail
__EOF__

Service

Nun starten wir Redmine als Service. Dazu müssen wir zunächst einen freien Port raussuchen …

[susanne@selen ~]$ REDMINE_PORT=$(( $RANDOM % 4535 + 61000)); netstat -tulpen | grep $REDMINE_PORT && echo "versuch's nochmal"
[susanne@selen ~]$ test -d $HOME/service || uberspace-setup-svscan
[susanne@selen ~]$ uberspace-setup-service redmine bundle exec unicorn_rails --port $REDMINE_PORT
[susanne@selen ~]$ sed -i -e 's/exec/cd $HOME\/redmine\/\nexec/' $HOME/service/redmine/run
[susanne@selen ~]$ svc -u $HOME/service/redmine

Solltest du einmal den Dienst neu starten müssen, dann geht das so:

[susanne@selen ~]$ svc -du $HOME/service/redmine

Proxy

[susanne@selen ~]$ cat > $HOME/html/.htaccess <<__EOF__
RewriteEngine On
RewriteCond %{HTTPS} !=on
RewriteCond %{ENV:HTTPS} !=on
RewriteRule .* https://%{SERVER_NAME}%{REQUEST_URI} [R=301,L]
RewriteRule (.*) http://localhost:${REDMINE_PORT}/\$1 [P]
__EOF__

Login

Besuche nun deine Redmine-Installation im Browser und logge dich ein. Benutzername und Passwort lauten beide 'admin'.

https://[user].[host].uberspace.de

Als erstes solltest du natürlich /das Passwort ändern. Das geht unter

https://[user].[host].uberspace.de/my/password

Fertig!

Damit bist du nun fertig. Viel Spaß mit Redmine!

Mehr Infos findest du im Redmine Guide

cool/redmine.txt · Zuletzt geändert: 2016/11/16 20:23 von uber