Redmine im Webspace

Redmine ist eine umfangreiche Projektmanagement-Software. Die Software ist multiprojektfähig und legt für jedes Projekt mehrere Werkzeuge an:

• Wiki
• Vorgangsverfolgung (Ticketsystem, Issue Tracker)
• Zeiterfassung
• Dokument- und Dateiverwaltung
• Foren
• Kalender, Gantt-Charts
• Schnittstelle zur Versionverwaltung (Git, Mercurial und weitere)

Diese Anleitung beschreibt, wie man Redmine auf der Managed Hosting Plattform von Hostsharing installieren kann. Redmine lässt sich in jedem Managed Webspace betreiben.

Vorbereitungen

Mit Hilfe von HSAdmin wird angelegt:

1. Ein User als Service-User mit /bin/bash als Shell, zum Beispiel Beispiel: xyz00-redmine
2. Eine Domain mit xyz00-redmine als Domain-Administrator, zum Beispiel prj.example.com
3. Die Domain muss aktualisiert werden: Domainoption passenger einschalten, fastcgi ausschalten
4. Einen Postgresql-User xyz00_dbuser mit Passwort meinPasswort
5. Eine Postgresql-Datenbank xyz00_prjdb mit Datenbank-Owner xyz00_dbuser

Ruby installieren

Unter Debian Bookworm kann das systemseitig installierte Ruby benutzt werden.

Sonst: siehe Seite RubyRBEnv

Download, Entpacken, Konfiguration

Anmeldung per ssh als User xyz00-redmine":

ssh xyz00-redmine@xyz00.hostsharing.net

Auf dem Hostsharing-Server:

cd ~
mkdir data
chmod 700 data
wget http://www.redmine.org/releases/redmine-5.1.2.tar.gz
tar xzf redmine-5.1.2.tar.gz 
cd ~/redmine-5.1.2/config

Anlegen der beiden Dateien "database.yml" und "configuration.yml" mit folgendem Inhalt:

database.yml:

production:
  adapter: postgresql
  database: xyz00_prjdb
  host: localhost
  username: xyz00_dbuser
  password: "meinPasswort"

configuration.yml:

default:
  email_delivery:
    delivery_method: :smtp
    smtp_settings:
      address: "127.0.0.1"
      port: 4025
      enable_starttls_auto: false
  attachments_storage_path: "/home/pacs/xyz00/users/redmine/data"
  autologin_cookie_name:
  autologin_cookie_path:
  autologin_cookie_secure:
  scm_subversion_command:
  scm_mercurial_command:
  scm_git_command:
  scm_cvs_command:
  scm_bazaar_command:
  scm_darcs_command:
  scm_subversion_path_regexp:
  scm_mercurial_path_regexp:
  scm_git_path_regexp:
  scm_cvs_path_regexp:
  scm_bazaar_path_regexp:
  scm_darcs_path_regexp:
  scm_filesystem_path_regexp:
  scm_stderr_log_file:
  database_cipher_key:

Achtung: Die Einrückung muss immer genau um zwei Leerzeichen erfolgen!

Der "attachments_storage_path" muss angepasst werden ("xyz00" und "redmine" durch den eigenen Webspace bzw. das eigene User-Postfix ersetzen). Wenn für den Webspace "Storage" gebucht ist, kann der Speicher nach "/home/storage/..." gelegt werden.

Redmine-Installation

Weiterhin als "xyz00-redmine" auf dem Hostsharing-Server:

cd ~/redmine-5.1.2
bundle config --local path 'vendor/bundle'
bundle config --local without 'development:test'
bundle install
bundle exec rake generate_secret_token
RAILS_ENV=production bundle exec rake db:migrate
RAILS_ENV=production bundle exec rake redmine:load_default_data

Weiter in der Shell:

cd ~/doms/prj.example.com/
rm -rf htdocs-ssl/ app-ssl/ subs/www/ subs-ssl/www/
ln -s $HOME/redmine-5.1.2 app-ssl
ln -s $HOME/redmine-5.1.2/public htdocs-ssl

Wenn alles gut gegangen ist, ist die Redmine-Installation unter https://prj.example.com erreichbar. Beim ersten Login als User "admin" mit Passwort "admin" wird ein neues Passwort konfiguriert.

Nach der Änderung des Admin-Passwort sollten einige Einstellungen im Bereich Administration/Konfiguration durchgesehen werden:

• im Bereich "Allgemein" der Applikationstitel, der Hostname und das Protokoll
• im Bereich "Mailbenachrichtigung" der E-Mail-Absender und die E-Mail-Fußzeile

weitere Schritte

Redmine ist ein stabiles Projektmanagement-Werkzeug. Es ist freie Software und weiterhin gepflegt. Die Benutzeroberfläche ist funktional. Sie macht aber einen etwas veralteten Eindruck.

Es gibt einige Themes und Plugins, die diesen Nachteil teilweise kompensieren können:

• Das Theme "farend bleuclair" sorgt für einen frischeren Ersteindruck
• Ein Kanban Board ist als Plugin verfügbar
• ebenso kann ein visueller Editor für das Wiki nachgerüstet werden

Weiterhin ist es möglich, das Anlegen von Tickets für eingehende E-Mail-Nachrichten zu konfigurieren.

eingehende E-Mails

Wenn für eingehende E-Mail-Nachrichten jeweils ein Ticket angelegt werden soll, ist das über die Datei .forward möglich.

# cat .forward 

"| /home/pacs/xyz00/users/redmine/bin/email2ticket"

# cat bin/email2ticket 

#!/bin/bash
export PATH=/usr/local/bin:/usr/bin:/bin
export RAILS_ENV=production
cd /home/pacs/xyz00/users/redmine/redmine-5.1.2
bundle exec rake redmine:email:read project=projekt-kurzname tracker=3 unknown_user=create

Links

• Redmine Projekt
• Installationsanleitung
• Theme Farend Bleuclair
• Redmine Dashboard Plugin oder Kanban Board Plugin
• Wysiwyg Editor Plugin
• Dokumentenverwaltung (DMS) mit WebDAV-Server und Volltextsuche
• Eingehende E-Mails verarbeiten

---